java.rmi.server

Class RMISocketFactory

Table des matières
  • All Implemented Interfaces:
    RMIClientSocketFactory, RMIServerSocketFactory

    public abstract class RMISocketFactory
extends Object
implements RMIClientSocketFactory, RMIServerSocketFactory
    An RMISocketFactory instance is used by the RMI runtime in order to obtain client and server sockets for RMI calls. An application may use the setSocketFactory method to request that the RMI runtime use its socket factory instance instead of the default implementation.

    The default socket factory implementation used goes through a three-tiered approach to creating client sockets. First, a direct socket connection to the remote VM is attempted. If that fails (due to a firewall), the runtime uses HTTP with the explicit port number of the server. If the firewall does not allow this type of communication, then HTTP to a cgi-bin script on the server is used to POST the RMI call.

    Since:
    JDK1.1

    • Constructor Detail

      • RMISocketFactory

        public RMISocketFactory()
        Constructs an RMISocketFactory.
        Since:
        JDK1.1

    • Method Detail

      • createSocket

        public abstract Socket createSocket(String host,
                  int port)
                             throws IOException
        Creates a client socket connected to the specified host and port.
        Specified by:
        createSocket in interface RMIClientSocketFactory
        Parameters:
        host - the host name
        port - the port number
        Returns:
        a socket connected to the specified host and port.
        Throws:
        IOException - if an I/O error occurs during socket creation
        Since:
        JDK1.1

      • createServerSocket

        public abstract ServerSocket createServerSocket(int port)
                                         throws IOException
        Create a server socket on the specified port (port 0 indicates an anonymous port).
        Specified by:
        createServerSocket in interface RMIServerSocketFactory
        Parameters:
        port - the port number
        Returns:
        the server socket on the specified port
        Throws:
        IOException - if an I/O error occurs during server socket creation
        Since:
        JDK1.1

      • setSocketFactory

        public static void setSocketFactory(RMISocketFactory fac)
                             throws IOException
        Set the global socket factory from which RMI gets sockets (if the remote object is not associated with a specific client and/or server socket factory). The RMI socket factory can only be set once. Note: The RMISocketFactory may only be set if the current security manager allows setting a socket factory; if disallowed, a SecurityException will be thrown.
        Parameters:
        fac - the socket factory
        Throws:
        IOException - if the RMI socket factory is already set
        SecurityException - if a security manager exists and its checkSetFactory method doesn't allow the operation.
        Since:
        JDK1.1
        See Also:
        getSocketFactory(), SecurityManager.checkSetFactory()

      • getSocketFactory

        public static RMISocketFactory getSocketFactory()
        Returns the socket factory set by the setSocketFactory method. Returns null if no socket factory has been set.
        Returns:
        the socket factory
        Since:
        JDK1.1
        See Also:
        setSocketFactory(RMISocketFactory)

      • getDefaultSocketFactory

        public static RMISocketFactory getDefaultSocketFactory()
        Returns a reference to the default socket factory used by this RMI implementation. This will be the factory used by the RMI runtime when getSocketFactory returns null.
        Returns:
        the default RMI socket factory
        Since:
        JDK1.1

      • setFailureHandler

        public static void setFailureHandler(RMIFailureHandler fh)
        Sets the failure handler to be called by the RMI runtime if server socket creation fails. By default, if no failure handler is installed and server socket creation fails, the RMI runtime does attempt to recreate the server socket.

        If there is a security manager, this method first calls the security manager's checkSetFactory method to ensure the operation is allowed. This could result in a SecurityException.

        Parameters:
        fh - the failure handler
        Throws:
        SecurityException - if a security manager exists and its checkSetFactory method doesn't allow the operation.
        Since:
        JDK1.1
        See Also:
        getFailureHandler(), RMIFailureHandler.failure(Exception)

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 25/07/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-java/rmi/server/RMISocketFactory.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, RMISocketFactory

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