All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.net.URLStreamHandler

Object
   |
   +----java.net.URLStreamHandler

public abstract class URLStreamHandler

extends Object

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.

Version:

1.23, 07/01/98

Author:

James Gosling

Since:

JDK1.0

See Also:

URL(java.lang.String, java.lang.String, int, java.lang.String)

java.net.URLStreamHandler()

openConnection(URL)

Opens a connection to the object referenced by the URL argument.

parseURL(URL, String, int, int)

Parses the string representation of a URL into a URL object.

setURL(URL, String, String, int, String, String)

Sets the fields of the URL argument to the indicated values.

toExternalForm(URL)

Converts a URL of a specific protocol to a String.

public URLStreamHandler()

protected abstract java.net.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.

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.

Since:

JDK1.0

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.

If the file component of the URL argument contains a question mark (as with CGI HTTP URLs), the context is considered to be the URL's file component up to the first / before the question mark, not including the question mark or the directory before it. For example, if the URL was:

    http://www.foo.com/dir/cgi-bin?foo=bar/baz

and the spec argument was

    quux.html

the resulting URL would be:

    http://www.foo.com/dir/quux.html

.

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.

Since:

JDK1.0

protected void setURL(URL u,
                      String protocol,
                      String host,
                      int port,
                      String file,
                      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.

file - the file.

ref - the reference.

Since:

JDK1.0

See Also:

set(java.lang.String, java.lang.String, int, java.lang.String, java.lang.String)

protected java.lang.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.

Since:

JDK1.0

All Packages  Class Hierarchy  This Package  Previous  Next  Index