javax.management.remote

Class JMXConnectorServerFactory

Table des matières

  • public class JMXConnectorServerFactory
extends Object

    Factory to create JMX API connector servers. There are no instances of this class.

    Each connector server is created by an instance of JMXConnectorServerProvider. This instance is found as follows. Suppose the given JMXServiceURL looks like "service:jmx:protocol:remainder". Then the factory will attempt to find the appropriate JMXConnectorServerProvider for protocol. Each occurrence of the character + or - in protocol is replaced by . or _, respectively.

    A provider package list is searched for as follows:

    1. If the environment parameter to newJMXConnectorServer contains the key jmx.remote.protocol.provider.pkgs then the associated value is the provider package list.
    2. Otherwise, if the system property jmx.remote.protocol.provider.pkgs exists, then its value is the provider package list.
    3. Otherwise, there is no provider package list.

    The provider package list is a string that is interpreted as a list of non-empty Java package names separated by vertical bars (|). If the string is empty, then so is the provider package list. If the provider package list is not a String, or if it contains an element that is an empty string, a JMXProviderException is thrown.

    If the provider package list exists and is not empty, then for each element pkg of the list, the factory will attempt to load the class

    pkg.protocol.ServerProvider

    If the environment parameter to newJMXConnectorServer contains the key jmx.remote.protocol.provider.class.loader then the associated value is the class loader to use to load the provider. If the associated value is not an instance of ClassLoader, an IllegalArgumentException is thrown.

    If the jmx.remote.protocol.provider.class.loader key is not present in the environment parameter, the calling thread's context class loader is used.

    If the attempt to load this class produces a ClassNotFoundException, the search for a handler continues with the next element of the list.

    Otherwise, a problem with the provider found is signalled by a JMXProviderException whose cause indicates the underlying exception, as follows:

    • if the attempt to load the class produces an exception other than ClassNotFoundException, that is the cause;
    • if Class.newInstance() for the class produces an exception, that is the cause.

    If no provider is found by the above steps, including the default case where there is no provider package list, then the implementation will use its own provider for protocol, or it will throw a MalformedURLException if there is none. An implementation may choose to find providers by other means. For example, it may support the JAR conventions for service providers, where the service interface is JMXConnectorServerProvider.

    Every implementation must support the RMI connector protocols, specified with the string rmi or iiop.

    Once a provider is found, the result of the newJMXConnectorServer method is the result of calling newJMXConnectorServer on the provider.

    The Map parameter passed to the JMXConnectorServerProvider is a new read-only Map that contains all the entries that were in the environment parameter to JMXConnectorServerFactory.newJMXConnectorServer, if there was one. Additionally, if the jmx.remote.protocol.provider.class.loader key is not present in the environment parameter, it is added to the new read-only Map. The associated value is the calling thread's context class loader.

    Since:
    1.5

    • Field Detail

      • DEFAULT_CLASS_LOADER

        public static final String DEFAULT_CLASS_LOADER

        Name of the attribute that specifies the default class loader. This class loader is used to deserialize objects in requests received from the client, possibly after consulting an MBean-specific class loader. The value associated with this attribute is an instance of ClassLoader.

        See Also:
        Constant Field Values

      • DEFAULT_CLASS_LOADER_NAME

        public static final String DEFAULT_CLASS_LOADER_NAME

        Name of the attribute that specifies the default class loader MBean name. This class loader is used to deserialize objects in requests received from the client, possibly after consulting an MBean-specific class loader. The value associated with this attribute is an instance of ObjectName.

        See Also:
        Constant Field Values

      • PROTOCOL_PROVIDER_PACKAGES

        public static final String PROTOCOL_PROVIDER_PACKAGES

        Name of the attribute that specifies the provider packages that are consulted when looking for the handler for a protocol. The value associated with this attribute is a string with package names separated by vertical bars (|).

        See Also:
        Constant Field Values

      • PROTOCOL_PROVIDER_CLASS_LOADER

        public static final String PROTOCOL_PROVIDER_CLASS_LOADER

        Name of the attribute that specifies the class loader for loading protocol providers. The value associated with this attribute is an instance of ClassLoader.

        See Also:
        Constant Field Values

    • Method Detail

      • newJMXConnectorServer

        public static JMXConnectorServer newJMXConnectorServer(JMXServiceURL serviceURL,
                                       Map<String,?> environment,
                                       MBeanServer mbeanServer)
                                                throws IOException

        Creates a connector server at the given address. The resultant server is not started until its start method is called.

        Parameters:
        serviceURL - the address of the new connector server. The actual address of the new connector server, as returned by its getAddress method, will not necessarily be exactly the same. For example, it might include a port number if the original address did not.
        environment - a set of attributes to control the new connector server's behavior. This parameter can be null. Keys in this map must be Strings. The appropriate type of each associated value depends on the attribute. The contents of environment are not changed by this call.
        mbeanServer - the MBean server that this connector server is attached to. Null if this connector server will be attached to an MBean server by being registered in it.
        Returns:
        a JMXConnectorServer representing the new connector server. Each successful call to this method produces a different object.
        Throws:
        NullPointerException - if serviceURL is null.
        IOException - if the connector server cannot be made because of a communication problem.
        MalformedURLException - if there is no provider for the protocol in serviceURL.
        JMXProviderException - if there is a provider for the protocol in serviceURL but it cannot be used for some reason.

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 20/11/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-javax/management/remote/JMXConnectorServerFactory.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, JMXConnectorServerFactory

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