Field Detail

• fullURL

  protected java.lang.String fullURL

  The full version of the URL

Constructor Detail

• URLName

  public URLName(java.lang.String protocol,
                 java.lang.String host,
                 int port,
                 java.lang.String file,
                 java.lang.String username,
                 java.lang.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.

  Parameters:

  protocol - the protocol

  host - the host name

  port - the port number

  file - the file

  username - the user name

  password - the password

• URLName

  public URLName(java.net.URL url)

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

  Parameters:

  url - the URL

• URLName

  public URLName(java.lang.String url)

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

  Parameters:

  url - the URL string

Method Detail

• toString

  public java.lang.String toString()

  Constructs a string representation of this URLName.

  Overrides:

  toString in class java.lang.Object

• parseString

  protected void parseString(java.lang.String url)

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

  Parameters:

  url - the URL string to parse

• getPort

  public int getPort()

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

  Returns:

  the port number

• getProtocol

  public java.lang.String getProtocol()

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

  Returns:

  the protocol

• getFile

  public java.lang.String getFile()

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

  Returns:

  the file name of this URLName

• getRef

  public java.lang.String getRef()

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

  Returns:

  the reference part of the URLName

• getHost

  public java.lang.String getHost()

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

  Returns:

  the host name

• getUsername

  public java.lang.String getUsername()

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

  Returns:

  the user name

• getPassword

  public java.lang.String getPassword()

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

  Returns:

  the password

• getURL

  public java.net.URL getURL()
                      throws java.net.MalformedURLException

  Constructs a URL from the URLName.

  Returns:

  the URL

  Throws:

  java.net.MalformedURLException - if the URL is malformed

• equals

  public boolean equals(java.lang.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 the same host, the same port number on the host, the same username, and the same file on the host. The fields (host, username, file) are also considered the same if they are both null.

  Hosts are considered equal if the names are equal (case independent) or if host name lookups for them both succeed and they both reference the same IP address.

  Note that URLName has no knowledge of default port numbers for particular protocols, so "imap://host" and "imap://host:143" would not compare as equal.

  Note also that the password field is not included in the comparison, nor is any reference field appended to the filename.

  Overrides:

  equals in class java.lang.Object

• hashCode

  public int hashCode()

  Compute the hash code for this URLName.

  Overrides:

  hashCode in class java.lang.Object