vona.rmi.rmiwrap

Class RMIWrap.ClientWriter

java.lang.Object

vona.rmi.rmiwrap.RMIWrap.WrapperBodyWriter

vona.rmi.rmiwrap.RMIWrap.ImplementationWriter

vona.rmi.rmiwrap.RMIWrap.ClientWriter

Enclosing class:

RMIWrap

protected static class RMIWrap.ClientWriter
extends RMIWrap.ImplementationWriter

Write foo.ImplClient from foo.API.

Field Summary

Fields inherited from class vona.rmi.rmiwrap.RMIWrap.ImplementationWriter

implementationName

Fields inherited from class vona.rmi.rmiwrap.RMIWrap.WrapperBodyWriter

interfaceClass, interfaceName

Constructor Summary

Constructors

Constructor and Description
RMIWrap.ClientWriter(java.lang.Class interfaceClass, java.lang.String implementationName) See superclass.

Method Summary

Methods

Modifier and Type	Method and Description
(package private) java.lang.String	classDeclExtra() Extra stuff (e.g.
(package private) void	processMethod(java.io.PrintWriter out, java.lang.reflect.Method method) Called by the default impl of RMIWrap.WrapperBodyWriter.writeWrapperBody(java.io.PrintWriter) to process a method of RMIWrap.WrapperBodyWriter.interfaceClass.
(package private) void	writeWrapperBody(java.io.PrintWriter out) Write the body of the wrapper class.

Methods inherited from class vona.rmi.rmiwrap.RMIWrap.WrapperBodyWriter

writeDropoutHook, writeSignature, writeTypeUnwrap, writeTypeWrap

Methods inherited from class java.lang.Object

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

Constructor Detail

RMIWrap.ClientWriter

RMIWrap.ClientWriter(java.lang.Class interfaceClass,
                    java.lang.String implementationName)

See superclass.

Method Detail

writeWrapperBody

void writeWrapperBody(java.io.PrintWriter out)

Write the body of the wrapper class.

Default impl calls RMIWrap.WrapperBodyWriter.processMethod(java.io.PrintWriter, java.lang.reflect.Method) for all methods of RMIWrap.WrapperBodyWriter.interfaceClass.

This impl writes

• the remote instance member remoteInstance
• a direct constructor, which takes an instance of foo.APIRemote and assigns it to remoteInstance
• an indirect constructor which takes an RMI URL-format name, acquires a remote reference to it, and then calls the direct constructor to assign it to remoteInstance, calling constructorRemoteException() if a RemoteException occurs in the process.
• A default constructorRemoteException(), which calls the generic RemoteException handler handleRemoteException (with method name "*constructor*") and if that returns null throws a RuntimeRemoteException.
• A default generic RemoteException handler handleRemoteException() which returns null (unhandled).
• A default generic short-circuit handler shortCircuitRemoteCall() which returns null (not short-circuited).

and then calls the superclass impl to handle the API methods.

Overrides:

writeWrapperBody in class RMIWrap.WrapperBodyWriter

Parameters:

out - where to write

processMethod

void processMethod(java.io.PrintWriter out,
                 java.lang.reflect.Method method)

Called by the default impl of RMIWrap.WrapperBodyWriter.writeWrapperBody(java.io.PrintWriter) to process a method of RMIWrap.WrapperBodyWriter.interfaceClass.

This impl writes

• a wrapper which implements foo.API and forwards the call to remoteInstance, first checking the generic short-circuit handler shortCircuitRemoteCall() (if that returns non-null the remote call will not be attempted), and catching any RemoteException and passing it to the generated handler (see below)
• a default implementation of the RemoteException handler for this method, which calls the generic handleRemoteException() and if that returns null throws RuntimeRemoteException

Specified by:

processMethod in class RMIWrap.WrapperBodyWriter

Parameters:

out - where to write

method - the Method to process

classDeclExtra

java.lang.String classDeclExtra()

Extra stuff (e.g. extends and implements specs) that should be added at the end of the class declaration.

Default impl returns the empty string.

This impl returns e.g. " implements foo.API".

Overrides:

classDeclExtra in class RMIWrap.WrapperBodyWriter

Returns:

Extra stuff (e.g. extends and implements specs) that should be added at the end of the class declaration