Package javax.rmi.CORBA
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:
-
Method Summary
Modifier and TypeMethodDescriptioncopyObject
(Object obj, ORB orb) Delegation call forUtil.copyObject(java.lang.Object, org.omg.CORBA.ORB)
.Object[]
copyObjects
(Object[] obj, ORB orb) Delegation call forUtil.copyObjects(java.lang.Object[], org.omg.CORBA.ORB)
.Delegation call forUtil.createValueHandler()
.getCodebase
(Class clz) Delegation call forUtil.getCodebase(java.lang.Class)
.Delegation call forUtil.getTie(java.rmi.Remote)
.boolean
Delegation call forUtil.isLocal(javax.rmi.CORBA.Stub)
.loadClass
(String className, String remoteCodebase, ClassLoader loader) Delegation call forUtil.loadClass(java.lang.String, java.lang.String, java.lang.ClassLoader)
.Delegation call forUtil.mapSystemException(org.omg.CORBA.SystemException)
.readAny
(InputStream in) Delegation call forUtil.readAny(org.omg.CORBA.portable.InputStream)
.void
registerTarget
(Tie tie, Remote target) Delegation call forUtil.registerTarget(javax.rmi.CORBA.Tie, java.rmi.Remote)
.void
unexportObject
(Remote target) Delegation call forUtil.unexportObject(java.rmi.Remote)
.wrapException
(Throwable obj) Delegation call forUtil.wrapException(java.lang.Throwable)
.void
writeAbstractObject
(OutputStream out, Object obj) Delegation call forUtil.writeAbstractObject(org.omg.CORBA.portable.OutputStream, java.lang.Object)
.void
writeAny
(OutputStream out, Object obj) Delegation call forUtil.writeAny(org.omg.CORBA.portable.OutputStream, java.lang.Object)
.void
writeRemoteObject
(OutputStream out, Object obj) Delegation call forUtil.writeRemoteObject(org.omg.CORBA.portable.OutputStream, java.lang.Object)
.
-
Method Details
-
mapSystemException
Delegation call forUtil.mapSystemException(org.omg.CORBA.SystemException)
.- Parameters:
ex
- the SystemException to map.- Returns:
- the mapped exception.
-
writeAny
Delegation call forUtil.writeAny(org.omg.CORBA.portable.OutputStream, java.lang.Object)
.- Parameters:
out
- the stream in which to write the any.obj
- the object to write as an any.
-
readAny
Delegation call forUtil.readAny(org.omg.CORBA.portable.InputStream)
.- Parameters:
in
- the stream from which to read the any.- Returns:
- the object read from the stream.
-
writeRemoteObject
Delegation call forUtil.writeRemoteObject(org.omg.CORBA.portable.OutputStream, java.lang.Object)
.- Parameters:
out
- the stream in which to write the object.obj
- the object to write.
-
writeAbstractObject
Delegation call forUtil.writeAbstractObject(org.omg.CORBA.portable.OutputStream, java.lang.Object)
.- Parameters:
out
- the stream in which to write the object.obj
- the object to write.
-
registerTarget
Delegation call forUtil.registerTarget(javax.rmi.CORBA.Tie, java.rmi.Remote)
.- Parameters:
tie
- tie to registertarget
- target for the tie
-
unexportObject
Delegation call forUtil.unexportObject(java.rmi.Remote)
.- Parameters:
target
- the object to unexport- Throws:
NoSuchObjectException
- if the target object does not exist
-
getTie
Delegation call forUtil.getTie(java.rmi.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 forUtil.createValueHandler()
.- Returns:
- a class which implements the ValueHandler interface.
-
getCodebase
Delegation call forUtil.getCodebase(java.lang.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 forUtil.loadClass(java.lang.String, java.lang.String, java.lang.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
Delegation call forUtil.isLocal(javax.rmi.CORBA.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
Delegation call forUtil.wrapException(java.lang.Throwable)
.- Parameters:
obj
- the exception to wrap.- Returns:
- the wrapped exception.
-
copyObject
Delegation call forUtil.copyObject(java.lang.Object, org.omg.CORBA.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
Delegation call forUtil.copyObjects(java.lang.Object[], org.omg.CORBA.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.
-