| java.lang.Object
 org.apache.tomcat.util.net.URL
| URL | | final public class URL implements Serializable(Code) | | URL is designed to provide public APIs for parsing
and synthesizing Uniform Resource Locators as similar as possible to the
APIs of java.net.URL, but without the ability to open a
stream or connection. One of the consequences of this is that you can
construct URLs for protocols for which a URLStreamHandler is not
available (such as an "https" URL when JSSE is not installed).
WARNING - This class assumes that the string
representation of a URL conforms to the spec argument
as described in RFC 2396 "Uniform Resource Identifiers: Generic Syntax":
<scheme>//<authority><path>?<query>#<fragment>
FIXME - This class really ought to end up in a Commons
package someplace.
author:
Craig R. McClanahan
version:
$Revision: 1.7 $ $Date: 2004/02/24 08:50:05 $ |
| Constructor Summary | |
| public | URL(String spec)
Create a URL object from the specified String representation. | | public | URL(URL context, String spec)
Create a URL object by parsing a string representation relative
to a specified context. | | public | URL(String protocol, String host, String file)
Create a URL object from the specified components. | | public | URL(String protocol, String host, int port, String file)
Create a URL object from the specified components. |
| URL | | public URL(URL context, String spec) throws MalformedURLException(Code) | | Create a URL object by parsing a string representation relative
to a specified context. Based on logic from JDK 1.3.1's
java.net.URL.
Parameters:
context - URL against which the relative representationis resolved
Parameters:
spec - String representation of the URL (usually relative)
exception:
MalformedURLException - if the string representationcannot be parsed successfully |
| URL | | public URL(String protocol, String host, String file) throws MalformedURLException(Code) | | Create a URL object from the specified components. The default port
number for the specified protocol will be used.
Parameters:
protocol - Name of the protocol to use
Parameters:
host - Name of the host addressed by this protocol
Parameters:
file - Filename on the specified host
exception:
MalformedURLException - is never thrown, but present forcompatible APIs |
| URL | | public URL(String protocol, String host, int port, String file) throws MalformedURLException(Code) | | Create a URL object from the specified components. Specifying a port
number of -1 indicates that the URL should use the default port for
that protocol. Based on logic from JDK 1.3.1's
java.net.URL.
Parameters:
protocol - Name of the protocol to use
Parameters:
host - Name of the host addressed by this protocol
Parameters:
port - Port number, or -1 for the default port for this protocol
Parameters:
file - Filename on the specified host
exception:
MalformedURLException - is never thrown, but present forcompatible APIs |
| equals | | public boolean equals(Object obj)(Code) | | Compare two URLs for equality. The result is true if and
only if the argument is not null, and is a URL object
that represents the same URL as this object. Two
URLs are equal if they have the same protocol and
reference the same host, the same port number on the host,
and the same file and anchor on the host.
Parameters:
obj - The URL to compare against |
| getAuthority | | public String getAuthority()(Code) | | Return the authority part of the URL.
|
| getFile | | public String getFile()(Code) | | Return the filename part of the URL. NOTE - For
compatibility with java.net.URL, this value includes
the query string if there was one. For just the path portion,
call getPath() instead.
|
| getHost | | public String getHost()(Code) | | Return the host name part of the URL.
|
| getPath | | public String getPath()(Code) | | Return the path part of the URL.
|
| getPort | | public int getPort()(Code) | | Return the port number part of the URL.
|
| getProtocol | | public String getProtocol()(Code) | | Return the protocol name part of the URL.
|
| getQuery | | public String getQuery()(Code) | | Return the query part of the URL.
|
| getRef | | public String getRef()(Code) | | Return the reference part of the URL.
|
| getUserInfo | | public String getUserInfo()(Code) | | Return the user info part of the URL.
|
| normalize | | public void normalize() throws MalformedURLException(Code) | | Normalize the path (and therefore file)
portions of this URL.
NOTE - This method is not part of the public API
of java.net.URL, but is provided as a value added
service of this implementation.
exception:
MalformedURLException - if a normalization error occurs,such as trying to move about the hierarchical root |
| sameFile | | public boolean sameFile(URL other)(Code) | | Compare two URLs, excluding the "ref" fields. Returns true
if this URL and the other argument both refer
to the same resource. The two URLs might not both contain
the same anchor.
|
| toExternalForm | | public String toExternalForm()(Code) | | Return a string representation of this URL. This follow the rules in
RFC 2396, Section 5.2, Step 7.
|
| toString | | public String toString()(Code) | | Return a string representation of this object.
|
|
|