URLStreamHandler is the common
+ * The abstract class {@code URLStreamHandler} is the common
* superclass for all stream protocol handlers. A stream protocol
* handler knows how to make a connection for a particular protocol
- * type, such as http or https.
+ * type, such as {@code http} or {@code https}.
*
- * In most cases, an instance of a URLStreamHandler
+ * In most cases, an instance of a {@code URLStreamHandler}
* subclass is not created directly by an application. Rather, the
* first time a protocol name is encountered when constructing a
- * URL, the appropriate stream protocol handler is
+ * {@code URL}, the appropriate stream protocol handler is
* automatically loaded.
*
* @author James Gosling
@@ -52,7 +52,7 @@
public abstract class URLStreamHandler {
/**
* Opens a connection to the object referenced by the
- * URL argument.
+ * {@code URL} argument.
* This method should be overridden by a subclass.
*
*
If for the handler's protocol (such as HTTP or JAR), there
@@ -64,7 +64,7 @@
* JarURLConnection will be returned.
*
* @param u the URL that this connects to.
- * @return a URLConnection object for the URL.
+ * @return a {@code URLConnection} object for the {@code URL}.
* @exception IOException if an I/O error occurs while opening the
* connection.
*/
@@ -83,7 +83,7 @@
* @param p the proxy through which the connection will be made.
* If direct connection is desired, Proxy.NO_PROXY
* should be specified.
- * @return a URLConnection object for the URL.
+ * @return a {@code URLConnection} object for the {@code URL}.
* @exception IOException if an I/O error occurs while opening the
* connection.
* @exception IllegalArgumentException if either u or p is null,
@@ -97,28 +97,28 @@
}
/**
- * Parses the string representation of a URL into a
- * URL object.
+ * Parses the string representation of a {@code URL} into a
+ * {@code URL} object.
*
* If there is any inherited context, then it has already been
- * copied into the URL argument.
+ * copied into the {@code URL} argument.
*
- * The parseURL method of URLStreamHandler
+ * The {@code parseURL} method of {@code URLStreamHandler}
* parses the string representation as if it were an
- * http specification. Most URL protocol families have a
+ * {@code 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 u the URL to receive the result of parsing
+ * @param u the {@code URL} to receive the result of parsing
* the spec.
- * @param spec the String representing the URL that
+ * @param spec the {@code String} representing the URL that
* must be parsed.
* @param start the character index at which to begin parsing. This is
- * just past the ':' (if there is one) that
+ * just past the '{@code :}' (if there is one) that
* specifies the determination of the protocol name.
* @param limit the character position to stop parsing at. This is the
* end of the string or the position of the
- * "#" character, if present. All information
+ * "{@code #}" character, if present. All information
* after the sharp sign indicates an anchor.
*/
protected void parseURL(URL u, String spec, int start, int limit) {
@@ -307,7 +307,7 @@
/**
* Returns the default port for a URL parsed by this handler. This method
* is meant to be overidden by handlers with default port numbers.
- * @return the default port for a URL parsed by this handler.
+ * @return the default port for a {@code URL} parsed by this handler.
* @since 1.3
*/
protected int getDefaultPort() {
@@ -321,7 +321,7 @@
* guaranteed by the fact that it is only called by java.net.URL class.
* @param u1 a URL object
* @param u2 a URL object
- * @return true if the two urls are
+ * @return {@code true} if the two urls are
* considered equal, ie. they refer to the same
* fragment in the same file.
* @since 1.3
@@ -338,7 +338,7 @@
* other protocols that have different requirements for hashCode
* calculation.
* @param u a URL object
- * @return an int suitable for hash table indexing
+ * @return an {@code int} suitable for hash table indexing
* @since 1.3
*/
protected int hashCode(URL u) {
@@ -420,7 +420,7 @@
* will result in a null return.
*
* @param u a URL object
- * @return an InetAddress representing the host
+ * @return an {@code InetAddress} representing the host
* IP address.
* @since 1.3
*/
@@ -447,8 +447,8 @@
* Compares the host components of two URLs.
* @param u1 the URL of the first host to compare
* @param u2 the URL of the second host to compare
- * @return true if and only if they
- * are equal, false otherwise.
+ * @return {@code true} if and only if they
+ * are equal, {@code false} otherwise.
* @since 1.3
*/
protected boolean hostsEqual(URL u1, URL u2) {
@@ -465,11 +465,11 @@
}
/**
- * Converts a URL of a specific protocol to a
- * String.
+ * Converts a {@code URL} of a specific protocol to a
+ * {@code String}.
*
* @param u the URL.
- * @return a string representation of the URL argument.
+ * @return a string representation of the {@code URL} argument.
*/
protected String toExternalForm(URL u) {
@@ -508,7 +508,7 @@
}
/**
- * Sets the fields of the URL argument to the indicated values.
+ * Sets the fields of the {@code URL} argument to the indicated values.
* Only classes derived from URLStreamHandler are able
* to use this method to set the values of the URL fields.
*
@@ -538,7 +538,7 @@
}
/**
- * Sets the fields of the URL argument to the indicated values.
+ * Sets the fields of the {@code URL} argument to the indicated values.
* Only classes derived from URLStreamHandler are able
* to use this method to set the values of the URL fields.
*