|
Oracle Fusion Middleware Java API Reference for Oracle ADF Model 11g Release 1 (11.1.1) E10653-04 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Objectoracle.jbo.common.NamedObjectImpl
oracle.jbo.server.NamedObjectImpl
oracle.jbo.server.ComponentObjectImpl
oracle.jbo.server.EntityCache
oracle.jbo.server.ejb.facade.EntityFacadeCollImpl
public abstract class EntityFacadeCollImpl
Abstract base class for Entity Facade collections.
This class extends
.
Beyond the base EntityCache
EntityCache
functionality, this class
is responsible for interacting with the Entity Bean Home.
In particular, it has the facility to create a new Entity Bean instance.
When the user builds an Entity Facade for an Entity Bean, a subclass of this class is generated.
Field Summary |
---|
Fields inherited from class oracle.jbo.common.NamedObjectImpl |
---|
mFullName, mObjName, mParent, mProperties, RES_ID_SUFFIX |
Constructor Summary | |
---|---|
EntityFacadeCollImpl()
Constructs an Entity Facade Collection. |
Method Summary | |
---|---|
protected javax.ejb.EJBLocalObject |
createBean(EntityFacadeImpl ent)
Creates an Entity Bean instance. |
protected abstract javax.ejb.EJBLocalObject |
findBeanByPrimaryKey(Key eKey)
An abstract method which returns an Entity Bean of the given primary key. |
protected java.sql.Timestamp |
getCurrentDbTime()
Get the current database time for DATE History Column. |
protected abstract javax.ejb.EJBLocalHome |
getEJBLocalHome()
An abstract method which returns the Entity Bean Home reference. |
protected void |
initEJBHome()
Initializes connection to the Entity Bean Home. |
protected abstract javax.ejb.EJBLocalObject |
invokeCreate(EntityFacadeImpl ent)
An abstract method which creates a new Entity Bean. |
protected abstract void |
setEJBLocalHome(javax.ejb.EJBLocalHome ejbHome)
An abstract method which stores the Entity Bean Home reference. |
protected void |
setupEJBHome(javax.naming.Context ic)
Sets up the Entity Bean Home. |
protected javax.naming.Context |
setupInitialContext()
Creates the initial context in preparation for setting up of the Entity Bean Home. |
Methods inherited from class oracle.jbo.server.NamedObjectImpl |
---|
setParent, setPropertiesMap |
Methods inherited from class oracle.jbo.common.NamedObjectImpl |
---|
allocatePropertyMap, getParent, getProperties, getPropertiesAsStrings, getPropertiesMap, getProperty, getProperty, getPropertyMap, getResourcesFromBundle, refreshProperty, removeProperty, removeProperty, requiresNamePrefixedResId, setFullName, setPropertiesMap2, setProperty, setProperty, setPropertyMap |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface oracle.jbo.rules.ValidationManager |
---|
getResourceBundleDef |
Methods inherited from interface oracle.jbo.Properties |
---|
getProperties, getProperty, getProperty, refreshProperty |
Constructor Detail |
---|
public EntityFacadeCollImpl()
Method Detail |
---|
protected void initEJBHome()
JboException
- if a javax.naming.NamingException is thrown
while trying to set up the Entity Bean Home.protected javax.naming.Context setupInitialContext() throws javax.naming.NamingException
initEJBHome()
.
javax.naming.NamingException
- if something goes wrong while setting up the initial context.protected void setupEJBHome(javax.naming.Context ic) throws javax.naming.NamingException
initEJBHome()
.
It gets the Entity Bean Home JDNI name from the Entity Definition.
It calls an abstract method setEJBLocalHome(javax.ejb.EJBLocalHome)
.
ic
- the initial context.
javax.naming.NamingException
protected abstract javax.ejb.EJBLocalHome getEJBLocalHome()
A subclass of this class has an implementation of this method which returns the Entity Bean Home reference.
protected abstract void setEJBLocalHome(javax.ejb.EJBLocalHome ejbHome)
A subclass of this class has an implementation of this
method which assigns ejbHome
to a field of
that subclass.
ejbHome
- the Entity Bean Local Home to be stored.protected abstract javax.ejb.EJBLocalObject findBeanByPrimaryKey(Key eKey) throws java.lang.Exception
A subclass of this class has an implementation of this
method which finds the Entity Bean by the primary key
of eKey
.
eKey
- primary key.
java.lang.Exception
- if something goes wrong. If the requested Entity
Bean instance is not found, it will throw a
javax.ejb.FinderException.protected javax.ejb.EJBLocalObject createBean(EntityFacadeImpl ent)
invokeCreate(EntityFacadeImpl)
.
It first checks to make sure that the Entity Bean Home is
initialized. Then, it calls invokeCreate(EntityFacadeImpl)
and handles exceptions thrown by invokeCreate(EntityFacadeImpl)
.
ent
- Entity Bean Facade instance from which the Entity Bean
instance is to be created.
JboException
- if something goes wrong during the creation process.protected abstract javax.ejb.EJBLocalObject invokeCreate(EntityFacadeImpl ent) throws java.lang.Exception
A subclass of this class has an implementation of this
method which creates a new Entity Bean, passing in the
appropriate parameters to the create()
method.
Then, it uses attribute values of ent
to initialize
attributes of the Entity Bean.
ent
- the Entity Facade instance.
java.lang.Exception
- if something goes wrong. If the Entity Bean's
create()
method encounters an error,
it will throw a javax.ejb.CreateException.protected java.sql.Timestamp getCurrentDbTime()
getCurrentDbTime
in class EntityCache
|
Oracle Fusion Middleware Java API Reference for Oracle ADF Model 11g Release 1 (11.1.1) E10653-04 |
||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |