net.jini.jeri

Interface InvocationLayerFactory

All Known Implementing Classes:

AbstractILFactory, BasicILFactory, ProxyTrustILFactory

public interface InvocationLayerFactory

A factory for creating a compatible proxy and invocation dispatcher for a remote object being exported. An InvocationLayerFactory is used in conjunction with the BasicJeriExporter class to customize remote invocation and dispatch behavior for remote objects.

Since:

2.0

Author:

Sun Microsystems, Inc.

Nested Class Summary

Nested Classes

Modifier and Type	Interface and Description
static class	InvocationLayerFactory.Instances A container for the proxy and invocation dispatcher instances returned by InvocationLayerFactory.createInstances.

Method Summary

Modifier and Type	Method and Description
InvocationLayerFactory.Instances	createInstances(Remote impl, ObjectEndpoint oe, ServerCapabilities caps) Returns a compatible proxy and invocation dispatcher for a remote object being exported.

Method Detail

createInstances

InvocationLayerFactory.Instances createInstances(Remote impl,
                                                 ObjectEndpoint oe,
                                                 ServerCapabilities caps)
                                          throws ExportException

Returns a compatible proxy and invocation dispatcher for a remote object being exported. The proxy and invocation dispatcher are returned in an InvocationLayerFactory.Instances container object. The proxy sends calls to the remote object using the supplied ObjectEndpoint.

The returned proxy implements an implementation-specific set of remote interfaces of impl and may implement additional implementation-specific interfaces.

A given Exporter implementation should only call this method once per export. An invocation dispatcher constructed for a previous export should not be reused.

Parameters:

impl - the remote object that the proxy is being created for

oe - the object endpoint used to communicate with the remote object

caps - the transport capabilities of the server

Returns:

a proxy and invocation dispatcher contained in an Instances object

Throws:

ExportException - if there is a problem creating the proxy or dispatcher

NullPointerException - if any argument is null