The Wayback Machine - https://web.archive.org/web/20160404155017/http://developer.android.com/reference/java/net/URLStreamHandler.html

URLStreamHandler

Developer Console

Interfaces
Classes
Enums
- Authenticator.RequestorType
- Proxy.Type
Exceptions

fullscreen Use Tree Navigation

Summary: Ctors | Protected Methods | Inherited Methods | [Expand All]

Added in API level 1

public abstract class

URLStreamHandler

extends Object

java.lang.Object
↳	java.net.URLStreamHandler

Class Overview

The abstract class URLStreamHandler is the base for all classes which can handle the communication with a URL object over a particular protocol type.

Summary

Public Constructors
	URLStreamHandler()

Protected Methods
boolean	equals(URL a, URL b) Returns true if `a` and `b` have the same protocol, host, port, file, and reference.
int	getDefaultPort() Returns the default port of the protocol used by the handled URL.
InetAddress	getHostAddress(URL url) Returns the host address of `url`.
int	hashCode(URL url) Returns the hash code of `url`.
boolean	hostsEqual(URL a, URL b) Returns true if the hosts of `a` and `b` are equal.
URLConnection	openConnection(URL u, Proxy proxy) Establishes a new connection to the resource specified by the URL `u` using the given `proxy`.
abstract URLConnection	openConnection(URL u) Establishes a new connection to the resource specified by the URL `u`.
void	parseURL(URL url, String spec, int start, int end) Parses the clear text URL in `str` into a URL object.
boolean	sameFile(URL a, URL b) Returns true if `a` and `b` have the same protocol, host, port and file.
void	setURL(URL u, String protocol, String host, int port, String file, String ref) This method was deprecated in API level 1. Use setURL(URL, String String, int, String, String, String, String, String) instead.
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 `u` to the values of the supplied arguments.
String	toExternalForm(URL url) Returns the clear text representation of a given URL using HTTP format.

[Expand]

Inherited Methods

From class java.lang.Object

Object	clone() Creates and returns a copy of this `Object`.
boolean	equals(Object o) Compares this instance with the specified object and indicates if they are equal.
void	finalize() Invoked when the garbage collector has detected that this instance is no longer reachable.
final Class<?>	getClass() Returns the unique instance of `Class` that represents this object's class.
int	hashCode() Returns an integer hash code for this object.
final void	notify() Causes a thread which is waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
final void	notifyAll() Causes all threads which are waiting on this object's monitor (by means of calling one of the `wait()` methods) to be woken up.
String	toString() Returns a string containing a concise, human-readable description of this object.
final void	wait() Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object.
final void	wait(long millis, int nanos) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.
final void	wait(long millis) Causes the calling thread to wait until another thread calls the `notify()` or `notifyAll()` method of this object or until the specified timeout expires.

Public Constructors

public URLStreamHandler ()

Added in API level 1

Protected Methods

protected boolean equals (URL a, URL b)

Added in API level 1

Returns true if a and b have the same protocol, host, port, file, and reference.

Parameters
`a`	`URL`
`b`	`URL`

Returns
`boolean`

protected int getDefaultPort ()

Added in API level 1

Returns the default port of the protocol used by the handled URL. The default implementation always returns -1.

Returns
`int`

protected InetAddress getHostAddress (URL url)

Added in API level 1

Returns the host address of url.

Parameters
`url`	`URL`

Returns
`InetAddress`

protected int hashCode (URL url)

Added in API level 1

Returns the hash code of url.

Parameters
`url`	`URL`

Returns
`int`

protected boolean hostsEqual (URL a, URL b)

Added in API level 1

Returns true if the hosts of a and b are equal.

Parameters
`a`	`URL`
`b`	`URL`

Returns
`boolean`

protected URLConnection openConnection (URL u, Proxy proxy)

Added in API level 1

Establishes a new connection to the resource specified by the URL u using the given proxy. Since different protocols also have unique ways of connecting, it must be overwritten by the subclass.

Parameters
`u`	`URL`: the URL to the resource where a connection has to be opened.
`proxy`	`Proxy`: the proxy that is used to make the connection.

Returns
`URLConnection`	the opened URLConnection to the specified resource.

Throws
`IOException`	if an I/O error occurs during opening the connection.
`IllegalArgumentException`	if any argument is `null` or the type of proxy is wrong.
`UnsupportedOperationException`	if the protocol handler doesn't support this method.

protected abstract URLConnection openConnection (URL u)

Added in API level 1

Establishes a new connection to the resource specified by the URL u. Since different protocols also have unique ways of connecting, it must be overwritten by the subclass.

Parameters
`u`	`URL`: the URL to the resource where a connection has to be opened.

Returns
`URLConnection`	the opened URLConnection to the specified resource.

Throws
`IOException`	if an I/O error occurs during opening the connection.

protected void parseURL (URL url, String spec, int start, int end)

Added in API level 1

Parses the clear text URL in str into a URL object. URL strings generally have the following format:

http://www.company.com/java/file1.java#reference

The string is parsed in HTTP format. If the protocol has a different URL format this method must be overridden.

Parameters
`url`	`URL`: the URL to fill in the parsed clear text URL parts.
`spec`	`String`: the URL string that is to be parsed.
`start`	`int`: the string position from where to begin parsing.
`end`	`int`: the string position to stop parsing.

See also:

toExternalForm(URL)
URL

protected boolean sameFile (URL a, URL b)

Added in API level 1

Returns true if a and b have the same protocol, host, port and file.

Parameters
`a`	`URL`
`b`	`URL`

Returns
`boolean`

protected void setURL (URL u, String protocol, String host, int port, String file, String ref)

Added in API level 1

This method was deprecated in API level 1.
Use setURL(URL, String String, int, String, String, String, String, String) instead.

Sets the fields of the URL u to the values of the supplied arguments.

Parameters
`u`	`URL`: the non-null URL object to be set.
`protocol`	`String`: the protocol.
`host`	`String`: the host name.
`port`	`int`: the port number.
`file`	`String`: the file component.
`ref`	`String`: the reference.

protected void setURL (URL u, String protocol, String host, int port, String authority, String userInfo, String path, String query, String ref)

Added in API level 1

Sets the fields of the URL u to the values of the supplied arguments.

Parameters
`u`	`URL`
`protocol`	`String`
`host`	`String`
`port`	`int`
`authority`	`String`
`userInfo`	`String`
`path`	`String`
`query`	`String`
`ref`	`String`

protected String toExternalForm (URL url)

Added in API level 1

Returns the clear text representation of a given URL using HTTP format.

Parameters
`url`	`URL`: the URL object to be converted.

Returns
`String`	the clear text representation of the specified URL.

See also:

Mar	APR	May
	04
2015	2016	2017

Results

Interfaces

Classes

Enums

Exceptions

URLStreamHandler

Class Overview

Summary

Public Constructors

public URLStreamHandler ()

Protected Methods

protected boolean equals (URL a, URL b)

protected int getDefaultPort ()

protected InetAddress getHostAddress (URL url)

protected int hashCode (URL url)

protected boolean hostsEqual (URL a, URL b)

protected URLConnection openConnection (URL u, Proxy proxy)

protected abstract URLConnection openConnection (URL u)

protected void parseURL (URL url, String spec, int start, int end)

protected boolean sameFile (URL a, URL b)

protected void setURL (URL u, String protocol, String host, int port, String file, String ref)

protected void setURL (URL u, String protocol, String host, int port, String authority, String userInfo, String path, String query, String ref)

protected String toExternalForm (URL url)