java.net
Class URLStreamHandler

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.

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.

URLStreamHandler

openConnection

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.
NOTE: java.net.HttpURLConnection is found in J2ME CDC profiles
such as J2ME Foundation Profile.

parseURL

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.

equals

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.

sameFile

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.

A script enabled browser is required for this page to function properly.A script enabled browser is required for this page to function properly.A script enabled browser is required for this page to function properly.A script enabled browser is required for this page to function properly.A script enabled browser is required for this page to function properly.