URL (Apache Tomcat 8.0.53 API Documentation)

java.lang.Object
- org.apache.tomcat.util.net.URL

All Implemented Interfaces:

java.io.Serializable

Deprecated.
Will be removed in Tomcat 8.5.x. Use URI or UriUtil.
```
@Deprecated
public final class URL
extends java.lang.Object
implements java.io.Serializable
```
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

See Also:
Serialized Form

Constructor Summary

Constructors
Constructor and Description
`URL(java.lang.String spec)` Deprecated. Create a URL object from the specified String representation.
`URL(URL context, java.lang.String spec)` Deprecated. Create a URL object by parsing a string representation relative to a specified context.

Method Summary

Methods
Modifier and Type	Method and Description
`boolean`	`equals(java.lang.Object obj)` Deprecated. Compare two URLs for equality.
`java.lang.String`	`getAuthority()` Deprecated. Return the authority part of the URL.
`java.lang.String`	`getFile()` Deprecated. Return the filename part of the URL.
`java.lang.String`	`getHost()` Deprecated. Return the host name part of the URL.
`java.lang.String`	`getPath()` Deprecated. Return the path part of the URL.
`int`	`getPort()` Deprecated. Return the port number part of the URL.
`java.lang.String`	`getProtocol()` Deprecated. Return the protocol name part of the URL.
`java.lang.String`	`getQuery()` Deprecated. Return the query part of the URL.
`java.lang.String`	`getRef()` Deprecated. Return the reference part of the URL.
`java.lang.String`	`getUserInfo()` Deprecated. Return the user info part of the URL.
`int`	`hashCode()` Deprecated.
`static boolean`	`isSchemeChar(char c)` Deprecated. Determine if the character is allowed in the scheme of a URI.
`void`	`normalize()` Deprecated. Normalize the `path` (and therefore `file`) portions of this URL.
`boolean`	`sameFile(URL other)` Deprecated. Compare two URLs, excluding the "ref" fields.
`java.lang.String`	`toString()` Deprecated. Return a string representation of this object.

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - URL
```
public URL(java.lang.String spec)
    throws java.net.MalformedURLException
```
    Deprecated.
    
    Create a URL object from the specified String representation.
    
    Parameters:
    spec - String representation of the URL
    
    Throws:
    
    java.net.MalformedURLException - if the string representation cannot be parsed successfully
  - URL
```
public URL(URL context,
   java.lang.String spec)
    throws java.net.MalformedURLException
```
    Deprecated.
    
    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 representation is resolved
    spec - String representation of the URL (usually relative)
    
    Throws:
    
    java.net.MalformedURLException - if the string representation cannot be parsed successfully
- Method Detail
  - equals
```
public boolean equals(java.lang.Object obj)
```
    Deprecated.
    
    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.
    
    Overrides:
    
    equals in class java.lang.Object
    
    Parameters:
    obj - The URL to compare against
  - hashCode
```
public int hashCode()
```
    Deprecated.
    
    Overrides:
    
    hashCode in class java.lang.Object
  - getAuthority
```
public java.lang.String getAuthority()
```
    Deprecated.
    
    Return the authority part of the URL.
  - getFile
```
public java.lang.String getFile()
```
    Deprecated.
    
    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 java.lang.String getHost()
```
    Deprecated.
    
    Return the host name part of the URL.
  - getPath
```
public java.lang.String getPath()
```
    Deprecated.
    
    Return the path part of the URL.
  - getPort
```
public int getPort()
```
    Deprecated.
    
    Return the port number part of the URL.
  - getProtocol
```
public java.lang.String getProtocol()
```
    Deprecated.
    
    Return the protocol name part of the URL.
  - getQuery
```
public java.lang.String getQuery()
```
    Deprecated.
    
    Return the query part of the URL.
  - getRef
```
public java.lang.String getRef()
```
    Deprecated.
    
    Return the reference part of the URL.
  - getUserInfo
```
public java.lang.String getUserInfo()
```
    Deprecated.
    
    Return the user info part of the URL.
  - normalize
```
public void normalize()
               throws java.net.MalformedURLException
```
    Deprecated.
    
    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.
    
    Throws:
    
    java.net.MalformedURLException - if a normalization error occurs, such as trying to move about the hierarchical root
  - sameFile
```
public boolean sameFile(URL other)
```
    Deprecated.
    
    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.
  - toString
```
public java.lang.String toString()
```
    Deprecated.
    
    Return a string representation of this object.
    
    Overrides:
    
    toString in class java.lang.Object
  - isSchemeChar
```
public static boolean isSchemeChar(char c)
```
    Deprecated.
    
    Determine if the character is allowed in the scheme of a URI. See RFC 2396, Section 3.1

Class URL

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Constructor Detail

URL

URL

Method Detail

equals

hashCode

getAuthority

getFile

getHost

getPath

getPort

getProtocol

getQuery

getRef

getUserInfo

normalize

sameFile

toString

isSchemeChar