jdk-sandbox: comparison jdk/src/share/classes/java/net/InetSocketAddress.java

equal deleted inserted replaced

-:f2358d18923a
+:1d9cb0d080e3
 /*
-* Copyright (c) 2000, 2012, Oracle and/or its affiliates. All rights reserved.
+* Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved.
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This code is free software; you can redistribute it and/or modify it
 * under the terms of the GNU General Public License version 2 only, as
 * published by the Free Software Foundation.  Oracle designates this
 * <p>
 * It provides an immutable object used by sockets for binding, connecting, or
 * as returned values.
 * <p>
 * The <i>wildcard</i> is a special local IP address. It usually means "any"
-* and can only be used for <code>bind</code> operations.
+* and can only be used for {@code bind} operations.
 *
 * @see java.net.Socket
 * @see java.net.ServerSocket
 * @since 1.4
 */
 /**
 * Creates a socket address where the IP address is the wildcard address
 * and the port number a specified value.
 * <p>
 * A valid port value is between 0 and 65535.
-* A port number of <code>zero</code> will let the system pick up an
+* A port number of {@code zero} will let the system pick up an
-* ephemeral port in a <code>bind</code> operation.
+* ephemeral port in a {@code bind} operation.
 * <p>
 * @param   port    The port number
 * @throws IllegalArgumentException if the port parameter is outside the specified
 * range of valid port values.
 */
 /**
 *
 * Creates a socket address from an IP address and a port number.
 * <p>
 * A valid port value is between 0 and 65535.
-* A port number of <code>zero</code> will let the system pick up an
+* A port number of {@code zero} will let the system pick up an
-* ephemeral port in a <code>bind</code> operation.
+* ephemeral port in a {@code bind} operation.
 * <P>
-* A <code>null</code> address will assign the <i>wildcard</i> address.
+* A {@code null} address will assign the <i>wildcard</i> address.
 * <p>
 * @param   addr    The IP address
 * @param   port    The port number
 * @throws IllegalArgumentException if the port parameter is outside the specified
 * range of valid port values.
 * Creates a socket address from a hostname and a port number.
 * <p>
 * An attempt will be made to resolve the hostname into an InetAddress.
 * If that attempt fails, the address will be flagged as <I>unresolved</I>.
 * <p>
-* If there is a security manager, its <code>checkConnect</code> method
+* If there is a security manager, its {@code checkConnect} method
 * is called with the host name as its argument to check the permissiom
 * to resolve it. This could result in a SecurityException.
 * <P>
 * A valid port value is between 0 and 65535.
-* A port number of <code>zero</code> will let the system pick up an
+* A port number of {@code zero} will let the system pick up an
-* ephemeral port in a <code>bind</code> operation.
+* ephemeral port in a {@code bind} operation.
 * <P>
 * @param   hostname the Host name
 * @param   port    The port number
 * @throws IllegalArgumentException if the port parameter is outside the range
 * of valid port values, or if the hostname parameter is <TT>null</TT>.
 * <p>
 * No attempt will be made to resolve the hostname into an InetAddress.
 * The address will be flagged as <I>unresolved</I>.
 * <p>
 * A valid port value is between 0 and 65535.
-* A port number of <code>zero</code> will let the system pick up an
+* A port number of {@code zero} will let the system pick up an
-* ephemeral port in a <code>bind</code> operation.
+* ephemeral port in a {@code bind} operation.
 * <P>
 * @param   host    the Host name
 * @param   port    The port number
 * @throws IllegalArgumentException if the port parameter is outside
 *                  the range of valid port values, or if the hostname
 *                  parameter is <TT>null</TT>.
 * @see     #isUnresolved()
-* @return  a <code>InetSocketAddress</code> representing the unresolved
+* @return  a {@code InetSocketAddress} representing the unresolved
 *          socket address
 * @since 1.5
 */
 public static InetSocketAddress createUnresolved(String host, int port) {
 return new InetSocketAddress(checkPort(port), checkHost(host));
 return holder.getPort();
 }
 /**
 *
-* Gets the <code>InetAddress</code>.
+* Gets the {@code InetAddress}.
 *
-* @return the InetAdress or <code>null</code> if it is unresolved.
+* @return the InetAdress or {@code null} if it is unresolved.
 */
 public final InetAddress getAddress() {
 return holder.getAddress();
 }
 /**
-* Gets the <code>hostname</code>.
+* Gets the {@code hostname}.
 * Note: This method may trigger a name service reverse lookup if the
 * address was created with a literal IP address.
 *
 * @return  the hostname part of the address.
 */
 }
 /**
 * Checks whether the address has been resolved or not.
 *
-* @return <code>true</code> if the hostname couldn't be resolved into
+* @return {@code true} if the hostname couldn't be resolved into
-*          an <code>InetAddress</code>.
+*          an {@code InetAddress}.
 */
 public final boolean isUnresolved() {
 return holder.isUnresolved();
 }
 return holder.toString();
 }
 /**
 * Compares this object against the specified object.
-* The result is <code>true</code> if and only if the argument is
+* The result is {@code true} if and only if the argument is
-* not <code>null</code> and it represents the same address as
+* not {@code null} and it represents the same address as
 * this object.
 * <p>
-* Two instances of <code>InetSocketAddress</code> represent the same
+* Two instances of {@code InetSocketAddress} represent the same
 * address if both the InetAddresses (or hostnames if it is unresolved) and port
 * numbers are equal.
 * If both addresses are unresolved, then the hostname and the port number
 * are compared.
 *
 * Note: Hostnames are case insensitive. e.g. "FooBar" and "foobar" are
 * considered equal.
 *
 * @param   obj   the object to compare against.
-* @return  <code>true</code> if the objects are the same;
+* @return  {@code true} if the objects are the same;
-*          <code>false</code> otherwise.
+*          {@code false} otherwise.
 * @see java.net.InetAddress#equals(java.lang.Object)
 */
 @Override
 public final boolean equals(Object obj) {
 if (obj == null || !(obj instanceof InetSocketAddress))

changeset 19069	1d9cb0d080e3
parent 18156	edb590d448c5
child 21278	ef8a3a2a72f2