com.progress.open4gl.javaproxy

Class ProObject

java.lang.Object

com.progress.open4gl.javaproxy.ProObject

All Implemented Interfaces:

SDOFactory

Direct Known Subclasses:

AppObject, Procedure, SubAppObject

public abstract class ProObject
extends java.lang.Object
implements SDOFactory

This is the base class for AppObject, Procedure, and SubAppObject.

Field Summary

Fields

Modifier and Type	Field and Description
protected static long	m_alreadyBusy
protected static long	m_badOutputVal
protected static long	m_notAvailable
protected IPoolProps	m_properties
protected static long	m_wrongProxyVer
protected static java.lang.String	TYPE_AO
protected static java.lang.String	TYPE_PO
protected static java.lang.String	TYPE_SC
protected static java.lang.String	TYPE_SO
protected static java.lang.String	TYPE_SP

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	ProObject()
	ProObject(ProObject proxyObj, java.lang.String objectType)
	ProObject(ProObject proxyObj, java.lang.String objectType, boolean isClass)
	ProObject(java.lang.String appName, IPoolProps properties, com.progress.common.ehnlog.IAppLogger log, java.lang.String requestID)

Method Summary

Modifier and Type	Method and Description
void	_cancelAllRequests() Stop any outstanding request from any object that shares this connection.
SDOInterface	_createSDOProcObject(java.lang.String procName) Create a pre-defined ProcObject that knows how to talk to an SDO whose procedure name is specified by procname.
SDOResultSet	_createSDOResultSet(java.lang.String procName, java.lang.String whereClause, java.lang.String sortBy, SDOParameters params) Creates an SDOResultSet object.
java.lang.String	_getConnectionId() Get Connection Id
java.lang.String	_getProcReturnString() Return the last Return-Value from a Progress procedure
java.lang.String	_getRequestId() Return the last Return-Value from a Progress procedure
java.lang.String	_getReturnValue() Return the last Return-Value from a Progress procedure
java.lang.String	_getReturnValue(java.lang.String sessionID) Return the last Return-Value from a Progress procedure
java.lang.String	_getSSLSubjectName() Return the last Return-Value from a Progress procedure
boolean	_isStreaming() Is there an open output temp-table?
void	_release() Decrement reference count on this connection - If last guy, we'll be disconnected from the server.
int	addReference()
int	deleteReference()
protected void	finalize()
long	get_tsCreated()
long	get_tsLastAccessed()
protected java.lang.String	getAppName()
protected com.progress.common.ehnlog.IAppLogger	getLog()
protected IPoolProps	getProperties()
int	getRefCount()
Session	getSession() return reference to session object
Session	getSession(java.lang.String sessionID) return reference to session object
protected java.lang.String	getSessionID()
protected int	getSessionMode()
protected SessionPool	getSessionPool()
java.lang.String	getWSAObjectID() Get the WSAObjectID of this Object
protected boolean	isClass()
protected boolean	isSessionAvailable()
protected static java.lang.String	newRequestID(IPoolProps properties)
RqContext	runProcedure(java.lang.String procName, ParameterSet params) Run an external non-persistent procedure
RqContext	runProcedure(java.lang.String procName, ParameterSet params, ResultSetSchema schema) Run an external non-persistent procedure
RqContext	runProcedure(java.lang.String requestID, java.lang.String procName, ParameterSet params) Run an external non-persistent procedure
RqContext	runProcedure(java.lang.String requestID, java.lang.String procName, ParameterSet params, ResultSetSchema schema) Run an external non-persistent procedure
long	set_tsLastAccessed()
protected java.lang.String	setSessionID(java.lang.String id)
void	shutdown() unconditionally disconnect the server This call makes this object unavailable.
java.lang.String	toString() Override the toString method to return the object WSA Object ID

Methods inherited from class java.lang.Object

clone, equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

m_notAvailable

protected static final long m_notAvailable

See Also:

Constant Field Values

m_wrongProxyVer

protected static final long m_wrongProxyVer

See Also:

Constant Field Values

m_badOutputVal

protected static final long m_badOutputVal

See Also:

Constant Field Values

m_alreadyBusy

protected static final long m_alreadyBusy

See Also:

Constant Field Values

TYPE_AO

protected static final java.lang.String TYPE_AO

See Also:

Constant Field Values

TYPE_SO

protected static final java.lang.String TYPE_SO

See Also:

Constant Field Values

TYPE_PO

protected static final java.lang.String TYPE_PO

See Also:

Constant Field Values

TYPE_SP

protected static final java.lang.String TYPE_SP

See Also:

Constant Field Values

TYPE_SC

protected static final java.lang.String TYPE_SC

See Also:

Constant Field Values

m_properties

protected IPoolProps m_properties

Constructor Detail

ProObject

protected ProObject()

ProObject

public ProObject(java.lang.String appName,
                 IPoolProps properties,
                 com.progress.common.ehnlog.IAppLogger log,
                 java.lang.String requestID)
          throws ConnectException,
                 Open4GLException,
                 SystemErrorException

Throws:

ConnectException

Open4GLException

SystemErrorException

ProObject

public ProObject(ProObject proxyObj,
                 java.lang.String objectType)
          throws Open4GLException

Throws:

Open4GLException

ProObject

public ProObject(ProObject proxyObj,
                 java.lang.String objectType,
                 boolean isClass)
          throws Open4GLException

Throws:

Open4GLException

Method Detail

newRequestID

protected static java.lang.String newRequestID(IPoolProps properties)

runProcedure

public RqContext runProcedure(java.lang.String procName,
                              ParameterSet params)
                       throws Open4GLException,
                              RunTime4GLException,
                              SystemErrorException

Run an external non-persistent procedure

All parameters are created and put into a ParameterSet before this call. All output parameters are retrieved after this call returns

Parameters:

procName -

params -

Returns:

Throws:

Open4GLException

RunTime4GLException

SystemErrorException

runProcedure

public RqContext runProcedure(java.lang.String requestID,
                              java.lang.String procName,
                              ParameterSet params)
                       throws Open4GLException,
                              RunTime4GLException,
                              SystemErrorException

Run an external non-persistent procedure

All parameters are created and put into a ParameterSet before this call. All output parameters are retrieved after this call returns

Parameters:

requestID -

procName -

params -

Returns:

Throws:

Open4GLException

RunTime4GLException

SystemErrorException

runProcedure

public RqContext runProcedure(java.lang.String procName,
                              ParameterSet params,
                              ResultSetSchema schema)
                       throws Open4GLException,
                              RunTime4GLException,
                              SystemErrorException

Run an external non-persistent procedure

All parameters are created and put into a ParameterSet before this call. All output parameters are retrieved after this call returns. All schemas for the temp table parameters are passed in.

Parameters:

procName -

params -

schema -

Returns:

Throws:

Open4GLException

RunTime4GLException

SystemErrorException

runProcedure

public RqContext runProcedure(java.lang.String requestID,
                              java.lang.String procName,
                              ParameterSet params,
                              ResultSetSchema schema)
                       throws Open4GLException,
                              RunTime4GLException,
                              SystemErrorException

Run an external non-persistent procedure

All parameters are created and put into a ParameterSet before this call. All output parameters are retrieved after this call returns. All schemas for the temp table parameters are passed in.

Parameters:

requestID -

procName -

params -

schema -

Returns:

Throws:

Open4GLException

RunTime4GLException

SystemErrorException

getSession

public Session getSession()
                   throws SessionPool.SessionPoolException,
                          Open4GLException

return reference to session object

Returns:

Throws:

SessionPool.SessionPoolException

Open4GLException

getSession

public Session getSession(java.lang.String sessionID)
                   throws SessionPool.SessionPoolException,
                          Open4GLException

return reference to session object

Parameters:

sessionID -

Returns:

Throws:

SessionPool.SessionPoolException

Open4GLException

_release

public void _release()
              throws Open4GLException,
                     SystemErrorException

Decrement reference count on this connection - If last guy, we'll be disconnected from the server. This call makes this object unavailable.

Throws:

Open4GLException

SystemErrorException

shutdown

public void shutdown()
              throws Open4GLException,
                     SystemErrorException

unconditionally disconnect the server This call makes this object unavailable.

Throws:

Open4GLException

SystemErrorException

_getConnectionId

public java.lang.String _getConnectionId()
                                  throws Open4GLException

Get Connection Id

Returns:

Throws:

Open4GLException

_isStreaming

public boolean _isStreaming()
                     throws Open4GLException

Is there an open output temp-table?

Returns:

Throws:

Open4GLException

_cancelAllRequests

public void _cancelAllRequests()
                        throws Open4GLException

Stop any outstanding request from any object that shares this connection.

Throws:

Open4GLException

_getReturnValue

public java.lang.String _getReturnValue()
                                 throws Open4GLException

Return the last Return-Value from a Progress procedure

Returns:

Throws:

Open4GLException

_getRequestId

public java.lang.String _getRequestId()
                               throws Open4GLException

Return the last Return-Value from a Progress procedure

Returns:

Throws:

Open4GLException

_getSSLSubjectName

public java.lang.String _getSSLSubjectName()
                                    throws Open4GLException

Return the last Return-Value from a Progress procedure

Returns:

Throws:

Open4GLException

_getReturnValue

public java.lang.String _getReturnValue(java.lang.String sessionID)
                                 throws Open4GLException

Return the last Return-Value from a Progress procedure

Parameters:

sessionID -

Returns:

Throws:

Open4GLException

_getProcReturnString

public java.lang.String _getProcReturnString()
                                      throws Open4GLException

Return the last Return-Value from a Progress procedure

Returns:

Throws:

Open4GLException

getWSAObjectID

public java.lang.String getWSAObjectID()

Get the WSAObjectID of this Object

Returns:

toString

public java.lang.String toString()

Override the toString method to return the object WSA Object ID

Overrides:

toString in class java.lang.Object

get_tsCreated

public long get_tsCreated()

get_tsLastAccessed

public long get_tsLastAccessed()

set_tsLastAccessed

public long set_tsLastAccessed()

getRefCount

public int getRefCount()

addReference

public int addReference()

deleteReference

public int deleteReference()
                    throws SystemErrorException,
                           Open4GLException

Throws:

SystemErrorException

Open4GLException

_createSDOResultSet

public SDOResultSet _createSDOResultSet(java.lang.String procName,
                                        java.lang.String whereClause,
                                        java.lang.String sortBy,
                                        SDOParameters params)
                                 throws Open4GLException,
                                        ProSQLException

Creates an SDOResultSet object. The whereClause, sortBy and params parameters can be null.

Parameters:

procName - the name of the SDO's .w file

whereClause - a where clause for the SDO's query

sortBy - a field sort list for the SDO's query

params - SDOResultSet initial parameters

Returns:

an SDOResultSet object

Throws:

ProSQLException - if an SDO data access error occurs

Open4GLException - if an Open4GL error occurs

_createSDOProcObject

public SDOInterface _createSDOProcObject(java.lang.String procName)
                                  throws Open4GLException

Create a pre-defined ProcObject that knows how to talk to an SDO whose procedure name is specified by procname.

Specified by:

_createSDOProcObject in interface SDOFactory

Throws:

Open4GLException

isClass

protected boolean isClass()

getAppName

protected java.lang.String getAppName()

getProperties

protected IPoolProps getProperties()

getLog

protected com.progress.common.ehnlog.IAppLogger getLog()

getSessionMode

protected int getSessionMode()

getSessionPool

protected SessionPool getSessionPool()

getSessionID

protected java.lang.String getSessionID()

setSessionID

protected java.lang.String setSessionID(java.lang.String id)

finalize

protected void finalize()

Overrides:

finalize in class java.lang.Object

isSessionAvailable

protected boolean isSessionAvailable()