Package 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 Object
implements SDOFactory

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

Field Summary

Fields

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

Constructor Summary

Constructors

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

Method Summary

Modifier and Type	Method	Description
void	_cancelAllRequests()	Stop any outstanding request from any object that shares this connection.
SDOInterface	_createSDOProcObject(String procName)	Create a pre-defined ProcObject that knows how to talk to an SDO whose procedure name is specified by procname.
SDOResultSet	_createSDOResultSet(String procName, String whereClause, String sortBy, SDOParameters params)	Creates an SDOResultSet object.
String	_getConnectionId()	Get Connection Id
String	_getProcReturnString()	Return the last Return-Value from a Progress procedure
String	_getRequestId()	Return the last Return-Value from a Progress procedure
String	_getReturnValue()	Return the last Return-Value from a Progress procedure
String	_getReturnValue(String sessionID)	Return the last Return-Value from a Progress procedure
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 String	getAppName()
protected com.progress.common.ehnlog.IAppLogger	getLog()
protected IPoolProps	getProperties()
int	getRefCount()
Session	getSession()	return reference to session object
Session	getSession(String sessionID)	return reference to session object
protected String	getSessionID()
protected int	getSessionMode()
protected SessionPool	getSessionPool()
String	getWSAObjectID()	Get the WSAObjectID of this Object
protected boolean	isClass()
protected boolean	isSessionAvailable()
protected static String	newRequestID(IPoolProps properties)
RqContext	runProcedure(String procName, ParameterSet params)	Run an external non-persistent procedure
RqContext	runProcedure(String procName, ParameterSet params, ResultSetSchema schema)	Run an external non-persistent procedure
RqContext	runProcedure(String requestID, String procName, ParameterSet params)	Run an external non-persistent procedure
RqContext	runProcedure(String requestID, String procName, ParameterSet params, ResultSetSchema schema)	Run an external non-persistent procedure
long	set_tsLastAccessed()
protected String	setSessionID(String id)
void	shutdown()	unconditionally disconnect the server This call makes this object unavailable.
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 Details

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 String TYPE_AO

See Also:

• Constant Field Values

TYPE_SO

protected static final String TYPE_SO

See Also:

• Constant Field Values

TYPE_PO

protected static final String TYPE_PO

See Also:

• Constant Field Values

TYPE_SP

protected static final String TYPE_SP

See Also:

• Constant Field Values

TYPE_SC

protected static final String TYPE_SC

See Also:

• Constant Field Values

m_properties

protected IPoolProps m_properties

Constructor Details

ProObject

protected ProObject()

ProObject

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

Throws:

ConnectException

Open4GLException

SystemErrorException

ProObject

public ProObject(ProObject proxyObj,
 String objectType)
          throws Open4GLException

Throws:

Open4GLException

ProObject

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

Throws:

Open4GLException

Method Details

newRequestID

protected static String newRequestID(IPoolProps properties)

runProcedure

public RqContext runProcedure(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(String requestID,
 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(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(String requestID,
 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(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 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 String _getReturnValue()
                       throws Open4GLException

Return the last Return-Value from a Progress procedure

Returns:

Throws:

Open4GLException

_getRequestId

public String _getRequestId()
                     throws Open4GLException

Return the last Return-Value from a Progress procedure

Returns:

Throws:

Open4GLException

_getSSLSubjectName

public String _getSSLSubjectName()
                          throws Open4GLException

Return the last Return-Value from a Progress procedure

Returns:

Throws:

Open4GLException

_getReturnValue

public String _getReturnValue(String sessionID)
                       throws Open4GLException

Return the last Return-Value from a Progress procedure

Parameters:

sessionID -

Returns:

Throws:

Open4GLException

_getProcReturnString

public String _getProcReturnString()
                            throws Open4GLException

Return the last Return-Value from a Progress procedure

Returns:

Throws:

Open4GLException

getWSAObjectID

public String getWSAObjectID()

Get the WSAObjectID of this Object

Returns:

toString

public String toString()

Override the toString method to return the object WSA Object ID

Overrides:

toString in class 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(String procName,
 String whereClause,
 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(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 String getAppName()

getProperties

protected IPoolProps getProperties()

getLog

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

getSessionMode

protected int getSessionMode()

getSessionPool

protected SessionPool getSessionPool()

getSessionID

protected String getSessionID()

setSessionID

protected String setSessionID(String id)

finalize

protected void finalize()

Overrides:

finalize in class Object

isSessionAvailable

protected boolean isSessionAvailable()