public abstract class URLStreamHandler extends Object
URLStreamHandleris 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
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.
URL.URL(java.lang.String, java.lang.String, int, java.lang.String)
|Constructor and Description|
|Modifier and Type||Method and Description|
Provides the default equals calculation.
Returns the default port for a URL parsed by this handler.
Provides the default hash calculation.
Compares the host components of two URLs.
Opens a connection to the object referenced by the
Parses the string representation of a
Compare two urls to see whether they refer to the same file, i.e., having the same protocol, host, port, and path.
Sets the fields of the
u1- a URL object
u2- a URL object
trueif the two urls are considered equal, ie. they refer to the same fragment in the same file.
protected int getDefaultPort()
URLparsed by this handler.
protected int hashCode(URL u)
u- a URL object
intsuitable for hash table indexing
u1- the URL of the first host to compare
u2- the URL of the second host to compare
trueif and only if they are equal,
protected abstract URLConnection openConnection(URL u) throws IOException
URLargument. 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.
u- the URL that this connects to.
URLConnectionobject for the
IOException- if an I/O error occurs while opening the connection.
If there is any inherited context, then it has already been copied into 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.
URLto receive the result of parsing the spec.
Stringrepresenting 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.
u1- a URL object
u2- a URL object
protected void setURL(URL u, String protocol, String host, int port, @Nullable String authority, @Nullable String userInfo, String path, @Nullable String query, @Nullable String ref)
URLargument to the indicated values. Only classes derived from URLStreamHandler are able to use this method to set the values of the URL fields.
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.
SecurityException- if the protocol handler of the URL is different from this one
URL.set(java.lang.String, java.lang.String, int, java.lang.String, java.lang.String)