oracle.toplink.ejb.cmp.wls11
Class SessionAccessor

java.lang.Object
  |
  +--oracle.toplink.ejb.cmp.wls11.SessionAccessor

Deprecated. use oracle.toplink.tools.sessionmanagement.SessionManager instead

public class SessionAccessor

extends java.lang.Object

PUBLIC

This class provides access to TopLink's Session and UnitOfWork and can be used at runtime by a bean to manage aspects of caching etc. that are not generally available in EJB.

If a bean has references to regular Java objects that are made persistent through TopLink, this class can be used to properly manage various serialized versions of the Java objects.

Method Summary

Type	Method
static oracle.toplink.ejb.cmp.wls11.UnitOfWork	getCurrentUnitOfWorkFor(javax.ejb.EntityContext context) Deprecated. PUBLIC
static oracle.toplink.ejb.cmp.wls11.Session	getSessionFor(javax.ejb.EntityContext context) Deprecated. PUBLIC
static oracle.toplink.ejb.cmp.wls11.Session	getSessionFor(java.lang.String name) Deprecated. PUBLIC
static java.lang.Object	registerOrMergeAttribute(java.lang.Object value, java.lang.String attributeName, javax.ejb.EntityContext ctx) Deprecated. PUBLIC
static java.lang.Object	registerOrMergeObject(java.lang.Object value, javax.ejb.EntityContext ctx) Deprecated. PUBLIC

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

getCurrentUnitOfWorkFor

public static oracle.toplink.ejb.cmp.wls11.UnitOfWork getCurrentUnitOfWorkFor(javax.ejb.EntityContext context)

Deprecated.

PUBLIC

Returns the active TopLink unit of work for the context. This can be accessed to give access to advanced TopLink API on the server.

WARNING - Only in rare instances should this method ever be used, and if so, caution must be taken to ensure that the unit of work is not misused.

Parameters:

context - the entity context for the bean

getSessionFor

public static oracle.toplink.ejb.cmp.wls11.Session getSessionFor(java.lang.String name)

Deprecated.

PUBLIC

Returns the active TopLink session for the project. This can be accessed to give access to advanced TopLink API on the server.

Parameters:

name - the project identifier of the project associated with the session

Returns:

The Session used by all of the descriptors in the given project

getSessionFor

public static oracle.toplink.ejb.cmp.wls11.Session getSessionFor(javax.ejb.EntityContext context)

Deprecated.

PUBLIC

Returns the active TopLink session for the context. This can be accessed to give access to advanced TopLink API on the server.

Parameters:

name - the project identifier of the project associated with the session

Returns:

The Session used by all of the descriptors in the project

registerOrMergeAttribute

public static java.lang.Object registerOrMergeAttribute(java.lang.Object value,
                                                        java.lang.String attributeName,
                                                        javax.ejb.EntityContext ctx)

Deprecated.

PUBLIC

Merge the changes from the remote clone into the server version of the object(s) for a bean's attribute.

Here is an example of how this method can be used within an EJB setter method.

public void setAddress(Address addressFromClient) { this.address = SessionAccessor.registerOrMergeAttribute(addressFromClient, "address", this.ctx); }

Parameters:

attributeValue - the attribute object to merge

attributeName - the name of the field in the bean

context - the entity context of the bean

Returns:

The merged object

registerOrMergeObject

public static java.lang.Object registerOrMergeObject(java.lang.Object value,
                                                     javax.ejb.EntityContext ctx)

Deprecated.

PUBLIC

Merge the changes from the remote clone into the server version of the object(s) for a bean's attribute. The object should not be a collection.

Here is an example of how this method can be used within an EJB setter method.

public void setAddress(Address addressFromClient) { this.address = (Address)SessionAccessor.registerOrMergeObject(addressFromClient, this.ctx); }

Parameters:

attributeValue - the attribute object to merge

context - the entity context of the bean

Returns:

The merged object