oracle.clex.persistence.sqlj
Class DefaultContextProvider

java.lang.Object
  |
  +--oracle.cle.persistence.ConnectionProvider
        |
        +--oracle.clex.persistence.sqlj.DefaultContextProvider

All Implemented Interfaces:

Connectable, java.io.Serializable

public class DefaultContextProvider

extends ConnectionProvider

DefaultContextProvider returns sqlj.runtime.ExecutionContext instances. These instances are from the underlying sqlj.runtime.ref.DefaultContext instanse. When the class loads, it creates a single physical connection to the database per deployment key.

Attributes can automatically be set and loaded by specifying properties in the "cle-providers.xml" file at the root of the classpath (ie. WEB-INF/classes/cle-providers.xml). See the http://xmlns.oracle.com/ias/mvc/cle-providers.dtd for more on structure of the file.

Example Default Context Provider in cle-providers.xml:

 <?xml version="1.0" standalone="yes"?>
 <!DOCTYPE cle-providers SYSTEM "http://xmlns.oracle.com/ias/mvc/cle-providers.dtd">
 <cle-providers>
  <provider name="personnel_sqlj" class="oracle.clex.persistence.sqlj.DefaultContextProvider">
    <property name="user" value="scott"/>
	  <property name="password" value="dGlnZXI="/>
	  <property name="connectionstring" value="jdbc:oracle:thin:scott/dGlnZXI=@localhost:1521:orcl"/>
	  <property name="host" value="localhost"/>
	  <property name="port" value="1521"/>
	  <property name="sid" value="orcl"/>
	  <property name="encryptiontype" value="BASE64"/>
	  <property name="drivertype" value="oracle.jdbc.driver.OracleDriver"/>
	  <property name="persistencebase" value="oracle.demo.personnel.persistence.jdbc"/>
	  <property name="failover" value=""/>
  </provider>
 </cle-providers>
 

Typical Usage in a Handler:

  public Vector aHandlerMethod(Object sessionId, <ArgumentType> aArgument)
    throws Exception
  {
    ExecutionContext ctxt = (ExecutionContext)getConnection(sessionId);
    .... use the connection here ...
    releaseConnection(sessionId);

    return theResult;
  } // end aHandlerMethod
 

See Also:

Serialized Form

Fields inherited from class oracle.cle.persistence.ConnectionProvider

BASE64, connection, connectionString, CONNECTIONSTRING, defaultProperties, deploymentKey, driverType, DRIVERTYPE, encryptionType, ENCRYPTIONTYPE, failover, FAILOVER, host, HOST, NO_SCOPE, NONE, password, PASSWORD, persistenceBase, PERSISTENCEBASE, port, PORT, releasedConnectionIds, REQUEST_SCOPE, scope, SCOPE, SESSION_SCOPE, sessionConnectionIds, sid, SID, USER, userName

Constructor Summary

DefaultContextProvider(java.util.Properties properties)
Default Constructor

Method Summary

void	connect() Do nothing..
sqlj.runtime.ExecutionContext	createContext() Connect to the database using its own provider info.
void	disconnect() Disconnect Provider
java.lang.Object	getConnection(java.lang.Object sessionId) Returns a sqlj DefaultContext
java.lang.Object	getConnection(java.lang.Object sessionId, int failover) Does nothing.
boolean	isConnected() Returns the state of the context for the Provider
boolean	isSame(ConnectionProvider provider) Compares this SQLJConnection info and returns true if their values are the same...
void	releaseConnection(java.lang.Object sessionId) Release the connection associated to the sessionId

Methods inherited from class oracle.cle.persistence.ConnectionProvider

addPropertyKey, addPropertyKeys, applyDynamicProperties, clone, compareDynamicProperties, compareProperty, equals, getConnection, getConnection, getConnection, getConnection, getConnection, getConnection, getConnectionString, getDefaultProperties, getDeploymentKey, getDriverType, getEncryptionType, getFailOver, getHost, getPassword, getPassword, getPersistenceBase, getPort, getProperty, getPropertyKeys, getScope, getSid, getUnspecifiedKeys, getUserName, hashCode, issueWarnings, releaseAllConnections, releaseAllConnections, releaseConnection, releaseConnection, releaseConnection, releaseRequestScopedConnections, releaseRequestScopedConnections, removePropertyKey, setConnectionString, setDefaultProperties, setDeploymentKey, setEncryptionType, setHost, setPassword, setPersistenceBase, setPort, setScope, setSid, setUserName, warn

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

DefaultContextProvider

public DefaultContextProvider(java.util.Properties properties)

Default Constructor

Method Detail

isSame

public boolean isSame(ConnectionProvider provider)

Compares this SQLJConnection info and returns true if their values are the same... false otherwise. Returns false when projectName is different

Overrides:

isSame in class ConnectionProvider

connect

public void connect()

Do nothing.. Use createContext instead of connect

createContext

public sqlj.runtime.ExecutionContext createContext()

Connect to the database using its own provider info.

disconnect

public void disconnect()

Disconnect Provider

isConnected

public boolean isConnected()

Returns the state of the context for the Provider

getConnection

public java.lang.Object getConnection(java.lang.Object sessionId)
                               throws java.lang.Exception

Returns a sqlj DefaultContext

Overrides:

getConnection in class ConnectionProvider

getConnection

public java.lang.Object getConnection(java.lang.Object sessionId,
                                      int failover)

Does nothing. Returns null

Overrides:

getConnection in class ConnectionProvider

releaseConnection

public void releaseConnection(java.lang.Object sessionId)

Release the connection associated to the sessionId

Overrides:

releaseConnection in class ConnectionProvider