net.jini.jeri

Class AtomicInvocationDispatcher

java.lang.Object

net.jini.jeri.BasicInvocationDispatcher

net.jini.jeri.AtomicInvocationDispatcher

All Implemented Interfaces:

InvocationDispatcher

public class AtomicInvocationDispatcher
extends BasicInvocationDispatcher

Author:

peter

Constructor Summary

Constructors

Constructor and Description
AtomicInvocationDispatcher(Collection methods, ServerCapabilities serverCapabilities, MethodConstraints serverConstraints, Class permissionClass, ClassLoader loader)

Method Summary

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

Methods inherited from class net.jini.jeri.BasicInvocationDispatcher

checkAccess, checkClientPermission, checkPermissionClass, dispatch, getClassLoader, invoke, marshalReturn, marshalThrow, unmarshalArguments, unmarshalMethod

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Detail

AtomicInvocationDispatcher

public AtomicInvocationDispatcher(Collection methods,
                                  ServerCapabilities serverCapabilities,
                                  MethodConstraints serverConstraints,
                                  Class permissionClass,
                                  ClassLoader loader)
                           throws ExportException

Throws:

ExportException

Method Detail

createMarshalInputStream

protected ObjectInputStream createMarshalInputStream(Object impl,
                                                     InboundRequest request,
                                                     boolean integrity,
                                                     Collection context)
                                              throws IOException

Returns a new marshal input stream to use to read objects from the request input stream obtained by invoking the getRequestInputStream method on the given request.

AtomicInvocationDispatcher implements this method as follows:

First, a class loader is selected to use as the defaultLoader and the verifierLoader for the marshal input stream instance. If the class loader specified at construction is not null, the selected loader is that loader. Otherwise, if a security manager exists, its checkPermission method is invoked with the permission RuntimePermission("getClassLoader"); this invocation may throw a SecurityException. If the above security check succeeds, the selected loader is the class loader of impl's class.

This method returns a new MarshalInputStream instance constructed with the input stream (obtained from the request as specified above) for the input stream in, the selected loader for defaultLoader and verifierLoader, the boolean integrity 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.

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

Overrides:

createMarshalInputStream in class BasicInvocationDispatcher

Parameters:

impl - the remote object

request - the inbound request

integrity - true if object integrity is being enforced for the remote call, and false otherwise

context - the server context

Returns:

a new marshal input stream for unmarshalling a call request

Throws:

IOException - if an I/O exception occurs

NullPointerException - if any argument is null

createMarshalOutputStream

protected ObjectOutputStream createMarshalOutputStream(Object impl,
                                                       Method method,
                                                       InboundRequest request,
                                                       Collection context)
                                                throws IOException

Returns a new marshal output stream to use to write objects to the response output stream obtained by invoking the getResponseOutputStream method on the given request.

This method will be called with a null method argument if an IOException occurred when reading method information from the incoming call stream.

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

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

Overrides:

createMarshalOutputStream in class BasicInvocationDispatcher

Parameters:

impl - the remote object

method - the possibly-null Method instance corresponding to the interface method invoked on the remote object

request - the inbound request

context - the server context

Returns:

a new marshal output stream for marshalling a call response

Throws:

IOException - if an I/O exception occurs

NullPointerException - if impl, request, or context is null