javax.mail
Class URLName

java.lang.Object
  |
  +--javax.mail.URLName

public class URLName

extends Object

The name of a URL. This class represents a URL name and also provides the basic parsing functionality to parse most internet standard URL schemes.

Note that this class differs from java.net.URL in that this class just represents the name of a URL, it does not model the connection to a URL.

Field Summary

(package private) static int	caseDiff
(package private) static BitSet	dontNeedEncoding The class contains a utility method for converting a String into a MIME format called "x-www-form-urlencoded" format.
protected String	fullURL The full version of the URL

Constructor Summary

URLName(String url)
Construct a URLName from the string.

URLName(String protocol, String host, int port, String file, String username, String password)
Creates a URLName object from the specified protocol, host, port number, file, username, and password.

URLName(URL url)
Construct a URLName from a java.net.URL object.

Method Summary

(package private) static void	()
(package private) static void	()
(package private) static String	decode(String s) Decodes a "x-www-form-urlencoded" to a String.
(package private) static String	encode(String s) Translates a string into x-www-form-urlencoded format.
boolean	equals(Object obj) Compares two URLNames.
String	getFile() Returns the file name of this URLName.
String	getHost() Returns the host of this URLName.
String	getPassword() Returns the password of this URLName.
int	getPort() Returns the port number of this URLName.
String	getProtocol() Returns the protocol of this URLName.
String	getRef() Returns the reference of this URLName.
URL	getURL() Constructs a URL from the URLName.
String	getUsername() Returns the user name of this URLName.
int	hashCode() Compute the hash code for this URLName.
protected void	parseString(String url) Method which does all of the work of parsing the string.
String	toString() Constructs a string representation of this URLName.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

fullURL

protected String fullURL

The full version of the URL

dontNeedEncoding

static BitSet dontNeedEncoding

The class contains a utility method for converting a String into a MIME format called "x-www-form-urlencoded" format.

To convert a String, each character is examined in turn:

• The ASCII characters 'a' through 'z', 'A' through 'Z', '0' through '9', and ".", "-", "*", "_" remain the same.
• The space character ' ' is converted into a plus sign '+'.
• All other characters are converted into the 3-character string "%xy", where xy is the two-digit hexadecimal representation of the lower 8-bits of the character.

Since:

JDK1.0

caseDiff

static final int caseDiff

Constructor Detail

URLName

public URLName(String protocol,
               String host,
               int port,
               String file,
               String username,
               String password)

Creates a URLName object from the specified protocol, host, port number, file, username, and password. Specifying a port number of -1 indicates that the URL should use the default port for the protocol.

URLName

public URLName(URL url)

Construct a URLName from a java.net.URL object.

URLName

public URLName(String url)

Construct a URLName from the string. Parses out all the possible information (protocol, host, port, file, username, password).

Method Detail

static void ()

toString

public String toString()

Constructs a string representation of this URLName.

Overrides:

toString in class Object

parseString

protected void parseString(String url)

Method which does all of the work of parsing the string.

getPort

public int getPort()

Returns the port number of this URLName. Returns -1 if the port is not set.

getProtocol

public String getProtocol()

Returns the protocol of this URLName. Returns null if this URLName has no protocol.

getFile

public String getFile()

Returns the file name of this URLName. Returns null if this URLName has no file name.

getRef

public String getRef()

Returns the reference of this URLName. Returns null if this URLName has no reference.

getHost

public String getHost()

Returns the host of this URLName. Returns null if this URLName has no host.

getUsername

public String getUsername()

Returns the user name of this URLName. Returns null if this URLName has no user name.

getPassword

public String getPassword()

Returns the password of this URLName. Returns null if this URLName has no password.

getURL

public URL getURL()
           throws MalformedURLException

Constructs a URL from the URLName.

equals

public boolean equals(Object obj)

Compares two URLNames. The result is true if and only if the argument is not null and is a URLName object that represents the same URLName as this object. Two URLName objects are equal if they have the same protocol and reference the same host, the same port number on the host, the same username and password, and the same file on the host. The fields (host, username, password, file) are also considered the same if they are both null.

Overrides:

equals in class Object

hashCode

public int hashCode()

Compute the hash code for this URLName.

Overrides:

hashCode in class Object

static void ()

encode

static String encode(String s)

Translates a string into x-www-form-urlencoded format.

Parameters:

s - String to be translated.

Returns:

the translated String.

decode

static String decode(String s)

Decodes a "x-www-form-urlencoded" to a String.

Parameters:

s - the String to decode

Returns:

the newly decoded String