- 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.- Author:
- Christopher Cotton, Bill Shannon
-
-
Field Summary
Fields Modifier and Type Field and Description protected String
fullURL
The full version of the URL
-
Constructor Summary
Constructors Constructor and Description 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
All Methods Instance Methods Concrete Methods Modifier and Type Method and Description 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.
-
-
-
Field Detail
-
fullURL
protected String fullURL
The full version of the URL
-
-
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
-
toString
public String toString()
Constructs a string representation of this URLName.
-
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.- Throws:
MalformedURLException
-
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 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.
-
-
Document created the 11/06/2005, last modified the 18/08/2025
Source of the printed document:https://www.gaudry.be/en/java-api-javaee-rf-javax/mail/URLName.html
The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.
References
These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author of this site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.