Home » openjdk-7 » java » net » [javadoc | source]
java.net
abstract public class: URLStreamHandler [javadoc | source]
java.lang.Object
   java.net.URLStreamHandler

Direct Known Subclasses:
   

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.

Method from java.net.URLStreamHandler Summary:
equals,   getDefaultPort,   getHostAddress,   hashCode,   hostsEqual,   openConnection,   openConnection,   parseURL,   sameFile,   setURL,   setURL,   toExternalForm
Methods from java.lang.Object:
clone,   equals,   finalize,   getClass,   hashCode,   notify,   notifyAll,   toString,   wait,   wait,   wait
Method from java.net.URLStreamHandler Detail:
 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.
 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.
 protected synchronized 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.
 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.
 protected boolean hostsEqual(URL u1,
    URL u2) 
    Compares the host components of two URLs.
 abstract protected 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.

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

 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.
 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.
 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.
 protected String toExternalForm(URL u) 
    Converts a URL of a specific protocol to a String.