mirror of
https://github.com/openjdk/jdk.git
synced 2026-06-04 01:32:38 +00:00
8156661: Handful of typos in javadoc
Reviewed-by: prappo, rriggs
This commit is contained in:
parent
967a686e70
commit
fcf085c678
@ -1221,13 +1221,13 @@ public final class Integer extends Number implements Comparable<Integer> {
|
||||
}
|
||||
|
||||
/**
|
||||
* Returns a hash code for a {@code int} value; compatible with
|
||||
* Returns a hash code for an {@code int} value; compatible with
|
||||
* {@code Integer.hashCode()}.
|
||||
*
|
||||
* @param value the value to hash
|
||||
* @since 1.8
|
||||
*
|
||||
* @return a hash code value for a {@code int} value.
|
||||
* @return a hash code value for an {@code int} value.
|
||||
*/
|
||||
public static int hashCode(int value) {
|
||||
return value;
|
||||
@ -1596,7 +1596,7 @@ public final class Integer extends Number implements Comparable<Integer> {
|
||||
@Native public static final int SIZE = 32;
|
||||
|
||||
/**
|
||||
* The number of bytes used to represent a {@code int} value in two's
|
||||
* The number of bytes used to represent an {@code int} value in two's
|
||||
* complement binary form.
|
||||
*
|
||||
* @since 1.8
|
||||
|
||||
@ -318,7 +318,7 @@ public class ModuleDescriptor
|
||||
/**
|
||||
* Tests this module export for equality with the given object.
|
||||
*
|
||||
* <p> If the given object is not a {@code Exports} then this method
|
||||
* <p> If the given object is not an {@code Exports} then this method
|
||||
* returns {@code false}. Two module exports objects are equal if the
|
||||
* package names are equal and the set of target module names is equal.
|
||||
* </p>
|
||||
|
||||
@ -903,7 +903,7 @@ class Field extends AccessibleObject implements Member {
|
||||
* Sets the value of a field as an {@code int} on the specified object.
|
||||
* This method is equivalent to
|
||||
* {@code set(obj, iObj)},
|
||||
* where {@code iObj} is a {@code Integer} object and
|
||||
* where {@code iObj} is an {@code Integer} object and
|
||||
* {@code iObj.intValue() == i}.
|
||||
*
|
||||
* @param obj the object whose field should be modified
|
||||
|
||||
@ -36,13 +36,13 @@ public class InaccessibleObjectException extends RuntimeException {
|
||||
private static final long serialVersionUID = 4158786093378140901L;
|
||||
|
||||
/**
|
||||
* Constructs a {@code InaccessibleObjectException} with no detail message.
|
||||
* Constructs an {@code InaccessibleObjectException} with no detail message.
|
||||
*/
|
||||
public InaccessibleObjectException() {
|
||||
}
|
||||
|
||||
/**
|
||||
* Constructs a {@code InaccessibleObjectException} with the given detail
|
||||
* Constructs an {@code InaccessibleObjectException} with the given detail
|
||||
* message.
|
||||
*
|
||||
* @param msg
|
||||
|
||||
@ -4676,7 +4676,7 @@ public class BigInteger extends Number implements Comparable<BigInteger> {
|
||||
*
|
||||
* @return this {@code BigInteger} converted to an {@code int}.
|
||||
* @throws ArithmeticException if the value of {@code this} will
|
||||
* not exactly fit in a {@code int}.
|
||||
* not exactly fit in an {@code int}.
|
||||
* @see BigInteger#intValue
|
||||
* @since 1.8
|
||||
*/
|
||||
|
||||
@ -246,7 +246,7 @@ public class InetSocketAddress
|
||||
* the range of valid port values, or if the hostname
|
||||
* parameter is {@code null}.
|
||||
* @see #isUnresolved()
|
||||
* @return a {@code InetSocketAddress} representing the unresolved
|
||||
* @return an {@code InetSocketAddress} representing the unresolved
|
||||
* socket address
|
||||
* @since 1.5
|
||||
*/
|
||||
|
||||
@ -106,8 +106,8 @@ public class URLDecoder {
|
||||
}
|
||||
|
||||
/**
|
||||
* Decodes a {@code application/x-www-form-urlencoded} string using a specific
|
||||
* encoding scheme.
|
||||
* Decodes an {@code application/x-www-form-urlencoded} string using
|
||||
* a specific encoding scheme.
|
||||
* The supplied encoding is used to determine
|
||||
* what characters are represented by any consecutive sequences of the
|
||||
* form "<i>{@code %xy}</i>".
|
||||
|
||||
@ -225,7 +225,7 @@ public class URLEncoder {
|
||||
/*
|
||||
* If this character represents the start of a Unicode
|
||||
* surrogate pair, then pass in two characters. It's not
|
||||
* clear what should be done if a bytes reserved in the
|
||||
* clear what should be done if a byte reserved in the
|
||||
* surrogate pairs range occurs outside of a legal
|
||||
* surrogate pair. For now, just treat it as if it were
|
||||
* any other character.
|
||||
|
||||
@ -65,7 +65,7 @@ extends GeneralSecurityException {
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a {@code InvalidAlgorithmParameterException} with the
|
||||
* Creates an {@code InvalidAlgorithmParameterException} with the
|
||||
* specified detail message and cause.
|
||||
*
|
||||
* @param message the detail message (which is saved for later retrieval
|
||||
@ -80,7 +80,7 @@ extends GeneralSecurityException {
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a {@code InvalidAlgorithmParameterException} with the
|
||||
* Creates an {@code InvalidAlgorithmParameterException} with the
|
||||
* specified cause and a detail message of
|
||||
* {@code (cause==null ? null : cause.toString())}
|
||||
* (which typically contains the class and detail message of
|
||||
|
||||
@ -58,7 +58,7 @@ public class InvalidKeyException extends KeyException {
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a {@code InvalidKeyException} with the specified
|
||||
* Creates an {@code InvalidKeyException} with the specified
|
||||
* detail message and cause.
|
||||
*
|
||||
* @param message the detail message (which is saved for later retrieval
|
||||
@ -73,7 +73,7 @@ public class InvalidKeyException extends KeyException {
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a {@code InvalidKeyException} with the specified cause
|
||||
* Creates an {@code InvalidKeyException} with the specified cause
|
||||
* and a detail message of {@code (cause==null ? null : cause.toString())}
|
||||
* (which typically contains the class and detail message of
|
||||
* {@code cause}).
|
||||
|
||||
@ -144,7 +144,7 @@ public class ProtectionDomain {
|
||||
/**
|
||||
* Creates a new ProtectionDomain with the given CodeSource and
|
||||
* Permissions. If the permissions object is not null, then
|
||||
* {@code setReadOnly())} will be called on the passed in
|
||||
* {@code setReadOnly()} will be called on the passed in
|
||||
* Permissions object. The only permissions granted to this domain
|
||||
* are the ones specified; the current Policy will not be consulted.
|
||||
*
|
||||
|
||||
@ -1809,7 +1809,7 @@ public abstract class Provider extends Properties {
|
||||
}
|
||||
|
||||
/**
|
||||
* Return whether this service has its Supported* properties for
|
||||
* Return whether this service has its supported properties for
|
||||
* keys defined. Parses the attributes if not yet initialized.
|
||||
*/
|
||||
private boolean hasKeyAttributes() {
|
||||
|
||||
@ -549,7 +549,7 @@ public final class Security {
|
||||
|
||||
/**
|
||||
* Returns an array containing all installed providers that satisfy the
|
||||
* specified* selection criteria, or null if no such providers have been
|
||||
* specified selection criteria, or null if no such providers have been
|
||||
* installed. The returned providers are ordered
|
||||
* according to their
|
||||
* {@linkplain #insertProviderAt(java.security.Provider, int)
|
||||
|
||||
@ -63,7 +63,7 @@ public class InvalidKeySpecException extends GeneralSecurityException {
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a {@code InvalidKeySpecException} with the specified
|
||||
* Creates an {@code InvalidKeySpecException} with the specified
|
||||
* detail message and cause.
|
||||
*
|
||||
* @param message the detail message (which is saved for later retrieval
|
||||
@ -78,7 +78,7 @@ public class InvalidKeySpecException extends GeneralSecurityException {
|
||||
}
|
||||
|
||||
/**
|
||||
* Creates a {@code InvalidKeySpecException} with the specified cause
|
||||
* Creates an {@code InvalidKeySpecException} with the specified cause
|
||||
* and a detail message of {@code (cause==null ? null : cause.toString())}
|
||||
* (which typically contains the class and detail message of
|
||||
* {@code cause}).
|
||||
|
||||
@ -799,33 +799,33 @@ public final class Instant
|
||||
* The supported fields behave as follows:
|
||||
* <ul>
|
||||
* <li>{@code NANOS} -
|
||||
* Returns a {@code Instant} with the specified number of nanoseconds added.
|
||||
* Returns an {@code Instant} with the specified number of nanoseconds added.
|
||||
* This is equivalent to {@link #plusNanos(long)}.
|
||||
* <li>{@code MICROS} -
|
||||
* Returns a {@code Instant} with the specified number of microseconds added.
|
||||
* Returns an {@code Instant} with the specified number of microseconds added.
|
||||
* This is equivalent to {@link #plusNanos(long)} with the amount
|
||||
* multiplied by 1,000.
|
||||
* <li>{@code MILLIS} -
|
||||
* Returns a {@code Instant} with the specified number of milliseconds added.
|
||||
* Returns an {@code Instant} with the specified number of milliseconds added.
|
||||
* This is equivalent to {@link #plusNanos(long)} with the amount
|
||||
* multiplied by 1,000,000.
|
||||
* <li>{@code SECONDS} -
|
||||
* Returns a {@code Instant} with the specified number of seconds added.
|
||||
* Returns an {@code Instant} with the specified number of seconds added.
|
||||
* This is equivalent to {@link #plusSeconds(long)}.
|
||||
* <li>{@code MINUTES} -
|
||||
* Returns a {@code Instant} with the specified number of minutes added.
|
||||
* Returns an {@code Instant} with the specified number of minutes added.
|
||||
* This is equivalent to {@link #plusSeconds(long)} with the amount
|
||||
* multiplied by 60.
|
||||
* <li>{@code HOURS} -
|
||||
* Returns a {@code Instant} with the specified number of hours added.
|
||||
* Returns an {@code Instant} with the specified number of hours added.
|
||||
* This is equivalent to {@link #plusSeconds(long)} with the amount
|
||||
* multiplied by 3,600.
|
||||
* <li>{@code HALF_DAYS} -
|
||||
* Returns a {@code Instant} with the specified number of half-days added.
|
||||
* Returns an {@code Instant} with the specified number of half-days added.
|
||||
* This is equivalent to {@link #plusSeconds(long)} with the amount
|
||||
* multiplied by 43,200 (12 hours).
|
||||
* <li>{@code DAYS} -
|
||||
* Returns a {@code Instant} with the specified number of days added.
|
||||
* Returns an {@code Instant} with the specified number of days added.
|
||||
* This is equivalent to {@link #plusSeconds(long)} with the amount
|
||||
* multiplied by 86,400 (24 hours).
|
||||
* </ul>
|
||||
@ -958,7 +958,7 @@ public final class Instant
|
||||
/**
|
||||
* Returns a copy of this instant with the specified amount subtracted.
|
||||
* <p>
|
||||
* This returns a {@code Instant}, based on this one, with the amount
|
||||
* This returns an {@code Instant}, based on this one, with the amount
|
||||
* in terms of the unit subtracted. If it is not possible to subtract the amount,
|
||||
* because the unit is not supported or for some other reason, an exception is thrown.
|
||||
* <p>
|
||||
|
||||
@ -665,7 +665,7 @@ public final class LocalDateTime
|
||||
* The {@link #isSupported(TemporalField) supported fields} will return valid
|
||||
* values based on this date-time, except {@code NANO_OF_DAY}, {@code MICRO_OF_DAY},
|
||||
* {@code EPOCH_DAY} and {@code PROLEPTIC_MONTH} which are too large to fit in
|
||||
* an {@code int} and throw a {@code UnsupportedTemporalTypeException}.
|
||||
* an {@code int} and throw an {@code UnsupportedTemporalTypeException}.
|
||||
* All other {@code ChronoField} instances will throw an {@code UnsupportedTemporalTypeException}.
|
||||
* <p>
|
||||
* If the field is not a {@code ChronoField}, then the result of this method
|
||||
|
||||
@ -619,7 +619,7 @@ public final class LocalTime
|
||||
* If the field is a {@link ChronoField} then the query is implemented here.
|
||||
* The {@link #isSupported(TemporalField) supported fields} will return valid
|
||||
* values based on this time, except {@code NANO_OF_DAY} and {@code MICRO_OF_DAY}
|
||||
* which are too large to fit in an {@code int} and throw a {@code UnsupportedTemporalTypeException}.
|
||||
* which are too large to fit in an {@code int} and throw an {@code UnsupportedTemporalTypeException}.
|
||||
* All other {@code ChronoField} instances will throw an {@code UnsupportedTemporalTypeException}.
|
||||
* <p>
|
||||
* If the field is not a {@code ChronoField}, then the result of this method
|
||||
|
||||
@ -576,7 +576,7 @@ public final class OffsetDateTime
|
||||
* The {@link #isSupported(TemporalField) supported fields} will return valid
|
||||
* values based on this date-time, except {@code NANO_OF_DAY}, {@code MICRO_OF_DAY},
|
||||
* {@code EPOCH_DAY}, {@code PROLEPTIC_MONTH} and {@code INSTANT_SECONDS} which are too
|
||||
* large to fit in an {@code int} and throw a {@code UnsupportedTemporalTypeException}.
|
||||
* large to fit in an {@code int} and throw an {@code UnsupportedTemporalTypeException}.
|
||||
* All other {@code ChronoField} instances will throw an {@code UnsupportedTemporalTypeException}.
|
||||
* <p>
|
||||
* If the field is not a {@code ChronoField}, then the result of this method
|
||||
|
||||
@ -481,7 +481,7 @@ public final class OffsetTime
|
||||
* If the field is a {@link ChronoField} then the query is implemented here.
|
||||
* The {@link #isSupported(TemporalField) supported fields} will return valid
|
||||
* values based on this time, except {@code NANO_OF_DAY} and {@code MICRO_OF_DAY}
|
||||
* which are too large to fit in an {@code int} and throw a {@code UnsupportedTemporalTypeException}.
|
||||
* which are too large to fit in an {@code int} and throw an {@code UnsupportedTemporalTypeException}.
|
||||
* All other {@code ChronoField} instances will throw an {@code UnsupportedTemporalTypeException}.
|
||||
* <p>
|
||||
* If the field is not a {@code ChronoField}, then the result of this method
|
||||
|
||||
@ -793,7 +793,7 @@ public final class ZonedDateTime
|
||||
* The {@link #isSupported(TemporalField) supported fields} will return valid
|
||||
* values based on this date-time, except {@code NANO_OF_DAY}, {@code MICRO_OF_DAY},
|
||||
* {@code EPOCH_DAY}, {@code PROLEPTIC_MONTH} and {@code INSTANT_SECONDS} which are too
|
||||
* large to fit in an {@code int} and throw a {@code UnsupportedTemporalTypeException}.
|
||||
* large to fit in an {@code int} and throw an {@code UnsupportedTemporalTypeException}.
|
||||
* All other {@code ChronoField} instances will throw an {@code UnsupportedTemporalTypeException}.
|
||||
* <p>
|
||||
* If the field is not a {@code ChronoField}, then the result of this method
|
||||
|
||||
@ -267,7 +267,7 @@ public interface Comparator<T> {
|
||||
|
||||
/**
|
||||
* Returns a lexicographic-order comparator with a function that
|
||||
* extracts a {@code int} sort key.
|
||||
* extracts an {@code int} sort key.
|
||||
*
|
||||
* @implSpec This default implementation behaves as if {@code
|
||||
* thenComparing(comparingInt(keyExtractor))}.
|
||||
|
||||
@ -469,7 +469,7 @@ import java.util.stream.StreamSupport;
|
||||
*
|
||||
* <li> A line-separator character (<code>'\u2028'</code>), or
|
||||
*
|
||||
* <li> A paragraph-separator character (<code>'\u2029</code>).
|
||||
* <li> A paragraph-separator character (<code>'\u2029'</code>).
|
||||
*
|
||||
* </ul>
|
||||
* <p>If {@link #UNIX_LINES} mode is activated, then the only line terminators
|
||||
|
||||
@ -40,7 +40,7 @@ public class UnsupportedCallbackException extends Exception {
|
||||
private Callback callback;
|
||||
|
||||
/**
|
||||
* Constructs a {@code UnsupportedCallbackException}
|
||||
* Constructs an {@code UnsupportedCallbackException}
|
||||
* with no detail message.
|
||||
*
|
||||
* @param callback the unrecognized {@code Callback}.
|
||||
|
||||
@ -784,7 +784,7 @@ public abstract class FtpClient implements java.io.Closeable {
|
||||
*
|
||||
* @param path the pathname of the directory to list or {@code null}
|
||||
* for the current working directoty.
|
||||
* @return a {@code Iterator} of files or {@code null} if the
|
||||
* @return an {@code Iterator} of files or {@code null} if the
|
||||
* command failed.
|
||||
* @throws IOException if an error occurred during the transmission
|
||||
* @see #setDirParser(FtpDirParser)
|
||||
|
||||
@ -51,7 +51,7 @@ public final class OCSPNonceExtension extends Extension {
|
||||
private byte[] nonceData = null;
|
||||
|
||||
/**
|
||||
* Create a {@code OCSPNonceExtension} by providing the nonce length.
|
||||
* Create an {@code OCSPNonceExtension} by providing the nonce length.
|
||||
* The criticality is set to false, and the OID for the extension will
|
||||
* be the value defined by "id-pkix-ocsp-nonce" from RFC 6960.
|
||||
*
|
||||
@ -66,7 +66,7 @@ public final class OCSPNonceExtension extends Extension {
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a {@code OCSPNonceExtension} by providing the nonce length and
|
||||
* Create an {@code OCSPNonceExtension} by providing the nonce length and
|
||||
* criticality setting. The OID for the extension will
|
||||
* be the value defined by "id-pkix-ocsp-nonce" from RFC 6960.
|
||||
*
|
||||
@ -96,7 +96,7 @@ public final class OCSPNonceExtension extends Extension {
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a {@code OCSPNonceExtension} by providing a nonce value.
|
||||
* Create an {@code OCSPNonceExtension} by providing a nonce value.
|
||||
* The criticality is set to false, and the OID for the extension will
|
||||
* be the value defined by "id-pkix-ocsp-nonce" from RFC 6960.
|
||||
*
|
||||
@ -114,7 +114,7 @@ public final class OCSPNonceExtension extends Extension {
|
||||
}
|
||||
|
||||
/**
|
||||
* Create a {@code OCSPNonceExtension} by providing a nonce value and
|
||||
* Create an {@code OCSPNonceExtension} by providing a nonce value and
|
||||
* criticality setting. The OID for the extension will
|
||||
* be the value defined by "id-pkix-ocsp-nonce" from RFC 6960.
|
||||
*
|
||||
|
||||
@ -123,7 +123,7 @@ final class SSLSocketInputRecord extends InputRecord implements SSLRecord {
|
||||
*/
|
||||
//
|
||||
// Short header is using here. We reverse the code here
|
||||
// in case it it used in the future.
|
||||
// in case it is used in the future.
|
||||
//
|
||||
// int mask = (isShort ? 0x7F : 0x3F);
|
||||
// len = ((byteZero & mask) << 8) +
|
||||
|
||||
@ -148,7 +148,7 @@ public class AttributeList extends ArrayList<Object> {
|
||||
* <p>If this method has ever been called on a given
|
||||
* {@code AttributeList} instance, a subsequent attempt to add
|
||||
* an object to that instance which is not an {@code Attribute}
|
||||
* will fail with a {@code IllegalArgumentException}. For compatibility
|
||||
* will fail with an {@code IllegalArgumentException}. For compatibility
|
||||
* reasons, an {@code AttributeList} on which this method has never
|
||||
* been called does allow objects other than {@code Attribute}s to
|
||||
* be added.</p>
|
||||
|
||||
@ -215,7 +215,7 @@ public class MBeanFeatureInfo implements Serializable, DescriptorRead {
|
||||
* <ul>
|
||||
* <li>1. The method {@link ObjectInputStream#readObject readObject()}
|
||||
* is called twice to obtain the field names (a {@code String[]}) and
|
||||
* the field values (a {@code Object[]}) of the {@code descriptor}.
|
||||
* the field values (an {@code Object[]}) of the {@code descriptor}.
|
||||
* The two obtained values then are used to construct
|
||||
* an {@link ImmutableDescriptor} instance for the field
|
||||
* {@code descriptor};</li>
|
||||
|
||||
@ -670,7 +670,7 @@ public class MBeanInfo implements Cloneable, Serializable, DescriptorRead {
|
||||
* <ul>
|
||||
* <li>1. The method {@link ObjectInputStream#readObject readObject()}
|
||||
* is called twice to obtain the field names (a {@code String[]}) and
|
||||
* the field values (a {@code Object[]}) of the {@code descriptor}.
|
||||
* the field values (an {@code Object[]}) of the {@code descriptor}.
|
||||
* The two obtained values then are used to construct
|
||||
* an {@link ImmutableDescriptor} instance for the field
|
||||
* {@code descriptor};</li>
|
||||
|
||||
@ -34,7 +34,7 @@ import java.util.HashMap;
|
||||
* An abstract sensor.
|
||||
*
|
||||
* <p>
|
||||
* A {@code AbstractSensor} object consists of two attributes:
|
||||
* An {@code AbstractSensor} object consists of two attributes:
|
||||
* <ul>
|
||||
* <li>{@code on} is a boolean flag indicating if a sensor is
|
||||
* triggered. This flag will be set or cleared by the
|
||||
|
||||
@ -27,14 +27,14 @@ package sun.management.counter.perf;
|
||||
|
||||
public class InstrumentationException extends RuntimeException {
|
||||
/**
|
||||
* Constructs a {@code InstrumentationException} with no
|
||||
* Constructs an {@code InstrumentationException} with no
|
||||
* detail message.
|
||||
*/
|
||||
public InstrumentationException() {
|
||||
}
|
||||
|
||||
/**
|
||||
* Constructs a {@code InstrumentationException} with a specified
|
||||
* Constructs an {@code InstrumentationException} with a specified
|
||||
* detail message.
|
||||
*
|
||||
* @param message the detail message
|
||||
|
||||
@ -78,7 +78,7 @@ final class EventQueue implements Runnable {
|
||||
* {@code UnsolicitedNotificationEvent}.
|
||||
* If it is a subclass of {@code NamingEvent}, all listeners must implement
|
||||
* the corresponding subinterface of {@code NamingListener}.
|
||||
* For example, for a {@code ObjectAddedEvent}, all listeners <em>must</em>
|
||||
* For example, for an {@code ObjectAddedEvent}, all listeners <em>must</em>
|
||||
* implement the {@code ObjectAddedListener} interface.
|
||||
* <em>The current implementation does not check this before dispatching
|
||||
* the event.</em>
|
||||
|
||||
@ -56,7 +56,7 @@ import javax.naming.NamingException;
|
||||
*{@code NameNotFoundException}).
|
||||
*<p>
|
||||
* An application can use the method {@code targetMustExist()} to check
|
||||
* whether a {@code EventContext} supports registration
|
||||
* whether an {@code EventContext} supports registration
|
||||
* of nonexistent targets.
|
||||
*
|
||||
*<h1>Event Source</h1>
|
||||
@ -92,7 +92,7 @@ import javax.naming.NamingException;
|
||||
* which it invoked {@code addNamingListener()} (just as
|
||||
* it needs to keep a reference to the listener in order to remove it
|
||||
* later). It cannot expect to do a {@code lookup()} and get another instance of
|
||||
* a {@code EventContext} on which to perform the deregistration.
|
||||
* an {@code EventContext} on which to perform the deregistration.
|
||||
*<h1>Lifetime of Registration</h1>
|
||||
* A registered listener becomes deregistered when:
|
||||
*<ul>
|
||||
@ -102,7 +102,7 @@ import javax.naming.NamingException;
|
||||
*<li>{@code Context.close()} is invoked on the {@code EventContext}
|
||||
* instance with which it has registered.
|
||||
</ul>
|
||||
* Until that point, a {@code EventContext} instance that has outstanding
|
||||
* Until that point, an {@code EventContext} instance that has outstanding
|
||||
* listeners will continue to exist and be maintained by the service provider.
|
||||
*
|
||||
*<h1>Listener Implementations</h1>
|
||||
|
||||
@ -40,7 +40,7 @@ package javax.naming.event;
|
||||
* from the {@code EventContext} with which it has registered.
|
||||
*<p>
|
||||
* For example, suppose a listener implements {@code ObjectChangeListener} and
|
||||
* registers with a {@code EventContext}.
|
||||
* registers with an {@code EventContext}.
|
||||
* Then, if the connection to the server is subsequently broken,
|
||||
* the listener will receive a {@code NamingExceptionEvent} and may
|
||||
* take some corrective action, such as notifying the user of the application.
|
||||
|
||||
@ -32,7 +32,7 @@ import javax.naming.event.NamingListener;
|
||||
* "Unsolicited notification" is defined in
|
||||
* <A HREF="http://www.ietf.org/rfc/rfc2251.txt">RFC 2251</A>.
|
||||
* It allows the server to send unsolicited notifications to the client.
|
||||
* A {@code UnsolicitedNotificationListener} must:
|
||||
* An {@code UnsolicitedNotificationListener} must:
|
||||
*<ol>
|
||||
* <li>Implement this interface and its method
|
||||
* <li>Implement {@code NamingListener.namingExceptionThrown()} so
|
||||
@ -41,7 +41,7 @@ import javax.naming.event.NamingListener;
|
||||
* <li>Register with the context using one of the {@code addNamingListener()}
|
||||
* methods from {@code EventContext} or {@code EventDirContext}.
|
||||
* Only the {@code NamingListener} argument of these methods are applicable;
|
||||
* the rest are ignored for a {@code UnsolicitedNotificationListener}.
|
||||
* the rest are ignored for an {@code UnsolicitedNotificationListener}.
|
||||
* (These arguments might be applicable to the listener if it implements
|
||||
* other listener interfaces).
|
||||
*</ol>
|
||||
|
||||
@ -61,7 +61,7 @@ public final class EncryptionKey implements SecretKey {
|
||||
private transient boolean destroyed = false;
|
||||
|
||||
/**
|
||||
* Constructs a {@code EncryptionKey} from the given bytes and
|
||||
* Constructs an {@code EncryptionKey} from the given bytes and
|
||||
* the key type.
|
||||
* <p>
|
||||
* The contents of the byte array are copied; subsequent modification of
|
||||
|
||||
@ -3799,7 +3799,7 @@ public class JdbcRowSetImpl extends BaseRowSet implements JdbcRowSet, Joinable {
|
||||
* Retrieves the column id as {@code int} array that was set using
|
||||
* {@code setMatchColumn(int [])} for this rowset.
|
||||
*
|
||||
* @return a {@code int} array object that contains the column ids
|
||||
* @return an {@code int} array object that contains the column ids
|
||||
* for the rowset which has this as the match columns.
|
||||
*
|
||||
* @throws SQLException if an error occurs or column index is not set
|
||||
@ -6226,7 +6226,7 @@ public class JdbcRowSetImpl extends BaseRowSet implements JdbcRowSet, Joinable {
|
||||
|
||||
|
||||
/**
|
||||
* Sets the designated parameter to a {@code InputStream} object. The inputstream must contain the number
|
||||
* Sets the designated parameter to an {@code InputStream} object. The inputstream must contain the number
|
||||
* of characters specified by length otherwise a {@code SQLException} will be
|
||||
* generated when the {@code PreparedStatement} is executed.
|
||||
* This method differs from the {@code setBinaryStream (int, InputStream, int)}
|
||||
@ -6256,7 +6256,7 @@ public class JdbcRowSetImpl extends BaseRowSet implements JdbcRowSet, Joinable {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the designated parameter to a {@code InputStream} object.
|
||||
* Sets the designated parameter to an {@code InputStream} object.
|
||||
* This method differs from the {@code setBinaryStream (int, InputStream)}
|
||||
* This method differs from the {@code setBinaryStream (int, InputStream)}
|
||||
* method because it informs the driver that the parameter value should be
|
||||
@ -6287,7 +6287,7 @@ public class JdbcRowSetImpl extends BaseRowSet implements JdbcRowSet, Joinable {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the designated parameter to a {@code InputStream} object. The {@code inputstream} must contain the number
|
||||
* Sets the designated parameter to an {@code InputStream} object. The {@code inputstream} must contain the number
|
||||
* of characters specified by length, otherwise a {@code SQLException} will be
|
||||
* generated when the {@code CallableStatement} is executed.
|
||||
* This method differs from the {@code setBinaryStream (int, InputStream, int)}
|
||||
@ -6336,7 +6336,7 @@ public class JdbcRowSetImpl extends BaseRowSet implements JdbcRowSet, Joinable {
|
||||
}
|
||||
|
||||
/**
|
||||
* Sets the designated parameter to a {@code InputStream} object.
|
||||
* Sets the designated parameter to an {@code InputStream} object.
|
||||
* This method differs from the {@code setBinaryStream (int, InputStream)}
|
||||
* method because it informs the driver that the parameter value should be
|
||||
* sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used,
|
||||
|
||||
@ -4586,7 +4586,7 @@ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver {
|
||||
* Retrieves the column id as {@code int} array that was set using
|
||||
* {@code setMatchColumn(int [])} for this rowset.
|
||||
*
|
||||
* @return a {@code int} array object that contains the column ids
|
||||
* @return an {@code int} array object that contains the column ids
|
||||
* for the rowset which has this as the match columns.
|
||||
*
|
||||
* @throws SQLException if an error occurs or column index is not set
|
||||
|
||||
@ -1882,7 +1882,7 @@ public interface CallableStatement extends PreparedStatement {
|
||||
throws SQLException;
|
||||
|
||||
/**
|
||||
* Sets the designated parameter to a {@code InputStream} object.
|
||||
* Sets the designated parameter to an {@code InputStream} object.
|
||||
* The <code>Inputstream</code> must contain the number
|
||||
* of characters specified by length, otherwise a <code>SQLException</code> will be
|
||||
* generated when the <code>CallableStatement</code> is executed.
|
||||
@ -2379,7 +2379,7 @@ public interface CallableStatement extends PreparedStatement {
|
||||
throws SQLException;
|
||||
|
||||
/**
|
||||
* Sets the designated parameter to a {@code InputStream} object.
|
||||
* Sets the designated parameter to an {@code InputStream} object.
|
||||
* This method differs from the <code>setBinaryStream (int, InputStream)</code>
|
||||
* method because it informs the driver that the parameter value should be
|
||||
* sent to the server as a <code>BLOB</code>. When the <code>setBinaryStream</code> method is used,
|
||||
|
||||
@ -101,7 +101,7 @@ public interface AgreementMethod {
|
||||
/**
|
||||
* Adds additional {@code AgreementMethod} information.
|
||||
*
|
||||
* @param info a {@code Element} that represents additional information
|
||||
* @param info an {@code Element} that represents additional information
|
||||
* specified by
|
||||
* <pre>{@code
|
||||
* <any namespace="##other" minOccurs="0" maxOccurs="unbounded"/>
|
||||
@ -112,7 +112,7 @@ public interface AgreementMethod {
|
||||
/**
|
||||
* Removes additional {@code AgreementMethod} information.
|
||||
*
|
||||
* @param info a {@code Element} that represents additional information
|
||||
* @param info an {@code Element} that represents additional information
|
||||
* specified by
|
||||
* <pre>{@code
|
||||
* <any namespace="##other" minOccurs="0" maxOccurs="unbounded"/>
|
||||
|
||||
@ -36,14 +36,14 @@ public class InvalidModuleException extends RuntimeException {
|
||||
private static final long serialVersionUID = 7907359387320658039L;
|
||||
|
||||
/**
|
||||
* Constructs a {@code InvalidModuleException} with no detail message.
|
||||
* Constructs an {@code InvalidModuleException} with no detail message.
|
||||
*/
|
||||
public InvalidModuleException() {
|
||||
super();
|
||||
}
|
||||
|
||||
/**
|
||||
* Constructs a {@code InvalidModuleException} with the given detail
|
||||
* Constructs an {@code InvalidModuleException} with the given detail
|
||||
* message.
|
||||
*
|
||||
* @param msg
|
||||
|
||||
Loading…
x
Reference in New Issue
Block a user