mirror of
https://github.com/openjdk/jdk.git
synced 2026-02-14 12:25:21 +00:00
8039172: Tidy warnings cleanup for java.net, java.math, java.time, java.rmi
Reviewed-by: alanb, lancea
This commit is contained in:
Alexander Stepanov
Yuri Nesterenko
parent
52c87adff4
commit
60be1bfa24
@ -104,7 +104,7 @@ class DatagramSocket implements java.io.Closeable {
|
||||
/**
|
||||
* Connects this socket to a remote socket address (IP address + port number).
|
||||
* Binds socket if not already bound.
|
||||
* <p>
|
||||
*
|
||||
* @param address The remote address.
|
||||
* @param port The remote port
|
||||
* @throws SocketException if binding the socket fails.
|
||||
@ -338,7 +338,7 @@ class DatagramSocket implements java.io.Closeable {
|
||||
* <p>
|
||||
* If the address is {@code null}, then the system will pick up
|
||||
* an ephemeral port and a valid local address to bind the socket.
|
||||
*<p>
|
||||
*
|
||||
* @param addr The address and port to bind to.
|
||||
* @throws SocketException if any error happens during the bind, or if the
|
||||
* socket is already bound.
|
||||
@ -1240,10 +1240,8 @@ class DatagramSocket implements java.io.Closeable {
|
||||
* datagram socket factory.
|
||||
* @exception SocketException if the factory is already defined.
|
||||
* @exception SecurityException if a security manager exists and its
|
||||
* {@code checkSetFactory} method doesn't allow the
|
||||
operation.
|
||||
* @see
|
||||
java.net.DatagramSocketImplFactory#createDatagramSocketImpl()
|
||||
* {@code checkSetFactory} method doesn't allow the operation.
|
||||
* @see java.net.DatagramSocketImplFactory#createDatagramSocketImpl()
|
||||
* @see SecurityManager#checkSetFactory
|
||||
* @since 1.3
|
||||
*/
|
||||
|
||||
@ -157,7 +157,7 @@ public class InetSocketAddress
|
||||
* A valid port value is between 0 and 65535.
|
||||
* A port number of {@code zero} will let the system pick up an
|
||||
* 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.
|
||||
@ -175,7 +175,7 @@ public class InetSocketAddress
|
||||
* ephemeral port in a {@code bind} operation.
|
||||
* <P>
|
||||
* 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
|
||||
@ -202,7 +202,7 @@ public class InetSocketAddress
|
||||
* A valid port value is between 0 and 65535.
|
||||
* A port number of {@code zero} will let the system pick up an
|
||||
* 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
|
||||
@ -239,7 +239,7 @@ public class InetSocketAddress
|
||||
* A valid port value is between 0 and 65535.
|
||||
* A port number of {@code zero} will let the system pick up an
|
||||
* 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
|
||||
|
||||
@ -157,7 +157,6 @@ class ServerSocket implements java.io.Closeable {
|
||||
* or may choose to ignore the parameter altogther. The value provided
|
||||
* should be greater than {@code 0}. If it is less than or equal to
|
||||
* {@code 0}, then an implementation specific default will be used.
|
||||
* <P>
|
||||
*
|
||||
* @param port the port number, or {@code 0} to use a port
|
||||
* number that is automatically allocated.
|
||||
@ -206,7 +205,7 @@ class ServerSocket implements java.io.Closeable {
|
||||
* or may choose to ignore the parameter altogther. The value provided
|
||||
* should be greater than {@code 0}. If it is less than or equal to
|
||||
* {@code 0}, then an implementation specific default will be used.
|
||||
* <P>
|
||||
*
|
||||
* @param port the port number, or {@code 0} to use a port
|
||||
* number that is automatically allocated.
|
||||
* @param backlog requested maximum length of the queue of incoming
|
||||
@ -315,7 +314,7 @@ class ServerSocket implements java.io.Closeable {
|
||||
* <p>
|
||||
* If the address is {@code null}, then the system will pick up
|
||||
* an ephemeral port and a valid local address to bind the socket.
|
||||
* <p>
|
||||
*
|
||||
* @param endpoint The IP address and port number to bind to.
|
||||
* @throws IOException if the bind operation fails, or if the socket
|
||||
* is already bound.
|
||||
|
||||
@ -153,7 +153,7 @@ class Socket implements java.io.Closeable {
|
||||
/**
|
||||
* Creates an unconnected Socket with a user-specified
|
||||
* SocketImpl.
|
||||
* <P>
|
||||
*
|
||||
* @param impl an instance of a <B>SocketImpl</B>
|
||||
* the subclass wishes to use on the Socket.
|
||||
*
|
||||
@ -1245,7 +1245,7 @@ class Socket implements java.io.Closeable {
|
||||
* <ol>
|
||||
* <li>For sockets accepted from a ServerSocket, this must be done by calling
|
||||
* {@link ServerSocket#setReceiveBufferSize(int)} before the ServerSocket
|
||||
* is bound to a local address.<p></li>
|
||||
* is bound to a local address.</li>
|
||||
* <li>For client sockets, setReceiveBufferSize() must be called before
|
||||
* connecting the socket to its remote peer.</li></ol>
|
||||
* @param size the size to which to set the receive buffer
|
||||
|
||||
@ -38,7 +38,7 @@ import java.lang.annotation.Native;
|
||||
* DatagramSocketImpl, <B>you won't use these directly.</B> There are
|
||||
* type-safe methods to get/set each of these options in Socket, ServerSocket,
|
||||
* DatagramSocket and MulticastSocket.
|
||||
* <P>
|
||||
*
|
||||
* @author David Brown
|
||||
*/
|
||||
|
||||
|
||||
@ -1001,7 +1001,7 @@ public final class SocketPermission extends Permission
|
||||
|
||||
/**
|
||||
* Checks two SocketPermission objects for equality.
|
||||
* <P>
|
||||
*
|
||||
* @param obj the object to test for equality with this object.
|
||||
*
|
||||
* @return true if <i>obj</i> is a SocketPermission, and has the
|
||||
|
||||
@ -867,7 +867,7 @@ public final class URL implements java.io.Serializable {
|
||||
* Creates an integer suitable for hash table indexing.<p>
|
||||
*
|
||||
* The hash code is based upon all the URL components relevant for URL
|
||||
* comparison. As such, this operation is a blocking operation.<p>
|
||||
* comparison. As such, this operation is a blocking operation.
|
||||
*
|
||||
* @return a hash code for this {@code URL}.
|
||||
*/
|
||||
|
||||
@ -271,7 +271,7 @@ public class URLClassLoader extends SecureClassLoader implements Closeable {
|
||||
* by catching {@link IOException}s internally. Unchecked exceptions
|
||||
* and errors are not caught. Calling close on an already closed
|
||||
* loader has no effect.
|
||||
* <p>
|
||||
*
|
||||
* @exception IOException if closing any file opened by this class loader
|
||||
* resulted in an IOException. Any such exceptions are caught internally.
|
||||
* If only one is caught, then it is re-thrown. If more than one exception
|
||||
|
||||
@ -35,7 +35,8 @@ alter the mechanisms and behavior of the various classes of the
|
||||
java.net package. Some are checked only once at startup of the VM,
|
||||
and therefore are best set using the -D option of the java command,
|
||||
while others have a more dynamic nature and can also be changed using
|
||||
the <a href="../../lang/System.html#setProperty(java.lang.String, java.lang.String)">System.setProperty()</a> API. The purpose of this document is to list
|
||||
the <a href="../../lang/System.html#setProperty(java.lang.String,%20java.lang.String)">System.setProperty()</a> API.
|
||||
The purpose of this document is to list
|
||||
and detail all of these properties.</P>
|
||||
<P>If there is no special note, a property value is checked every time it is used.</P>
|
||||
<a name="Ipv4IPv6"></a>
|
||||
|
||||
@ -172,7 +172,7 @@ public abstract class ActivationGroup
|
||||
*
|
||||
* <p>This method simply informs the group's monitor that the object
|
||||
* is inactive. It is up to the concrete subclass of ActivationGroup
|
||||
* to fulfill the additional requirement of unexporting the object. <p>
|
||||
* to fulfill the additional requirement of unexporting the object.
|
||||
*
|
||||
* @param id the object's activation identifier
|
||||
* @return true if the object was successfully deactivated; otherwise
|
||||
|
||||
@ -49,7 +49,7 @@ import java.util.Properties;
|
||||
*
|
||||
* <li> the group's <code>ActivationGroupID</code>, and
|
||||
* <li> the group's initialization data (in a
|
||||
* <code>java.rmi.MarshalledObject</code>)</ul><p>
|
||||
* <code>java.rmi.MarshalledObject</code>)</ul>
|
||||
*
|
||||
* @author Ann Wollrath
|
||||
* @since 1.2
|
||||
|
||||
@ -63,7 +63,7 @@ public interface ActivationMonitor extends Remote {
|
||||
* reference associated with <code>id</code> as a stale reference.
|
||||
* Since the reference is considered stale, a subsequent
|
||||
* <code>activate</code> call for the same activation identifier
|
||||
* results in re-activating the remote object.<p>
|
||||
* results in re-activating the remote object.
|
||||
*
|
||||
* @param id the object's activation identifier
|
||||
* @exception UnknownObjectException if object is unknown
|
||||
|
||||
@ -61,7 +61,7 @@ public interface ActivationSystem extends Remote {
|
||||
* receives an <code>activate</code> request for a specific identifier, it
|
||||
* looks up the activation descriptor (registered previously) for
|
||||
* the specified identifier and uses that information to activate
|
||||
* the object. <p>
|
||||
* the object.
|
||||
*
|
||||
* @param desc the object's activation descriptor
|
||||
* @return the activation id that can be used to activate the object
|
||||
|
||||
@ -53,7 +53,7 @@ import java.rmi.activation.UnknownObjectException;
|
||||
*
|
||||
* The activator is responsible for monitoring and detecting when
|
||||
* activation groups fail so that it can remove stale remote references
|
||||
* to groups and active object's within those groups.<p>
|
||||
* to groups and active object's within those groups.
|
||||
*
|
||||
* @author Ann Wollrath
|
||||
* @see ActivationInstantiator
|
||||
@ -95,7 +95,7 @@ public interface Activator extends Remote {
|
||||
* collection for that object. If the activator kept a strong
|
||||
* reference to the remote object, the activator would then
|
||||
* prevent the object from being garbage collected under the
|
||||
* normal distributed garbage collection mechanism. <p>
|
||||
* normal distributed garbage collection mechanism.
|
||||
*
|
||||
* @param id the activation identifier for the object being activated
|
||||
* @param force if true, the activator contacts the group to obtain
|
||||
|
||||
@ -939,7 +939,7 @@ public final class DateTimeFormatterBuilder {
|
||||
* During parsing, the offset is parsed using the format defined above.
|
||||
* If the offset cannot be parsed then an exception is thrown unless the
|
||||
* section of the formatter is optional.
|
||||
* <p>
|
||||
*
|
||||
* @param style the format style to use, not null
|
||||
* @return this, for chaining, not null
|
||||
* @throws IllegalArgumentException if style is neither {@link TextStyle#FULL
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user