To allow for concurrent handling of new connections, the completion * handler is not invoked directly by the initiating thread when a new * connection is accepted immediately (see Threading). + * href="AsynchronousChannelGroup.html#threading">Threading). * *
If a security manager has been installed then it verifies that the * address and port number of the connection's remote endpoint are permitted diff --git a/src/share/classes/java/nio/channels/Channel.java b/src/share/classes/java/nio/channels/Channel.java index a20de123dfaf6308048df52fa71cf1eb41e4b5e4..88d15ace67f6172967b851b1755aabbad92b5e6b 100644 --- a/src/share/classes/java/nio/channels/Channel.java +++ b/src/share/classes/java/nio/channels/Channel.java @@ -56,7 +56,7 @@ import java.io.Closeable; public interface Channel extends Closeable { /** - * Tells whether or not this channel is open.
+ * Tells whether or not this channel is open. * * @return true if, and only if, this channel is open */ diff --git a/src/share/classes/java/nio/channels/FileChannel.java b/src/share/classes/java/nio/channels/FileChannel.java index b9fe83db08bc809a53c142c17cdc5fe74386e6cf..02d9082d2309c1cba86d7f71ecf0304a937acc93 100644 --- a/src/share/classes/java/nio/channels/FileChannel.java +++ b/src/share/classes/java/nio/channels/FileChannel.java @@ -418,7 +418,7 @@ public abstract class FileChannel // -- Other operations -- /** - * Returns this channel's file position. + * Returns this channel's file position. * * @return This channel's file position, * a non-negative integer counting the number of bytes @@ -461,7 +461,7 @@ public abstract class FileChannel public abstract FileChannel position(long newPosition) throws IOException; /** - * Returns the current size of this channel's file. + * Returns the current size of this channel's file. * * @return The current size of this channel's file, * measured in bytes diff --git a/src/share/classes/java/nio/channels/FileLock.java b/src/share/classes/java/nio/channels/FileLock.java index 019b90222fbebcab47aa6b56ee82a515642e896e..e978af431792c14e16d765f93d2a1668dd492c3c 100644 --- a/src/share/classes/java/nio/channels/FileLock.java +++ b/src/share/classes/java/nio/channels/FileLock.java @@ -124,7 +124,7 @@ public abstract class FileLock implements AutoCloseable { private final boolean shared; /** - * Initializes a new instance of this class. + * Initializes a new instance of this class. * * @param channel * The file channel upon whose file this lock is held @@ -249,7 +249,7 @@ public abstract class FileLock implements AutoCloseable { } /** - * Tells whether this lock is shared. + * Tells whether this lock is shared. * * @return true if lock is shared, * false if it is exclusive @@ -259,7 +259,7 @@ public abstract class FileLock implements AutoCloseable { } /** - * Tells whether or not this lock overlaps the given lock range. + * Tells whether or not this lock overlaps the given lock range. * * @return true if, and only if, this lock and the given lock * range overlap by at least one byte diff --git a/src/share/classes/java/nio/channels/Pipe.java b/src/share/classes/java/nio/channels/Pipe.java index c4d7bce7452e83ccd2f3c52087e29c6315cf6f94..af0722e99abd4affa434f959d7c0578de0d92c53 100644 --- a/src/share/classes/java/nio/channels/Pipe.java +++ b/src/share/classes/java/nio/channels/Pipe.java @@ -53,7 +53,7 @@ import java.nio.channels.spi.*; public abstract class Pipe { /** - * A channel representing the readable end of a {@link Pipe}. + * A channel representing the readable end of a {@link Pipe}. * * @since 1.4 */ @@ -84,7 +84,7 @@ public abstract class Pipe { } /** - * A channel representing the writable end of a {@link Pipe}. + * A channel representing the writable end of a {@link Pipe}. * * @since 1.4 */ @@ -120,14 +120,14 @@ public abstract class Pipe { protected Pipe() { } /** - * Returns this pipe's source channel. + * Returns this pipe's source channel. * * @return This pipe's source channel */ public abstract SourceChannel source(); /** - * Returns this pipe's sink channel. + * Returns this pipe's sink channel. * * @return This pipe's sink channel */ diff --git a/src/share/classes/java/nio/channels/SelectableChannel.java b/src/share/classes/java/nio/channels/SelectableChannel.java index 35569e86ed75dd05dbb4de49ccb3b2679bda05e6..7041c34e188f196bb6fce2fcfa9369e5a662f1b1 100644 --- a/src/share/classes/java/nio/channels/SelectableChannel.java +++ b/src/share/classes/java/nio/channels/SelectableChannel.java @@ -111,7 +111,7 @@ public abstract class SelectableChannel * identifying this channel's supported operations. The bits that are set * in this integer value denote exactly the operations that are valid for * this channel. This method always returns the same value for a given - * concrete channel class. + * concrete channel class. * * @return The valid-operation set */ @@ -140,7 +140,7 @@ public abstract class SelectableChannel /** * Retrieves the key representing the channel's registration with the given - * selector. + * selector. * * @return The key returned when this channel was last registered with the * given selector, or null if this channel is not @@ -333,7 +333,6 @@ public abstract class SelectableChannel * configureBlocking} and {@link #register register} methods synchronize. * This is often useful in the implementation of adaptors that require a * specific blocking mode to be maintained for a short period of time. - * * * @return The blocking-mode lock object */ diff --git a/src/share/classes/java/nio/channels/SelectionKey.java b/src/share/classes/java/nio/channels/SelectionKey.java index 2280cb9e2160d5f3fb7d96c1b8f26b00df28ae3e..7a0ab88ac3e1f41238254df5890fcc782db79915 100644 --- a/src/share/classes/java/nio/channels/SelectionKey.java +++ b/src/share/classes/java/nio/channels/SelectionKey.java @@ -119,7 +119,7 @@ public abstract class SelectionKey { /** * Returns the channel for which this key was created. This method will - * continue to return the channel even after the key is cancelled. + * continue to return the channel even after the key is cancelled. * * @return This key's channel */ @@ -127,7 +127,7 @@ public abstract class SelectionKey { /** * Returns the selector for which this key was created. This method will - * continue to return the selector even after the key is cancelled. + * continue to return the selector even after the key is cancelled. * * @return This key's selector */ @@ -228,7 +228,7 @@ public abstract class SelectionKey { public static final int OP_READ = 1 << 0; /** - * Operation-set bit for write operations. + * Operation-set bit for write operations. * * Suppose that a selection key's interest set contains
* OP_WRITE at the start of a
+ * Operation-set bit for socket-connect operations.
*
* Suppose that a selection key's interest set contains
* OP_CONNECT at the start of a
+ * Operation-set bit for socket-accept operations.
*
* Suppose that a selection key's interest set contains
* OP_ACCEPT at the start of a An invocation of this method of the form k.isConnectable()
* behaves in exactly the same way as the expression
*
- * {@code
+ *
*
@@ -389,7 +389,7 @@ public abstract class SelectionKey {
}
/**
- * Retrieves the current attachment. {@code
* k.readyOps() & OP_CONNECT != 0
* }
This method invokes the {@link #implOnMalformedInput * implOnMalformedInput} method, passing the new action.
@@ -391,7 +391,6 @@ public abstract class Charset$Coder$ { /** * Returns this $coder$'s current action for unmappable-character errors. - * * * @return The current unmappable-character action, which is never * null @@ -435,7 +434,7 @@ public abstract class Charset$Coder$ { /** * Returns the average number of $otype$s that will be produced for each * $itype$ of input. This heuristic value may be used to estimate the size - * of the output buffer required for a given input sequence. + * of the output buffer required for a given input sequence. * * @return The average number of $otype$s produced * per $itype$ of input @@ -447,7 +446,7 @@ public abstract class Charset$Coder$ { /** * Returns the maximum number of $otype$s that will be produced for each * $itype$ of input. This value may be used to compute the worst-case size - * of the output buffer required for a given input sequence. + * of the output buffer required for a given input sequence. * * @return The maximum number of $otype$s that will be produced per * $itype$ of input diff --git a/src/share/classes/java/nio/charset/Charset.java b/src/share/classes/java/nio/charset/Charset.java index 9451c537a36fe079e3c2e28bea16a713443d9bd9..69c3ab0e19fecc314508a8fd12d053178e0fe741 100644 --- a/src/share/classes/java/nio/charset/Charset.java +++ b/src/share/classes/java/nio/charset/Charset.java @@ -490,7 +490,7 @@ public abstract class Charset } /** - * Tells whether the named charset is supported. + * Tells whether the named charset is supported. * * @param charsetName * The name of the requested charset; may be either @@ -510,7 +510,7 @@ public abstract class Charset } /** - * Returns a charset object for the named charset. + * Returns a charset object for the named charset. * * @param charsetName * The name of the requested charset; may be either @@ -629,7 +629,7 @@ public abstract class Charset /** * Initializes a new charset with the given canonical name and alias - * set. + * set. * * @param canonicalName * The canonical name of this charset @@ -650,7 +650,7 @@ public abstract class Charset } /** - * Returns this charset's canonical name. + * Returns this charset's canonical name. * * @return The canonical name of this charset */ @@ -659,7 +659,7 @@ public abstract class Charset } /** - * Returns a set containing this charset's aliases. + * Returns a set containing this charset's aliases. * * @return An immutable set of this charset's aliases */ @@ -690,7 +690,7 @@ public abstract class Charset /** * Tells whether or not this charset is registered in the IANA Charset - * Registry. + * Registry. * * @return true if, and only if, this charset is known by its * implementor to be registered with the IANA @@ -742,14 +742,14 @@ public abstract class Charset public abstract boolean contains(Charset cs); /** - * Constructs a new decoder for this charset. + * Constructs a new decoder for this charset. * * @return A new decoder for this charset */ public abstract CharsetDecoder newDecoder(); /** - * Constructs a new encoder for this charset. + * Constructs a new encoder for this charset. * * @return A new encoder for this charset * @@ -881,7 +881,7 @@ public abstract class Charset } /** - * Computes a hashcode for this charset. + * Computes a hashcode for this charset. * * @return An integer hashcode */ @@ -907,7 +907,7 @@ public abstract class Charset } /** - * Returns a string describing this charset. + * Returns a string describing this charset. * * @return A string describing this charset */ diff --git a/src/share/classes/java/nio/charset/CoderResult.java b/src/share/classes/java/nio/charset/CoderResult.java index 00f29db07ef19f303ac9eab47dabb545a74c0e36..5b2c4d41f89fc283f22a1398c6120c9f5fcbf1c2 100644 --- a/src/share/classes/java/nio/charset/CoderResult.java +++ b/src/share/classes/java/nio/charset/CoderResult.java @@ -71,7 +71,7 @@ import java.util.HashMap; * * * - * For convenience, the {@link #isError() isError} method returns true + *For convenience, the {@link #isError() isError} method returns true * for result objects that describe malformed-input and unmappable-character * errors but false for those that describe underflow or overflow * conditions.
@@ -112,7 +112,7 @@ public class CoderResult { } /** - * Tells whether or not this object describes an underflow condition. + * Tells whether or not this object describes an underflow condition. * * @return true if, and only if, this object denotes underflow */ @@ -121,7 +121,7 @@ public class CoderResult { } /** - * Tells whether or not this object describes an overflow condition. + * Tells whether or not this object describes an overflow condition. * * @return true if, and only if, this object denotes overflow */ @@ -130,7 +130,7 @@ public class CoderResult { } /** - * Tells whether or not this object describes an error condition. + * Tells whether or not this object describes an error condition. * * @return true if, and only if, this object denotes either a * malformed-input error or an unmappable-character error @@ -141,7 +141,6 @@ public class CoderResult { /** * Tells whether or not this object describes a malformed-input error. - * * * @return true if, and only if, this object denotes a * malformed-input error @@ -152,7 +151,7 @@ public class CoderResult { /** * Tells whether or not this object describes an unmappable-character - * error. + * error. * * @return true if, and only if, this object denotes an * unmappable-character error @@ -163,7 +162,7 @@ public class CoderResult { /** * Returns the length of the erroneous input described by this - * object (optional operation). + * object (optional operation). * * @return The length of the erroneous input, a positive integer * @@ -180,14 +179,14 @@ public class CoderResult { /** * Result object indicating underflow, meaning that either the input buffer * has been completely consumed or, if the input buffer is not yet empty, - * that additional input is required. + * that additional input is required. */ public static final CoderResult UNDERFLOW = new CoderResult(CR_UNDERFLOW, 0); /** * Result object indicating overflow, meaning that there is insufficient - * room in the output buffer. + * room in the output buffer. */ public static final CoderResult OVERFLOW = new CoderResult(CR_OVERFLOW, 0); @@ -226,7 +225,7 @@ public class CoderResult { /** * Static factory method that returns the unique object describing a - * malformed-input error of the given length. + * malformed-input error of the given length. * * @return The requested coder-result object */ @@ -242,7 +241,7 @@ public class CoderResult { /** * Static factory method that returns the unique result object describing - * an unmappable-character error of the given length. + * an unmappable-character error of the given length. * * @return The requested coder-result object */ @@ -252,7 +251,6 @@ public class CoderResult { /** * Throws an exception appropriate to the result described by this object. - * * * @throws BufferUnderflowException * If this object is {@link #UNDERFLOW} diff --git a/src/share/classes/java/nio/charset/CodingErrorAction.java b/src/share/classes/java/nio/charset/CodingErrorAction.java index 8c9cb2193b25b2c7a694ded83e67a45109cd6f2b..8ca30e4900bd0fc80110306bd4f50f25225d16d1 100644 --- a/src/share/classes/java/nio/charset/CodingErrorAction.java +++ b/src/share/classes/java/nio/charset/CodingErrorAction.java @@ -50,7 +50,7 @@ public class CodingErrorAction { /** * Action indicating that a coding error is to be handled by dropping the - * erroneous input and resuming the coding operation. + * erroneous input and resuming the coding operation. */ public static final CodingErrorAction IGNORE = new CodingErrorAction("IGNORE"); @@ -58,7 +58,7 @@ public class CodingErrorAction { /** * Action indicating that a coding error is to be handled by dropping the * erroneous input, appending the coder's replacement value to the output - * buffer, and resuming the coding operation. + * buffer, and resuming the coding operation. */ public static final CodingErrorAction REPLACE = new CodingErrorAction("REPLACE"); @@ -73,7 +73,7 @@ public class CodingErrorAction { = new CodingErrorAction("REPORT"); /** - * Returns a string describing this action. + * Returns a string describing this action. * * @return A descriptive string */ diff --git a/src/share/classes/java/nio/charset/UnmappableCharacterException.java b/src/share/classes/java/nio/charset/UnmappableCharacterException.java index 4af924fd1fc45f1727e5a50d9dff68ea8f64c0cc..5fa12476d688e29cf671398b88521305ed64a4ef 100644 --- a/src/share/classes/java/nio/charset/UnmappableCharacterException.java +++ b/src/share/classes/java/nio/charset/UnmappableCharacterException.java @@ -29,7 +29,7 @@ package java.nio.charset; /** * Checked exception thrown when an input character (or byte) sequence * is valid but cannot be mapped to an output byte (or character) - * sequence. + * sequence. * * @since 1.4 */ diff --git a/src/share/classes/java/nio/charset/spi/CharsetProvider.java b/src/share/classes/java/nio/charset/spi/CharsetProvider.java index a4d646a86e24d020749bb220dfaefd4f8e8c9f56..3525e201d8757d485bc132b9ce46f148cf34ecd4 100644 --- a/src/share/classes/java/nio/charset/spi/CharsetProvider.java +++ b/src/share/classes/java/nio/charset/spi/CharsetProvider.java @@ -72,7 +72,7 @@ import java.util.Iterator; public abstract class CharsetProvider { /** - * Initializes a new charset provider. + * Initializes a new charset provider. * * @throws SecurityException * If a security manager has been installed and it denies @@ -88,14 +88,14 @@ public abstract class CharsetProvider { * Creates an iterator that iterates over the charsets supported by this * provider. This method is used in the implementation of the {@link * java.nio.charset.Charset#availableCharsets Charset.availableCharsets} - * method. + * method. * * @return The new iterator */ public abstract Iterator