com.sun.corba.se.impl.javax.rmi.CORBA

Class Util

java.lang.Object

com.sun.corba.se.impl.javax.rmi.CORBA.Util

All Implemented Interfaces:

UtilDelegate

public class Util
extends Object
implements UtilDelegate

Provides utility methods that can be used by stubs and ties to perform common operations.

Constructor Summary

Constructors

Constructor and Description
Util()

Method Summary

Modifier and Type	Method and Description
protected void	cleanUpTie(Tie cachedTie)
Object	copyObject(Object obj, ORB orb) Copies or connects an object.
Object[]	copyObjects(Object[] obj, ORB orb) Copies or connects an array of objects.
ValueHandler	createValueHandler() Returns a singleton instance of a class that implements the ValueHandler interface.
String	getCodebase(Class clz) Returns the codebase, if any, for the given class.
static Util	getInstance()
Tie	getTie(Remote target) Returns the tie (if any) for a given target object.
static boolean	isInstanceDefined()
boolean	isLocal(Stub stub) The isLocal method has the same semantics as the ObjectImpl._is_local method, except that it can throw a RemoteException.
Class	loadClass(String className, String remoteCodebase, ClassLoader loader) Returns a class instance for the specified class.
RemoteException	mapSystemException(SystemException ex) Maps a SystemException to a RemoteException.
Object	readAny(InputStream in) Reads a java.lang.Object as a CORBA any.
void	registerTarget(Tie tie, Remote target) Registers a target for a tie.
void	unexportObject(Remote target) Removes the associated tie from an internal table and calls Tie.deactivate() to deactivate the object.
void	unregisterTargetsForORB(ORB orb)
RemoteException	wrapException(Throwable orig) Wraps an exception thrown by an implementation method.
void	writeAbstractObject(OutputStream out, Object obj) Writes a java.lang.Object as either a value or a CORBA Object.
void	writeAny(OutputStream out, Object obj) Writes any java.lang.Object as a CORBA any.
void	writeRemoteObject(OutputStream out, Object obj) Writes a java.lang.Object as a CORBA Object.

Methods inherited from class java.lang.Object

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

Constructor Detail

Util

public Util()

Method Detail

getInstance

public static Util getInstance()

isInstanceDefined

public static boolean isInstanceDefined()

unregisterTargetsForORB

public void unregisterTargetsForORB(ORB orb)

mapSystemException

public RemoteException mapSystemException(SystemException ex)

Maps a SystemException to a RemoteException.

Specified by:

mapSystemException in interface UtilDelegate

Parameters:

ex - the SystemException to map.

Returns:

the mapped exception.

writeAny

public void writeAny(OutputStream out,
                     Object obj)

Writes any java.lang.Object as a CORBA any.

Specified by:

writeAny in interface UtilDelegate

Parameters:

out - the stream in which to write the any.

obj - the object to write as an any.

readAny

public Object readAny(InputStream in)

Reads a java.lang.Object as a CORBA any.

Specified by:

readAny in interface UtilDelegate

Parameters:

in - the stream from which to read the any.

Returns:

the object read from the stream.

writeRemoteObject

public void writeRemoteObject(OutputStream out,
                              Object obj)

Writes a java.lang.Object as a CORBA Object. If obj is an exported RMI-IIOP server object, the tie is found and wired to obj, then written to out.write_Object(org.omg.CORBA.Object). If obj is a CORBA Object, it is written to out.write_Object(org.omg.CORBA.Object).

Specified by:

writeRemoteObject in interface UtilDelegate

Parameters:

out - the stream in which to write the object.

obj - the object to write.

writeAbstractObject

public void writeAbstractObject(OutputStream out,
                                Object obj)

Writes a java.lang.Object as either a value or a CORBA Object. If obj is a value object or a stub object, it is written to out.write_abstract_interface(java.lang.Object). If obj is an exported RMI-IIOP server object, the tie is found and wired to obj, then written to out.write_abstract_interface(java.lang.Object).

Specified by:

writeAbstractObject in interface UtilDelegate

Parameters:

out - the stream in which to write the object.

obj - the object to write.

registerTarget

public void registerTarget(Tie tie,
                           Remote target)

Registers a target for a tie. Adds the tie to an internal table and calls Tie.setTarget(java.rmi.Remote) on the tie object.

Specified by:

registerTarget in interface UtilDelegate

Parameters:

tie - the tie to register.

target - the target for the tie.

unexportObject

public void unexportObject(Remote target)
                    throws NoSuchObjectException

Removes the associated tie from an internal table and calls Tie.deactivate() to deactivate the object.

Specified by:

unexportObject in interface UtilDelegate

Parameters:

target - the object to unexport.

Throws:

NoSuchObjectException

cleanUpTie

protected void cleanUpTie(Tie cachedTie)
                   throws NoSuchObjectException

Throws:

NoSuchObjectException

getTie

public Tie getTie(Remote target)

Returns the tie (if any) for a given target object.

Specified by:

getTie in interface UtilDelegate

Returns:

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

createValueHandler

public ValueHandler createValueHandler()

Returns a singleton instance of a class that implements the ValueHandler interface.

Specified by:

createValueHandler in interface UtilDelegate

Returns:

a class which implements the ValueHandler interface.

getCodebase

public String getCodebase(Class clz)

Returns the codebase, if any, for the given class.

Specified by:

getCodebase in interface UtilDelegate

Parameters:

clz - the class to get a codebase for.

Returns:

a space-separated list of URLs, or null.

loadClass

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

Returns a class instance for the specified class.

Specified by:

loadClass in interface UtilDelegate

Parameters:

className - the name of the class.

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

loadingContext - a class whose ClassLoader 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

public boolean isLocal(Stub stub)
                throws RemoteException

The isLocal method has the same semantics as the ObjectImpl._is_local method, except that it can throw a RemoteException. (no it doesn't but the spec says it should.) The _is_local() method is provided so that stubs may determine if a particular object is implemented by a local servant and hence local invocation APIs may be used.

Specified by:

isLocal in interface UtilDelegate

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 behavior of _is_local() is to return false.

Throws:

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

wrapException

public RemoteException wrapException(Throwable orig)

Wraps an exception thrown by an implementation method. It returns the corresponding client-side exception.

Specified by:

wrapException in interface UtilDelegate

Parameters:

orig - the exception to wrap.

Returns:

the wrapped exception.

copyObjects

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

Copies or connects an array of objects. Used by local stubs to copy any number of actual parameters, preserving sharing across parameters as necessary to support RMI semantics.

Specified by:

copyObjects in interface UtilDelegate

Parameters:

obj - the objects to copy or connect.

orb - the ORB.

Returns:

the copied or connected objects.

Throws:

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

copyObject

public Object copyObject(Object obj,
                         ORB orb)
                  throws RemoteException

Copies or connects an object. Used by local stubs to copy an actual parameter, result object, or exception.

Specified by:

copyObject in interface UtilDelegate

Parameters:

obj - the object to copy.

orb - the ORB.

Returns:

the copy or connected object.

Throws:

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