net.jini.jeri

Class AtomicILFactory

java.lang.Object

net.jini.jeri.AbstractILFactory

net.jini.jeri.BasicILFactory

net.jini.jeri.AtomicILFactory

All Implemented Interfaces:

InvocationLayerFactory

public class AtomicILFactory
extends BasicILFactory

An atomic serialization implementation of an InvocationLayerFactory. This factory is used to create a Proxy instance with a AtomicInvocationHandler and to create a AtomicInvocationDispatcher for a remote object being exported. This factory is used in conjunction with the BasicJeriExporter class. Serialization is performed with atomic input validation. Class codebase annotations are not appended in the stream, instead each endpoint must have the same class visibility via the default ClassLoader.

Since:

3.1

Author:

Peter.

Nested Class Summary

Nested classes/interfaces inherited from interface net.jini.jeri.InvocationLayerFactory

InvocationLayerFactory.Instances

Constructor Summary

Constructors

Constructor and Description
AtomicILFactory(MethodConstraints serverConstraints, Class proxyOrServiceImplClass) Creates a AtomicILFactory with the specified server constraints, and proxy or service implementation class.
AtomicILFactory(MethodConstraints serverConstraints, Class permissionClass, Class proxyOrServiceImplClass) Creates a AtomicILFactory with the specified server constraints, permission class, and proxy or service implementation class.
AtomicILFactory(MethodConstraints serverConstraints, Class permissionClass, ClassLoader loader) Creates a AtomicILFactory with the specified server constraints, permission class, and class loader.

Method Summary

Modifier and Type	Method and Description
protected InvocationDispatcher	createInvocationDispatcher(Collection methods, Remote impl, ServerCapabilities caps) Returns an invocation dispatcher to receive incoming remote calls for the specified methods to the specified remote object, for a server and transport with the specified capabilities.
protected InvocationHandler	createInvocationHandler(Class[] interfaces, Remote impl, ObjectEndpoint oe) Returns an invocation handler to use with a Proxy instance implementing the specified interfaces, communicating with the specified remote object using the specified object endpoint.
boolean	equals(Object o) Compares the specified object with this invocation layer factory for equality.
int	hashCode() Returns a hash code value for this factory.

Methods inherited from class net.jini.jeri.BasicILFactory

getExtraProxyInterfaces, getPermissionClass, getServerConstraints, toString

Methods inherited from class net.jini.jeri.AbstractILFactory

createInstances, getClassLoader, getInvocationDispatcherMethods, getProxyInterfaces, getRemoteInterfaces

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

AtomicILFactory

public AtomicILFactory(MethodConstraints serverConstraints,
                       Class permissionClass,
                       ClassLoader loader)

Creates a AtomicILFactory with the specified server constraints, permission class, and class loader. The server constraints, if not null, are used to enforce minimum constraints for remote calls. The permission class, if not null, is used to perform server-side access control on incoming remote calls. The class loader, which may be null, is passed to the superclass constructor and is used by the createInstances method.

Parameters:

serverConstraints - the server constraints, or null

permissionClass - the permission class, or null

loader - the class loader, or null

Throws:

IllegalArgumentException - if the permission class is abstract, is not a subclass of Permission, or does not have a public constructor that has either one String parameter or one Method parameter and has no declared exceptions

AtomicILFactory

public AtomicILFactory(MethodConstraints serverConstraints,
                       Class proxyOrServiceImplClass)

Creates a AtomicILFactory with the specified server constraints, and proxy or service implementation class. The server constraints, if not null, are used to enforce minimum constraints for remote calls. The proxy or service implementation class, which cannot be null, is used to obtain the ClassLoader to be passed to the superclass constructor and is used by the createInstances method.

Parameters:

serverConstraints - the server constraints, or null

proxyOrServiceImplClass - the class of the smart proxy implementation or the class of the service implementation for dynamic proxy's.

Throws:

IllegalArgumentException - if the permission class is abstract, is not a subclass of Permission, or does not have a public constructor that has either one String parameter or one Method parameter and has no declared exceptions

SecurityException - if caller doesn't have RuntimePermission "getClassLoader".

NullPointerException - if proxyorServiceImplClass is null.

AtomicILFactory

public AtomicILFactory(MethodConstraints serverConstraints,
                       Class permissionClass,
                       Class proxyOrServiceImplClass)

Creates a AtomicILFactory with the specified server constraints, permission class, and proxy or service implementation class. The server constraints, if not null, are used to enforce minimum constraints for remote calls. The permission class, if not null, is used to perform server-side access control on incoming remote calls. The proxy or service implementation class, which cannot be null, is used to obtain the ClassLoader to be passed to the superclass constructor and is used by the createInstances method.

Parameters:

serverConstraints - the server constraints, or null

permissionClass - the permission class, or null

proxyOrServiceImplClass - the class of the smart proxy implementation or the class of the service implementation for dynamic proxy's.

Throws:

IllegalArgumentException - if the permission class is abstract, is not a subclass of Permission, or does not have a public constructor that has either one String parameter or one Method parameter and has no declared exceptions

SecurityException - if caller doesn't have RuntimePermission "getClassLoader".

NullPointerException - if proxyorServiceImplClass is null.

Method Detail

createInvocationHandler

protected InvocationHandler createInvocationHandler(Class[] interfaces,
                                                    Remote impl,
                                                    ObjectEndpoint oe)
                                             throws ExportException

Returns an invocation handler to use with a Proxy instance implementing the specified interfaces, communicating with the specified remote object using the specified object endpoint.

AtomicILFactory implements this method to return a BasicInvocationHandler constructed with the specified object endpoint and this factory's server constraints.

Overrides:

createInvocationHandler in class BasicILFactory

Parameters:

interfaces - an array of proxy interfaces

impl - a remote object this invocation handler is being created for

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

Returns:

a new InvocationHandler instance.

Throws:

ExportException - if there is a problem creating the invocation handler

NullPointerException - if any argument is null, or if interfaces contains a null element

createInvocationDispatcher

protected InvocationDispatcher createInvocationDispatcher(Collection methods,
                                                          Remote impl,
                                                          ServerCapabilities caps)
                                                   throws ExportException

Returns an invocation dispatcher to receive incoming remote calls for the specified methods to the specified remote object, for a server and transport with the specified capabilities.

AtomicILFactory implements this method to return a BasicInvocationDispatcher instance constructed with the specified methods, server capabilities, and this factory's server constraints, permission class, and class loader specified at construction.

Overrides:

createInvocationDispatcher in class BasicILFactory

Parameters:

methods - a collection of Method instances for the remote methods

impl - a remote object that the dispatcher is being created for

caps - the transport capabilities of the server

Returns:

a new InvocationDispatcher instance.

Throws:

ExportException - if there is a problem creating the invocation dispatcher.

NullPointerException - if any argument is null, or if methods contains a null element

IllegalArgumentException - if methods contains an element that is not a Method instance

equals

public boolean equals(Object o)

Description copied from class: BasicILFactory

Compares the specified object with this invocation layer factory for equality.

BasicILFactory implements this method to return true if and only if invoking the superclass's equals method passing the specified object returns true, the specified object has the same class as this object, and the server constraints and permission class are equal to the ones in this object.

Overrides:

equals in class BasicILFactory

hashCode

public int hashCode()

Description copied from class: BasicILFactory

Returns a hash code value for this factory.

Overrides:

hashCode in class BasicILFactory