java.net.URL Maven / Gradle / Ivy
package java.net;
import java.io.IOException;
import java.io.InputStream;
import java.util.Objects;
/**
* A stripped-down URL suitable for use in GWT client-side.
*
* It could do with a lot more trimming, and use of native js encodeURIComponent.
*
*
* Any volunteers with some existing unit tests who'd like to improve client side URL performance?
*
*
*/
@SuppressWarnings("checkstyle:abbreviationaswordinname")
public final class URL implements java.io.Serializable {
static final long serialVersionUID = -7627629688361524110L;
/**
* The protocol to use (ftp, http, nntp, ... etc.) .
*
* @serial
*/
private String protocol;
/**
* The host name to connect to.
*
* @serial
*/
private String host;
/**
* The protocol port to connect to.
*
* @serial
*/
private int port = -1;
/**
* The specified file name on that host. file is defined as path[?query]
*
* @serial
*/
private String file;
/**
* The query part of this URL.
*/
private transient String query;
/**
* The authority part of this URL.
*
* @serial
*/
private String authority;
/**
* The path part of this URL.
*/
private String path;
/**
* The userinfo part of this URL.
*/
private String userInfo;
/**
* # reference.
*
* @serial
*/
private String ref;
/*
* Our hash code.
*
* @serial
*/
private int hashCodeValue = -1;
/**
* Creates a URL object from the String representation.
*
*
* This constructor is equivalent to a call to the two-argument constructor with a
* null first argument.
*
*
* @param spec the String to parse as a URL.
* @exception MalformedURLException If the string specifies an unknown protocol.
* @see java.net.URL#URL(java.net.URL, java.lang.String)
*/
public URL(final String spec) throws MalformedURLException {
this(null, spec);
}
/**
* Creates a URL by parsing the given spec within a specified context. The new URL is created from
* the given context URL and the spec argument as described in RFC2396 "Uniform Resource
* Identifiers : Generic * Syntax" :
*
*
* <scheme>://<authority><path>?<query>#<fragment>
*
*
*
The reference is parsed into the scheme, authority, path, query and fragment
* parts. If the path component is empty and the scheme, authority, and query components are
* undefined, then the new URL is a reference to the current document. Otherwise, the fragment and
* query parts present in the spec are used in the new URL.
*
* If the scheme component is defined in the given spec and does not match the scheme of the
* context, then the new URL is created as an absolute URL based on the spec alone. Otherwise the
* scheme component is inherited from the context URL.
*
*
* If the authority component is present in the spec then the spec is treated as absolute and the
* spec authority and path will replace the context authority and path. If the authority component
* is absent in the spec then the authority of the new URL will be inherited from the context.
*
*
* If the spec's path component begins with a slash character "/" then the path is
* treated as absolute and the spec path replaces the context path.
*
*
* Otherwise, the path is treated as a relative path and is appended to the context path, as
* described in RFC2396. Also, in this case, the path is canonicalized through the removal of
* directory changes made by occurences of ".." and ".".
*
*
* For a more detailed description of URL parsing, refer to RFC2396.
*
*
* @param context the context in which to parse the specification.
* @param spec the String to parse as a URL.
* @exception MalformedURLException if no protocol is specified, or an unknown protocol is found.
* @see java.net.URL#URL(java.lang.String, java.lang.String, int, java.lang.String)
* @see java.net.URLStreamHandler
* @see java.net.URLStreamHandler#parseURL(java.net.URL, java.lang.String, int, int)
*/
public URL(final URL context, final String spec) throws MalformedURLException {
final String original = spec;
int index;
int limit;
int character;
int start = 0;
String newProtocol = null;
boolean aref = false;
boolean isRelative = false;
try {
limit = spec.length();
while (limit > 0 && spec.charAt(limit - 1) <= ' ') {
limit--; // eliminate trailing whitespace
}
while (start < limit && spec.charAt(start) <= ' ') {
start++; // eliminate leading whitespace
}
if (spec.regionMatches(true, start, "url:", 0, 4)) {
start += 4;
}
if (start < spec.length() && spec.charAt(start) == '#') {
/*
* we're assuming this is a ref relative to the context URL. This means protocols cannot
* start w/ '#', but we must parse ref URL's like: "hello:there" w/ a ':' in them.
*/
aref = true;
}
for (index = start; !aref && index < limit // NOPMD
&& (character = spec.charAt(index)) != '/'; index++) {
if (character == ':') {
final String s = spec.substring(start, index).toLowerCase();
if (isValidProtocol(s)) {
newProtocol = s;
start = index + 1;
}
break;
}
}
// Only use our context if the protocols match.
protocol = newProtocol;
if (context != null && context.protocol != null
&& context.protocol.equalsIgnoreCase(newProtocol)) {
// inherit the protocol handler from the context
// if not specified to the constructor
// If the context is a hierarchical URL scheme and the spec
// contains a matching scheme then maintain backwards
// compatibility and treat it as if the spec didn't contain
// the scheme; see 5.2.3 of RFC2396
if (context.path != null && context.path.startsWith("/")) {
newProtocol = null;
}
if (newProtocol == null) {
protocol = context.protocol;
authority = context.authority;
userInfo = context.userInfo;
host = context.host;
port = context.port;
file = context.file;
path = context.path;
isRelative = true;
}
}
if (protocol == null) {
throw new MalformedURLException("no protocol: " + original);
}
index = spec.indexOf('#', start);
if (index >= 0) {
ref = spec.substring(index + 1, limit);
limit = index;
}
/* Handle special case inheritance of query and fragment implied by RFC2396 section 5.2.2. */
if (isRelative && start == limit) {
query = context.query;
if (ref == null) {
ref = context.ref;
}
}
parseURL(this, spec, start, limit);
} catch (final MalformedURLException e) { // NOPMD
throw e;
} catch (final Exception e) {
throw new MalformedURLException(e.getMessage()); // NOPMD
}
}
/**
* Parses the string representation of a URL into a URL object.
*
* If there is any inherited context, then it has already been copied into the URL
* argument.
*
*
* The parseURL method of URLStreamHandler parses the string
* representation as if it were an http specification. Most URL protocol families
* have a similar parsing. A stream protocol handler for a protocol that has a different syntax
* must override this routine.
*
*
* @param purl the URL to receive the result of parsing the spec.
* @param pspec the String representing the URL that must be parsed.
* @param pstart the character index at which to begin parsing. This is just past the '
* :' (if there is one) that specifies the determination of the protocol name.
* @param plimit the character position to stop parsing at. This is the end of the string or the
* position of the "#" character, if present. All information after the sharp
* sign indicates an anchor.
*/
protected void parseURL(final URL purl, final String pspec, final int pstart, final int plimit) {
// These fields may receive context content if this was relative URL
final String protocol = purl.getProtocol();
String authority = purl.getAuthority();
String userInfo = purl.getUserInfo();
String host = purl.getHost();
int port = purl.getPort();
String path = purl.getPath();
String query = purl.getQuery();
String spec = pspec;
int start = pstart;
int limit = plimit;
// This field has already been parsed
final String ref = purl.getRef();
boolean isRelPath = false;
boolean queryOnly = false;
// FIX: should not assume query if opaque
// Strip off the query part
if (start < limit) {
final int queryStart = spec.indexOf('?');
queryOnly = queryStart == start;
if (queryStart != -1 && queryStart < limit) {
query = spec.substring(queryStart + 1, limit);
if (limit > queryStart) {
limit = queryStart;
}
spec = spec.substring(0, queryStart);
}
}
int indexI = 0;
// Parse the authority part if any
final boolean isUncName =
start <= limit - 4 && spec.charAt(start) == '/' && spec.charAt(start + 1) == '/'
&& spec.charAt(start + 2) == '/' && spec.charAt(start + 3) == '/';
if (!isUncName && start <= limit - 2 && spec.charAt(start) == '/'
&& spec.charAt(start + 1) == '/') {
start += 2;
indexI = spec.indexOf('/', start);
if (indexI < 0) {
indexI = spec.indexOf('?', start);
if (indexI < 0) {
indexI = limit;
}
}
host = authority = spec.substring(start, indexI);
int ind = authority.indexOf('@');
if (ind == -1) {
userInfo = null;
} else {
userInfo = authority.substring(0, ind);
host = authority.substring(ind + 1);
}
if (host == null) {
host = "";
} else {
// If the host is surrounded by [ and ] then its an IPv6
// literal address as specified in RFC2732
if (host.length() > 0 && host.charAt(0) == '[') {
if ((ind = host.indexOf(']')) > 2) { // NOPMD
final String nhost = host;
host = nhost.substring(0, ind + 1);
if (!isIPv6LiteralAddress(host.substring(1, ind))) {
throw new IllegalArgumentException("Invalid host: " + host);
}
port = -1;
if (nhost.length() > ind + 1) {
if (nhost.charAt(ind + 1) == ':') {
++ind;
// port can be null according to RFC2396
if (nhost.length() > ind + 1) {
port = Integer.parseInt(nhost.substring(ind + 1));
}
} else {
throw new IllegalArgumentException("Invalid authority field: " + authority);
}
}
} else {
throw new IllegalArgumentException("Invalid authority field: " + authority);
}
} else {
ind = host.indexOf(':');
port = -1;
if (ind >= 0) {
// port can be null according to RFC2396
if (host.length() > ind + 1) {
port = Integer.parseInt(host.substring(ind + 1));
}
host = host.substring(0, ind);
}
}
}
if (port < -1) {
throw new IllegalArgumentException("Invalid port number :" + port);
}
start = indexI;
// If the authority is defined then the path is defined by the
// spec only; See RFC 2396 Section 5.2.4.
if (authority != null && authority.length() > 0) {
path = "";
}
}
if (host == null) {
host = "";
}
// Parse the file path if any
if (start < limit) {
if (spec.charAt(start) == '/') {
path = spec.substring(start, limit);
} else if (path != null && path.length() > 0) {
isRelPath = true;
final int ind = path.lastIndexOf('/');
String seperator = "";
if (ind == -1 && authority != null) {
seperator = "/";
}
path = path.substring(0, ind + 1) + seperator + spec.substring(start, limit);
} else {
final String seperator = authority == null ? "" : "/";
path = seperator + spec.substring(start, limit);
}
} else if (queryOnly && path != null) {
int ind = path.lastIndexOf('/');
if (ind < 0) {
ind = 0;
}
path = path.substring(0, ind) + "/";
}
if (path == null) {
path = "";
}
if (isRelPath) {
// Remove embedded /./
while ((indexI = path.indexOf("/./")) >= 0) { // NOPMD
path = path.substring(0, indexI) + path.substring(indexI + 2);
}
// Remove embedded /../ if possible
indexI = 0;
while ((indexI = path.indexOf("/../", indexI)) >= 0) { // NOPMD
/*
* A "/../" will cancel the previous segment and itself, unless that segment is a "/../"
* itself i.e. "/a/b/../c" becomes "/a/c" but "/../../a" should stay unchanged
*/
limit = path.lastIndexOf('/', indexI - 1);
if (indexI > 0 && limit >= 0 && path.indexOf("/../", limit) != 0) {
path = path.substring(0, limit) + path.substring(indexI + 3);
indexI = 0;
} else {
indexI = indexI + 3;
}
}
// Remove trailing .. if possible
while (path.endsWith("/..")) {
indexI = path.indexOf("/..");
limit = path.lastIndexOf('/', indexI - 1);
if (limit >= 0) {
path = path.substring(0, limit + 1);
} else {
break;
}
}
// Remove starting .
if (path.startsWith("./") && path.length() > 2) {
path = path.substring(2);
}
// Remove trailing .
if (path.endsWith("/.")) {
path = path.substring(0, path.length() - 1);
}
}
purl.set(protocol, host, port, authority, userInfo, path, query, ref);
}
private static final int INADDR4SZ = 4;
private static final int INADDR16SZ = 16;
private static final int INT16SZ = 2;
private boolean isIPv6LiteralAddress(final String src) {
// Shortest valid string is "::", hence at least 2 chars
if (src.length() < 2) {
return false;
}
int colonp;
char ch;
final char[] srcb = src.toCharArray();
final byte[] dst = new byte[INADDR16SZ];
int srcbLength = srcb.length;
final int pc = src.indexOf('%');
if (pc == srcbLength - 1) {
return false;
}
if (pc != -1) {
srcbLength = pc;
}
colonp = -1;
int indexI = 0;
int indexJ = 0;
/* Leading :: requires some special handling. */
if (srcb[indexI] == ':') {
if (srcb[++indexI] != ':') { // NOPMD
return false;
}
}
int curtok = indexI;
boolean sawXdigit = false;
int val = 0;
while (indexI < srcbLength) {
ch = srcb[indexI++];
final int chval = Character.digit(ch, 16);
if (chval != -1) {
val <<= 4;
val |= chval;
if (val > 0xffff) {
return false;
}
sawXdigit = true;
continue;
}
if (ch == ':') {
curtok = indexI;
if (!sawXdigit) { // NOPMD
if (colonp != -1) {
return false;
}
colonp = indexJ;
continue;
} else if (indexI == srcbLength) {
return false;
}
if (indexJ + INT16SZ > INADDR16SZ) {
return false;
}
dst[indexJ++] = (byte) (val >> 8 & 0xff);
dst[indexJ++] = (byte) (val & 0xff);
sawXdigit = false;
val = 0;
continue;
}
if (ch == '.' && indexJ + INADDR4SZ <= INADDR16SZ) {
final String ia4 = src.substring(curtok, srcbLength);
/* check this IPv4 address has 3 dots, ie. A.B.C.D */
int dotCount = 0;
int index = 0;
while ((index = ia4.indexOf('.', index)) != -1) { // NOPMD
dotCount++;
index++;
}
if (dotCount != 3) {
return false;
}
final byte[] v4addr = textToNumericFormatV4(ia4);
if (v4addr == null) {
return false;
}
for (int k = 0; k < INADDR4SZ; k++) {
dst[indexJ++] = v4addr[k];
}
sawXdigit = false;
break; /* '\0' was seen by inet_pton4(). */
}
return false; // NOPMD
}
if (sawXdigit) {
if (indexJ + INT16SZ > INADDR16SZ) {
return false;
}
dst[indexJ++] = (byte) (val >> 8 & 0xff);
dst[indexJ++] = (byte) (val & 0xff);
}
if (colonp != -1) {
final int n = indexJ - colonp;
if (indexJ == INADDR16SZ) {
return false;
}
for (indexI = 1; indexI <= n; indexI++) {
dst[INADDR16SZ - indexI] = dst[colonp + n - indexI];
dst[colonp + n - indexI] = 0;
}
indexJ = INADDR16SZ;
}
if (indexJ != INADDR16SZ) {
return false;
}
final byte[] newdst = convertFromIPv4MappedAddress(dst);
if (newdst == null) {
return dst != null;
}
return true;
}
/**
* Convert IPv4-Mapped address to IPv4 address. Both input and returned value are in network order
* binary form.
*
* @param src a string representing an IPv4-Mapped address in textual format
*
* @return a byte array representing the IPv4 numeric address
*/
public static byte[] textToNumericFormatV4(final String src) {
if (src.length() == 0) {
return null;
}
final byte[] res = new byte[INADDR4SZ];
final String[] s = src.split("\\.", -1);
long val;
try {
switch (s.length) {
case 1:
/*
* When only one part is given, the value is stored directly in the network address
* without any byte rearrangement.
*/
val = Long.parseLong(s[0]);
if (val < 0 || val > 0xffffffffL) {
return null;
}
res[0] = (byte) (val >> 24 & 0xff);
res[1] = (byte) ((val & 0xffffff) >> 16 & 0xff);
res[2] = (byte) ((val & 0xffff) >> 8 & 0xff);
res[3] = (byte) (val & 0xff);
break;
case 2:
/*
* When a two part address is supplied, the last part is interpreted as a 24-bit quantity
* and placed in the right most three bytes of the network address. This makes the two
* part address format convenient for specifying Class A network addresses as net.host.
*/
val = Integer.parseInt(s[0]);
if (val < 0 || val > 0xff) {
return null;
}
res[0] = (byte) (val & 0xff);
val = Integer.parseInt(s[1]);
if (val < 0 || val > 0xffffff) {
return null;
}
res[1] = (byte) (val >> 16 & 0xff);
res[2] = (byte) ((val & 0xffff) >> 8 & 0xff);
res[3] = (byte) (val & 0xff);
break;
case 3:
/*
* When a three part address is specified, the last part is interpreted as a 16-bit
* quantity and placed in the right most two bytes of the network address. This makes the
* three part address format convenient for specifying Class B net- work addresses as
* 128.net.host.
*/
for (int i = 0; i < 2; i++) {
val = Integer.parseInt(s[i]);
if (val < 0 || val > 0xff) {
return null;
}
res[i] = (byte) (val & 0xff);
}
val = Integer.parseInt(s[2]);
if (val < 0 || val > 0xffff) {
return null;
}
res[2] = (byte) (val >> 8 & 0xff);
res[3] = (byte) (val & 0xff);
break;
case 4:
/*
* When four parts are specified, each is interpreted as a byte of data and assigned, from
* left to right, to the four bytes of an IPv4 address.
*/
for (int i = 0; i < 4; i++) {
val = Integer.parseInt(s[i]);
if (val < 0 || val > 0xff) {
return null;
}
res[i] = (byte) (val & 0xff);
}
break;
default:
return null;
}
} catch (final NumberFormatException e) {
return null;
}
return res;
}
/**
* Convert IPv4-Mapped address to IPv4 address. Both input and returned value are in network order
* binary form.
*
* @param addr a representing an IPv4-Mapped address in textual format
*
* @return a byte array representing the IPv4 numeric address
*/
public static byte[] convertFromIPv4MappedAddress(final byte[] addr) { // NOPMD
if (isIPv4MappedAddress(addr)) {
final byte[] newAddr = new byte[INADDR4SZ];
System.arraycopy(addr, 12, newAddr, 0, INADDR4SZ);
return newAddr;
}
return null;
}
/**
* Utility routine to check if the InetAddress is an IPv4 mapped IPv6 address.
*
* @return a boolean indicating if the InetAddress is an IPv4 mapped IPv6 address; or
* false if address is IPv4 address.
*/
private static boolean isIPv4MappedAddress(final byte[] addr) {
if (addr.length < INADDR16SZ) {
return false;
}
return addr[0] == 0x00 && addr[1] == 0x00 && addr[2] == 0x00 && addr[3] == 0x00
&& addr[4] == 0x00 && addr[5] == 0x00 && addr[6] == 0x00 && addr[7] == 0x00
&& addr[8] == 0x00 && addr[9] == 0x00 && addr[10] == (byte) 0xff && addr[11] == (byte) 0xff;
}
/* Returns true if specified string is a valid protocol name. */
private boolean isValidProtocol(final String protocol) {
final int len = protocol.length();
if (len < 1) {
return false;
}
char character = protocol.charAt(0);
if (!Character.isLetter(character)) {
return false;
}
for (int i = 1; i < len; i++) {
character = protocol.charAt(i);
if (!Character.isLetterOrDigit(character) && character != '.' && character != '+'
&& character != '-') {
return false;
}
}
return true;
}
/**
* Sets the fields of the URL. This is not a public method so that only URLStreamHandlers can
* modify URL fields. URLs are otherwise constant.
*
* @param protocol the name of the protocol to use
* @param host the name of the host
* @param port the port number on the host
* @param file the file on the host
* @param ref the internal reference in the URL
*/
protected void set(final String protocol, final String host, final int port, final String file,
final String ref) {
this.protocol = protocol;
this.host = host;
authority = port == -1 ? host : host + ":" + port;
this.port = port;
this.file = file;
this.ref = ref;
/*
* This is very important. We must recompute this after the URL has been changed.
*/
hashCodeValue = -1;
final int q = file.lastIndexOf('?');
if (q == -1) {
path = file;
} else {
query = file.substring(q + 1);
path = file.substring(0, q);
}
}
/**
* Sets the specified 8 fields of the URL. This is not a public method so that only
* URLStreamHandlers can modify URL fields. URLs are otherwise constant.
*
* @param protocol the name of the protocol to use
* @param host the name of the host
* @param port the port number on the host
* @param authority the authority part for the url
* @param userInfo the username and password
* @param path the file on the host
* @param ref the internal reference in the URL
* @param query the query part of this URL
* @since 1.3
*/
protected void set(final String protocol, final String host, final int port,
final String authority, final String userInfo, final String path, final String query,
final String ref) {
this.protocol = protocol;
this.host = host;
this.port = port;
file = query == null ? path : path + "?" + query;
this.userInfo = userInfo;
this.path = path;
this.ref = ref;
/*
* This is very important. We must recompute this after the URL has been changed.
*/
hashCodeValue = -1;
this.query = query;
this.authority = authority;
}
/**
* Gets the query part of this URL.
*
* @return the query part of this URL, or null if one does not exist
* @since 1.3
*/
public String getQuery() {
return query;
}
/**
* Gets the path part of this URL.
*
* @return the path part of this URL, or an empty string if one does not exist
* @since 1.3
*/
public String getPath() {
return path;
}
/**
* Gets the userInfo part of this URL.
*
* @return the userInfo part of this URL, or null if one does not exist
* @since 1.3
*/
public String getUserInfo() {
return userInfo;
}
/**
* Gets the authority part of this URL.
*
* @return the authority part of this URL
* @since 1.3
*/
public String getAuthority() {
return authority;
}
/**
* Gets the port number of this URL.
*
* @return the port number, or -1 if the port is not set
*/
public int getPort() {
return port;
}
/**
* Gets the default port number of the protocol associated with this URL. If the URL
* scheme or the URLStreamHandler for the URL do not define a default port number, then -1 is
* returned.
*
* @return the port number
* @since 1.4
*/
public int getDefaultPort() {
return -1;
}
/**
* Gets the protocol name of this URL.
*
* @return the protocol of this URL.
*/
public String getProtocol() {
return protocol;
}
/**
* Gets the host name of this URL, if applicable. The format of the host conforms to
* RFC 2732, i.e. for a literal IPv6 address, this method will return the IPv6 address enclosed in
* square brackets ( '[' and ']').
*
* @return the host name of this URL.
*/
public String getHost() {
return host;
}
/**
* Gets the file name of this URL. The returned file portion will be the same as
* getPath(), plus the concatenation of the value of getQuery(), if any.
* If there is no query portion, this method and getPath() will return identical
* results.
*
* @return the file name of this URL, or an empty string if one does not exist
*/
public String getFile() {
return file;
}
/**
* Gets the anchor (also known as the "reference") of this URL.
*
* @return the anchor (also known as the "reference") of this URL, or
* null if one does not exist
*/
public String getRef() {
return ref;
}
/**
* Compares this URL for equality with another object.
*
*
* If the given object is not a URL then this method immediately returns false.
*
*
*
* Two URL objects are equal if they have the same protocol, reference equivalent hosts, have the
* same port number on the host, and the same file and fragment of the file.
*
*
*
* Two hosts are considered equivalent if both host names can be resolved into the same IP
* addresses; else if either host name can't be resolved, the host names must be equal without
* regard to case; or both host names equal to null.
*
*
*
* Since hosts comparison requires name resolution, this operation is a blocking operation.
*
*
*
* Note: The defined behavior for equals is known to be inconsistent with virtual
* hosting in HTTP.
*
*
* @param obj the URL to compare against.
* @return true if the objects are the same; false otherwise.
*/
@Override
public boolean equals(final Object obj) {
if (!(obj instanceof URL)) {
return false;
}
final URL u2 = (URL) obj;
return Objects.equals(getRef(), u2.getRef()) && sameFile(this, u2);
}
private boolean sameFile(final URL u1, final URL u2) {
if (u1 == null) {
return u2 == null;
}
if (u2 == null) {
return u1 == null;
}
return equalsIgnoreCase(u1.getProtocol(), u2.getProtocol())
&& equalsIgnoreCase(u1.getFile(), u2.getFile()) && u1.getPort() == u2.getPort()
&& equalsIgnoreCase(u1.getHost(), u2.getHost());
}
private boolean equalsIgnoreCase(final String cs1, final String cs2) {
if (cs1 == cs2) {
return true;
}
if (cs1 == null || cs2 == null) {
return false;
}
if (cs1.length() != cs2.length()) {
return false;
}
return cs1.equalsIgnoreCase(cs2);
}
/**
* Creates an integer suitable for hash table indexing.
*
*
* The hash code is based upon all the URL components relevant for URL comparison. As such, this
* operation is a blocking operation.
*
*
* @return a hash code for this URL.
*/
@Override
public int hashCode() {
if (hashCodeValue != -1) {
return hashCodeValue;
}
hashCodeValue = Objects.hash(getProtocol(), getHost() == null ? null : getHost().toLowerCase(),
getFile(), getRef());
return hashCodeValue;
}
public InputStream openStream() {
throw new RuntimeException(
new NoSuchMethodException("You may not call URL.openStream() in compiled gwt code"));
}
/**
* Constructs a string representation of this URL. The string is created by calling
* the toExternalForm method of the stream protocol handler for this object.
*
* @return a string representation of this object.
* @see java.net.URL#URL(java.lang.String, java.lang.String, int, java.lang.String)
* @see java.net.URLStreamHandler#toExternalForm(java.net.URL)
*/
@Override
public String toString() {
return toExternalForm();
}
/**
* Constructs a string representation of this URL. The string is created by calling
* the toExternalForm method of the stream protocol handler for this object.
*
* @return a string representation of this object.
* @see java.net.URL#URL(java.lang.String, java.lang.String, int, java.lang.String)
* @see java.net.URLStreamHandler#toExternalForm(java.net.URL)
*/
public String toExternalForm() {
// pre-compute length of StringBuffer
int len = getProtocol().length() + 1;
if (getAuthority() != null && getAuthority().length() > 0) {
len += 2 + getAuthority().length();
}
if (getPath() != null) {
len += getPath().length();
}
if (getQuery() != null) {
len += 1 + getQuery().length();
}
if (getRef() != null) {
len += 1 + getRef().length();
}
final StringBuffer result = new StringBuffer(len);
result.append(getProtocol());
result.append(':');
if (getAuthority() != null && getAuthority().length() > 0) {
result.append("//");
result.append(getAuthority());
}
if (getPath() != null) {
result.append(getPath());
}
if (getQuery() != null) {
result.append('?');
result.append(getQuery());
}
if (getRef() != null) {
result.append('#');
result.append(getRef());
}
return result.toString();
}
// TODO(james) support URI as well...
/**
* Returns a {@link java.net.URI} equivalent to this URL. This method functions in the same way as
* new URI (this.toString()).
*
*
* Note, any URL instance that complies with RFC 2396 can be converted to a URI. However, some
* URLs that are not strictly in compliance can not be converted to a URI.
*
*
* @exception URISyntaxException if this URL is not formatted strictly according to to RFC2396 and
* cannot be converted to a URI.
* @return a URI instance equivalent to this URL.
* @since 1.5
*/
// public URI toURI() throws URISyntaxException {
// return new URI (toString());
// }
public URLConnection openConnection() throws IOException {
throw new UnsupportedOperationException();
}
class Parts {
String path;
String query;
String ref;
Parts(final String pfile) {
final int ind = pfile.indexOf('#');
ref = ind < 0 ? null : pfile.substring(ind + 1);
final String file = ind < 0 ? pfile : pfile.substring(0, ind);
final int q = file.lastIndexOf('?');
if (q == -1) {
path = file;
} else {
query = file.substring(q + 1);
path = file.substring(0, q);
}
}
String getPath() {
return path;
}
String getQuery() {
return query;
}
String getRef() {
return ref;
}
}
}