Package org.apache.openejb.spi

Interface ApplicationServer

All Known Implementing Classes:
IntraVmServer, ServerFederation
public interface ApplicationServer

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 jakarta.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 jakarta.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 jakarta.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 jakarta.ejb.* implementations is implementation specific.

Version:
$Revision$ $Date$

  • Method Details

    • getEJBMetaData

      jakarta.ejb.EJBMetaData getEJBMetaData(ProxyInfo proxyInfo)

    • getHandle

      jakarta.ejb.Handle getHandle(ProxyInfo proxyInfo)

    • getHomeHandle

      jakarta.ejb.HomeHandle getHomeHandle(ProxyInfo proxyInfo)

    • getEJBObject

      jakarta.ejb.EJBObject getEJBObject(ProxyInfo proxyInfo)

    • getBusinessObject

      Object getBusinessObject(ProxyInfo proxyInfo)

    • getEJBHome

      jakarta.ejb.EJBHome getEJBHome(ProxyInfo proxyInfo)