java.net

Class URLStreamHandler


  • public abstract class URLStreamHandler
    extends Object
    The abstract class URLStreamHandler is the common superclass for all stream protocol handlers. A stream protocol handler knows how to make a connection for a particular protocol type, such as http, ftp, or gopher.

    In most cases, an instance of a URLStreamHandler subclass is not created directly by an application. Rather, the first time a protocol name is encountered when constructing a URL, the appropriate stream protocol handler is automatically loaded.

    Since:
    JDK1.0
    See Also:
    URL.URL(java.lang.String, java.lang.String, int, java.lang.String)
    • Constructor Summary

      Constructors 
      Constructor and Description
      URLStreamHandler() 

        

    • Method Summary

      Methods 
      Modifier and Type Method and Description
      protected boolean equals(URL u1, URL u2)
      Provides the default equals calculation.
      protected int getDefaultPort()
      Returns the default port for a URL parsed by this handler.
      protected InetAddress getHostAddress(URL u)
      Get the IP address of our host.
      protected int hashCode(URL u)
      Provides the default hash calculation.
      protected boolean hostsEqual(URL u1, URL u2)
      Compares the host components of two URLs.
      protected abstract URLConnection openConnection(URL u)
      Opens a connection to the object referenced by the URL argument.
      protected URLConnection openConnection(URL u, Proxy p)
      Same as openConnection(URL), except that the connection will be made through the specified proxy; Protocol handlers that do not support proxying will ignore the proxy parameter and make a normal connection.
      protected void parseURL(URL u, String spec, int start, int limit)
      Parses the string representation of a URL into a URL object.
      protected boolean sameFile(URL u1, URL u2)
      Compare two urls to see whether they refer to the same file, i.e., having the same protocol, host, port, and path.
      protected void setURL(URL u, String protocol, String host, int port, String file, String ref)
      Deprecated. 
      Use setURL(URL, String, String, int, String, String, String, String);
      protected void setURL(URL u, String protocol, String host, int port, String authority, String userInfo, String path, String query, String ref)
      Sets the fields of the URL argument to the indicated values.
      protected String toExternalForm(URL u)
      Converts a URL of a specific protocol to a String.

        

    • Constructor Detail

      • URLStreamHandler

        public URLStreamHandler()
    • Method Detail

      • openConnection

        protected abstract URLConnection openConnection(URL u)
                                                 throws IOException
        Opens a connection to the object referenced by the URL argument. This method should be overridden by a subclass.

        If for the handler's protocol (such as HTTP or JAR), there exists a public, specialized URLConnection subclass belonging to one of the following packages or one of their subpackages: java.lang, java.io, java.util, java.net, the connection returned will be of that subclass. For example, for HTTP an HttpURLConnection will be returned, and for JAR a JarURLConnection will be returned.

        Parameters:
        u - the URL that this connects to.
        Returns:
        a URLConnection object for the URL.
        Throws:
        IOException - if an I/O error occurs while opening the connection.
      • openConnection

        protected URLConnection openConnection(URL u,
                                   Proxy p)
                                        throws IOException
        Same as openConnection(URL), except that the connection will be made through the specified proxy; Protocol handlers that do not support proxying will ignore the proxy parameter and make a normal connection. Calling this method preempts the system's default ProxySelector settings.
        Parameters:
        u - the URL that this connects to.
        p - the proxy through which the connection will be made. If direct connection is desired, Proxy.NO_PROXY should be specified.
        Returns:
        a URLConnection object for the URL.
        Throws:
        IOException - if an I/O error occurs while opening the connection.
        IllegalArgumentException - if either u or p is null, or p has the wrong type.
        UnsupportedOperationException - if the subclass that implements the protocol doesn't support this method.
        Since:
        1.5
      • parseURL

        protected void parseURL(URL u,
                    String spec,
                    int start,
                    int limit)
        Parses the string representation of a URL into a URL object.

        If there is any inherited context, then it has already been copied into the URL argument.

        The parseURL method of URLStreamHandler parses the string representation as if it were an http specification. Most URL protocol families have a similar parsing. A stream protocol handler for a protocol that has a different syntax must override this routine.

        Parameters:
        u - the URL to receive the result of parsing the spec.
        spec - the String representing the URL that must be parsed.
        start - the character index at which to begin parsing. This is just past the ':' (if there is one) that specifies the determination of the protocol name.
        limit - the character position to stop parsing at. This is the end of the string or the position of the "#" character, if present. All information after the sharp sign indicates an anchor.
      • getDefaultPort

        protected int getDefaultPort()
        Returns the default port for a URL parsed by this handler. This method is meant to be overidden by handlers with default port numbers.
        Returns:
        the default port for a URL parsed by this handler.
        Since:
        1.3
      • equals

        protected boolean equals(URL u1,
                     URL u2)
        Provides the default equals calculation. May be overidden by handlers for other protocols that have different requirements for equals(). This method requires that none of its arguments is null. This is guaranteed by the fact that it is only called by java.net.URL class.
        Parameters:
        u1 - a URL object
        u2 - a URL object
        Returns:
        true if the two urls are considered equal, ie. they refer to the same fragment in the same file.
        Since:
        1.3
      • hashCode

        protected int hashCode(URL u)
        Provides the default hash calculation. May be overidden by handlers for other protocols that have different requirements for hashCode calculation.
        Parameters:
        u - a URL object
        Returns:
        an int suitable for hash table indexing
        Since:
        1.3
      • sameFile

        protected boolean sameFile(URL u1,
                       URL u2)
        Compare two urls to see whether they refer to the same file, i.e., having the same protocol, host, port, and path. This method requires that none of its arguments is null. This is guaranteed by the fact that it is only called indirectly by java.net.URL class.
        Parameters:
        u1 - a URL object
        u2 - a URL object
        Returns:
        true if u1 and u2 refer to the same file
        Since:
        1.3
      • getHostAddress

        protected InetAddress getHostAddress(URL u)
        Get the IP address of our host. An empty host field or a DNS failure will result in a null return.
        Parameters:
        u - a URL object
        Returns:
        an InetAddress representing the host IP address.
        Since:
        1.3
      • hostsEqual

        protected boolean hostsEqual(URL u1,
                         URL u2)
        Compares the host components of two URLs.
        Parameters:
        u1 - the URL of the first host to compare
        u2 - the URL of the second host to compare
        Returns:
        true if and only if they are equal, false otherwise.
        Since:
        1.3
      • toExternalForm

        protected String toExternalForm(URL u)
        Converts a URL of a specific protocol to a String.
        Parameters:
        u - the URL.
        Returns:
        a string representation of the URL argument.
      • setURL

        protected void setURL(URL u,
                  String protocol,
                  String host,
                  int port,
                  String authority,
                  String userInfo,
                  String path,
                  String query,
                  String ref)
        Sets the fields of the URL argument to the indicated values. Only classes derived from URLStreamHandler are supposed to be able to call the set method on a URL.
        Parameters:
        u - the URL to modify.
        protocol - the protocol name.
        host - the remote host value for the URL.
        port - the port on the remote machine.
        authority - the authority part for the URL.
        userInfo - the userInfo part of the URL.
        path - the path component of the URL.
        query - the query part for the URL.
        ref - the reference.
        Throws:
        SecurityException - if the protocol handler of the URL is different from this one
        Since:
        1.3
        See Also:
        URL.set(java.lang.String, java.lang.String, int, java.lang.String, java.lang.String)
      • setURL

        @Deprecated
        protected void setURL(URL u,
                             String protocol,
                             String host,
                             int port,
                             String file,
                             String ref)
        Deprecated. Use setURL(URL, String, String, int, String, String, String, String);
        Sets the fields of the URL argument to the indicated values. Only classes derived from URLStreamHandler are supposed to be able to call the set method on a URL.
        Parameters:
        u - the URL to modify.
        protocol - the protocol name. This value is ignored since 1.2.
        host - the remote host value for the URL.
        port - the port on the remote machine.
        file - the file.
        ref - the reference.
        Throws:
        SecurityException - if the protocol handler of the URL is different from this one

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.

Version en cache

24/11/2024 14:13:13 Cette version de la page est en cache (à la date du 24/11/2024 14:13:13) afin d'accélérer le traitement. Vous pouvez activer le mode utilisateur dans le menu en haut pour afficher la dernère version de la page.

Document créé le 29/08/2006, dernière modification le 04/03/2020
Source du document imprimé : https://www.gaudry.be/java-api-rf-java/net/urlstreamhandler.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, URLStreamHandler

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