Interface UtilDelegate

All Known Implementing Classes:

Util

public interface UtilDelegate

Supports delegation for method implementations in Util. The delegate is a singleton instance of a class that implements this interface and provides a replacement implementation for all the methods of javax.rmi.CORBA.Util. Delegation is enabled by providing the delegate's class name as the value of the javax.rmi.CORBA.UtilClass system property.

See Also:

• Util

Method Summary

Modifier and Type	Method	Description
Object	copyObject(Object obj, ORB orb)	Delegation call for Util.copyObject(Object, ORB).
Object[]	copyObjects(Object[] obj, ORB orb)	Delegation call for Util.copyObjects(Object[], ORB).
ValueHandler	createValueHandler()	Delegation call for Util.createValueHandler().
String	getCodebase(Class clz)	Delegation call for Util.getCodebase(Class).
Tie	getTie(Remote target)	Delegation call for Util.getTie(Remote).
boolean	isLocal(Stub stub)	Delegation call for Util.isLocal(Stub).
Class	loadClass(String className, String remoteCodebase, ClassLoader loader)	Delegation call for Util.loadClass(String, String, ClassLoader).
RemoteException	mapSystemException(SystemException ex)	Delegation call for Util.mapSystemException(SystemException).
Object	readAny(InputStream in)	Delegation call for Util.readAny(InputStream).
void	registerTarget(Tie tie, Remote target)	Delegation call for Util.registerTarget(Tie, Remote).
void	unexportObject(Remote target)	Delegation call for Util.unexportObject(Remote).
RemoteException	wrapException(Throwable obj)	Delegation call for Util.wrapException(Throwable).
void	writeAbstractObject(OutputStream out, Object obj)	Delegation call for Util.writeAbstractObject(OutputStream, Object).
void	writeAny(OutputStream out, Object obj)	Delegation call for Util.writeAny(OutputStream, Object).
void	writeRemoteObject(OutputStream out, Object obj)	Delegation call for Util.writeRemoteObject(OutputStream, Object).

Method Details

mapSystemException

RemoteException mapSystemException(SystemException ex)

Delegation call for Util.mapSystemException(SystemException).

Parameters:

ex - the SystemException to map.

Returns:

the mapped exception.

writeAny

void writeAny(OutputStream out,
 Object obj)

Delegation call for Util.writeAny(OutputStream, Object).

Parameters:

out - the stream in which to write the any.

obj - the object to write as an any.

readAny

Object readAny(InputStream in)

Delegation call for Util.readAny(InputStream).

Parameters:

in - the stream from which to read the any.

Returns:

the object read from the stream.

writeRemoteObject

void writeRemoteObject(OutputStream out,
 Object obj)

Delegation call for Util.writeRemoteObject(OutputStream, Object).

Parameters:

out - the stream in which to write the object.

obj - the object to write.

writeAbstractObject

void writeAbstractObject(OutputStream out,
 Object obj)

Delegation call for Util.writeAbstractObject(OutputStream, Object).

Parameters:

out - the stream in which to write the object.

obj - the object to write.

registerTarget

void registerTarget(Tie tie,
 Remote target)

Delegation call for Util.registerTarget(Tie, Remote).

Parameters:

tie - tie to register

target - target for the tie

unexportObject

void unexportObject(Remote target)
             throws NoSuchObjectException

Delegation call for Util.unexportObject(Remote).

Parameters:

target - the object to unexport

Throws:

NoSuchObjectException - if the target object does not exist

getTie

Tie getTie(Remote target)

Delegation call for Util.getTie(Remote).

Parameters:

target - the object to get the tie for

Returns:

the tie or null if no tie is registered for the given target.

createValueHandler

ValueHandler createValueHandler()

Delegation call for Util.createValueHandler().

Returns:

a class which implements the ValueHandler interface.

getCodebase

String getCodebase(Class clz)

Delegation call for Util.getCodebase(Class).

Parameters:

clz - the class to get a codebase for.

Returns:

a space-separated list of URLs, or null.

loadClass

Class loadClass(String className,
 String remoteCodebase,
 ClassLoader loader)
         throws ClassNotFoundException

Delegation call for Util.loadClass(String, String, ClassLoader).

Parameters:

className - the name of the class.

remoteCodebase - a space-separated list of URLs at which the class might be found. May be null.

loader - a ClassLoader that may be used to load the class if all other methods fail.

Returns:

the Class object representing the loaded class.

Throws:

ClassNotFoundException - if class cannot be loaded.

isLocal

boolean isLocal(Stub stub)
         throws RemoteException

Delegation call for Util.isLocal(Stub).

Parameters:

stub - the stub to test.

Returns:

The is_local() method returns true if the servant incarnating the object is located in the same process as the stub and they both share the same ORB instance. The is_local() method returns false otherwise. The default behaviour of is_local() is to return false.

Throws:

RemoteException - The Java to IDL specification does not specify the conditions that cause a RemoteException to be thrown.

wrapException

RemoteException wrapException(Throwable obj)

Delegation call for Util.wrapException(Throwable).

Parameters:

obj - the exception to wrap.

Returns:

the wrapped exception.

copyObject

Object copyObject(Object obj,
 ORB orb)
           throws RemoteException

Delegation call for Util.copyObject(Object, ORB).

Parameters:

obj - the object to copy or connect.

orb - the ORB

Returns:

the copied or connected object.

Throws:

RemoteException - if the object could not be copied or connected.

copyObjects

Object[] copyObjects(Object[] obj,
 ORB orb)
              throws RemoteException

Delegation call for Util.copyObjects(Object[], ORB).

Parameters:

obj - the objects to copy or connect.

orb - the ORB

Returns:

the copied or connected objects.

Throws:

RemoteException - if the objects could not be copied or connected.