oracle.clex.persistence.ejb.oc4j
Class OC4JEJBHomeProvider

java.lang.Object
  |
  +--oracle.cle.persistence.ConnectionProvider
        |
        +--oracle.clex.persistence.jndi.JndiObjectProvider
              |
              +--oracle.clex.persistence.ejb.EJBHomeProvider
                    |
                    +--oracle.clex.persistence.ejb.oc4j.OC4JEJBHomeProvider

All Implemented Interfaces:

Connectable, java.io.Serializable

Deprecated. Use EJBHomeProvider instead. No longer need to subclass EJBHomeProvider for different app servers. Use EJBHomeProvider directly with additional property: contextfactory, where contextfactory is the value for the java.naming.factory.initial environment property. For OC4J, for example, the contextfactory would be com.evermind.server.ApplicationClientInitialContextFactory

public class OC4JEJBHomeProvider

extends EJBHomeProvider

Provides a specific EJBHome for the OC4J Application Server

Attributes can automatically be set and loaded by specifying in an entry in the cle-provider.xml descriptor file. Each entry must have a label or name called the deploymentKey. This is how the ConnectionManager will reference the specific ConnectionProvider instance.

Example OC4J EJB Home 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_ejb" class="oracle.clex.persistence.ejb.oc4j.OC4JEJBHomeProvider">
    <property name="user" value="admin"/>
    <property name="password" value="oracle"/>
    <property name="jndiname" value="PersonnelManager"/>
    <property name="connectionstring" value="ormi://localhost/personnel"/>
    <property name="host" value="localhost"/>
    <property name="classname" value="oracle.demo.personnel.persistence.ejb_cmp.PersonnelManagerHome"/>
    <property name="persistencebase" value="oracle.demo.personnel.persistence.ejb_cmp"/>
    <property name="failover" value=""/>
  </provider>
 </cle-providers>
 

Typical Usage in a Handler:

  public Vector aHandlerMethod(Object sessionId, <ArgumentType> aArgument)
    throws Exception
  {
    MyEJBHome home = (MyEJBHome)getConnection(sessionId);
    MyEJB myEJB = (MyEJB)home.create();
    .... use the ejb here ...
    releaseConnection(sessionId);

    return theResult;
  } // end aHandlerMethod
 

See Also:

Serialized Form

Fields inherited from class oracle.clex.persistence.ejb.EJBHomeProvider

classname, CLASSNAME, contextFactory, CONTEXTFACTORY, homeInterface, NON_SSL_LOGIN

Fields inherited from class oracle.clex.persistence.jndi.JndiObjectProvider

jndiName, JNDINAME, jndiObject

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

OC4JEJBHomeProvider()
Deprecated.

OC4JEJBHomeProvider(java.util.Properties properties)
Deprecated.

Method Summary

protected void	addPropertyKeys() Deprecated. Each subclass should overload or override this method to include all the properties that it will use.
javax.naming.Context	getInitialContext() Deprecated. Get an IntitialContext so that we can find the Home Interface.

Methods inherited from class oracle.clex.persistence.ejb.EJBHomeProvider

connect, createHomeInterface, getClassname, getConnection, getConnection, getContextFactory, isConnected, releaseConnection, setClassname, setContextFactory

Methods inherited from class oracle.clex.persistence.jndi.JndiObjectProvider

applyDynamicProperties, disconnect, findJndiObject, getJndiName, hashCode, isSame, setJndiName

Methods inherited from class oracle.cle.persistence.ConnectionProvider

addPropertyKey, 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, 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

OC4JEJBHomeProvider

public OC4JEJBHomeProvider()

Deprecated.

OC4JEJBHomeProvider

public OC4JEJBHomeProvider(java.util.Properties properties)

Deprecated.

Method Detail

addPropertyKeys

protected void addPropertyKeys()

Deprecated.

Each subclass should overload or override this method to include all the properties that it will use.

Overrides:

addPropertyKeys in class EJBHomeProvider

getInitialContext

public javax.naming.Context getInitialContext()
                                       throws javax.naming.NamingException,
                                              java.lang.Exception

Deprecated.

Description copied from class: EJBHomeProvider

Get an IntitialContext so that we can find the Home Interface.

NOTE: This method first tries to get an InitialContext without programmatically passing environment properties. If that fails to return a valid Context, then and only then are the properties for this provider used. This allows this provider to use a jndi.properties file, for example, to get the environment in a standard way.

Overrides:

getInitialContext in class EJBHomeProvider