Home » openejb-3.1.2-src » org.apache » openejb » spi » [javadoc | source]
org.apache.openejb.spi
public interface: ApplicationServer [javadoc | source]

All Known Implementing Classes:
    EjbServer, ServerFederation, EjbDaemon, IntraVmServer, ClientObjectFactory

LOCAL to REMOTE SERIALIZATION

Definition:

This is a serialization that initiates in the local vm, but is outside the scope of a marked IntraVM local serialization.

Circumstances:

When an IntraVM implementation of a javax.ejb.* interface is serialized outside the scope of the IntraVM Server

These serializations happen when objects are sent from a local bean to a remote client as part of a return value, or when a stateful session bean is passified.

Action:

Don't serialize the IntraVM javax.ejb.* interface implementation, instead ask the ApplicationServer to nominate its own implementation as a replacement. This is done via the org.apache.openejb.spi.ApplicationServer interface.

Example Scenario:

SERIALIZATION

1. ObjectOutputStream encounters an IntraVmMetaData instance in the object graph and calls its writeReplace method.
2. The IntraVmMetaData instance determines it is being serialized outside the scope of an IntraVM serialization by calling IntraVmCopyMonitor.isIntraVmCopyOperation().
3. The IntraVmMetaData instance calls the getEJBMetaData method on the ApplicationServer.
4. The IntraVmMetaData instance returns the ApplicationServer's EJBMetaData instance from the writeReplace method.
5. The ObjectOutputStream serializes the ApplicationServer's EJBMetaData instance in place of the IntraVmMetaData instance.

Note: The ApplicationServer's EJBMetaData instance can be any object that implements the javax.ejb.EJBMetaData interface and can also implement any serialization methods, such as the writeReplace method, to nominate a replacement or implement protocol specific logic or otherwise gain control over the serialization of EJBMetaData instances destined for its remote clients.

DESERIALIZATION

The deserialization of the Application Server's javax.ejb.* implementations is implementation specific.

Method from org.apache.openejb.spi.ApplicationServer Summary:
getBusinessObject,   getEJBHome,   getEJBMetaData,   getEJBObject,   getHandle,   getHomeHandle
Method from org.apache.openejb.spi.ApplicationServer Detail:
 public Object getBusinessObject(ProxyInfo proxyInfo)
 public EJBHome getEJBHome(ProxyInfo proxyInfo)
 public EJBMetaData getEJBMetaData(ProxyInfo proxyInfo)
 public EJBObject getEJBObject(ProxyInfo proxyInfo)
 public Handle getHandle(ProxyInfo proxyInfo)
 public HomeHandle getHomeHandle(ProxyInfo proxyInfo)