public class PortableRemoteObject
extends Object 

• Constructor Summary

  Constructors

  Modifier	Constructor	Description
  protected	PortableRemoteObject ()	Initializes the object by calling exportObject(this).

• Method Summary

  All Methods

  Modifier and Type	Method	Description
  static void	connect (Remote target, Remote source)	Makes a Remote object ready for remote communication.
  static void	exportObject (Remote obj)	Makes a server object ready to receive remote calls.
  static Object	narrow (Object narrowFrom, Class narrowTo)	Checks to ensure that an object of a remote or abstract interface type can be cast to a desired type.
  static Remote	toStub (Remote obj)	Returns a stub for the given server object.
  static void	unexportObject (Remote obj)	Deregisters a server object from the runtime, allowing the object to become available for garbage collection.

  • Methods inherited from class java.lang.Object

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

• Constructor Detail

  • PortableRemoteObject

    protected PortableRemoteObject()
     throws RemoteException 

    Initializes the object by calling exportObject(this).

    Throws:

    RemoteException - if export fails.

• Method Detail

  • exportObject

    public static void exportObject(Remote obj)
     throws RemoteException 

    Makes a server object ready to receive remote calls. Note that subclasses of PortableRemoteObject do not need to call this method, as it is called by the constructor.

    Parameters:

    obj - the server object to export.

    Throws:

    RemoteException - if export fails.

  • toStub

    public static Remote toStub(Remote obj)
     throws NoSuchObjectException 

    Returns a stub for the given server object.

    Parameters:

    obj - the server object for which a stub is required. Must either be a subclass of PortableRemoteObject or have been previously the target of a call to exportObject(java.rmi.Remote).

    Returns:

    the most derived stub for the object.

    Throws:

    NoSuchObjectException - if a stub cannot be located for the given server object.

  • unexportObject

    public static void unexportObject(Remote obj)
     throws NoSuchObjectException 

    Deregisters a server object from the runtime, allowing the object to become available for garbage collection.

    Parameters:

    obj - the object to unexport.

    Throws:

    NoSuchObjectException - if the remote object is not currently exported.

  • narrow

    public static Object narrow(Object narrowFrom,
     Class narrowTo)
     throws ClassCastException 

    Checks to ensure that an object of a remote or abstract interface type can be cast to a desired type.

    Parameters:

    narrowFrom - the object to check.

    narrowTo - the desired type.

    Returns:

    an object which can be cast to the desired type.

    Throws:

    ClassCastException - if narrowFrom cannot be cast to narrowTo.

  • connect

    public static void connect(Remote target,
     Remote source)
     throws RemoteException 

    Makes a Remote object ready for remote communication. This normally happens implicitly when the object is sent or received as an argument on a remote method call, but in some circumstances it is useful to perform this action by making an explicit call. See the Stub.connect(org.omg.CORBA.ORB) method for more information.

    Parameters:

    target - the object to connect.

    source - a previously connected object.

    Throws:

    RemoteException - if source is not connected or if target is already connected to a different ORB than source.