javax.rmi: public class: PortableRemoteObject

javax.rmi
public class: PortableRemoteObject [javadoc | source]

java.lang.Object
   javax.rmi.PortableRemoteObject

Server implementation objects may either inherit from javax.rmi.PortableRemoteObject or they may implement a remote interface and then use the exportObject method to register themselves as a server object. The toStub method takes a server implementation and returns a stub that can be used to access that server object. The connect method makes a Remote object ready for remote communication. The unexportObject method is used to deregister a server object, allowing it to become available for garbage collection. The narrow method takes an object reference or abstract interface type and attempts to narrow it to conform to the given interface. If the operation is successful the result will be an object of the specified type, otherwise an exception will be thrown.

Constructor:

Constructor:
protected PortableRemoteObject() throws RemoteException { proDelegate = (javax.rmi.CORBA.PortableRemoteObjectDelegate) createDelegateIfSpecified(PortableRemoteObjectClassKey); if (proDelegate != null) { PortableRemoteObject.exportObject((Remote)this); } } Initializes the object by calling `exportObject(this)`. Throws: `RemoteException` - if export fails. exception: `RemoteException` - if export fails.

 protected PortableRemoteObject() throws RemoteException {
     
        proDelegate = (javax.rmi.CORBA.PortableRemoteObjectDelegate)
            createDelegateIfSpecified(PortableRemoteObjectClassKey);
        if (proDelegate != null) {
            PortableRemoteObject.exportObject((Remote)this);
        }
}

exportObject(this)

Throws:

RemoteException - if export fails.

exception: RemoteException - if export fails.

Method from javax.rmi.PortableRemoteObject Summary:
connect, exportObject, narrow, toStub, unexportObject

Methods from java.lang.Object:
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method from javax.rmi.PortableRemoteObject Detail:
public static void connect(Remote target, Remote source) throws RemoteException { if (proDelegate != null) { proDelegate.connect(target, source); } } 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 method for more information.
public static void exportObject(Remote obj) throws RemoteException { // Let the delegate do everything, including error handling. if (proDelegate != null) { proDelegate.exportObject(obj); } } 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.
public static Object narrow(Object narrowFrom, Class narrowTo) throws ClassCastException { if (proDelegate != null) { return proDelegate.narrow(narrowFrom, narrowTo); } return null; } Checks to ensure that an object of a remote or abstract interface type can be cast to a desired type.
public static Remote toStub(Remote obj) throws NoSuchObjectException { if (proDelegate != null) { return proDelegate.toStub(obj); } return null; } Returns a stub for the given server object.
public static void unexportObject(Remote obj) throws NoSuchObjectException { if (proDelegate != null) { proDelegate.unexportObject(obj); } } Deregisters a server object from the runtime, allowing the object to become available for garbage collection.

Method from javax.rmi.PortableRemoteObject Detail:

 public static  void connect(Remote target,
    Remote source) throws RemoteException {
        if (proDelegate != null) {
            proDelegate.connect(target, source);
        }
}

Stub#connect

 public static  void exportObject(Remote obj) throws RemoteException {
        // Let the delegate do everything, including error handling.
        if (proDelegate != null) {
            proDelegate.exportObject(obj);
        }
}

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.

 public static Object narrow(Object narrowFrom,
    Class narrowTo) throws ClassCastException {
        if (proDelegate != null) {
            return proDelegate.narrow(narrowFrom, narrowTo);
        }
        return null;
}

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

 public static Remote toStub(Remote obj) throws NoSuchObjectException {
        if (proDelegate != null) {
            return proDelegate.toStub(obj);
        }
        return null;
}

Returns a stub for the given server object.

 public static  void unexportObject(Remote obj) throws NoSuchObjectException {
        if (proDelegate != null) {
            proDelegate.unexportObject(obj);
        }
}

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