net.jini.jeri

Class AtomicInvocationHandler

java.lang.Object

net.jini.jeri.BasicInvocationHandler

net.jini.jeri.AtomicInvocationHandler

All Implemented Interfaces:

Serializable, InvocationHandler, TrustEquivalence

public class AtomicInvocationHandler
extends BasicInvocationHandler

Author:

peter

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
AtomicInvocationHandler(AtomicInvocationHandler other, MethodConstraints clientConstraints)
AtomicInvocationHandler(AtomicSerial.GetArg arg)
AtomicInvocationHandler(ObjectEndpoint oe, MethodConstraints serverConstraints)

Method Summary

Modifier and Type	Method and Description
protected ObjectInputStream	createMarshalInputStream(Object proxy, Method method, OutboundRequest request, boolean integrity, Collection context) Returns a new ObjectInputStream instance to use to read objects from the response input stream obtained by invoking the getResponseInputStream method on the given request.
protected ObjectOutputStream	createMarshalOutputStream(Object proxy, Method method, OutboundRequest request, Collection context) Returns a new ObjectOutputStream instance to use to write objects to the request output stream obtained by invoking the getRequestOutputStream method on the given request.

Methods inherited from class net.jini.jeri.BasicInvocationHandler

checkTrustEquivalence, equals, getClientConstraints, getObjectEndpoint, getServerConstraints, hashCode, invoke, marshalArguments, marshalMethod, setClientConstraints, toString, unmarshalReturn, unmarshalThrow

Methods inherited from class java.lang.Object

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

Constructor Detail

AtomicInvocationHandler

public AtomicInvocationHandler(AtomicInvocationHandler other,
                               MethodConstraints clientConstraints)

AtomicInvocationHandler

public AtomicInvocationHandler(AtomicSerial.GetArg arg)
                        throws IOException

Throws:

IOException

AtomicInvocationHandler

public AtomicInvocationHandler(ObjectEndpoint oe,
                               MethodConstraints serverConstraints)

Method Detail

createMarshalOutputStream

protected ObjectOutputStream createMarshalOutputStream(Object proxy,
                                                       Method method,
                                                       OutboundRequest request,
                                                       Collection context)
                                                throws IOException

Returns a new ObjectOutputStream instance to use to write objects to the request output stream obtained by invoking the getRequestOutputStream method on the given request.

AtomicInvocationHandler implements this method to return a new MarshalOutputStream instance constructed with the output stream obtained from request as specified above and an unmodifiable view of the supplied context collection.

A subclass can override this method to control how the marshal input stream is created or implemented.

Overrides:

createMarshalOutputStream in class BasicInvocationHandler

Parameters:

proxy - the proxy instance

method - the remote method invoked

request - the outbound request

context - the client context

Returns:

a new ObjectOutputStream instance for marshalling a call request

Throws:

IOException - if an I/O exception occurs

NullPointerException - if any argument is null

createMarshalInputStream

protected ObjectInputStream createMarshalInputStream(Object proxy,
                                                     Method method,
                                                     OutboundRequest request,
                                                     boolean integrity,
                                                     Collection context)
                                              throws IOException

Returns a new ObjectInputStream instance to use to read objects from the response input stream obtained by invoking the getResponseInputStream method on the given request.

AtomicInvocationHandler implements this method to return a new MarshalInputStream instance constructed with the input stream obtained from request as specified above for the input stream in, the class loader of proxy's class for defaultLoader and verifierLoader, this method's integrity argument for verifyCodebaseIntegrity, and an unmodifiable view of context for the context collection. The useCodebaseAnnotations method is invoked on the created stream before it is returned.

An exception is thrown if proxy is not an instance of a dynamic proxy class containing this invocation handler.

A subclass can override this method to control how the marshal input stream is created or implemented.

Overrides:

createMarshalInputStream in class BasicInvocationHandler

Parameters:

proxy - the proxy instance

method - the remote method invoked

request - the outbound request

integrity - whether or not to verify codebase integrity

context - the client context

Returns:

a new ObjectInputStream instance for unmarshalling a call response

Throws:

IOException - if an I/O exception occurs

NullPointerException - if any argument is null