javax.rmi

Class PortableRemoteObject

Table des matières

  • public class PortableRemoteObject
extends Object
    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 Summary

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

        

    • 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.

Traduction non disponible

Les API Java ne sont pas encore traduites en français sur l'infobrol. Seule la version anglaise est disponible pour l'instant.

Document créé le 31/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/rmi/PortableRemoteObject.html

L'infobrol est un site personnel dont le contenu n'engage que moi. Le texte est mis à disposition sous licence CreativeCommons(BY-NC-SA). Plus d'info sur les conditions d'utilisation et sur l'auteur.

Références

  1. Consulter le document html Langue du document :fr Manuel PHP : https://docs.oracle.com, PortableRemoteObject

Ces références et liens indiquent des documents consultés lors de la rédaction de cette page, ou qui peuvent apporter un complément d'information, mais les auteurs de ces sources ne peuvent être tenus responsables du contenu de cette page.
L'auteur de ce site est seul responsable de la manière dont sont présentés ici les différents concepts, et des libertés qui sont prises avec les ouvrages de référence. N'oubliez pas que vous devez croiser les informations de sources multiples afin de diminuer les risques d'erreurs.

Table des matières Haut