--- old/src/java.base/share/classes/com/sun/net/ssl/SSLContext.java 2015-06-05 21:04:11.855466093 +0400 +++ new/src/java.base/share/classes/com/sun/net/ssl/SSLContext.java 2015-06-05 21:04:11.695466093 +0400 @@ -58,7 +58,7 @@ * * @param contextSpi the delegate * @param provider the provider - * @param algorithm the algorithm + * @param protocol the protocol */ protected SSLContext(SSLContextSpi contextSpi, Provider provider, String protocol) { --- old/src/java.base/share/classes/com/sun/net/ssl/SSLContextSpi.java 2015-06-05 21:04:12.367466093 +0400 +++ new/src/java.base/share/classes/com/sun/net/ssl/SSLContextSpi.java 2015-06-05 21:04:12.207466093 +0400 @@ -49,9 +49,9 @@ /** * Initializes this context. * - * @param km the sources of authentication keys - * @param tm the sources of peer authentication trust decisions - * @param random the source of randomness for this generator + * @param ah the sources of authentication keys + * @param th the sources of peer authentication trust decisions + * @param sr the source of randomness for this generator */ protected abstract void engineInit(KeyManager[] ah, TrustManager[] th, SecureRandom sr) throws KeyManagementException; --- old/src/java.base/share/classes/com/sun/net/ssl/SSLPermission.java 2015-06-05 21:04:12.867466092 +0400 +++ new/src/java.base/share/classes/com/sun/net/ssl/SSLPermission.java 2015-06-05 21:04:12.707466092 +0400 @@ -52,7 +52,6 @@ * The following table lists all the possible SSLPermission target names, * and for each provides a description of what the permission allows * and a discussion of the risks of granting code the permission. - *
* *
+ * * @serialData Default fields followed by separator character. */ private synchronized void writeObject(java.io.ObjectOutputStream s) --- old/src/java.base/share/classes/java/lang/Process.java 2015-06-05 21:04:13.895466091 +0400 +++ new/src/java.base/share/classes/java/lang/Process.java 2015-06-05 21:04:13.731466091 +0400 @@ -368,7 +368,7 @@ * Processes returned from {@link ProcessBuilder#start} override the * default implementation to provide an efficient mechanism to wait * for process exit. - *
+ * * @apiNote * Using {@link #onExit() onExit} is an alternative to * {@link #waitFor() waitFor} that enables both additional concurrency --- old/src/java.base/share/classes/java/lang/ProcessHandle.java 2015-06-05 21:04:14.403466091 +0400 +++ new/src/java.base/share/classes/java/lang/ProcessHandle.java 2015-06-05 21:04:14.239466091 +0400 @@ -71,7 +71,7 @@ * The ability to control processes is also restricted by the native system, * ProcessHandle provides no more access to, or control over, the native process * than would be allowed by a native application. - *
+ * * @implSpec * In the case where ProcessHandles cannot be supported then the factory * methods must consistently throw {@link java.lang.UnsupportedOperationException}. --- old/src/java.base/share/classes/java/text/SimpleDateFormat.java 2015-06-05 21:04:14.907466090 +0400 +++ new/src/java.base/share/classes/java/text/SimpleDateFormat.java 2015-06-05 21:04:14.743466091 +0400 @@ -2374,7 +2374,7 @@ /** * After reading an object from the input stream, the format * pattern in the object is verified. - *
+ * * @exception InvalidObjectException if the pattern is invalid */ private void readObject(ObjectInputStream stream) --- old/src/java.base/share/classes/javax/security/auth/Subject.java 2015-06-05 21:04:15.431466090 +0400 +++ new/src/java.base/share/classes/javax/security/auth/Subject.java 2015-06-05 21:04:15.267466090 +0400 @@ -1401,8 +1401,6 @@ /** * Writes this object out to a stream (i.e., serializes it). * - *
- * * @serialData If this is a private credential set, * a security check is performed to ensure that * the caller has permission to access each credential --- old/src/java.base/share/classes/jdk/internal/org/objectweb/asm/util/TraceClassVisitor.java 2015-06-05 21:04:15.943466090 +0400 +++ new/src/java.base/share/classes/jdk/internal/org/objectweb/asm/util/TraceClassVisitor.java 2015-06-05 21:04:15.783466090 +0400 @@ -74,36 +74,34 @@ * visitor chain to trace the class that is visited at a given point in this * chain. This may be useful for debugging purposes. *
- * The trace printed when visiting the Hello class is the following: - *
+ * The trace printed when visiting the {@code Hello} class is the following: *
* - * + * {@code * // class version 49.0 (49) // access flags 0x21 public class Hello { * * // compiled from: Hello.java * - * // access flags 0x1 public <init> ()V ALOAD 0 INVOKESPECIAL - * java/lang/Object <init> ()V RETURN MAXSTACK = 1 MAXLOCALS = 1 + * // access flags 0x1 public ()V ALOAD 0 INVOKESPECIAL + * java/lang/Object ()V RETURN MAXSTACK = 1 MAXLOCALS = 1 * * // access flags 0x9 public static main ([Ljava/lang/String;)V GETSTATIC - * java/lang/System out Ljava/io/PrintStream; LDC "hello" + * java/lang/System out Ljava/io/PrintStream; LDC "hello" * INVOKEVIRTUAL java/io/PrintStream println (Ljava/lang/String;)V RETURN * MAXSTACK = 2 MAXLOCALS = 1 } - * + * } * - *
+ * {@code * // class version 49.0 (49) // access flags 0x21 public class Hello { * * // compiled from: Hello.java * - * // access flags 0x1 public <init> ()V ALOAD 0 INVOKESPECIAL - * java/lang/Object <init> ()V RETURN MAXSTACK = 1 MAXLOCALS = 1 + * // access flags 0x1 public ()V ALOAD 0 INVOKESPECIAL + * java/lang/Object ()V RETURN MAXSTACK = 1 MAXLOCALS = 1 * * // access flags 0x9 public static main ([Ljava/lang/String;)V GETSTATIC - * java/lang/System out Ljava/io/PrintStream; LDC "hello" + * java/lang/System out Ljava/io/PrintStream; LDC "hello" * INVOKEVIRTUAL java/io/PrintStream println (Ljava/lang/String;)V RETURN * MAXSTACK = 2 MAXLOCALS = 1 } - * + * }
{@code * // class version 49.0 (49) // access flags 0x21 public class Hello { * * // compiled from: Hello.java * - * // access flags 0x1 public <init> ()V ALOAD 0 INVOKESPECIAL - * java/lang/Object <init> ()V RETURN MAXSTACK = 1 MAXLOCALS = 1 + * // access flags 0x1 public ()V ALOAD 0 INVOKESPECIAL + * java/lang/Object ()V RETURN MAXSTACK = 1 MAXLOCALS = 1 * * // access flags 0x9 public static main ([Ljava/lang/String;)V GETSTATIC - * java/lang/System out Ljava/io/PrintStream; LDC "hello" + * java/lang/System out Ljava/io/PrintStream; LDC "hello" * INVOKEVIRTUAL java/io/PrintStream println (Ljava/lang/String;)V RETURN * MAXSTACK = 2 MAXLOCALS = 1 } - *
+ * where {@code Hello} is defined by: *
* - * + * {@code * public class Hello { * * public static void main(String[] args) { - * System.out.println("hello"); + * System.out.println("hello"); * } * } - * + * } * *
+ * {@code * public class Hello { * * public static void main(String[] args) { - * System.out.println("hello"); + * System.out.println("hello"); * } * } - * + * }
{@code * public class Hello { * * public static void main(String[] args) { - * System.out.println("hello"); + * System.out.println("hello"); * } * } - *
{@code * ftp.mumble.bar/... => ftp://ftp.mumble.bar/... * gopher.mumble.bar/... => gopher://gopher.mumble.bar/... * other.name.dom/... => http://other.name.dom/... * /foo/... => file:/foo/... + * }
OutputStream
String containing the name of the file to + * @param name a {@code String} containing the name of the file to * retreive from the server. * @param local the OutputStream the file should be written to. * @throws IOException if the transfer fails. --- old/src/java.base/share/classes/sun/net/www/MessageHeader.java 2015-06-05 21:04:19.171466087 +0400 +++ new/src/java.base/share/classes/sun/net/www/MessageHeader.java 2015-06-05 21:04:19.007466087 +0400 @@ -411,7 +411,7 @@ } /** Convert a message-id string to canonical form (strips off - leading and trailing <>s) */ + leading and trailing {@literal <>s}) */ public static String canonicalID(String id) { if (id == null) return ""; --- old/src/java.base/share/classes/sun/net/www/http/HttpClient.java 2015-06-05 21:04:19.675466087 +0400 +++ new/src/java.base/share/classes/sun/net/www/http/HttpClient.java 2015-06-05 21:04:19.511466087 +0400 @@ -625,7 +625,7 @@ } /** Parse the first line of the HTTP request. It usually looks - something like: "HTTP/1.0 comment\r\n". */ + something like: {@literal "HTTP/1.0 comment\r\n"}. */ public boolean parseHTTP(MessageHeader responses, ProgressSource pi, HttpURLConnection httpuc) throws IOException { --- old/src/java.base/share/classes/sun/net/www/protocol/ftp/FtpURLConnection.java 2015-06-05 21:04:20.183466086 +0400 +++ new/src/java.base/share/classes/sun/net/www/protocol/ftp/FtpURLConnection.java 2015-06-05 21:04:20.023466086 +0400 @@ -68,13 +68,14 @@ * Disconnect * * You should not have to use it directly in most cases because all will be handled - * in a abstract layer. Here is an example of how to use the class : - * - * URL url = new URL("ftp://ftp.sun.com/pub/test.txt"); - * UrlConnection con = url.openConnection(); - * InputStream is = con.getInputStream(); - * ... - * is.close(); + * in a abstract layer. Here is an example of how to use the class: + * {@code + * URL url = new URL("ftp://ftp.sun.com/pub/test.txt"); + * UrlConnection con = url.openConnection(); + * InputStream is = con.getInputStream(); + * ... + * is.close(); + * } * * @see sun.net.ftp.FtpClient */ @@ -158,7 +159,7 @@ /** * Creates an FtpURLConnection from a URL. * - * @param url The URL to retrieve or store. + * @param url The {@code URL} to retrieve or store. */ public FtpURLConnection(URL url) { this(url, null); @@ -382,7 +383,7 @@ * Get the InputStream to retreive the remote file. It will issue the * "get" (or "dir") command to the ftp server. * - * @return the InputStream to the connection. + * @return the {@code InputStream} to the connection. * * @throws IOException if already opened for output * @throws FtpProtocolException if errors occur during the transfert. @@ -495,7 +496,7 @@ * Get the OutputStream to store the remote file. It will issue the * "put" command to the ftp server. * - * @return the OutputStream to the connection. + * @return the {@code OutputStream} to the connection. * * @throws IOException if already opened for input or the URL * points to a directory @@ -548,9 +549,9 @@ } /** - * Gets the Permission associated with the host & port. + * Gets the {@code Permission} associated with the host and port. * - * @return The Permission object. + * @return The {@code Permission} object. */ @Override public Permission getPermission() { @@ -568,7 +569,7 @@ * exists, overwrite its value with the new value. * * @param key the keyword by which the request is known - * (e.g., "accept"). + * (e.g., "{@code accept}"). * @param value the value associated with it. * @throws IllegalStateException if already connected * @see #getRequestProperty(java.lang.String) --- old/src/java.base/share/classes/sun/net/www/protocol/http/HttpAuthenticator.java 2015-06-05 21:04:20.691466086 +0400 +++ new/src/java.base/share/classes/sun/net/www/protocol/http/HttpAuthenticator.java 2015-06-05 21:04:20.527466086 +0400 @@ -59,6 +59,7 @@ * supplied or could be found. * * Example: + * {@code * --> GET http://www.authorization-required.com/ HTTP/1.0 * <-- HTTP/1.0 403 Unauthorized * <-- WWW-Authenticate: Basic realm="WallyWorld" @@ -67,8 +68,9 @@ * return "QWadhgWERghghWERfdfQ==" * --> GET http://www.authorization-required.com/ HTTP/1.0 * --> Authorization: Basic QWadhgWERghghWERfdfQ== - * <-- HTTP/1.0 200 OK + * <-- HTTP/1.0 200 OK} * YAY!!! + * */ public String authString (URL u, String scheme, String realm); --- old/src/java.base/share/classes/sun/net/www/protocol/http/HttpURLConnection.java 2015-06-05 21:04:21.191466085 +0400 +++ new/src/java.base/share/classes/sun/net/www/protocol/http/HttpURLConnection.java 2015-06-05 21:04:21.027466085 +0400 @@ -1954,7 +1954,7 @@ /** * Set the tunneling status. * - * @param the state + * @param tunnelState the state */ public void setTunnelState(TunnelState tunnelState) { this.tunnelState = tunnelState; --- old/src/java.base/share/classes/sun/net/www/protocol/jar/JarURLConnection.java 2015-06-05 21:04:21.723466085 +0400 +++ new/src/java.base/share/classes/sun/net/www/protocol/jar/JarURLConnection.java 2015-06-05 21:04:21.559466085 +0400 @@ -338,7 +338,7 @@ * Sets the value of the ifModifiedSince field of * this URLConnection to the specified value. * - * @param value the new value. + * @param ifmodifiedsince the new value. * @see java.net.URLConnection#ifModifiedSince */ public void setIfModifiedSince(long ifmodifiedsince) { --- old/src/java.base/share/classes/sun/reflect/annotation/AnnotationParser.java 2015-06-05 21:04:22.227466084 +0400 +++ new/src/java.base/share/classes/sun/reflect/annotation/AnnotationParser.java 2015-06-05 21:04:22.063466085 +0400 @@ -295,7 +295,7 @@ /** * Returns an annotation of the given type backed by the given - * member -> value map. + * member {@literal ->} value map. */ public static Annotation annotationForMap(final Class extends Annotation> type, final Map memberValues) --- old/src/java.base/share/classes/sun/reflect/annotation/AnnotationType.java 2015-06-05 21:04:22.735466084 +0400 +++ new/src/java.base/share/classes/sun/reflect/annotation/AnnotationType.java 2015-06-05 21:04:22.571466084 +0400 @@ -73,8 +73,8 @@ /** * Returns an AnnotationType instance for the specified annotation type. * - * @throw IllegalArgumentException if the specified class object for - * does not represent a valid annotation type + * @throws IllegalArgumentException if the specified class object + * does not represent a valid annotation type */ public static AnnotationType getInstance( Class extends Annotation> annotationClass) @@ -183,7 +183,7 @@ /** * Returns member types for this annotation type - * (member name -> type mapping). + * (member name {@literal ->} type mapping). */ public Map> memberTypes() { return memberTypes; @@ -191,7 +191,7 @@ /** * Returns members of this annotation type - * (member name -> associated Method object mapping). + * (member name {@literal ->} associated Method object mapping). */ public Map members() { return members; @@ -199,7 +199,7 @@ /** * Returns the default values for this annotation type - * (Member name -> default value mapping). + * (Member name {@literal ->} default value mapping). */ public Map memberDefaults() { return memberDefaults; --- old/src/java.base/share/classes/sun/reflect/annotation/TypeAnnotationParser.java 2015-06-05 21:04:23.239466084 +0400 +++ new/src/java.base/share/classes/sun/reflect/annotation/TypeAnnotationParser.java 2015-06-05 21:04:23.075466084 +0400 @@ -199,7 +199,7 @@ * Regular Annotations on TypeVariables are stored in the type * annotation byte[] in the class file. * - * @param genericsDecl the declaration declaring the type variable + * @param genericDecl the declaration declaring the type variable * @param typeVarIndex the 0-based index of this type variable in the declaration */ public static Annotation[] parseTypeVariableAnnotations(D genericDecl, --- old/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/ParameterizedTypeImpl.java 2015-06-05 21:04:23.743466083 +0400 +++ new/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/ParameterizedTypeImpl.java 2015-06-05 21:04:23.579466083 +0400 @@ -73,17 +73,17 @@ * This method throws a MalformedParameterizedTypeException * under the following circumstances: * If the number of actual type arguments (i.e., the size of the - * array typeArgs) does not correspond to the number of + * array {@code typeArgs}) does not correspond to the number of * formal type arguments. * If any of the actual type arguments is not an instance of the * bounds on the corresponding formal. * @param rawType the Class representing the generic type declaration being * instantiated - * @param actualTypeArguments - a (possibly empty) array of types + * @param actualTypeArguments a (possibly empty) array of types * representing the actual type arguments to the parameterized type - * @param ownerType - the enclosing type, if known. - * @return An instance of ParameterizedType - * @throws MalformedParameterizedTypeException - if the instantiation + * @param ownerType the enclosing type, if known. + * @return An instance of {@code ParameterizedType} + * @throws MalformedParameterizedTypeException if the instantiation * is invalid */ public static ParameterizedTypeImpl make(Class> rawType, @@ -95,18 +95,18 @@ /** - * Returns an array of Type objects representing the actual type + * Returns an array of {@code Type} objects representing the actual type * arguments to this type. * * Note that in some cases, the returned array be empty. This can occur * if this type represents a non-parameterized type nested within * a parameterized type. * - * @return an array of Type objects representing the actual type + * @return an array of {@code Type} objects representing the actual type * arguments to this type - * @throws TypeNotPresentException if any of the + * @throws TypeNotPresentException if any of the * actual type arguments refers to a non-existent type declaration - * @throws MalformedParameterizedTypeException if any of the + * @throws MalformedParameterizedTypeException if any of the * actual type parameters refer to a parameterized type that cannot * be instantiated for any reason * @since 1.5 @@ -116,10 +116,10 @@ } /** - * Returns the Type object representing the class or interface + * Returns the {@code Type} object representing the class or interface * that declared this type. * - * @return the Type object representing the class or interface + * @return the {@code Type} object representing the class or interface * that declared this type */ public Class> getRawType() { @@ -128,18 +128,18 @@ /** - * Returns a Type object representing the type that this type - * is a member of. For example, if this type is O.I, - * return a representation of O. + * Returns a {@code Type} object representing the type that this type + * is a member of. For example, if this type is {@code O.I}, + * return a representation of {@code O}. * - * If this type is a top-level type, null is returned. + * If this type is a top-level type, {@code null} is returned. * - * @return a Type object representing the type that + * @return a {@code Type} object representing the type that * this type is a member of. If this type is a top-level type, - * null is returned - * @throws TypeNotPresentException if the owner type + * {@code null} is returned + * @throws TypeNotPresentException if the owner type * refers to a non-existent type declaration - * @throws MalformedParameterizedTypeException if the owner type + * @throws MalformedParameterizedTypeException if the owner type * refers to a parameterized type that cannot be instantiated * for any reason * --- old/src/java.base/share/classes/sun/reflect/generics/scope/ConstructorScope.java 2015-06-05 21:04:24.251466083 +0400 +++ new/src/java.base/share/classes/sun/reflect/generics/scope/ConstructorScope.java 2015-06-05 21:04:24.087466083 +0400 @@ -56,9 +56,9 @@ } /** - * Factory method. Takes a Constructor object and creates a + * Factory method. Takes a {@code Constructor} object and creates a * scope for it. - * @param m - A Constructor whose scope we want to obtain + * @param c - A Constructor whose scope we want to obtain * @return The type-variable scope for the constructor m */ public static ConstructorScope make(Constructor> c) { --- old/src/java.base/share/classes/sun/util/PreHashedMap.java 2015-06-05 21:04:24.751466082 +0400 +++ new/src/java.base/share/classes/sun/util/PreHashedMap.java 2015-06-05 21:04:24.587466082 +0400 @@ -121,8 +121,7 @@ * This method must construct the map's hash chains and store them into * the appropriate elements of the given hash-table row array. * - * @param rows - * The row array to be initialized + * @param ht The row array to be initialized */ protected abstract void init(Object[] ht); --- old/src/java.base/share/classes/sun/util/calendar/BaseCalendar.java 2015-06-05 21:04:25.251466082 +0400 +++ new/src/java.base/share/classes/sun/util/calendar/BaseCalendar.java 2015-06-05 21:04:25.087466082 +0400 @@ -28,7 +28,7 @@ import java.util.TimeZone; /** - * The BaseCalendar provides basic calendar calculation + * The {@code BaseCalendar} provides basic calendar calculation * functions to support the Julian, Gregorian, and Gregorian-based * calendar systems. * @@ -290,11 +290,11 @@ /** * Returns 366 if the specified date is in a leap year, or 365 * otherwise This method does not perform the normalization with - * the specified CalendarDate. The - * CalendarDate must be normalized to get a correct + * the specified {@code CalendarDate}. The + * {@code CalendarDate} must be normalized to get a correct * value. * - * @param a CalendarDate + * @param date a {@code CalendarDate} * @return a year length in days * @throws ClassCastException if the specified date is not a * {@link BaseCalendar.Date} @@ -412,7 +412,7 @@ /** * Calculates calendar fields and store them in the specified - * CalendarDate. + * {@code CalendarDate}. */ // should be 'protected' public void getCalendarDateFromFixedDate(CalendarDate date, --- old/src/java.base/share/classes/sun/util/calendar/CalendarUtils.java 2015-06-05 21:04:25.759466082 +0400 +++ new/src/java.base/share/classes/sun/util/calendar/CalendarUtils.java 2015-06-05 21:04:25.595466082 +0400 @@ -94,7 +94,7 @@ * 0 and -1%4 is -1. * * @param n the numerator - * @param d a divisor which must be > 0 + * @param d a divisor which must be {@literal > 0} * @param r an array of at least one element in which the value * mod(n, d) is returned. * @return the floor of the quotient. @@ -117,7 +117,7 @@ * 0 and -1%4 is -1. * * @param n the numerator - * @param d a divisor which must be > 0 + * @param d a divisor which must be {@literal > 0} * @param r an array of at least one element in which the value * mod(n, d) is returned. * @return the floor of the quotient. --- old/src/java.base/share/classes/sun/util/calendar/ZoneInfo.java 2015-06-05 21:04:26.263466081 +0400 +++ new/src/java.base/share/classes/sun/util/calendar/ZoneInfo.java 2015-06-05 21:04:26.099466081 +0400 @@ -364,7 +364,7 @@ * 0 for January. * @param day The day-in-month of the given date. * @param dayOfWeek The day-of-week of the given date. - * @param millis The milliseconds in day in standard local time. + * @param milliseconds The milliseconds in day in standard local time. * @return The milliseconds to add to UTC to get local time. */ public int getOffset(int era, int year, int month, int day, --- old/src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java 2015-06-05 21:04:26.771466081 +0400 +++ new/src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java 2015-06-05 21:04:26.607466081 +0400 @@ -72,7 +72,7 @@ * If the name returned cannot be localized according to locale, * (say, the provider does not have a Japanese name for Croatian), * this method returns null. - * @param languageCode the ISO 639 language code string in the form of two + * @param lang the ISO 639 language code string in the form of two * lower-case letters between 'a' (U+0061) and 'z' (U+007A) * @param locale the desired locale * @return the name of the given language code for the specified locale, or null if it's not @@ -129,7 +129,7 @@ * If the name returned cannot be localized according to locale, * (say, the provider does not have a Japanese name for Croatia), * this method returns null. - * @param countryCode the ISO 3166 country code string in the form of two + * @param ctry the ISO 3166 country code string in the form of two * upper-case letters between 'A' (U+0041) and 'Z' (U+005A) * @param locale the desired locale * @return the name of the given country code for the specified locale, or null if it's not @@ -152,7 +152,7 @@ * is appropriate for display to the user. * If the name returned cannot be localized according to locale, * this method returns null. - * @param variant the variant string + * @param vrnt the variant string * @param locale the desired locale * @return the name of the given variant string for the specified locale, or null if it's not * available. --- old/src/java.base/share/classes/sun/util/locale/provider/TimeZoneNameProviderImpl.java 2015-06-05 21:04:27.363466080 +0400 +++ new/src/java.base/share/classes/sun/util/locale/provider/TimeZoneNameProviderImpl.java 2015-06-05 21:04:27.199466080 +0400 @@ -79,7 +79,7 @@ * appropriate for daylight saving time even if the specified time zone * has not observed daylight saving time in the past. * - * @param ID a time zone ID string + * @param id a time zone ID string * @param daylight if true, return the daylight saving name. * @param style either {@link java.util.TimeZone#LONG TimeZone.LONG} or * {@link java.util.TimeZone#SHORT TimeZone.SHORT} --- old/src/java.base/share/classes/sun/util/logging/PlatformLogger.java 2015-06-05 21:04:27.951466080 +0400 +++ new/src/java.base/share/classes/sun/util/logging/PlatformLogger.java 2015-06-05 21:04:27.787466080 +0400 @@ -74,10 +74,10 @@ * java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter * * Limitation: - * /conf/logging.properties is the system-wide logging + * {@code /conf/logging.properties} is the system-wide logging * configuration defined in the specification and read in the * default case to configure any java.util.logging.Logger instances. - * Platform loggers will not detect if /conf/logging.properties + * Platform loggers will not detect if {@code /conf/logging.properties} * is modified. In other words, unless the java.util.logging API * is used at runtime or the logging system properties is set, * the platform loggers will use the default setting described above. --- old/src/java.base/share/classes/sun/util/resources/TimeZoneNamesBundle.java 2015-06-05 21:04:28.459466079 +0400 +++ new/src/java.base/share/classes/sun/util/resources/TimeZoneNamesBundle.java 2015-06-05 21:04:28.295466079 +0400 @@ -55,7 +55,7 @@ * array for the enumeration returned by getKeys. * Inserts the time zone ID (the key of the bundle entries) into * the string arrays returned by handleGetObject. - * + * * All TimeZoneNames resource bundles must extend this * class and implement the getContents method. */ --- old/src/java.base/unix/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:28.963466079 +0400 +++ new/src/java.base/unix/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:28.799466079 +0400 @@ -50,7 +50,7 @@ } /** - * @returns the platform specific path corresponding to the URL + * @return the platform specific path corresponding to the URL * so long as the URL does not contain a hostname in the authority field. */ --- old/src/java.base/unix/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:29.467466078 +0400 +++ new/src/java.base/unix/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:29.303466079 +0400 @@ -113,7 +113,8 @@ Client client; /** * Create a NTLMAuthentication: - * Username may be specified as domainusername in the application Authenticator. + * Username may be specified as {@literal domainusername} + * in the application Authenticator. * If this notation is not used, then the domain will be taken * from a system property: "http.auth.ntlm.domain". */ --- old/src/java.base/windows/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:29.967466078 +0400 +++ new/src/java.base/windows/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:29.803466078 +0400 @@ -46,7 +46,7 @@ } /** - * @returns the platform specific path corresponding to the URL, and in particular + * @return the platform specific path corresponding to the URL, and in particular * returns a UNC when the authority contains a hostname */ --- old/src/java.base/windows/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:30.467466078 +0400 +++ new/src/java.base/windows/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:30.303466078 +0400 @@ -83,7 +83,8 @@ /** * Create a NTLMAuthentication: - * Username may be specified as domainusername in the application Authenticator. + * Username may be specified as {@literal domainusername} + * in the application Authenticator. * If this notation is not used, then the domain will be taken * from a system property: "http.auth.ntlm.domain". */ --- old/src/java.datatransfer/share/classes/sun/datatransfer/DataFlavorUtil.java 2015-06-05 21:04:30.971466077 +0400 +++ new/src/java.datatransfer/share/classes/sun/datatransfer/DataFlavorUtil.java 2015-06-05 21:04:30.807466077 +0400 @@ -55,7 +55,7 @@ /** * Utility class with different datatransfer helper functions * - * @see 1.9 + * @since 1.9 */ public class DataFlavorUtil { --- old/src/java.desktop/macosx/classes/com/apple/eio/FileManager.java 2015-06-05 21:04:31.483466077 +0400 +++ new/src/java.desktop/macosx/classes/com/apple/eio/FileManager.java 2015-06-05 21:04:31.319466077 +0400 @@ -97,7 +97,8 @@ /** - * Converts an OSType (e.g. "macs" from ) into an int. + * Converts an OSType (e.g. "macs" + * from {@literal }) into an int. * * @param type the 4 character type to convert. * @return an int representing the 4 character value @@ -355,7 +356,7 @@ /** * Moves the specified file to the Trash * - * @param file + * @param file the file * @return returns true if the NSFileManager successfully moved the file to the Trash. * @throws FileNotFoundException * --- old/src/java.desktop/share/classes/sun/applet/AppletPanel.java 2015-06-05 21:04:31.991466076 +0400 +++ new/src/java.desktop/share/classes/sun/applet/AppletPanel.java 2015-06-05 21:04:31.823466077 +0400 @@ -344,12 +344,14 @@ * Execute applet events. * Here is the state transition diagram * + * {@literal * Note: (XXX) is the action * APPLET_XXX is the state - * (applet code loaded) --> APPLET_LOAD -- (applet init called)--> APPLET_INIT -- ( - * applet start called) --> APPLET_START -- (applet stop called) -->APPLET_STOP --(applet - * destroyed called) --> APPLET_DESTROY -->(applet gets disposed) --> - * APPLET_DISPOSE -->.... + * (applet code loaded) --> APPLET_LOAD -- (applet init called)--> APPLET_INIT -- + * (applet start called) --> APPLET_START -- (applet stop called) --> APPLET_STOP -- + * (applet destroyed called) --> APPLET_DESTROY --> (applet gets disposed) --> + * APPLET_DISPOSE --> ... + * } * * In the legacy lifecycle model. The applet gets loaded, inited and started. So it stays * in the APPLET_START state unless the applet goes away(refresh page or leave the page). @@ -364,10 +366,9 @@ * APPLET_STOP to APPLET_DESTROY and to APPLET_INIT . * * Also, the applet can jump from APPLET_INIT state to APPLET_DESTROY (in Netscape/Mozilla case). - * Same as APPLET_LOAD to + * Same as APPLET_LOAD to * APPLET_DISPOSE since all of this are triggered by browser. * - * */ @Override public void run() { --- old/src/java.desktop/share/classes/sun/applet/AppletViewer.java 2015-06-05 21:04:32.503466076 +0400 +++ new/src/java.desktop/share/classes/sun/applet/AppletViewer.java 2015-06-05 21:04:32.335466076 +0400 @@ -1093,7 +1093,7 @@ } /** - * Scan an html file for tags + * Scan an html file for {@code } tags */ public static void parse(URL url, String enc) throws IOException { encoding = enc; --- old/src/java.naming/share/classes/com/sun/jndi/ldap/LdapName.java 2015-06-05 21:04:33.107466075 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/LdapName.java 2015-06-05 21:04:32.939466076 +0400 @@ -358,7 +358,7 @@ * Serializes only the unparsed DN, for compactness and to avoid * any implementation dependency. * - * @serialdata The DN string and a boolean indicating whether + * @serialData The DN string and a boolean indicating whether * the values are case sensitive. */ private void writeObject(java.io.ObjectOutputStream s) --- old/src/java.sql.rowset/share/classes/com/sun/rowset/JdbcRowSetImpl.java 2015-06-05 21:04:33.715466075 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/JdbcRowSetImpl.java 2015-06-05 21:04:33.547466075 +0400 @@ -35,7 +35,7 @@ import javax.sql.rowset.*; /** - * The standard implementation of the JdbcRowSet interface. See the interface + * The standard implementation of the {@code JdbcRowSet} interface. See the interface * definition for full behavior and implementation requirements. * * @author Jonathan Bruce, Amit Handa @@ -44,40 +44,40 @@ public class JdbcRowSetImpl extends BaseRowSet implements JdbcRowSet, Joinable { /** - * The Connection object that is this rowset's + * The {@code Connection} object that is this rowset's * current connection to the database. This field is set * internally when the connection is established. */ private Connection conn; /** - * The PreparedStatement object that is this rowset's + * The {@code PreparedStatement} object that is this rowset's * current command. This field is set internally when the method - * execute creates the PreparedStatement + * {@code execute} creates the {@code PreparedStatement} * object. */ private PreparedStatement ps; /** - * The ResultSet object that is this rowset's + * The {@code ResultSet} object that is this rowset's * current result set. This field is set internally when the method - * execute executes the rowset's command and thereby - * creates the rowset's ResultSet object. + * {@code execute} executes the rowset's command and thereby + * creates the rowset's {@code ResultSet} object. */ private ResultSet rs; /** - * The RowSetMetaDataImpl object that is constructed when - * a ResultSet object is passed to the JdbcRowSet + * The {@code RowSetMetaDataImpl} object that is constructed when + * a {@code ResultSet} object is passed to the {@code JdbcRowSet} * constructor. This helps in constructing all metadata associated - * with the ResultSet object using the setter methods of - * RowSetMetaDataImpl. + * with the {@code ResultSet} object using the setter methods of + * {@code RowSetMetaDataImpl}. */ private RowSetMetaDataImpl rowsMD; /** - * The ResultSetMetaData object from which this - * RowSetMetaDataImpl is formed and which helps in getting + * The {@code ResultSetMetaData} object from which this + * {@code RowSetMetaDataImpl} is formed and which helps in getting * the metadata information. */ private ResultSetMetaData resMD; @@ -97,13 +97,13 @@ protected transient JdbcRowSetResourceBundle resBundle; /** - * Constructs a default JdbcRowSet object. - * The new instance of JdbcRowSet will serve as a proxy - * for the ResultSet object it creates, and by so doing, + * Constructs a default {@code JdbcRowSet} object. + * The new instance of {@code JdbcRowSet} will serve as a proxy + * for the {@code ResultSet} object it creates, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -114,17 +114,17 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * - * A newly created JdbcRowSet object must have its - * execute method invoked before other public methods + * A newly created {@code JdbcRowSet} object must have its + * {@code execute} method invoked before other public methods * are called on it; otherwise, such method calls will cause an * exception to be thrown. * * @throws SQLException [1] if any of its public methods are called prior - * to calling the execute method; [2] if invalid JDBC driver + * to calling the {@code execute} method; [2] if invalid JDBC driver * properties are set or [3] if no connection to a data source exists. */ public JdbcRowSetImpl() { @@ -217,14 +217,14 @@ } /** - * Constructs a default JdbcRowSet object given a - * valid Connection object. The new - * instance of JdbcRowSet will serve as a proxy for - * the ResultSet object it creates, and by so doing, + * Constructs a default {@code JdbcRowSet} object given a + * valid {@code Connection} object. The new + * instance of {@code JdbcRowSet} will serve as a proxy for + * the {@code ResultSet} object it creates, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -235,17 +235,17 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * - * A newly created JdbcRowSet object must have its - * execute method invoked before other public methods + * A newly created {@code JdbcRowSet} object must have its + * {@code execute} method invoked before other public methods * are called on it; otherwise, such method calls will cause an * exception to be thrown. * * @throws SQLException [1] if any of its public methods are called prior - * to calling the execute method, [2] if invalid JDBC driver + * to calling the {@code execute} method, [2] if invalid JDBC driver * properties are set, or [3] if no connection to a data source exists. */ public JdbcRowSetImpl(Connection con) throws SQLException { @@ -289,15 +289,15 @@ } /** - * Constructs a default JdbcRowSet object using the + * Constructs a default {@code JdbcRowSet} object using the * URL, username, and password arguments supplied. The new - * instance of JdbcRowSet will serve as a proxy for - * the ResultSet object it creates, and by so doing, + * instance of {@code JdbcRowSet} will serve as a proxy for + * the {@code ResultSet} object it creates, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -308,17 +308,17 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * * - * @param url - a JDBC URL for the database to which this JdbcRowSet + * @param url a JDBC URL for the database to which this {@code JdbcRowSet} * object will be connected. The form for a JDBC URL is - * jdbc:subprotocol:subname. - * @param user - the database user on whose behalf the connection + * {@code jdbc:subprotocol:subname}. + * @param user the database user on whose behalf the connection * is being made - * @param password - the user's password + * @param password the user's password * * @throws SQLException if a database access error occurs * @@ -372,15 +372,15 @@ /** - * Constructs a JdbcRowSet object using the given valid - * ResultSet object. The new - * instance of JdbcRowSet will serve as a proxy for - * the ResultSet object, and by so doing, + * Constructs a {@code JdbcRowSet} object using the given valid + * {@code ResultSet} object. The new + * instance of {@code JdbcRowSet} will serve as a proxy for + * the {@code ResultSet} object, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -391,12 +391,12 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * * - * @param res a valid ResultSet object + * @param res a valid {@code ResultSet} object * * @throws SQLException if a database access occurs due to a non * valid ResultSet handle. @@ -460,13 +460,13 @@ } /** - * Initializes the given RowSetMetaData object with the values - * in the given ResultSetMetaData object. + * Initializes the given {@code RowSetMetaData} object with the values + * in the given {@code ResultSetMetaData} object. * - * @param md the RowSetMetaData object for this - * JdbcRowSetImpl object, which will be set with + * @param md the {@code RowSetMetaData} object for this + * {@code JdbcRowSetImpl} object, which will be set with * values from rsmd - * @param rsmd the ResultSetMetaData object from which new + * @param rsmd the {@code ResultSetMetaData} object from which new * values for md will be read * @throws SQLException if an error occurs */ @@ -511,24 +511,24 @@ //--------------------------------------------------------------------- /** - * Creates the internal ResultSet object for which this - * JdbcRowSet object is a wrapper, effectively + * Creates the internal {@code ResultSet} object for which this + * {@code JdbcRowSet} object is a wrapper, effectively * making the result set a JavaBeans component. * * Certain properties must have been set before this method is called * so that it can establish a connection to a database and execute the - * query that will create the result set. If a DataSource + * query that will create the result set. If a {@code DataSource} * object will be used to create the connection, properties for the * data source name, user name, and password must be set. If the - * DriverManager will be used, the properties for the + * {@code DriverManager} will be used, the properties for the * URL, user name, and password must be set. In either case, the * property for the command must be set. If the command has placeholder * parameters, those must also be set. This method throws * an exception if the required properties are not set. * * Other properties have default values that may optionally be set - * to new values. The execute method will use the value - * for the command property to create a PreparedStatement + * to new values. The {@code execute} method will use the value + * for the command property to create a {@code PreparedStatement} * object and set its properties (escape processing, maximum field * size, maximum number of rows, and query timeout limit) to be those * of this rowset. @@ -784,20 +784,20 @@ } /** - * Moves the cursor for this rowset's ResultSet + * Moves the cursor for this rowset's {@code ResultSet} * object down one row from its current position. - * A ResultSet cursor is initially positioned + * A {@code ResultSet} cursor is initially positioned * before the first row; the first call to the method - * next makes the first row the current row; the + * {@code next} makes the first row the current row; the * second call makes the second row the current row, and so on. * * If an input stream is open for the current row, a call - * to the method next will - * implicitly close it. A ResultSet object's + * to the method {@code next} will + * implicitly close it. A {@code ResultSet} object's * warning chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -811,16 +811,16 @@ } /** - * Releases this rowset's ResultSet object's database and + * Releases this rowset's {@code ResultSet} object's database and * JDBC resources immediately instead of waiting for * this to happen when it is automatically closed. * - * Note: A ResultSet object + * Note: A {@code ResultSet} object * is automatically closed by the - * Statement object that generated it when - * that Statement object is closed, + * {@code Statement} object that generated it when + * that {@code Statement} object is closed, * re-executed, or is used to retrieve the next result from a - * sequence of multiple results. A ResultSet object + * sequence of multiple results. A {@code ResultSet} object * is also automatically closed when it is garbage collected. * * @throws SQLException if a database access error occurs @@ -836,14 +836,14 @@ /** * Reports whether the last column read from this rowset's - * ResultSet object had a value of SQL NULL. - * Note that you must first call one of the getXXX methods + * {@code ResultSet} object had a value of SQL {@code NULL}. + * Note that you must first call one of the {@code getXXX} methods * on a column to try to read its value and then call - * the method wasNull to see if the value read was - * SQL NULL. + * the method {@code wasNull} to see if the value read was + * SQL {@code NULL}. * - * @return true if the last column value read was SQL - * NULL and false otherwise + * @return {@code true} if the last column value read was SQL + * {@code NULL} and {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not have a currently valid connection, * prepared statement, and result set @@ -860,12 +860,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a String. + * of this rowset's {@code ResultSet} object as + * a {@code String}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -878,12 +878,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a boolean. + * of this rowset's {@code ResultSet} object as + * a {@code boolean}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is false + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code false} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -896,12 +896,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte. + * of this rowset's {@code ResultSet} object as + * a {@code byte}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -914,12 +914,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a short. + * of this rowset's {@code ResultSet} object as + * a {@code short}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -932,12 +932,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an int. + * of this rowset's {@code ResultSet} object as + * an {@code int}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -950,12 +950,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a long. + * of this rowset's {@code ResultSet} object as + * a {@code long}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -968,12 +968,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a float. + * of this rowset's {@code ResultSet} object as + * a {@code float}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -986,12 +986,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a double. + * of this rowset's {@code ResultSet} object as + * a {@code double}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1004,13 +1004,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.BigDecimal. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.BigDecimal}. * * @param columnIndex the first column is 1, the second is 2, and so on * @param scale the number of digits to the right of the decimal point - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1025,13 +1025,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte array in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code byte} array in the Java programming language. * The bytes represent the raw values returned by the driver. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1044,12 +1044,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Date object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Date} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1062,12 +1062,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Time object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Time} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1080,12 +1080,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Timestamp object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Timestamp} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1098,25 +1098,25 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as + * of this rowset's {@code ResultSet} object as * a stream of ASCII characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream of one-byte ASCII characters; - * if the value is SQL NULL, the - * value returned is null + * as a stream of one-byte ASCII characters; + * if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) database access error occurs * (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1129,31 +1129,31 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as + * of this rowset's {@code ResultSet} object as * as a stream of Unicode characters. * The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving largeLONGVARCHARvalues. The JDBC driver will + * suitable for retrieving large{@code LONGVARCHAR}values. The JDBC driver will * do any necessary conversion from the database format into Unicode. * The byte format of the Unicode stream must be Java UTF-8, * as specified in the Java virtual machine specification. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream in Java UTF-8 byte format; - * if the value is SQL NULL, the value returned is null + * as a stream in Java UTF-8 byte format; + * if the value is SQL {@code NULL}, the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set - * @deprecated use getCharacterStream in place of - * getUnicodeStream + * @deprecated use {@code getCharacterStream} in place of + * {@code getUnicodeStream} */ @Deprecated public java.io.InputStream getUnicodeStream(int columnIndex) throws SQLException { @@ -1165,22 +1165,22 @@ /** * Gets the value of a column in the current row as a stream of * the value of the designated column in the current row - * of this rowset's ResultSet object as a binary stream of + * of this rowset's {@code ResultSet} object as a binary stream of * uninterpreted bytes. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes; - * if the value is SQL NULL, the value returned is null + * as a stream of uninterpreted bytes; + * if the value is SQL {@code NULL}, the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1198,12 +1198,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a String. + * of this rowset's {@code ResultSet} object as + * a {@code String}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1214,12 +1214,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a boolean. + * of this rowset's {@code ResultSet} object as + * a {@code boolean}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is false + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code false} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1230,12 +1230,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte. + * of this rowset's {@code ResultSet} object as + * a {@code byte}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1246,12 +1246,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a short. + * of this rowset's {@code ResultSet} object as + * a {@code short}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1262,12 +1262,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an int. + * of this rowset's {@code ResultSet} object as + * an {@code int}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1278,12 +1278,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a long. + * of this rowset's {@code ResultSet} object as + * a {@code long}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if a database access error occurs * or this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1294,12 +1294,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a float. + * of this rowset's {@code ResultSet} object as + * a {@code float}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1310,12 +1310,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a double. + * of this rowset's {@code ResultSet} object as + * a {@code double}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1326,13 +1326,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.math.BigDecimal. + * of this rowset's {@code ResultSet} object as + * a {@code java.math.BigDecimal}. * * @param columnName the SQL name of the column * @param scale the number of digits to the right of the decimal point - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) adatabase access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1345,13 +1345,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte array in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code byte} array in the Java programming language. * The bytes represent the raw values returned by the driver. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1362,12 +1362,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Date object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Date} object in the Java programming language. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1378,13 +1378,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Time object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Time} object in the Java programming language. * * @param columnName the SQL name of the column * @return the column value; - * if the value is SQL NULL, - * the value returned is null + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1395,12 +1395,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Timestamp} object. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1411,24 +1411,24 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of + * of this rowset's {@code ResultSet} object as a stream of * ASCII characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of one-byte ASCII characters. - * If the value is SQL NULL, - * the value returned is null. + * as a stream of one-byte ASCII characters. + * If the value is SQL {@code NULL}, + * the value returned is {@code null}. * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1439,10 +1439,10 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of + * of this rowset's {@code ResultSet} object as a stream of * Unicode characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into Unicode. * The byte format of the Unicode stream must be Java UTF-8, @@ -1450,15 +1450,15 @@ * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of two-byte Unicode characters. - * If the value is SQL NULL, - * the value returned is null. + * as a stream of two-byte Unicode characters. + * If the value is SQL {@code NULL}, + * the value returned is {@code null}. * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1471,23 +1471,23 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of uninterpreted - * bytes. + * of this rowset's {@code ResultSet} object as a stream of uninterpreted + * {@code byte}s. * The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARBINARY + * suitable for retrieving large {@code LONGVARBINARY} * values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes; - * if the value is SQL NULL, the result is null + * as a stream of uninterpreted bytes; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1503,21 +1503,21 @@ /** * Returns the first warning reported by calls on this rowset's - * ResultSet object. - * Subsequent warnings on this rowset's ResultSet object - * will be chained to the SQLWarning object that + * {@code ResultSet} object. + * Subsequent warnings on this rowset's {@code ResultSet} object + * will be chained to the {@code SQLWarning} object that * this method returns. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by - * Statement methods + * by {@code ResultSet} methods. Any warning caused by + * {@code Statement} methods * (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * - * @return the first SQLWarning object reported or null + * @return the first {@code SQLWarning} object reported or {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1529,10 +1529,10 @@ } /** - * Clears all warnings reported on this rowset's ResultSet object. - * After this method is called, the method getWarnings - * returns null until a new warning is - * reported for this rowset's ResultSet object. + * Clears all warnings reported on this rowset's {@code ResultSet} object. + * After this method is called, the method {@code getWarnings} + * returns {@code null} until a new warning is + * reported for this rowset's {@code ResultSet} object. * * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, @@ -1545,26 +1545,26 @@ } /** - * Gets the name of the SQL cursor used by this rowset's ResultSet + * Gets the name of the SQL cursor used by this rowset's {@code ResultSet} * object. * * In SQL, a result table is retrieved through a cursor that is * named. The current row of a result set can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To insure that the cursor has the proper isolation - * level to support update, the cursor's select statement should be + * level to support update, the cursor's {@code select} statement should be * of the form 'select for update'. If the 'for update' clause is * omitted, the positioned updates may fail. * * The JDBC API supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. - * The current row of a ResultSet object + * SQL cursor used by a {@code ResultSet} object. + * The current row of a {@code ResultSet} object * is also the current row of this SQL cursor. * * Note: If positioned update is not supported, a - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL name for this rowset's ResultSet object's cursor + * @return the SQL name for this rowset's {@code ResultSet} object's cursor * @throws SQLException if (1) a database access error occurs * or (2) xthis rowset does not have a currently valid connection, * prepared statement, and result set @@ -1577,9 +1577,9 @@ /** * Retrieves the number, types and properties of - * this rowset's ResultSet object's columns. + * this rowset's {@code ResultSet} object's columns. * - * @return the description of this rowset's ResultSet + * @return the description of this rowset's {@code ResultSet} * object's columns * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, @@ -1607,8 +1607,8 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an Object. + * of this rowset's {@code ResultSet} object as + * an {@code Object}. * * This method will return the value of the given column as a * Java object. The type of the Java object will be the default @@ -1620,14 +1620,14 @@ * abstract data types. * * In the JDBC 3.0 API, the behavior of method - * getObject is extended to materialize + * {@code getObject} is extended to materialize * data of SQL user-defined types. When a column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to: getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to: {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return a java.lang.Object holding the column value + * @return a {@code java.lang.Object} holding the column value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1640,8 +1640,8 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an Object. + * of this rowset's {@code ResultSet} object as + * an {@code Object}. * * This method will return the value of the given column as a * Java object. The type of the Java object will be the default @@ -1653,14 +1653,14 @@ * abstract data types. * * In the JDBC 3.0 API, the behavior of the method - * getObject is extended to materialize + * {@code getObject} is extended to materialize * data of SQL user-defined types. When a column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to: getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to: {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * * @param columnName the SQL name of the column - * @return a java.lang.Object holding the column value + * @return a {@code java.lang.Object} holding the column value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1672,9 +1672,9 @@ //---------------------------------------------------------------- /** - * Maps the given JdbcRowSetImpl column name to its - * JdbcRowSetImpl column index and reflects this on - * the internal ResultSet object. + * Maps the given {@code JdbcRowSetImpl} column name to its + * {@code JdbcRowSetImpl} column index and reflects this on + * the internal {@code ResultSet} object. * * @param columnName the name of the column * @return the column index of the given column name @@ -1697,11 +1697,11 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.io.Reader object. - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null. + * of this rowset's {@code ResultSet} object as a + * {@code java.io.Reader} object. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @param columnIndex the first column is 1, the second is 2, and so on * */ @@ -1713,14 +1713,14 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.io.Reader object. + * of this rowset's {@code ResultSet} object as a + * {@code java.io.Reader} object. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @param columnName the name of the column - * @return the value in the specified column as a java.io.Reader + * @return the value in the specified column as a {@code java.io.Reader} * */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { @@ -1729,13 +1729,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.math.BigDecimal with full precision. + * of this rowset's {@code ResultSet} object as a + * {@code java.math.BigDecimal} with full precision. * * @param columnIndex the first column is 1, the second is 2, and so on * @return the column value (full precision); - * if the value is SQL NULL, the value returned is - * null. + * if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1748,13 +1748,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.math.BigDecimal with full precision. + * of this rowset's {@code ResultSet} object as a + * {@code java.math.BigDecimal} with full precision. * * @param columnName the column name * @return the column value (full precision); - * if the value is SQL NULL, the value returned is - * null. + * if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1769,11 +1769,11 @@ /** * Indicates whether the cursor is before the first row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is before the first row; - * false if the cursor is at any other position or the - * result set contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} if the cursor is at any other position or the + * result set contains no rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1786,11 +1786,11 @@ /** * Indicates whether the cursor is after the last row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is after the last row; - * false if the cursor is at any other position or the - * result set contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} if the cursor is at any other position or the + * result set contains no rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1803,10 +1803,10 @@ /** * Indicates whether the cursor is on the first row of - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on the first row; - * false otherwise + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1819,14 +1819,14 @@ /** * Indicates whether the cursor is on the last row of - * this rowset's ResultSet object. - * Note: Calling the method isLast may be expensive + * this rowset's {@code ResultSet} object. + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver * might need to fetch ahead one row in order to determine * whether the current row is the last row in the result set. * - * @return true if the cursor is on the last row; - * false otherwise + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1840,11 +1840,11 @@ /** * Moves the cursor to the front of - * this rowset's ResultSet object, just before the + * this rowset's {@code ResultSet} object, just before the * first row. This method has no effect if the result set contains no rows. * * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1857,10 +1857,10 @@ /** * Moves the cursor to the end of - * this rowset's ResultSet object, just after the + * this rowset's {@code ResultSet} object, just after the * last row. This method has no effect if the result set contains no rows. * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1873,12 +1873,12 @@ /** * Moves the cursor to the first row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on a valid row; - * false if there are no rows in the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if there are no rows in the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1893,12 +1893,12 @@ /** * Moves the cursor to the last row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on a valid row; - * false if there are no rows in the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if there are no rows in the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1914,7 +1914,7 @@ * Retrieves the current row number. The first row is number 1, the * second is number 2, and so on. * - * @return the current row number; 0 if there is no current row + * @return the current row number; {@code 0} if there is no current row * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1927,7 +1927,7 @@ /** * Moves the cursor to the given row number in - * this rowset's internal ResultSet object. + * this rowset's internal {@code ResultSet} object. * * If the row number is positive, the cursor moves to * the given row number with respect to the @@ -1937,23 +1937,23 @@ * If the given row number is negative, the cursor moves to * an absolute row position with respect to * the end of the result set. For example, calling the method - * absolute(-1) positions the - * cursor on the last row, calling the method absolute(-2) + * {@code absolute(-1)} positions the + * cursor on the last row, calling the method {@code absolute(-2)} * moves the cursor to the next-to-last row, and so on. * * An attempt to position the cursor beyond the first/last row in * the result set leaves the cursor before the first row or after * the last row. * - * Note: Calling absolute(1) is the same - * as calling first(). Calling absolute(-1) - * is the same as calling last(). + * Note: Calling {@code absolute(1)} is the same + * as calling {@code first()}. Calling {@code absolute(-1)} + * is the same as calling {@code last()}. * - * @return true if the cursor is on the result set; - * false otherwise + * @return {@code true} if the cursor is on the result set; + * {@code false} otherwise * @throws SQLException if (1) a database access error occurs, - * (2) the row is 0, (3) the result set - * type is TYPE_FORWARD_ONLY, or (4) this + * (2) the row is {@code 0}, (3) the result set + * type is {@code TYPE_FORWARD_ONLY}, or (4) this * rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -1969,21 +1969,21 @@ * Moves the cursor a relative number of rows, either positive or negative. * Attempting to move beyond the first/last row in the * result set positions the cursor before/after the - * the first/last row. Calling relative(0) is valid, but does + * the first/last row. Calling {@code relative(0)} is valid, but does * not change the cursor position. * - * Note: Calling the method relative(1) - * is different from calling the method next() - * because is makes sense to call next() when there + * Note: Calling the method {@code relative(1)} + * is different from calling the method {@code next()} + * because is makes sense to call {@code next()} when there * is no current row, * for example, when the cursor is positioned before the first row * or after the last row of the result set. * - * @return true if the cursor is on a row; - * false otherwise + * @return {@code true} if the cursor is on a row; + * {@code false} otherwise * @throws SQLException if (1) a database access error occurs, * (2) there is no current row, (3) the result set - * type is TYPE_FORWARD_ONLY, or (4) this + * type is {@code TYPE_FORWARD_ONLY}, or (4) this * rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -1997,16 +1997,16 @@ /** * Moves the cursor to the previous row in this - * ResultSet object. + * {@code ResultSet} object. * - * Note: Calling the method previous() is not the same as - * calling the method relative(-1) because it - * makes sense to call previous() when there is no current row. + * Note: Calling the method {@code previous()} is not the same as + * calling the method {@code relative(-1)} because it + * makes sense to call {@code previous()} when there is no current row. * - * @return true if the cursor is on a valid row; - * false if it is off the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is off the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -2020,15 +2020,15 @@ /** * Gives a hint as to the direction in which the rows in this - * ResultSet object will be processed. + * {@code ResultSet} object will be processed. * The initial value is determined by the - * Statement object - * that produced this rowset's ResultSet object. + * {@code Statement} object + * that produced this rowset's {@code ResultSet} object. * The fetch direction may be changed at any time. * * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY - * and the fetch direction is not FETCH_FORWARD, + * (2) the result set type is {@code TYPE_FORWARD_ONLY} + * and the fetch direction is not {@code FETCH_FORWARD}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set * @see java.sql.Statement#setFetchDirection @@ -2041,10 +2041,10 @@ /** * Returns the fetch direction for this - * ResultSet object. + * {@code ResultSet} object. * * @return the current fetch direction for this rowset's - * ResultSet object + * {@code ResultSet} object * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2061,16 +2061,16 @@ /** * Gives the JDBC driver a hint as to the number of rows that should * be fetched from the database when more rows are needed for this - * ResultSet object. + * {@code ResultSet} object. * If the fetch size specified is zero, the JDBC driver * ignores the value and is free to make its own best guess as to what * the fetch size should be. The default value is set by the - * Statement object + * {@code Statement} object * that created the result set. The fetch size may be changed at any time. * * @param rows the number of rows to fetch * @throws SQLException if (1) a database access error occurs, (2) the - * condition 0 <= rows <= this.getMaxRows() is not + * condition {@code 0 <= rows <= this.getMaxRows()} is not * satisfied, or (3) this rowset does not currently have a valid * connection, prepared statement, and result set * @@ -2084,9 +2084,9 @@ /** * * Returns the fetch size for this - * ResultSet object. + * {@code ResultSet} object. * - * @return the current fetch size for this rowset's ResultSet object + * @return the current fetch size for this rowset's {@code ResultSet} object * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2111,12 +2111,12 @@ } /** - * Returns the concurrency mode of this rowset's ResultSet object. + * Returns the concurrency mode of this rowset's {@code ResultSet} object. * The concurrency used is determined by the - * Statement object that created the result set. + * {@code Statement} object that created the result set. * - * @return the concurrency type, either CONCUR_READ_ONLY - * or CONCUR_UPDATABLE + * @return the concurrency type, either {@code CONCUR_READ_ONLY} + * or {@code CONCUR_UPDATABLE} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2138,7 +2138,7 @@ * Indicates whether the current row has been updated. The value returned * depends on whether or not the result set can detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another, and updates are detected * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, @@ -2154,10 +2154,10 @@ /** * Indicates whether the current row has had an insertion. * The value returned depends on whether or not this - * ResultSet object can detect visible inserts. + * {@code ResultSet} object can detect visible inserts. * - * @return true if a row has had an insertion - * and insertions are detected; false otherwise + * @return {@code true} if a row has had an insertion + * and insertions are detected; {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2174,10 +2174,10 @@ * Indicates whether a row has been deleted. A deleted row may leave * a visible "hole" in a result set. This method can be used to * detect holes in a result set. The value returned depends on whether - * or not this rowset's ResultSet object can detect deletions. + * or not this rowset's {@code ResultSet} object can detect deletions. * - * @return true if a row was deleted and deletions are detected; - * false otherwise + * @return {@code true} if a row was deleted and deletions are detected; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2192,10 +2192,10 @@ /** * Gives a nullable column a null value. * - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow - * or insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} + * or {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @throws SQLException if a database access error occurs @@ -2213,11 +2213,11 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2237,11 +2237,11 @@ } /** - * Updates the designated column with a byte value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * * @param columnIndex the first column is 1, the second is 2, and so on @@ -2262,11 +2262,11 @@ } /** - * Updates the designated column with a short value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code short} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2286,11 +2286,11 @@ } /** - * Updates the designated column with an int value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code int} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2309,11 +2309,11 @@ } /** - * Updates the designated column with a long value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code long} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2333,11 +2333,11 @@ } /** - * Updates the designated column with a float value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code float} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2357,11 +2357,11 @@ } /** - * Updates the designated column with a double value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code double} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2381,12 +2381,12 @@ } /** - * Updates the designated column with a java.math.BigDecimal + * Updates the designated column with a {@code java.math.BigDecimal} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2406,11 +2406,11 @@ } /** - * Updates the designated column with a String value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code String} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2430,11 +2430,11 @@ } /** - * Updates the designated column with a byte array value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} array value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2454,11 +2454,11 @@ } /** - * Updates the designated column with a java.sql.Date value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Date} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2479,11 +2479,11 @@ /** - * Updates the designated column with a java.sql.Time value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Time} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2503,12 +2503,12 @@ } /** - * Updates the designated column with a java.sql.Timestamp + * Updates the designated column with a {@code java.sql.Timestamp} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2529,10 +2529,10 @@ /** * Updates the designated column with an ascii stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2554,10 +2554,10 @@ /** * Updates the designated column with a binary stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2579,10 +2579,10 @@ /** * Updates the designated column with a character stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2603,18 +2603,18 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value - * @param scale for java.sql.Types.DECIMAl - * or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types this value will be ignored. + * @param scale for {@code java.sql.Types.DECIMAl} + * or {@code java.sql.Types.NUMERIC} types, + * this is the number of digits after the decimal point. For all other + * types this value will be ignored. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2631,11 +2631,11 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2655,11 +2655,11 @@ } /** - * Updates the designated column with a null value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code null} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @throws SQLException if a database access error occurs @@ -2672,11 +2672,11 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2688,11 +2688,11 @@ } /** - * Updates the designated column with a byte value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2704,11 +2704,11 @@ } /** - * Updates the designated column with a short value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code short} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2720,11 +2720,11 @@ } /** - * Updates the designated column with an int value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code int} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2736,11 +2736,11 @@ } /** - * Updates the designated column with a long value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code long} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2752,11 +2752,11 @@ } /** - * Updates the designated column with a float value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code float } value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2768,11 +2768,11 @@ } /** - * Updates the designated column with a double value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code double} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2784,12 +2784,12 @@ } /** - * Updates the designated column with a java.sql.BigDecimal + * Updates the designated column with a {@code java.sql.BigDecimal} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2801,11 +2801,11 @@ } /** - * Updates the designated column with a String value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code String} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2817,19 +2817,19 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * JDBC 2.0 * * Updates a column with a byte array value. * - * The updateXXX methods are used to update column values in the - * current row, or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or insertRow + * The {@code updateXXX} methods are used to update column values in the + * current row, or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or {@code insertRow} * methods are called to update the database. * * @param columnName the name of the column @@ -2842,11 +2842,11 @@ } /** - * Updates the designated column with a java.sql.Date value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Date} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2858,11 +2858,11 @@ } /** - * Updates the designated column with a java.sql.Time value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Time} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2874,12 +2874,12 @@ } /** - * Updates the designated column with a java.sql.Timestamp + * Updates the designated column with a {@code java.sql.Timestamp} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2892,10 +2892,10 @@ /** * Updates the designated column with an ascii stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2909,10 +2909,10 @@ /** * Updates the designated column with a binary stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2926,14 +2926,14 @@ /** * Updates the designated column with a character stream value. - * The updateXXX methods are used to update column values - * in the current row or the insert row. The updateXXX + * The {@code updateXXX} methods are used to update column values + * in the current row or the insert row. The {@code updateXXX} * methods do not update the underlying database; instead the - * updateRow or insertRow methods are called + * {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column - * @param reader the new column Reader stream value + * @param reader the new column {@code Reader} stream value * @param length the length of the stream * @throws SQLException if a database access error occurs * @@ -2943,16 +2943,16 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value - * @param scale for java.sql.Types.DECIMAL - * or java.sql.Types.NUMERIC types, + * @param scale for {@code java.sql.Types.DECIMAL} + * or {@code java.sql.Types.NUMERIC} types, * this is the number of digits after the decimal point. For all other * types this value will be ignored. * @throws SQLException if a database access error occurs @@ -2963,11 +2963,11 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2980,7 +2980,7 @@ /** * Inserts the contents of the insert row into this - * ResultSet object and into the database + * {@code ResultSet} object and into the database * and also notifies listeners that a row has changed. * The cursor must be on the insert row when this method is called. * @@ -3000,14 +3000,14 @@ /** * Updates the underlying database with the new contents of the - * current row of this rowset's ResultSet object + * current row of this rowset's {@code ResultSet} object * and notifies listeners that a row has changed. * This method cannot be called when the cursor is on the insert row. * * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is * on the insert row, (3) the concurrency of the result - * set is ResultSet.CONCUR_READ_ONLY, or + * set is {@code ResultSet.CONCUR_READ_ONLY}, or * (4) this rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -3019,18 +3019,18 @@ } /** - * Deletes the current row from this rowset's ResultSet object + * Deletes the current row from this rowset's {@code ResultSet} object * and from the underlying database and also notifies listeners that a row * has changed. This method cannot be called when the cursor is on the insert * row. * * @throws SQLException if a database access error occurs - * or if this method is called when the cursor is on the insert row + * or if this method is called when the cursor is on the insert row * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is before the * first row, after the last row, or on the insert row, * (3) the concurrency of this rowset's result - * set is ResultSet.CONCUR_READ_ONLY, or + * set is {@code ResultSet.CONCUR_READ_ONLY}, or * (4) this rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -3042,24 +3042,24 @@ } /** - * Refreshes the current row of this rowset's ResultSet + * Refreshes the current row of this rowset's {@code ResultSet} * object with its most recent value in the database. This method * cannot be called when the cursor is on the insert row. * - * The refreshRow method provides a way for an + * The {@code refreshRow} method provides a way for an * application to explicitly tell the JDBC driver to refetch * a row(s) from the database. An application may want to call - * refreshRow when caching or prefetching is being + * {@code refreshRow} when caching or prefetching is being * done by the JDBC driver to fetch the latest value of a row * from the database. The JDBC driver may actually refresh multiple * rows at once if the fetch size is greater than one. * * All values are refetched subject to the transaction isolation - * level and cursor sensitivity. If refreshRow is called after - * calling an updateXXX method, but before calling - * the method updateRow, then the + * level and cursor sensitivity. If {@code refreshRow} is called after + * calling an {@code updateXXX} method, but before calling + * the method {@code updateRow}, then the * updates made to the row are lost. Calling the method - * refreshRow frequently will likely slow performance. + * {@code refreshRow} frequently will likely slow performance. * * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is @@ -3076,12 +3076,12 @@ /** * Cancels the updates made to the current row in this - * ResultSet object and notifies listeners that a row + * {@code ResultSet} object and notifies listeners that a row * has changed. This method may be called after calling an - * updateXXX method(s) and before calling - * the method updateRow to roll back + * {@code updateXXX} method(s) and before calling + * the method {@code updateRow} to roll back * the updates made to a row. If no updates have been made or - * updateRow has already been called, this method has no + * {@code updateRow} has already been called, this method has no * effect. * * @throws SQLException if (1) a database access error occurs, @@ -3104,19 +3104,19 @@ * * The insert row is a special row associated with an updatable * result set. It is essentially a buffer where a new row may - * be constructed by calling the updateXXX methods prior to + * be constructed by calling the {@code updateXXX} methods prior to * inserting the row into the result set. * - * Only the updateXXX, getXXX, - * and insertRow methods may be + * Only the {@code updateXXX}, {@code getXXX}, + * and {@code insertRow} methods may be * called when the cursor is on the insert row. All of the columns in * a result set must be given a value each time this method is - * called before calling insertRow. - * An updateXXX method must be called before a - * getXXX method can be called on a column value. + * called before calling {@code insertRow}. + * An {@code updateXXX} method must be called before a + * {@code getXXX} method can be called on a column value. * * @throws SQLException if (1) a database access error occurs, - * (2) this rowset's ResultSet object is + * (2) this rowset's {@code ResultSet} object is * not updatable, or (3) this rowset does not * currently have a valid connection, prepared statement, * and result set @@ -3134,7 +3134,7 @@ * the insert row. * * @throws SQLException if (1) a database access error occurs, - * (2) this rowset's ResultSet object is + * (2) this rowset's {@code ResultSet} object is * not updatable, or (3) this rowset does not * currently have a valid connection, prepared statement, * and result set @@ -3146,14 +3146,14 @@ } /** - * Returns the Statement object that produced this - * ResultSet object. + * Returns the {@code Statement} object that produced this + * {@code ResultSet} object. * If the result set was generated some other way, such as by a - * DatabaseMetaData method, this method returns - * null. + * {@code DatabaseMetaData} method, this method returns + * {@code null}. * - * @return the Statement object that produced - * this rowset's ResultSet object or null + * @return the {@code Statement} object that produced + * this rowset's {@code ResultSet} object or {@code null} * if the result set was produced some other way * @throws SQLException if a database access error occurs */ @@ -3169,16 +3169,16 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Object. - * This method uses the given Map object + * of this rowset's {@code ResultSet} object as an {@code Object}. + * This method uses the given {@code Map} object * for the custom mapping of the * SQL structured or distinct type that is being retrieved. * * @param i the first column is 1, the second is 2, and so on - * @param map a java.util.Map object that contains the mapping - * from SQL type names to classes in the Java programming language - * @return an Object in the Java programming language - * representing the SQL value + * @param map a {@code java.util.Map} object that contains the mapping + * from SQL type names to classes in the Java programming language + * @return an {@code Object} in the Java programming language + * representing the SQL value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3193,10 +3193,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Ref object. + * of this rowset's {@code ResultSet} object as a {@code Ref} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL {@code REF} value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3210,10 +3210,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Blob object. + * of this rowset's {@code ResultSet} object as a {@code Blob} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Blob object representing the SQL BLOB + * @return a {@code Blob} object representing the SQL {@code BLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3227,10 +3227,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Clob object. + * of this rowset's {@code ResultSet} object as a {@code Clob} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Clob object representing the SQL CLOB + * @return a {@code Clob} object representing the SQL {@code CLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3244,10 +3244,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Array object. + * of this rowset's {@code ResultSet} object as an {@code Array} object. * * @param i the first column is 1, the second is 2, and so on. - * @return an Array object representing the SQL ARRAY + * @return an {@code Array} object representing the SQL {@code ARRAY} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3261,14 +3261,14 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Object. - * This method uses the specified Map object for + * of this rowset's {@code ResultSet} object as an {@code Object}. + * This method uses the specified {@code Map} object for * custom mapping if appropriate. * * @param colName the name of the column from which to retrieve the value - * @param map a java.util.Map object that contains the mapping + * @param map a {@code java.util.Map} object that contains the mapping * from SQL type names to classes in the Java programming language - * @return an Object representing the SQL + * @return an {@code Object} representing the SQL * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3282,10 +3282,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Ref object. + * of this rowset's {@code ResultSet} object as a {@code Ref} object. * * @param colName the column name - * @return a Ref object representing the SQL REF value in + * @return a {@code Ref} object representing the SQL {@code REF} value in * the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3297,10 +3297,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Blob object. + * of this rowset's {@code ResultSet} object as a {@code Blob} object. * * @param colName the name of the column from which to retrieve the value - * @return a Blob object representing the SQL BLOB + * @return a {@code Blob} object representing the SQL {@code BLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3312,10 +3312,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Clob object. + * of this rowset's {@code ResultSet} object as a {@code Clob} object. * * @param colName the name of the column from which to retrieve the value - * @return a Clob object representing the SQL CLOB + * @return a {@code Clob} object representing the SQL {@code CLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3327,10 +3327,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Array object. + * of this rowset's {@code ResultSet} object as an {@code Array} object. * * @param colName the name of the column from which to retrieve the value - * @return an Array object representing the SQL ARRAY + * @return an {@code Array} object representing the SQL {@code ARRAY} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3342,17 +3342,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Date + * of this rowset's {@code ResultSet} object as a {@code java.sql.Date} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the date - * @return the column value as a java.sql.Date object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Date} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3365,17 +3365,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Date + * of this rowset's {@code ResultSet} object as a {@code java.sql.Date} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column from which to retrieve the value - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the date - * @return the column value as a java.sql.Date object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Date} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3387,17 +3387,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Time + * of this rowset's {@code ResultSet} object as a {@code java.sql.Time} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the time - * @return the column value as a java.sql.Time object; - * if the value is SQL NULL, - * the value returned is null in the Java programming language + * @return the column value as a {@code java.sql.Time} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} in the Java programming language * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3410,17 +3410,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Time + * of this rowset's {@code ResultSet} object as a {@code java.sql.Time} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the time - * @return the column value as a java.sql.Time object; - * if the value is SQL NULL, - * the value returned is null in the Java programming language + * @return the column value as a {@code java.sql.Time} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} in the Java programming language * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3431,18 +3431,18 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as a + * {@code java.sql.Timestamp} object. * This method uses the given calendar to construct an appropriate millisecond * value for the timestamp if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the timestamp - * @return the column value as a java.sql.Timestamp object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Timestamp} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3455,18 +3455,18 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as a + * {@code java.sql.Timestamp} object. * This method uses the given calendar to construct an appropriate millisecond * value for the timestamp if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the timestamp - * @return the column value as a java.sql.Timestamp object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Timestamp} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3478,8 +3478,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3490,14 +3490,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new Ref column value + * @param ref the new {@code Ref} column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { @@ -3507,8 +3507,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3519,13 +3519,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param ref the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { @@ -3534,8 +3534,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3546,14 +3546,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { checkState(); @@ -3563,8 +3563,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3575,13 +3575,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { updateClob(findColumn(columnName), c); @@ -3589,8 +3589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3601,14 +3601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { checkState(); @@ -3617,8 +3617,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3629,13 +3629,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { updateBlob(findColumn(columnName), b); @@ -3643,8 +3643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3655,14 +3655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { checkState(); @@ -3671,8 +3671,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3683,20 +3683,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { updateArray(findColumn(columnName), a); } /** - * Provide interface coverage for getURL(int) in ResultSet->RowSet + * Provide interface coverage for getURL(int) in {@code ResultSet->RowSet} */ public java.net.URL getURL(int columnIndex) throws SQLException { checkState(); @@ -3704,7 +3704,7 @@ } /** - * Provide interface coverage for getURL(String) in ResultSet->RowSet + * Provide interface coverage for getURL(String) in {@code ResultSet->RowSet} */ public java.net.URL getURL(String columnName) throws SQLException { return getURL(findColumn(columnName)); @@ -3712,14 +3712,14 @@ /** * Return the RowSetWarning object for the current row of a - * JdbcRowSetImpl + * {@code JdbcRowSetImpl} */ public RowSetWarning getRowSetWarnings() throws SQLException { return null; } /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3728,8 +3728,8 @@ * @param columnIdxes the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * parameter index is out of bounds or if the columnIdx is + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { @@ -3748,7 +3748,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3757,8 +3757,8 @@ * @param columnIdxes the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * parameter index is out of bounds or if the columnName is + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { @@ -3774,11 +3774,11 @@ } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -3796,10 +3796,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -3829,19 +3829,19 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(int[] columnIdxes) throws SQLException { @@ -3858,17 +3858,17 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(String[] columnNames) throws SQLException { @@ -3883,22 +3883,22 @@ } - /** - * Sets the designated parameter to the given int + /** + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(int columnIdx) throws SQLException { // validate, if col is ok to be set @@ -3912,19 +3912,19 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(String columnName) throws SQLException { // validate, if col is ok to be set @@ -3938,8 +3938,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3948,8 +3948,8 @@ * @param columnIdx the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * parameter index is out of bounds or if the columnIdx is + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { // check if we are unsetting the SAME column @@ -3964,8 +3964,8 @@ } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3974,8 +3974,8 @@ * @param columnName the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * parameter index is out of bounds or if the columnName is + * not the same as set using {@code setMatchColumn(String)} * */ public void unsetMatchColumn(String columnName) throws SQLException { @@ -3992,12 +3992,12 @@ } /** - * Retrieves the DatabaseMetaData associated with + * Retrieves the {@code DatabaseMetaData} associated with * the connection handle associated with this - * JdbcRowSet object. + * {@code JdbcRowSet} object. * - * @return the DatabaseMetadata associated - * with the rowset's connection. + * @return the {@code DatabaseMetadata} associated + * with the rowset's connection. * @throws SQLException if a database access error occurs */ public DatabaseMetaData getDatabaseMetaData() throws SQLException { @@ -4006,12 +4006,12 @@ } /** - * Retrieves the ParameterMetaData associated with + * Retrieves the {@code ParameterMetaData} associated with * the connection handle associated with this - * JdbcRowSet object. + * {@code JdbcRowSet} object. * - * @return the ParameterMetadata associated - * with the rowset's connection. + * @return the {@code ParameterMetadata} associated + * with the rowset's connection. * @throws SQLException if a database access error occurs */ public ParameterMetaData getParameterMetaData() throws SQLException { @@ -4020,18 +4020,18 @@ } /** - * Commits all updates in this JdbcRowSet object by - * wrapping the internal Connection object and calling - * its commit method. - * This method sets this JdbcRowSet object's private field - * rs to null after saving its value to another - * object, but only if the ResultSet - * constant HOLD_CURSORS_OVER_COMMIT has not been set. - * (The field rs is this JdbcRowSet object's - * ResultSet object.) + * Commits all updates in this {@code JdbcRowSet} object by + * wrapping the internal {@code Connection} object and calling + * its {@code commit} method. + * This method sets this {@code JdbcRowSet} object's private field + * {@code rs} to {@code null} after saving its value to another + * object, but only if the {@code ResultSet} + * constant {@code HOLD_CURSORS_OVER_COMMIT} has not been set. + * (The field {@code rs} is this {@code JdbcRowSet} object's + * {@code ResultSet} object.) * * @throws SQLException if autoCommit is set to true or if a database - * access error occurs + * access error occurs */ public void commit() throws SQLException { conn.commit(); @@ -4045,8 +4045,8 @@ } /** - * Sets auto-commit on the internal Connection object with this - * JdbcRowSet + * Sets auto-commit on the internal {@code Connection} object with this + * {@code JdbcRowSet} * * @throws SQLException if a database access error occurs */ @@ -4074,7 +4074,7 @@ } /** - * Returns the auto-commit status with this JdbcRowSet. + * Returns the auto-commit status with this {@code JdbcRowSet}. * * @return true if auto commit is true; false otherwise * @throws SQLException if a database access error occurs @@ -4084,16 +4084,16 @@ } /** - * Rolls back all the updates in this JdbcRowSet object by - * wrapping the internal Connection object and calling its - * rollback method. - * This method sets this JdbcRowSet object's private field - * rs to null after saving its value to another object. - * (The field rs is this JdbcRowSet object's - * internal ResultSet object.) + * Rolls back all the updates in this {@code JdbcRowSet} object by + * wrapping the internal {@code Connection} object and calling its + * {@code rollback} method. + * This method sets this {@code JdbcRowSet} object's private field + * {@code rs} to {@code null} after saving its value to another object. + * (The field {@code rs} is this {@code JdbcRowSet} object's + * internal {@code ResultSet} object.) * * @throws SQLException if autoCommit is set to true or a database - * access error occurs + * access error occurs */ public void rollback() throws SQLException { conn.rollback(); @@ -4106,14 +4106,14 @@ /** - * Rollbacks all the updates in the JdbcRowSet back to the - * last Savepoint transaction marker. Wraps the internal - * Connection object and call it's rollback method + * Rollbacks all the updates in the {@code JdbcRowSet} back to the + * last {@code Savepoint} transaction marker. Wraps the internal + * {@code Connection} object and call it's rollback method * - * @param s the Savepoint transaction marker to roll the - * transaction to. + * @param s the {@code Savepoint} transaction marker to roll the + * transaction to. * @throws SQLException if autoCommit is set to true; or ia a database - * access error occurs + * access error occurs */ public void rollback(Savepoint s) throws SQLException { conn.rollback(s); @@ -4144,10 +4144,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's Connection property + * Gets this {@code JdbcRowSet} object's Connection property * * - * @return the Connection object associated with this rowset; + * @return the {@code Connection} object associated with this rowset; */ protected Connection getConnection() { @@ -4158,10 +4158,10 @@ // Added as per rave requirements /** - * Sets this JdbcRowSet object's connection property - * to the given Connection object. + * Sets this {@code JdbcRowSet} object's connection property + * to the given {@code Connection} object. * - * @param connection the Connection object. + * @param connection the {@code Connection} object. */ protected void setConnection(Connection connection) { @@ -4172,10 +4172,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's PreparedStatement property + * Gets this {@code JdbcRowSet} object's PreparedStatement property * * - * @return the PreparedStatement object associated with this rowset; + * @return the {@code PreparedStatement} object associated with this rowset; */ protected PreparedStatement getPreparedStatement() { @@ -4186,10 +4186,10 @@ // Added as per Rave requirements /** - * Sets this JdbcRowSet object's preparedtsatement property - * to the given PreparedStatemennt object. + * Sets this {@code JdbcRowSet} object's preparedtsatement property + * to the given {@code PreparedStatemennt} object. * - * @param preparedStatement the PreparedStatement object + * @param preparedStatement the {@code PreparedStatement} object * */ protected void setPreparedStatement(PreparedStatement preparedStatement) { @@ -4200,10 +4200,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's ResultSet property + * Gets this {@code JdbcRowSet} object's ResultSet property * * - * @return the ResultSet object associated with this rowset; + * @return the {@code ResultSet} object associated with this rowset; */ protected ResultSet getResultSet() throws SQLException { @@ -4217,10 +4217,10 @@ // Added as per Rave requirements /** - * Sets this JdbcRowSet object's resultset property - * to the given ResultSet object. + * Sets this {@code JdbcRowSet} object's resultset property + * to the given {@code ResultSet} object. * - * @param resultSet the ResultSet object + * @param resultSet the {@code ResultSet} object * */ protected void setResultSet(ResultSet resultSet) { @@ -4228,25 +4228,25 @@ } /** - * Sets this JdbcRowSet object's command property to - * the given String object and clears the parameters, if any, + * Sets this {@code JdbcRowSet} object's {@code command} property to + * the given {@code String} object and clears the parameters, if any, * that were set for the previous command. In addition, - * if the command property has previously been set to a + * if the {@code command} property has previously been set to a * non-null value and it is - * different from the String object supplied, - * this method sets this JdbcRowSet object's private fields - * ps and rs to null. - * (The field ps is its PreparedStatement object, and - * the field rs is its ResultSet object.) + * different from the {@code String} object supplied, + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps} and {@code rs} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, and + * the field {@code rs} is its {@code ResultSet} object.) * - * The command property may not be needed if the RowSet + * The {@code command} property may not be needed if the {@code RowSet} * object gets its data from a source that does not support commands, * such as a spreadsheet or other tabular file. - * Thus, this property is optional and may be null. + * Thus, this property is optional and may be {@code null}. * - * @param command a String object containing an SQL query - * that will be set as this RowSet object's command - * property; may be null but may not be an empty string + * @param command a {@code String} object containing an SQL query + * that will be set as this {@code RowSet} object's command + * property; may be {@code null} but may not be an empty string * @throws SQLException if an empty string is provided as the command value * @see #getCommand */ @@ -4265,32 +4265,32 @@ } /** - * Sets the dataSourceName property for this JdbcRowSet - * object to the given logical name and sets this JdbcRowSet object's - * Url property to null. In addition, if the dataSourceName + * Sets the {@code dataSourceName} property for this {@code JdbcRowSet} + * object to the given logical name and sets this {@code JdbcRowSet} object's + * Url property to {@code null}. In addition, if the {@code dataSourceName} * property has previously been set and is different from the one supplied, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * the field rs is its ResultSet object, and - * the field conn is its Connection object.) + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * the field {@code rs} is its {@code ResultSet} object, and + * the field {@code conn} is its {@code Connection} object.) * * The name supplied to this method must have been bound to a - * DataSource object in a JNDI naming service so that an + * {@code DataSource} object in a JNDI naming service so that an * application can do a lookup using that name to retrieve the - * DataSource object bound to it. The DataSource + * {@code DataSource} object bound to it. The {@code DataSource} * object can then be used to establish a connection to the data source it * represents. * * Users should set either the Url property or the dataSourceName property. * If both properties are set, the driver will use the property set most recently. * - * @param dsName a String object with the name that can be supplied + * @param dsName a {@code String} object with the name that can be supplied * to a naming service based on JNDI technology to retrieve the - * DataSource object that can be used to get a connection; - * may be null + * {@code DataSource} object that can be used to get a connection; + * may be {@code null} * @throws SQLException if there is a problem setting the - * dataSourceName property + * {@code dataSourceName} property * @see #getDataSourceName */ public void setDataSourceName(String dsName) throws SQLException{ @@ -4310,42 +4310,42 @@ /** - * Sets the Url property for this JdbcRowSet object - * to the given String object and sets the dataSource name - * property to null. In addition, if the Url property has - * previously been set to a non null value and its value + * Sets the Url property for this {@code JdbcRowSet} object + * to the given {@code String} object and sets the dataSource name + * property to {@code null}. In addition, if the Url property has + * previously been set to a non {@code null} value and its value * is different from the value to be set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * the field rs is its ResultSet object, and - * the field conn is its Connection object.) + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * the field {@code rs} is its {@code ResultSet} object, and + * the field {@code conn} is its {@code Connection} object.) * * The Url property is a JDBC URL that is used when * the connection is created using a JDBC technology-enabled driver - * ("JDBC driver") and the DriverManager. + * ("JDBC driver") and the {@code DriverManager}. * The correct JDBC URL for the specific driver to be used can be found * in the driver documentation. Although there are guidelines for how * a JDBC URL is formed, - * a driver vendor can specify any String object except - * one with a length of 0 (an empty string). + * a driver vendor can specify any {@code String} object except + * one with a length of {@code 0} (an empty string). * * Setting the Url property is optional if connections are established using - * a DataSource object instead of the DriverManager. + * a {@code DataSource} object instead of the {@code DriverManager}. * The driver will use either the URL property or the * dataSourceName property to create a connection, whichever was * specified most recently. If an application uses a JDBC URL, it * must load a JDBC driver that accepts the JDBC URL before it uses the - * RowSet object to connect to a database. The RowSet + * {@code RowSet} object to connect to a database. The {@code RowSet} * object will use the URL internally to create a database connection in order * to read or write data. * - * @param url a String object that contains the JDBC URL + * @param url a {@code String} object that contains the JDBC URL * that will be used to establish the connection to a database for this - * RowSet object; may be null but must not + * {@code RowSet} object; may be {@code null} but must not * be an empty string * @throws SQLException if an error occurs setting the Url property or the - * parameter supplied is a string with a length of 0 (an + * parameter supplied is a string with a length of {@code 0} (an * empty string) * @see #getUrl */ @@ -4365,24 +4365,24 @@ } } - /** - * Sets the username property for this JdbcRowSet object + /** + * Sets the username property for this {@code JdbcRowSet} object * to the given user name. Because it * is not serialized, the username property is set at run time before - * calling the method execute. In addition, - * if the username property is already set with a - * non-null value and that value is different from the String + * calling the method {@code execute}. In addition, + * if the {@code username} property is already set with a + * non-null value and that value is different from the {@code String} * object to be set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * rs is its ResultSet object, and - * conn is its Connection object.) - * Setting these fields to null ensures that only current + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * {@code rs} is its {@code ResultSet} object, and + * {@code conn} is its {@code Connection} object.) + * Setting these fields to {@code null} ensures that only current * values will be used. * - * @param uname the String object containing the user name that - * is supplied to the data source to create a connection. It may be null. + * @param uname the {@code String} object containing the user name that + * is supplied to the data source to create a connection. It may be null. * @see #getUsername */ public void setUsername(String uname) { @@ -4401,23 +4401,23 @@ } /** - * Sets the password property for this JdbcRowSet object - * to the given String object. Because it + * Sets the password property for this {@code JdbcRowSet} object + * to the given {@code String} object. Because it * is not serialized, the password property is set at run time before - * calling the method execute. Its default valus is - * null. In addition, - * if the password property is already set with a + * calling the method {@code execute}. Its default valus is + * {@code null}. In addition, + * if the {@code password} property is already set with a * non-null value and that value is different from the one being set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * rs is its ResultSet object, and - * conn is its Connection object.) - * Setting these fields to null ensures that only current + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * {@code rs} is its {@code ResultSet} object, and + * {@code conn} is its {@code Connection} object.) + * Setting these fields to {@code null} ensures that only current * values will be used. * - * @param password the String object that represents the password - * that must be supplied to the database to create a connection + * @param password the {@code String} object that represents the password + * that must be supplied to the database to create a connection */ public void setPassword(String password) { @@ -4435,18 +4435,18 @@ } /** - * Sets the type for this RowSet object to the specified type. - * The default type is ResultSet.TYPE_SCROLL_INSENSITIVE. + * Sets the type for this {@code RowSet} object to the specified type. + * The default type is {@code ResultSet.TYPE_SCROLL_INSENSITIVE}. * * @param type one of the following constants: - * ResultSet.TYPE_FORWARD_ONLY, - * ResultSet.TYPE_SCROLL_INSENSITIVE, or - * ResultSet.TYPE_SCROLL_SENSITIVE + * {@code ResultSet.TYPE_FORWARD_ONLY}, + * {@code ResultSet.TYPE_SCROLL_INSENSITIVE}, or + * {@code ResultSet.TYPE_SCROLL_SENSITIVE} * @throws SQLException if the parameter supplied is not one of the * following constants: - * ResultSet.TYPE_FORWARD_ONLY or - * ResultSet.TYPE_SCROLL_INSENSITIVE - * ResultSet.TYPE_SCROLL_SENSITIVE + * {@code ResultSet.TYPE_FORWARD_ONLY} or + * {@code ResultSet.TYPE_SCROLL_INSENSITIVE} + * {@code ResultSet.TYPE_SCROLL_SENSITIVE} * @see #getConcurrency * @see #getType */ @@ -4468,18 +4468,18 @@ } /** - * Sets the concurrency for this RowSet object to - * the specified concurrency. The default concurrency for any RowSet - * object (connected or disconnected) is ResultSet.CONCUR_UPDATABLE, + * Sets the concurrency for this {@code RowSet} object to + * the specified concurrency. The default concurrency for any {@code RowSet} + * object (connected or disconnected) is {@code ResultSet.CONCUR_UPDATABLE}, * but this method may be called at any time to change the concurrency. * * @param concur one of the following constants: - * ResultSet.CONCUR_READ_ONLY or - * ResultSet.CONCUR_UPDATABLE + * {@code ResultSet.CONCUR_READ_ONLY} or + * {@code ResultSet.CONCUR_UPDATABLE} * @throws SQLException if the parameter supplied is not one of the * following constants: - * ResultSet.CONCUR_UPDATABLE or - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_UPDATABLE} or + * {@code ResultSet.CONCUR_READ_ONLY} * @see #getConcurrency * @see #isReadOnly */ @@ -4500,8 +4500,8 @@ } /** - * Retrieves the value of the designated SQL XML parameter as a - * SQLXML object in the Java programming language. + * Retrieves the value of the designated {@code SQL XML} parameter as a + * {@code SQLXML} object in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @return a SQLXML object that maps an SQL XML value * @throws SQLException if a database access error occurs @@ -4512,8 +4512,8 @@ } /** - * Retrieves the value of the designated SQL XML parameter as a - * SQLXML object in the Java programming language. + * Retrieves the value of the designated {@code SQL XML} parameter as a + * {@code SQLXML} object in the Java programming language. * @param colName the name of the column from which to retrieve the value * @return a SQLXML object that maps an SQL XML value * @throws SQLException if a database access error occurs @@ -4524,12 +4524,12 @@ /** * Retrieves the value of the designated column in the current row of this - * ResultSet object as a java.sql.RowId object in the Java + * {@code ResultSet} object as a java.sql.RowId object in the Java * programming language. * * @param columnIndex the first column is 1, the second 2, ... - * @return the column value if the value is a SQL NULL the - * value returned is null + * @return the column value if the value is a SQL {@code NULL} the + * value returned is {@code null} * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4539,12 +4539,12 @@ /** * Retrieves the value of the designated column in the current row of this - * ResultSet object as a java.sql.RowId object in the Java + * {@code ResultSet} object as a java.sql.RowId object in the Java * programming language. * * @param columnName the name of the column - * @return the column value if the value is a SQL NULL the - * value returned is null + * @return the column value if the value is a SQL {@code NULL} the + * value returned is {@code null} * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4553,10 +4553,10 @@ } /** - * Updates the designated column with a RowId value. The updater + * Updates the designated column with a {@code RowId} value. The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnIndex the first column is 1, the second 2, ... @@ -4569,10 +4569,10 @@ } /** - * Updates the designated column with a RowId value. The updater + * Updates the designated column with a {@code RowId} value. The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4631,8 +4631,8 @@ /*o - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnIndex the first column is 1, the second 2, ... * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4643,8 +4643,8 @@ } /** - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnName name of the column * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4656,12 +4656,12 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param i the first column is 1, the second is 2, ... - * @return a NClob object representing the SQL - * NCLOB value in the specified column + * @return a {@code NClob} object representing the SQL + * {@code NCLOB} value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4672,11 +4672,11 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param colName the name of the column from which to retrieve the value - * @return a NClob object representing the SQL NCLOB + * @return a {@code NClob} object representing the SQL {@code NCLOB} * value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 @@ -4694,10 +4694,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * SQL {@code XML} value when it sends it to the database. * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an SQL {@code XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4706,10 +4706,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * {@code SQL XML} value when it sends it to the database. * @param parameterName the name of the parameter - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an {@code SQL XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4718,8 +4718,8 @@ } /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID value when it sends it + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} value when it sends it * to the database * * @param parameterIndex the first parameter is 1, the second is 2, ... @@ -4732,9 +4732,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID when it sends it to the + /** + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} when it sends it to the * database. * * @param parameterName the name of the parameter @@ -4748,18 +4748,18 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR value + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on NVARCHAR values) + * size relative to the driver's limits on {@code NVARCHAR} values) * when it sends it to the database. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNString(int parameterIndex, String value) throws SQLException { @@ -4768,9 +4768,9 @@ /** - * Sets the designated parameter in this RowSet object's command - * to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter in this {@code RowSet} object's command + * to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -4779,14 +4779,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed PreparedStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -4795,14 +4795,14 @@ } /** - * Sets the designated parameter to a java.sql.NClob object. The object - * implements the java.sql.NClob interface. This NClob - * object maps to a SQL NCLOB. + * Sets the designated parameter to a {@code java.sql.NClob} object. The object + * implements the {@code java.sql.NClob} interface. This {@code NClob} + * object maps to a SQL {@code NCLOB}. * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(String parameterName, NClob value) throws SQLException { @@ -4810,17 +4810,17 @@ } - /** + /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @exception SQLException if a database access error occurs * @since 1.6 @@ -4832,16 +4832,16 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the name of the column - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4850,11 +4850,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * @param columnIndex the first column is 1, the second 2, ... * @param xmlObject the value for the column to be updated @@ -4866,11 +4866,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4884,15 +4884,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnIndex the first column is 1, the second is 2, ... - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4902,15 +4902,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4927,9 +4927,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnIndex - the first column is 1, the second is 2, ... - * @param x - the new column value - * @param length - the length of the stream + * @param columnIndex the first column is 1, the second is 2, ... + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4949,9 +4949,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnName - name of the Column - * @param x - the new column value - * @param length - the length of the stream + * @param columnName name of the Column + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4963,26 +4963,27 @@ } /** - * Updates the designated column with a character stream value. The + * Updates the designated column with a character stream value. The * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} or this + * method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -4997,26 +4998,27 @@ * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * the result set concurrency is {@code CONCUR_READ_ONLY} or + * this method is called on a closed result set + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method * @since 1.6 */ public void updateNCharacterStream(String columnLabel, @@ -5027,9 +5029,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5039,16 +5041,16 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5060,9 +5062,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5072,18 +5074,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, + * then the label is the name of the column. * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException { @@ -5092,9 +5096,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5102,23 +5106,23 @@ * Java stream object or your own subclass that implements the * standard interface. * - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException { @@ -5127,9 +5131,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5138,22 +5142,23 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException { @@ -5161,11 +5166,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5175,17 +5180,17 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5193,11 +5198,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5207,17 +5212,18 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5225,33 +5231,33 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader) throws SQLException { @@ -5259,34 +5265,35 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader) throws SQLException { @@ -5294,11 +5301,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5308,19 +5315,19 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5328,11 +5335,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5342,19 +5349,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5362,11 +5370,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5375,22 +5383,22 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader) throws SQLException { @@ -5398,11 +5406,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5411,23 +5419,24 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader) throws SQLException { @@ -5435,22 +5444,22 @@ } - /** + /** * Updates the designated column with an ascii stream value, which will have * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5464,17 +5473,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBinaryStream(int columnIndex, @@ -5488,17 +5497,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5512,17 +5521,19 @@ * the specified number of bytes.. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5535,20 +5546,20 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5560,21 +5571,22 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5588,15 +5600,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5611,18 +5625,18 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5637,19 +5651,20 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5665,18 +5680,20 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5689,20 +5706,20 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5714,22 +5731,23 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5738,97 +5756,98 @@ } - /** - * Sets the designated parameter to the given java.net.URL value. - * The driver converts this to an SQL DATALINK value - * when it sends it to the database. - * - * @param parameterIndex the first parameter is 1, the second is 2, ... - * @param x the java.net.URL object to be set - * @exception SQLException if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.4 - */ + /** + * Sets the designated parameter to the given {@code java.net.URL} value. + * The driver converts this to an SQL {@code DATALINK} value + * when it sends it to the database. + * + * @param parameterIndex the first parameter is 1, the second is 2, ... + * @param x the {@code java.net.URL} object to be set + * @exception SQLException if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * @since 1.4 + */ public void setURL(int parameterIndex, java.net.URL x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB - * Note: Consult your JDBC driver documentation to determine if - * it might be more efficient to use a version of - * setNClob which takes a length parameter. - * - * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param reader An object that contains the data to set the parameter value to. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * - * @since 1.6 - */ + /** + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * Note: Consult your JDBC driver documentation to determine if + * it might be more efficient to use a version of + * {@code setNClob} which takes a length parameter. + * + * @param parameterIndex index of the first parameter is 1, the second is 2, ... + * @param reader An object that contains the data to set the parameter value to. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * + * @since 1.6 + */ public void setNClob(int parameterIndex, Reader reader) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB - * - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national - * character sets; if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * @since 1.6 - */ - public void setNClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. + * The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national + * character sets; if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * @since 1.6 + */ + public void setNClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); - } + } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNClob which takes a length parameter. + * {@code setNClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5839,23 +5858,24 @@ } - /** - ** of characters specified by length otherwise a SQLException will becontain the number - * generated when the PreparedStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method + /** + * of characters specified by length otherwise a {@code SQLException} will becontain the number + * generated when the {@code PreparedStatement} is executed. + * This method differs from the {@code setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5867,14 +5887,14 @@ /** - * Sets the designated parameter to a java.sql.NClob object. The driver converts this to -a - * SQL NCLOB value when it sends it to the database. + * Sets the designated parameter to a {@code java.sql.NClob} object. + * The driver converts this to an + * SQL {@code NCLOB} value when it sends it to the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(int parameterIndex, NClob value) throws SQLException{ @@ -5883,14 +5903,14 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNString(String parameterName, String value) @@ -5899,8 +5919,8 @@ } /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... @@ -5908,7 +5928,7 @@ * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException{ @@ -5918,8 +5938,8 @@ /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterName the name of the column to be set @@ -5935,9 +5955,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + /** + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -5946,14 +5966,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed CallableStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -5962,23 +5982,23 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIMESTAMP value, + * Sets the designated parameter to the given {@code java.sql.Timestamp} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIMESTAMP} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the timestamp + * a {@code Calendar} object, the driver can calculate the timestamp * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use - * to construct the timestamp + * @param cal the {@code Calendar} object the driver will use + * to construct the timestamp * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -5987,28 +6007,29 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } @@ -6016,16 +6037,16 @@ /** - * Sets the designated parameter to the given java.sql.Clob object. - * The driver converts this to an SQL CLOB value when it + * Sets the designated parameter to the given {@code java.sql.Clob} object. + * The driver converts this to an SQL {@code CLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Clob object that maps an SQL CLOB value + * @param x a {@code Clob} object that maps an SQL {@code CLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setClob (String parameterName, Clob x) throws SQLException{ @@ -6033,21 +6054,21 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs or this method is called on - * a closed CallableStatement + * a closed {@code CallableStatement} * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6058,19 +6079,19 @@ } - /** - * Sets the designated parameter to the given java.sql.Date value + /** + * Sets the designated parameter to the given {@code java.sql.Date} value * using the default time zone of the virtual machine that is running * the application. * The driver converts this - * to an SQL DATE value when it sends it to the database. + * to an SQL {@code DATE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6080,23 +6101,23 @@ } /** - * Sets the designated parameter to the given java.sql.Date value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL DATE value, + * Sets the designated parameter to the given {@code java.sql.Date} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code DATE} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the date + * a {@code Calendar} object, the driver can calculate the date * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the date * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6107,16 +6128,16 @@ /** - * Sets the designated parameter to the given java.sql.Time value. + * Sets the designated parameter to the given {@code java.sql.Time} value. * The driver converts this - * to an SQL TIME value when it sends it to the database. + * to an SQL {@code TIME} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6126,23 +6147,23 @@ } /** - * Sets the designated parameter to the given java.sql.Time value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIME value, + * Sets the designated parameter to the given {@code java.sql.Time} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIME} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the time + * a {@code Calendar} object, the driver can calculate the time * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the time * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6152,22 +6173,22 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatementor if parameterIndex does not correspond to a parameter - * marker in the SQL statement + * a closed {@code PreparedStatement}or if parameterIndex does not correspond to a parameter + * marker in the SQL statement * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6179,19 +6200,19 @@ /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - *This method differs from the setCharacterStream (int, Reader, int) method + * Sets the designated parameter to a {@code Reader} object. The reader 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 setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatement, if parameterIndex does not correspond to a parameter + * a closed {@code PreparedStatement}, if parameterIndex does not correspond to a parameter * marker in the SQL statement, or if the length specified is less than zero. * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method @@ -6204,25 +6225,26 @@ /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) + * Sets the designated parameter to a {@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)} * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... + * the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement, - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, if the length specified - * is less than zero or if the number of bytes in the inputstream does not match - * the specified length. + * this method is called on a closed {@code PreparedStatement}, + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, if the length specified + * is less than zero or if the number of bytes in the inputstream does not match + * the specified length. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6233,28 +6255,27 @@ } /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) - * This method differs from the setBinaryStream (int, InputStream) + * Sets the designated parameter to a {@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 - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... - - + * the second is 2, ... + * * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement or - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, + * this method is called on a closed {@code PreparedStatement} or + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6264,72 +6285,72 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length, otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) - * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, - * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB - * - * @param parameterName the name of the parameter to be set - * the second is 2, ... - * - * @param inputStream An object that contains the data to set the parameter - * value to. - * @param length the number of bytes in the parameter data. - * @throws SQLException if parameterIndex does not correspond - * to a parameter marker in the SQL statement, or if the length specified - * is less than zero; if the number of bytes in the inputstream does not match - * the specified length; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setBlob(String parameterName, InputStream inputStream, long length) + /** + * Sets the designated parameter to a {@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)} + * 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, + * the driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * + * @param parameterName the name of the parameter to be set + * the second is 2, ... + * + * @param inputStream An object that contains the data to set the parameter + * value to. + * @param length the number of bytes in the parameter data. + * @throws SQLException if parameterIndex does not correspond + * to a parameter marker in the SQL statement, or if the length specified + * is less than zero; if the number of bytes in the inputstream does not match + * the specified length; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.Blob object. - * The driver converts this to an SQL BLOB value when it + /** + * Sets the designated parameter to the given {@code java.sql.Blob} object. + * The driver converts this to an SQL {@code BLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Blob object that maps an SQL BLOB value + * @param x a {@code Blob} object that maps an SQL {@code BLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setBlob (String parameterName, Blob x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) + /** + * Sets the designated parameter to a {@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 BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARBINARY or a BLOB + * data should be send to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterName the name of the parameter * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6339,22 +6360,22 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. The second * argument must be an object type; for integral values, the - * java.lang equivalent objects should be used. + * {@code java.lang} equivalent objects should be used. * * The given Java object will be converted to the given targetSqlType * before being sent to the database. * * If the object has a custom mapping (is of a class implementing the - * interface SQLData), - * the JDBC driver should call the method SQLData.writeSQL to write it + * interface {@code SQLData}), + * the JDBC driver should call the method {@code SQLData.writeSQL} to write it * to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * Note that this method may be used to pass datatabase- @@ -6365,17 +6386,17 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database. The scale argument may further qualify this type. * @param scale for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types, this value will be ignored. + * this is the number of digits after the decimal point. For all other + * types, this value will be ignored. * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see Types * @see #getObject * @since 1.4 @@ -6387,7 +6408,7 @@ /** * Sets the value of the designated parameter with the given object. - * This method is like the method setObject + * This method is like the method {@code setObject} * above, except that it assumes a scale of zero. * * @param parameterName the name of the parameter @@ -6395,14 +6416,14 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see #getObject * @since 1.4 */ @@ -6411,13 +6432,13 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. - * The second parameter must be of type Object; therefore, the - * java.lang equivalent objects should be used for built-in types. + * The second parameter must be of type {@code Object}; therefore, the + * {@code java.lang} equivalent objects should be used for built-in types. * * The JDBC specification specifies a standard mapping from - * Java Object types to SQL types. The given argument + * Java {@code Object} types to SQL types. The given argument * will be converted to the corresponding SQL type before being * sent to the database. * @@ -6425,13 +6446,13 @@ * specific abstract data types, by using a driver-specific Java * type. * - * If the object is of a class implementing the interface SQLData, - * the JDBC driver should call the method SQLData.writeSQL + * If the object is of a class implementing the interface {@code SQLData}, + * the JDBC driver should call the method {@code SQLData.writeSQL} * to write it to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * This method throws an exception if there is an ambiguity, for example, if the @@ -6440,10 +6461,10 @@ * @param parameterName the name of the parameter * @param x the object containing the input parameter value * @exception SQLException if a database access error occurs, - * this method is called on a closed CallableStatement or if the given - * Object parameter is ambiguous + * this method is called on a closed {@code CallableStatement} or if the given + * {@code Object} parameter is ambiguous * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getObject * @since 1.4 */ @@ -6454,9 +6475,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6468,9 +6489,9 @@ * @param x the Java input stream that contains the ASCII parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setAsciiStream(String parameterName, java.io.InputStream x, int length) @@ -6482,9 +6503,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the stream + * {@code java.io.InputStream} object. The data will be read from the stream * as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6495,9 +6516,9 @@ * @param x the java input stream which contains the binary parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBinaryStream(String parameterName, java.io.InputStream x, @@ -6506,11 +6527,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6519,13 +6540,13 @@ * standard interface. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that + * @param reader the {@code java.io.Reader} object that * contains the UNICODE data used as the designated parameter * @param length the number of characters in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setCharacterStream(String parameterName, @@ -6536,9 +6557,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6547,15 +6568,15 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setAsciiStream which takes a length parameter. + * {@code setAsciiStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the Java input stream that contains the ASCII parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.6 - */ + * @since 1.6 + */ public void setAsciiStream(String parameterName, java.io.InputStream x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); @@ -6564,9 +6585,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the + * {@code java.io.InputStream} object. The data will be read from the * stream as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6574,12 +6595,12 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBinaryStream which takes a length parameter. + * {@code setBinaryStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the java input stream which contains the binary parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6589,11 +6610,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6602,13 +6623,13 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setCharacterStream which takes a length parameter. + * {@code setCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that contains the + * @param reader the {@code java.io.Reader} object that contains the * Unicode data * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6619,16 +6640,16 @@ /** * Sets the designated parameter to the given - * java.math.BigDecimal value. - * The driver converts this to an SQL NUMERIC value when + * {@code java.math.BigDecimal} value. + * The driver converts this to an SQL {@code NUMERIC} value when * it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBigDecimal * @since 1.4 */ @@ -6636,20 +6657,20 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java String value. + /** + * Sets the designated parameter to the given Java {@code String} value. * The driver converts this - * to an SQL VARCHAR or LONGVARCHAR value + * to an SQL {@code VARCHAR} or {@code LONGVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on VARCHAR values) + * size relative to the driver's limits on {@code VARCHAR} values) * when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getString * @since 1.4 */ @@ -6659,19 +6680,19 @@ - /** + /** * Sets the designated parameter to the given Java array of bytes. - * The driver converts this to an SQL VARBINARY or - * LONGVARBINARY (depending on the argument's size relative - * to the driver's limits on VARBINARY values) when it sends + * The driver converts this to an SQL {@code VARBINARY} or + * {@code LONGVARBINARY} (depending on the argument's size relative + * to the driver's limits on {@code VARBINARY} values) when it sends * it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBytes * @since 1.4 */ @@ -6680,17 +6701,17 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value. + * Sets the designated parameter to the given {@code java.sql.Timestamp} value. * The driver - * converts this to an SQL TIMESTAMP value when it sends it to the + * converts this to an SQL {@code TIMESTAMP} value when it sends it to the * database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -6700,16 +6721,16 @@ } /** - * Sets the designated parameter to SQL NULL. + * Sets the designated parameter to SQL {@code NULL}. * * Note: You must specify the parameter's SQL type. * * @param parameterName the name of the parameter - * @param sqlType the SQL type code defined in java.sql.Types + * @param sqlType the SQL type code defined in {@code java.sql.Types} * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull(String parameterName, int sqlType) throws SQLException { @@ -6717,8 +6738,8 @@ } /** - * Sets the designated parameter to SQL NULL. - * This version of the method setNull should + * Sets the designated parameter to SQL {@code NULL}. + * This version of the method {@code setNull} should * be used for user-defined types and REF type parameters. Examples * of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and * named array types. @@ -6738,14 +6759,14 @@ * * * @param parameterName the name of the parameter - * @param sqlType a value from java.sql.Types + * @param sqlType a value from {@code java.sql.Types} * @param typeName the fully-qualified name of an SQL user-defined type; * ignored if the parameter is not a user-defined type or - * SQL REF value + * SQL {@code REF} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull (String parameterName, int sqlType, String typeName) @@ -6754,17 +6775,17 @@ } /** - * Sets the designated parameter to the given Java boolean value. + * Sets the designated parameter to the given Java {@code boolean} value. * The driver converts this - * to an SQL BIT or BOOLEAN value when it sends it to the database. + * to an SQL {@code BIT} or {@code BOOLEAN} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @see #getBoolean * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBoolean(String parameterName, boolean x) throws SQLException{ @@ -6774,16 +6795,16 @@ /** - * Sets the designated parameter to the given Java byte value. + * Sets the designated parameter to the given Java {@code byte} value. * The driver converts this - * to an SQL TINYINT value when it sends it to the database. + * to an SQL {@code TINYINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getByte * @since 1.4 */ @@ -6793,16 +6814,16 @@ /** - * Sets the designated parameter to the given Java short value. + * Sets the designated parameter to the given Java {@code short} value. * The driver converts this - * to an SQL SMALLINT value when it sends it to the database. + * to an SQL {@code SMALLINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getShort * @since 1.4 */ @@ -6812,16 +6833,16 @@ /** - * Sets the designated parameter to the given Java int value. + * Sets the designated parameter to the given Java {@code int} value. * The driver converts this - * to an SQL INTEGER value when it sends it to the database. + * to an SQL {@code INTEGER} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getInt * @since 1.4 */ @@ -6829,17 +6850,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java long value. + /** + * Sets the designated parameter to the given Java {@code long} value. * The driver converts this - * to an SQL BIGINT value when it sends it to the database. + * to an SQL {@code BIGINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getLong * @since 1.4 */ @@ -6848,17 +6869,17 @@ } - /** - * Sets the designated parameter to the given Java float value. + /** + * Sets the designated parameter to the given Java {@code float} value. * The driver converts this - * to an SQL FLOAT value when it sends it to the database. + * to an SQL {@code FLOAT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getFloat * @since 1.4 */ @@ -6866,17 +6887,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java double value. + /** + * Sets the designated parameter to the given Java {@code double} value. * The driver converts this - * to an SQL DOUBLE value when it sends it to the database. + * to an SQL {@code DOUBLE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDouble * @since 1.4 */ @@ -6887,7 +6908,6 @@ /** * This method re populates the resBundle * during the deserialization process - * */ private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException { // Default state initialization happens here --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.803466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.635466074 +0400 @@ -43,22 +43,22 @@ /** - * The facility called on internally by the RIOptimisticProvider implementation to + * The facility called on internally by the {@code RIOptimisticProvider} implementation to * propagate changes back to the data source from which the rowset got its data. * - * A CachedRowSetWriter object, called a writer, has the public - * method writeData for writing modified data to the underlying data source. + * A {@code CachedRowSetWriter} object, called a writer, has the public + * method {@code writeData} for writing modified data to the underlying data source. * This method is invoked by the rowset internally and is never invoked directly by an application. * A writer also has public methods for setting and getting - * the CachedRowSetReader object, called a reader, that is associated + * the {@code CachedRowSetReader} object, called a reader, that is associated * with the writer. The remainder of the methods in this class are private and * are invoked internally, either directly or indirectly, by the method - * writeData. + * {@code writeData}. * - * Typically the SyncFactory manages the RowSetReader and - * the RowSetWriter implementations using SyncProvider objects. + * Typically the {@code SyncFactory} manages the {@code RowSetReader} and + * the {@code RowSetWriter} implementations using {@code SyncProvider} objects. * Standard JDBC RowSet implementations provide an object instance of this - * writer by invoking the SyncProvider.getRowSetWriter() method. + * writer by invoking the {@code SyncProvider.getRowSetWriter()} method. * * @version 0.2 * @author Jonathan Bruce @@ -69,15 +69,15 @@ public class CachedRowSetWriter implements TransactionalWriter, Serializable { /** - * The Connection object that this writer will use to make a + * The {@code Connection} object that this writer will use to make a * connection to the data source to which it will write data. * */ private transient Connection con; /** - * The SQL SELECT command that this writer will call - * internally. The method initSQLStatements builds this + * The SQL {@code SELECT} command that this writer will call + * internally. The method {@code initSQLStatements} builds this * command by supplying the words "SELECT" and "FROM," and using * metadata to get the table name and column names . * @@ -86,9 +86,9 @@ private String selectCmd; /** - * The SQL UPDATE command that this writer will call + * The SQL {@code UPDATE} command that this writer will call * internally to write data to the rowset's underlying data source. - * The method initSQLStatements builds this String + * The method {@code initSQLStatements} builds this {@code String} * object. * * @serial @@ -96,8 +96,8 @@ private String updateCmd; /** - * The SQL WHERE clause the writer will use for update - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for update + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -105,7 +105,7 @@ private String updateWhere; /** - * The SQL DELETE command that this writer will call + * The SQL {@code DELETE} command that this writer will call * internally to delete a row in the rowset's underlying data source. * * @serial @@ -113,8 +113,8 @@ private String deleteCmd; /** - * The SQL WHERE clause the writer will use for delete - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for delete + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -122,9 +122,9 @@ private String deleteWhere; /** - * The SQL INSERT INTO command that this writer will internally use + * The SQL {@code INSERT INTO} command that this writer will internally use * to insert data into the rowset's underlying data source. The method - * initSQLStatements builds this command with a question + * {@code initSQLStatements} builds this command with a question * mark parameter placeholder for each column in the rowset. * * @serial @@ -133,8 +133,8 @@ /** * An array containing the column numbers of the columns that are - * needed to uniquely identify a row in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * needed to uniquely identify a row in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ @@ -142,7 +142,7 @@ /** * An array of the parameters that should be used to set the parameter - * placeholders in a PreparedStatement object that this + * placeholders in a {@code PreparedStatement} object that this * writer will execute. * * @serial @@ -150,33 +150,33 @@ private Object[] params; /** - * The CachedRowSetReader object that has been - * set as the reader for the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code CachedRowSetReader} object that has been + * set as the reader for the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private CachedRowSetReader reader; /** - * The ResultSetMetaData object that contains information - * about the columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code ResultSetMetaData} object that contains information + * about the columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private ResultSetMetaData callerMd; /** - * The number of columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The number of columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private int callerColumnCount; /** - * This CachedRowSet will hold the conflicting values + * This {@code CachedRowSet} will hold the conflicting values * retrieved from the db and hold it. */ private CachedRowSetImpl crsResolve; @@ -209,8 +209,8 @@ } /** - * Propagates changes in the given RowSet object - * back to its underlying data source and returns true + * Propagates changes in the given {@code RowSet} object + * back to its underlying data source and returns {@code true} * if successful. The writer will check to see if * the data in the pre-modified rowset (the original values) differ * from the data in the underlying data source. If data in the data @@ -221,15 +221,15 @@ * access for concurrent users. * * This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. * - * Creates a CachedRowSet object from the given - * RowSet object + * Creates a {@code CachedRowSet} object from the given + * {@code RowSet} object * Makes a connection with the data source * * Disables autocommit mode if it is not already disabled @@ -237,32 +237,32 @@ * * Checks to see if the reader has read new data since the writer * was last called and, if so, calls the method - * initSQLStatements to initialize new SQL statements + * {@code initSQLStatements} to initialize new SQL statements * - * Builds new SELECT, UPDATE, - * INSERT, and DELETE statements - * Uses the CachedRowSet object's metadata to + * Builds new {@code SELECT}, {@code UPDATE}, + * {@code INSERT}, and {@code DELETE} statements + * Uses the {@code CachedRowSet} object's metadata to * determine the table name, column names, and the columns * that make up the primary key * * When there is no conflict, propagates changes made to the - * CachedRowSet object back to its underlying data source + * {@code CachedRowSet} object back to its underlying data source * - * Iterates through each row of the CachedRowSet object + * Iterates through each row of the {@code CachedRowSet} object * to determine whether it has been updated, inserted, or deleted * If the corresponding row in the data source has not been changed * since the rowset last read its * values, the writer will use the appropriate command to update, * insert, or delete the row * If any data in the data source does not match the original values - * for the CachedRowSet object, the writer will roll + * for the {@code CachedRowSet} object, the writer will roll * back any changes it has made to the row in the data source. * * * - * @return true if changes to the rowset were successfully + * @return {@code true} if changes to the rowset were successfully * written to the rowset's underlying data source; - * false otherwise + * {@code false} otherwise */ public boolean writeData(RowSetInternal caller) throws SQLException { long conflicts = 0; @@ -434,25 +434,25 @@ } //end writeData -/** - * Updates the given CachedRowSet object's underlying data - * source so that updates to the rowset are reflected in the original - * data source, and returns false if the update was successful. - * A return value of true indicates that there is a conflict, - * meaning that a value updated in the rowset has already been changed by - * someone else in the underlying data source. A conflict can also exist - * if, for example, more than one row in the data source would be affected - * by the update or if no rows would be affected. In any case, if there is - * a conflict, this method does not update the underlying data source. - * - * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + * + * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - * - * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + * + * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. * - * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - * - * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + * + * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. * * If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. * * The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. * * NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. * * This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. * - * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. * - * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. * * Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. * - * undoUpdateRowSet object backed by the same data as - * that of this CachedRowSetImpl object and sharing a set of cursors + * Returns a new {@code RowSet} object backed by the same data as + * that of this {@code CachedRowSetImpl} object and sharing a set of cursors * with it. This allows cursors to interate over a shared set of rows, providing * multiple views of the underlying data. * - * @return a RowSet object that is a copy of this CachedRowSetImpl + * @return a {@code RowSet} object that is a copy of this {@code CachedRowSetImpl} * object and shares a set of cursors with it * @throws SQLException if an error occurs or cloning is * not supported @@ -750,19 +750,19 @@ } /** - * Returns a new RowSet object containing by the same data - * as this CachedRowSetImpl object. This method - * differs from the method createCopy in that it throws a - * CloneNotSupportedException object instead of an - * SQLException object, as the method createShared - * does. This clone - * method is called internally by the method createShared, - * which catches the CloneNotSupportedException object - * and in turn throws a new SQLException object. + * Returns a new {@code RowSet} object containing by the same data + * as this {@code CachedRowSetImpl} object. This method + * differs from the method {@code createCopy} in that it throws a + * {@code CloneNotSupportedException} object instead of an + * {@code SQLException} object, as the method {@code createShared} + * does. This {@code clone} + * method is called internally by the method {@code createShared}, + * which catches the {@code CloneNotSupportedException} object + * and in turn throws a new {@code SQLException} object. * - * @return a copy of this CachedRowSetImpl object + * @return a copy of this {@code CachedRowSetImpl} object * @throws CloneNotSupportedException if an error occurs when - * attempting to clone this CachedRowSetImpl object + * attempting to clone this {@code CachedRowSetImpl} object * @see #createShared */ protected Object clone() throws CloneNotSupportedException { @@ -770,8 +770,8 @@ } /** - * Creates a RowSet object that is a deep copy of - * this CachedRowSetImpl object's data, including + * Creates a {@code RowSet} object that is a deep copy of + * this {@code CachedRowSetImpl} object's data, including * constraints. Updates made * on a copy are not visible to the original rowset; * a copy of a rowset is completely independent from the original. @@ -780,12 +780,12 @@ * from first principles, which can be quite expensive. * For example, it can eliminate the need to query a * remote database server. - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSet object and is - * completely independent from this CachedRowSetImpl + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSet} object and is + * completely independent from this {@code CachedRowSetImpl} * object. * @throws SQLException if an error occurs in generating the copy of this - * of the CachedRowSetImpl + * of the {@code CachedRowSetImpl} * @see #createShared * @see javax.sql.RowSetEvent * @see javax.sql.RowSetListener @@ -795,21 +795,21 @@ } /** - * Creates a RowSet object that is a copy of - * this CachedRowSetImpl object's table structure + * Creates a {@code RowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's table structure * and the constraints only. * There will be no data in the object being returned. * Updates made on a copy are not visible to the original rowset. * * This helps in getting the underlying XML schema which can - * be used as the basis for populating a WebRowSet. + * be used as the basis for populating a {@code WebRowSet}. * - * @return a new CachedRowSet object that is a copy - * of this CachedRowSetImpl object's schema and + * @return a new {@code CachedRowSet} object that is a copy + * of this {@code CachedRowSetImpl} object's schema and * retains all the constraints on the original rowset but contains * no data * @throws SQLException if an error occurs in generating the copy - * of the CachedRowSet object + * of the {@code CachedRowSet} object * @see #createShared * @see #createCopy * @see #createCopyNoConstraints @@ -821,17 +821,17 @@ } /** - * Creates a CachedRowSet object that is a copy of - * this CachedRowSetImpl object's data only. + * Creates a {@code CachedRowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's data only. * All constraints set in this object will not be there * in the returning object. Updates made * on a copy are not visible to the original rowset. * - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSetImpl object and is - * completely independent from this CachedRowSetImpl object + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSetImpl} object and is + * completely independent from this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the copy of the - * of the CachedRowSet + * of the {@code CachedRowSet} * @see #createShared * @see #createCopy * @see #createCopySchema @@ -843,15 +843,15 @@ } /** - * Converts this CachedRowSetImpl object to a collection - * of tables. The sample implementation utilitizes the TreeMap + * Converts this {@code CachedRowSetImpl} object to a collection + * of tables. The sample implementation utilitizes the {@code TreeMap} * collection type. * This class guarantees that the map will be in ascending key order, * sorted according to the natural order for the key's class. * - * @return a Collection object consisting of tables, + * @return a {@code Collection} object consisting of tables, * each of which is a copy of a row in this - * CachedRowSetImpl object + * {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the collection * @see #toCollection(int) * @see #toCollection(String) @@ -863,16 +863,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -886,16 +886,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -914,25 +914,25 @@ /** - * Returns the SyncProvider implementation being used - * with this CachedRowSetImpl implementation rowset. + * Returns the {@code SyncProvider} implementation being used + * with this {@code CachedRowSetImpl} implementation rowset. * * @return the SyncProvider used by the rowset. If not provider was * set when the rowset was instantiated, the reference * implementation (default) provider is returned. * @throws SQLException if error occurs while return the - * SyncProvider instance. + * {@code SyncProvider} instance. */ public SyncProvider getSyncProvider() throws SQLException { throw new UnsupportedOperationException(); } /** - * Sets the active SyncProvider and attempts to load - * load the new provider using the SyncFactory SPI. + * Sets the active {@code SyncProvider} and attempts to load + * load the new provider using the {@code SyncFactory} SPI. * * @throws SQLException if an error occurs while resetting the - * SyncProvider. + * {@code SyncProvider}. */ public void setSyncProvider(String providerStr) throws SQLException { throw new UnsupportedOperationException(); @@ -953,23 +953,23 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data. + * Populates this {@code CachedRowSetImpl} object with data. * This form of the method uses the rowset's user, password, and url or * data source name properties to create a database * connection. If properties that are needed * have not been set, this method will throw an exception. * - * Another form of this method uses an existing JDBC Connection + * Another form of this method uses an existing JDBC {@code Connection} * object instead of creating a new one; therefore, it ignores the * properties used for establishing a new connection. * * The query specified by the command property is executed to create a - * ResultSet object from which to retrieve data. + * {@code ResultSet} object from which to retrieve data. * The current contents of the rowset are discarded, and the * rowset's metadata is also (re)set. If there are outstanding updates, * they are also ignored. * - * The method execute closes any database connections that it + * The method {@code execute} closes any database connections that it * creates. * * @throws SQLException if an error occurs or the @@ -987,20 +987,20 @@ /** * Moves the cursor down one row from its current position and - * returns true if the new cursor position is a + * returns {@code true} if the new cursor position is a * valid row. - * The cursor for a new ResultSet object is initially + * The cursor for a new {@code ResultSet} object is initially * positioned before the first row. The first call to the method - * next moves the cursor to the first row, making it + * {@code next} moves the cursor to the first row, making it * the current row; the second call makes the second row the * current row, and so on. * * If an input stream from the previous row is open, it is - * implicitly closed. The ResultSet object's warning + * implicitly closed. The {@code ResultSet} object's warning * chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if an error occurs or * the cursor is not positioned in the rowset, before * the first row, or after the last row @@ -1010,9 +1010,9 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the next - * row and returns true if the cursor is still in the rowset; - * returns false if the cursor has moved to the position after + * Moves this {@code CachedRowSetImpl} object's cursor to the next + * row and returns {@code true} if the cursor is still in the rowset; + * returns {@code false} if the cursor has moved to the position after * the last row. * * This method handles the cases where the cursor moves to a row that @@ -1021,15 +1021,15 @@ * that has been deleted, this method moves the cursor to the next * row until the cursor is on a row that has not been deleted. * - * The method internalNext is called by methods such as - * next, absolute, and relative, + * The method {@code internalNext} is called by methods such as + * {@code next}, {@code absolute}, and {@code relative}, * and, as its name implies, is only called internally. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a valid row in this - * rowset; false if it is after the last row + * @return {@code true} if the cursor is on a valid row in this + * rowset; {@code false} if it is after the last row * @throws SQLException if an error occurs */ protected boolean internalNext() throws SQLException { @@ -1037,25 +1037,25 @@ } /** - * Closes this CachedRowSetImpl objecy and releases any resources + * Closes this {@code CachedRowSetImpl} objecy and releases any resources * it was using. * * @throws SQLException if an error occurs when releasing any resources in use - * by this CachedRowSetImpl object + * by this {@code CachedRowSetImpl} object */ public void close() throws SQLException { throw new UnsupportedOperationException(); } /** - * Reports whether the last column read was SQL NULL. - * Note that you must first call the method getXXX + * Reports whether the last column read was SQL {@code NULL}. + * Note that you must first call the method {@code getXXX} * on a column to try to read its value and then call the method - * wasNull to determine whether the value was - * SQL NULL. + * {@code wasNull} to determine whether the value was + * SQL {@code NULL}. * - * @return true if the value in the last column read - * was SQL NULL; false otherwise + * @return {@code true} if the value in the last column read + * was SQL {@code NULL}; {@code false} otherwise * @throws SQLException if an error occurs */ public boolean wasNull() throws SQLException { @@ -1064,9 +1064,9 @@ /** * Returns the insert row or the current row of this - * CachedRowSetImplobject. + * {@code CachedRowSetImpl}object. * - * @return the Row object on which this CachedRowSetImpl + * @return the {@code Row} object on which this {@code CachedRowSetImpl} * objects's cursor is positioned */ protected BaseRow getCurrentRow() { @@ -1077,7 +1077,7 @@ * Removes the row on which the cursor is positioned. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * * @throws SQLException if the cursor is positioned on the insert * row @@ -1089,20 +1089,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * String object. + * of this {@code CachedRowSetImpl} object as a + * {@code String} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} {@code CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type designates the * recommended return type. */ public String getString(int columnIndex) throws SQLException { @@ -1111,18 +1111,18 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * boolean value. + * of this {@code CachedRowSetImpl} object as a + * {@code boolean} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a boolean in the Java progamming language; - * if the value is SQL NULL, the result is false + * @return the column value as a {@code boolean} in the Java progamming language; + * if the value is SQL {@code NULL}, the result is {@code false} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BOOLEAN value + * SQL {@code BOOLEAN} value * @see #getBoolean(String) */ public boolean getBoolean(int columnIndex) throws SQLException { @@ -1131,20 +1131,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type + * SQL {@code TINYINT}, {@code SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type * designates the recommended return type. * @see #getByte(String) */ @@ -1154,21 +1154,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * short value. + * of this {@code CachedRowSetImpl} object as a + * {@code short} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT}, {@code SMALLINT}, + * {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(String) */ public short getShort(int columnIndex) throws SQLException { @@ -1177,21 +1178,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * int value. + * of this {@code CachedRowSetImpl} object as an + * {@code int} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1199,21 +1201,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * long value. + * of this {@code CachedRowSetImpl} object as a + * {@code long} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getLong(String) */ public long getLong(int columnIndex) throws SQLException { @@ -1222,21 +1225,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * float value. + * of this {@code CachedRowSetImpl} object as a + * {@code float} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,} + * {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC, + * BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(int columnIndex) throws SQLException { @@ -1245,21 +1248,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * double value. + * of this {@code CachedRowSetImpl} object as a + * {@code double} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,} + * {@code FLOAT, DOUBLE}, + * {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getDouble(String) * */ @@ -1269,21 +1273,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * This method is deprecated; use the version of getBigDecimal + * This method is deprecated; use the version of {@code getBigDecimal} * that does not take a scale parameter and returns a value with full * precision. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @param scale the number of digits to the right of the decimal point in the * value returned * @return the column value with the specified number of digits to the right - * of the decimal point; if the value is SQL NULL, the - * result is null + * of the decimal point; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails * @deprecated @@ -1295,22 +1299,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte array value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} array value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the - * result is null + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the + * result is {@code null} * * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or + * {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getBytes(String) */ public byte[] getBytes(int columnIndex) throws SQLException { @@ -1319,17 +1323,17 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Date object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Date} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a java.sql.Data object; if - * the value is SQL NULL, the - * result is null + * @return the column value as a {@code java.sql.Data} object; if + * the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, - * the cursor is not on a valid row, or this method fails + * the cursor is not on a valid row, or this method fails */ public java.sql.Date getDate(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1337,14 +1341,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Time object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Time} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1354,14 +1358,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1371,33 +1375,33 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The JDBC + * suitable for retrieving large {@code LONGVARCHAR} values. The JDBC * driver will do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. . Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(String) */ public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException { @@ -1416,8 +1420,8 @@ * stream may return 0 for available() whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of two byte Unicode characters. If the value is SQL NULL @@ -1432,30 +1436,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for - * CachedRowSetImpl.available() whether there is data + * stream may return {@code 0} for + * {@code CachedRowSetImpl.available()} whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes. If the value is SQL NULL - * then the result is null. + * as a stream of uninterpreted bytes. If the value is SQL {@code NULL} + * then the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY}. * The bold type indicates the SQL type that this method is recommened * to retrieve. * @see #getBinaryStream(String) @@ -1472,19 +1476,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a String object. + * of the current row as a {@code String} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR< value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} + * {@code CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. */ public String getString(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1492,17 +1496,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a boolean value. + * of the current row as a {@code boolean} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a boolean in the Java programming - * language; if the value is SQL NULL, - * the result is false + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code boolean} in the Java programming + * language; if the value is SQL {@code NULL}, + * the result is {@code false} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BOOLEAN value + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BOOLEAN} value * @see #getBoolean(int) */ public boolean getBoolean(String columnName) throws SQLException { @@ -1511,19 +1515,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte value. + * of the current row as a {@code byte} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The - * bold type designates the recommended return type + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT}, + * {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} + * value. The bold type designates the recommended return type. */ public byte getByte(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1531,19 +1535,20 @@ /** * Retrieves the value stored in the designated column - * of the current row as a short value. + * of the current row as a {@code short} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT,} + * {@code SMALLINT}, {@code INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(int) */ public short getShort(String columnName) throws SQLException { @@ -1552,20 +1557,21 @@ /** * Retrieves the value stored in the designated column - * of the current row as an int value. + * of the current row as an {@code int} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name - * of a column in this rowset, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * of a column in this rowset, + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1573,19 +1579,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a long value. + * of the current row as a {@code long} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getLong(int) */ public long getLong(String columnName) throws SQLException { @@ -1594,19 +1600,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a float value. + * of the current row as a {@code float} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT,} {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(String columnName) throws SQLException { @@ -1615,20 +1621,20 @@ /** * Retrieves the value stored in the designated column - * of the current row of this CachedRowSetImpl object - * as a double value. + * of the current row of this {@code CachedRowSetImpl} object + * as a {@code double} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return types. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL,} {@code FLOAT, DOUBLE}, {@code DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return types. * @see #getDouble(int) */ public double getDouble(String columnName) throws SQLException { @@ -1637,22 +1643,22 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.math.BigDecimal object. + * of the current row as a {@code java.math.BigDecimal} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @param scale the number of digits to the right of the decimal point - * @return a java.math.BugDecimal object with scale - * number of digits to the right of the decimal point. + * @return a java.math.BugDecimal object with {@code scale} + * number of digits to the right of the decimal point. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve. - * @deprecated Use the getBigDecimal(String columnName) + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. + * @deprecated Use the {@code getBigDecimal(String columnName)} * method instead */ @Deprecated @@ -1662,19 +1668,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte array. + * of the current row as a {@code byte} array. * The bytes represent the raw values returned by the driver. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BINARY, VARBINARY - * or LONGVARBINARY values - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BINARY, VARBINARY} + * or {@code LONGVARBINARY} values. + * The bold SQL type designates the recommended return type. * @see #getBytes(int) */ public byte[] getBytes(String columnName) throws SQLException { @@ -1683,17 +1689,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Date object. + * of the current row as a {@code java.sql.Date} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1701,12 +1707,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Time object. + * of the current row as a {@code java.sql.Time} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1717,12 +1723,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Timestamp object. + * of the current row as a {@code java.sql.Timestamp} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1733,32 +1739,32 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The - * SyncProvider will rely on the JDBC driver to do any necessary + * suitable for retrieving large {@code LONGVARCHAR} values. The + * {@code SyncProvider} will rely on the JDBC driver to do any necessary * conversion from the database format into ASCII format. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * a column in this rowset + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(int) */ public java.io.InputStream getAsciiStream(String columnName) throws SQLException { @@ -1769,23 +1775,23 @@ /** * A column value can be retrieved as a stream of Unicode characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will do any necessary conversion from the database * format into Unicode. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row - * @deprecated use the method getCharacterStream instead + * @deprecated use the method {@code getCharacterStream} instead */ @Deprecated public java.io.InputStream getUnicodeStream(String columnName) throws SQLException { @@ -1794,30 +1800,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of uninterpreted bytes. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is unknown, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY - * The bold type indicates the SQL type that this method is recommened - * to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY} + * The bold type indicates the SQL type that this method is recommened + * to retrieve. * @see #getBinaryStream(int) * */ @@ -1831,17 +1837,17 @@ //===================================================================== /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by statement + * by {@code ResultSet} methods. Any warning caused by statement * methods (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * * @return the first SQLWarning or null */ @@ -1850,10 +1856,10 @@ } /** - * Clears all the warnings reporeted for the CachedRowSetImpl - * object. After a call to this method, the getWarnings method - * returns null until a new warning is reported for this - * CachedRowSetImpl object. + * Clears all the warnings reporeted for the {@code CachedRowSetImpl} + * object. After a call to this method, the {@code getWarnings} method + * returns {@code null} until a new warning is reported for this + * {@code CachedRowSetImpl} object. */ public void clearWarnings() { throw new UnsupportedOperationException(); @@ -1861,25 +1867,25 @@ /** * Retrieves the name of the SQL cursor used by this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * * In SQL, a result table is retrieved through a cursor that is - * named. The current row of a ResultSet can be updated or deleted + * named. The current row of a {@code ResultSet} can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To ensure that the cursor has the proper isolation - * level to support an update operation, the cursor's SELECT - * statement should be of the form select for update. - * If the for update clause + * level to support an update operation, the cursor's {@code SELECT} + * statement should be of the form {@code select for update}. + * If the {@code for update} clause * is omitted, positioned updates may fail. * * JDBC supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. The current row + * SQL cursor used by a {@code ResultSet} object. The current row * of a result set is also the current row of this SQL cursor. * * Note: If positioned updates are not supported, an - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL cursor name for this CachedRowSetImpl object's + * @return the SQL cursor name for this {@code CachedRowSetImpl} object's * cursor * @throws SQLException if an error occurs */ @@ -1888,12 +1894,12 @@ } /** - * Retrieves a ResultSetMetaData object instance that - * contains information about the CachedRowSet object. + * Retrieves a {@code ResultSetMetaData} object instance that + * contains information about the {@code CachedRowSet} object. * However, applications should cast the returned object to a - * RowSetMetaData interface implementation. In the + * {@code RowSetMetaData} interface implementation. In the * reference implementation, this cast can be done on the - * RowSetMetaDataImpl class. + * {@code RowSetMetaDataImpl} class. * * For example: * @@ -1907,10 +1913,10 @@ * crs.setMetaData(metaData); * * - * @return the ResultSetMetaData object that describes this - * CachedRowSetImpl object's columns + * @return the {@code ResultSetMetaData} object that describes this + * {@code CachedRowSetImpl} object's columns * @throws SQLException if an error occurs in generating the RowSet - * meta data; or if the CachedRowSetImpl is empty. + * meta data; or if the {@code CachedRowSetImpl} is empty. * @see javax.sql.RowSetMetaData */ public ResultSetMetaData getMetaData() throws SQLException { @@ -1920,10 +1926,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1931,23 +1937,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes in the Java programming language. * When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(String) */ public Object getObject(int columnIndex) throws SQLException { @@ -1956,10 +1962,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1967,23 +1973,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes * in the Java programming language. When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name does not match one of * this rowset's column names, (2) the cursor is not * on a valid row, or (3) there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(int) */ public Object getObject(String columnName) throws SQLException { @@ -1993,10 +1999,10 @@ //---------------------------------------------------------------- /** - * Maps the given column name for one of this CachedRowSetImpl + * Maps the given column name for one of this {@code CachedRowSetImpl} * object's columns to its column number. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @return the column index of the given column name * @throws SQLException if the given column name does not match one @@ -2014,25 +2020,25 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java character stream that delivers the database column value * as a stream of two-byte unicode characters in a - * java.io.Reader object. If the value is - * SQL NULL, the result is null. + * {@code java.io.Reader} object. If the value is + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR,} {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getCharacterStream(String) */ public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{ @@ -2041,23 +2047,24 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY or LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code CHAR, VARCHAR,} + * {@code LONGVARCHAR}, + * {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -2065,21 +2072,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return types that this method is used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return types that this method is used to retrieve. * @see #getBigDecimal(String) */ public BigDecimal getBigDecimal(int columnIndex) throws SQLException { @@ -2088,21 +2096,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. * @see #getBigDecimal(int) */ public BigDecimal getBigDecimal(String columnName) throws SQLException { @@ -2114,7 +2122,7 @@ //--------------------------------------------------------------------- /** - * Returns the number of rows in this CachedRowSetImpl object. + * Returns the number of rows in this {@code CachedRowSetImpl} object. * * @return number of rows in the rowset */ @@ -2124,10 +2132,10 @@ /** * Indicates whether the cursor is before the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is before the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isBeforeFirst() throws SQLException { @@ -2136,10 +2144,10 @@ /** * Indicates whether the cursor is after the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is after the last row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isAfterLast() throws SQLException { @@ -2148,10 +2156,10 @@ /** * Indicates whether the cursor is on the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is on the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isFirst() throws SQLException { @@ -2160,14 +2168,14 @@ /** * Indicates whether the cursor is on the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * Note: Calling the method isLast may be expensive + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver might need to fetch ahead one row in order * to determine whether the current row is the last row in this rowset. * - * @return true if the cursor is on the last row; - * false otherwise or if this rowset contains no rows + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise or if this rowset contains no rows * @throws SQLException if an error occurs */ public boolean isLast() throws SQLException { @@ -2175,19 +2183,19 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the front of + * Moves this {@code CachedRowSetImpl} object's cursor to the front of * the rowset, just before the first row. This method has no effect if * this rowset contains no rows. * * @throws SQLException if an error occurs or the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public void beforeFirst() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the end of + * Moves this {@code CachedRowSetImpl} object's cursor to the end of * the rowset, just after the last row. This method has no effect if * this rowset contains no rows. * @@ -2198,34 +2206,34 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the first row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the first row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean first() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the first - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the first + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the methods first, - * isFirst, and absolute. - * It in turn calls the method internalNext in order to + * This method is called internally by the methods {@code first}, + * {@code isFirst}, and {@code absolute}. + * It in turn calls the method {@code internalNext} in order to * handle the case where the first row is a deleted row that is not visible. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the first row; - * false otherwise + * @return {@code true} if the cursor moved to the first row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalFirst() throws SQLException { @@ -2233,35 +2241,35 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the last row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the last row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean last() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the last - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the last + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the method last + * This method is called internally by the method {@code last} * when rows have been deleted and the deletions are not visible. - * The method internalLast handles the case where the + * The method {@code internalLast} handles the case where the * last row is a deleted row that is not visible by in turn calling - * the method internalPrevious. + * the method {@code internalPrevious}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the last row; - * false otherwise + * @return {@code true} if the cursor moved to the last row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalLast() throws SQLException { @@ -2269,12 +2277,12 @@ } /** - * Returns the number of the current row in this CachedRowSetImpl + * Returns the number of the current row in this {@code CachedRowSetImpl} * object. The first row is number 1, the second number 2, and so on. * - * @return the number of the current row; 0 if there is no + * @return the number of the current row; {@code 0} if there is no * current row - * @throws SQLException if an error occurs; or if the CacheRowSetImpl + * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl} * is empty */ public int getRow() throws SQLException { @@ -2282,51 +2290,51 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the row number + * Moves this {@code CachedRowSetImpl} object's cursor to the row number * specified. * * If the number is positive, the cursor moves to an absolute row with * respect to the beginning of the rowset. The first row is row 1, the second * is row 2, and so on. For example, the following command, in which - * crs is a CachedRowSetImpl object, moves the cursor + * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor * to the fourth row, starting from the beginning of the rowset. - * + * {@code * * crs.absolute(4); * - * + * } * * If the number is negative, the cursor moves to an absolute row position * with respect to the end of the rowset. For example, calling - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row, counting * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. * * @param row a positive number to indicate the row, starting row numbering from - * the first row, which is 1; a negative number to indicate + * the first row, which is {@code 1}; a negative number to indicate * the row, starting row numbering from the last row, which is - * -1; it must not be 0 - * @return true if the cursor is on the rowset; false + * {@code -1}; it must not be {@code 0} + * @return {@code true} if the cursor is on the rowset; {@code false} * otherwise - * @throws SQLException if the given cursor position is 0 or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * @throws SQLException if the given cursor position is {@code 0} or the + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean absolute( int row ) throws SQLException { throw new UnsupportedOperationException(); @@ -2340,80 +2348,80 @@ * If the number is positive, the cursor moves the specified number of * rows toward the end of the rowset, starting at the current row. * For example, the following command, in which - * crs is a CachedRowSetImpl object with 100 rows, + * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows, * moves the cursor forward four rows from the current row. If the * current row is 50, the cursor would move to row 54. - * + * {@code * * crs.relative(4); * - * + * } * * If the number is negative, the cursor moves back toward the beginning * the specified number of rows, starting at the current row. * For example, calling the method - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. In both cases, this method - * throws an SQLException. + * throws an {@code SQLException}. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). Calling relative(0) + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. Calling {@code relative(0)} * is valid, but it does not change the cursor position. * - * @param rows an int indicating the number of rows to move + * @param rows an {@code int} indicating the number of rows to move * the cursor, starting at the current row; a positive number * moves the cursor forward; a negative number moves the cursor * backward; must not move the cursor past the valid * rows - * @return true if the cursor is on a row in this - * CachedRowSetImpl object; false + * @return {@code true} if the cursor is on a row in this + * {@code CachedRowSetImpl} object; {@code false} * otherwise * @throws SQLException if there are no rows in this rowset, the cursor is * positioned either before the first row or after the last row, or - * the rowset is type ResultSet.TYPE_FORWARD_ONLY + * the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean relative(int rows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the - * previous row and returns true if the cursor is on - * a valid row or false if it is not. + * Moves this {@code CachedRowSetImpl} object's cursor to the + * previous row and returns {@code true} if the cursor is on + * a valid row or {@code false} if it is not. * This method also notifies all listeners registered with this - * CachedRowSetImpl object that its cursor has moved. + * {@code CachedRowSetImpl} object that its cursor has moved. * - * Note: calling the method previous() is not the same - * as calling the method relative(-1). This is true - * because it is possible to call previous() from the insert + * Note: calling the method {@code previous()} is not the same + * as calling the method {@code relative(-1)}. This is true + * because it is possible to call {@code previous()} from the insert * row, from after the last row, or from the current row, whereas - * relative may only be called from the current row. + * {@code relative} may only be called from the current row. * - * The method previous may used in a while + * The method {@code previous} may used in a {@code while} * loop to iterate through a rowset starting after the last row - * and moving toward the beginning. The loop ends when previous - * returns false, meaning that there are no more rows. + * and moving toward the beginning. The loop ends when {@code previous} + * returns {@code false}, meaning that there are no more rows. * For example, the following code fragment retrieves all the data in - * the CachedRowSetImpl object crs, which has + * the {@code CachedRowSetImpl} object {@code crs}, which has * three columns. Note that the cursor must initially be positioned * after the last row so that the first call to the method - * previous places the cursor on the last line. - * + * {@code previous} places the cursor on the last line. + * {@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - * - * This method throws an SQLException if the cursor is not + * } + * This method throws an {@code SQLException} if the cursor is not * on a row in the rowset, before the first row, or after the last row. * - * @return true if the cursor is on a valid row; - * false if it is before the first row or after the + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is before the first row or after the * last row * @throws SQLException if the cursor is not on a valid position or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean previous() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor to the previous row in this CachedRowSetImpl + * Moves the cursor to the previous row in this {@code CachedRowSetImpl} * object, skipping past deleted rows that are not visible; returns - * true if the cursor is on a row in this rowset and - * false when the cursor goes before the first row. + * {@code true} if the cursor is on a row in this rowset and + * {@code false} when the cursor goes before the first row. * - * This method is called internally by the method previous. + * This method is called internally by the method {@code previous}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a row in this rowset; - * false when the cursor reaches the position before + * @return {@code true} if the cursor is on a row in this rowset; + * {@code false} when the cursor reaches the position before * the first row * @throws SQLException if an error occurs */ @@ -2463,14 +2471,14 @@ //--------------------------------------------------------------------- /** - * Indicates whether the current row of this CachedRowSetImpl + * Indicates whether the current row of this {@code CachedRowSetImpl} * object has been updated. The value returned - * depends on whether this rowset can detect updates: false + * depends on whether this rowset can detect updates: {@code false} * will always be returned if it does not detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another and updates are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2482,13 +2490,13 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * * @param idx the index identifier of the column that may be have been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2500,14 +2508,14 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * - * @param columnName the String column name column that may be have + * @param columnName the {@code String} column name column that may be have * been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2521,8 +2529,8 @@ * Indicates whether the current row has been inserted. The value returned * depends on whether or not the rowset can detect visible inserts. * - * @return true if a row has been inserted and inserts are detected; - * false otherwise + * @return {@code true} if a row has been inserted and inserts are detected; + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2536,12 +2544,12 @@ * Indicates whether the current row has been deleted. A deleted row * may leave a visible "hole" in a rowset. This method can be used to * detect such holes if the rowset can detect deletions. This method - * will always return false if this rowset cannot detect + * will always return {@code false} if this rowset cannot detect * deletions. * - * @return true if (1)the current row is blank, indicating that + * @return {@code true} if (1)the current row is blank, indicating that * the row has been deleted, and (2)deletions are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on a valid row in this rowset * @see DatabaseMetaData#deletesAreDetected */ @@ -2551,8 +2559,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset; however, another method must be called to complete @@ -2565,15 +2573,15 @@ * * In order to propagate updates in this rowset to the underlying * data source, an application must call the method {@link #acceptChanges} - * after it calls either updateRow or insertRow. + * after it calls either {@code updateRow} or {@code insertRow}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -2581,8 +2589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2593,14 +2601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(int columnIndex, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -2608,8 +2616,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2620,14 +2628,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(int columnIndex, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -2635,8 +2643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2647,14 +2655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(int columnIndex, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -2662,8 +2670,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2674,14 +2682,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(int columnIndex, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -2689,8 +2697,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2701,14 +2709,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(int columnIndex, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -2717,8 +2725,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2729,14 +2737,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(int columnIndex, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -2744,8 +2752,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2756,14 +2764,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(int columnIndex, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -2771,8 +2779,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2783,14 +2791,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -2798,8 +2806,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2810,17 +2818,17 @@ * as inserted. Both of these methods must be called before the * cursor moves to another row. * - * The method acceptChanges must be called if the + * The method {@code acceptChanges} must be called if the * updated values are to be written back to the underlying database. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(int columnIndex, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -2828,8 +2836,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2840,14 +2848,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(int columnIndex, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -2855,8 +2863,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2867,15 +2875,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(int columnIndex, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -2883,8 +2891,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2895,15 +2903,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL TIME or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code TIME} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(int columnIndex, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -2911,8 +2919,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2923,16 +2931,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE, TIME, or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE}, {@code TIME}, or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -2940,7 +2948,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -2952,8 +2960,8 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -2965,8 +2973,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2977,17 +2985,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not binary, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException { throw new UnsupportedOperationException(); @@ -2995,8 +3003,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3007,19 +3015,19 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.Reader - * containing BINARY, VARBINARY, - * LONGVARBINARY, CHAR, VARCHAR, - * or LONGVARCHAR data + * @param x the new column value; must be a {@code java.io.Reader} + * containing {@code BINARY}, {@code VARBINARY}, + * {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR}, + * or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not a binary or * character type, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3027,11 +3035,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter indicates + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter indicates * the number of digits to the right of the decimal point and is ignored * if the new column value is not a type that will be mapped to an SQL - * DECIMAL or NUMERIC value. + * {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3042,16 +3050,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3059,8 +3067,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3071,14 +3079,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x) throws SQLException { throw new UnsupportedOperationException(); @@ -3087,8 +3095,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3098,12 +3106,12 @@ * must be called, which will insert the new row into both this rowset * and the database. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -3111,8 +3119,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3123,13 +3131,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(String columnName, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -3137,8 +3145,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3149,13 +3157,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(String columnName, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -3163,8 +3171,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3175,13 +3183,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(String columnName, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -3189,8 +3197,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3201,13 +3209,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(String columnName, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -3215,8 +3223,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3227,13 +3235,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(String columnName, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -3241,8 +3249,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3253,13 +3261,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(String columnName, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -3267,8 +3275,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3279,13 +3287,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(String columnName, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -3293,8 +3301,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3305,13 +3313,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -3319,8 +3327,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3331,13 +3339,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(String columnName, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -3345,8 +3353,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3357,13 +3365,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(String columnName, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -3371,8 +3379,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3383,15 +3391,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(String columnName, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -3399,8 +3407,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3411,15 +3419,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL TIME or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code TIME} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(String columnName, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -3427,8 +3435,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3439,7 +3447,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if the given column index is out of bounds or @@ -3448,9 +3456,9 @@ * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE, - * TIME, or TIMESTAMP, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP}, or (4) this + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -3458,7 +3466,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -3470,7 +3478,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -3483,8 +3491,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3495,17 +3503,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not binary, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3513,8 +3521,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3525,18 +3533,18 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param reader the new column value; must be a - * java.io.Reader containing BINARY, - * VARBINARY, LONGVARBINARY, CHAR, - * VARCHAR, or LONGVARCHAR data + * {@code java.io.Reader} containing {@code BINARY}, + * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR}, + * {@code VARCHAR}, or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not a binary or character type, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(String columnName, java.io.Reader reader, @@ -3546,11 +3554,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter * indicates the number of digits to the right of the decimal point * and is ignored if the new column value is not a type that will be - * mapped to an SQL DECIMAL or NUMERIC value. + * mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3561,15 +3569,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3577,8 +3585,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3589,20 +3597,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x) throws SQLException { throw new UnsupportedOperationException(); } /** - * Inserts the contents of this CachedRowSetImpl object's insert + * Inserts the contents of this {@code CachedRowSetImpl} object's insert * row into this rowset immediately following the current row. * If the current row is the * position after the last row or before the first row, the new row will @@ -3614,14 +3622,14 @@ * @throws SQLException if (1) the cursor is not on the insert row, * (2) one or more of the non-nullable columns in the insert * row has not been given a value, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void insertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Marks the current row of this CachedRowSetImpl object as + * Marks the current row of this {@code CachedRowSetImpl} object as * updated and notifies listeners registered with this rowset that the * row has changed. * @@ -3631,26 +3639,26 @@ * and the updates made before the cursor moved will be lost. * * @throws SQLException if the cursor is on the insert row or this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Deletes the current row from this CachedRowSetImpl object and + * Deletes the current row from this {@code CachedRowSetImpl} object and * notifies listeners registered with this rowset that a row has changed. * This method cannot be called when the cursor is on the insert row. * * This method marks the current row as deleted, but it does not delete * the row from the underlying data source. The method - * acceptChanges must be called to delete the row in + * {@code acceptChanges} must be called to delete the row in * the data source. * * @throws SQLException if (1) this method is called when the cursor * is on the insert row, before the first row, or after the * last row or (2) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void deleteRow() throws SQLException { throw new UnsupportedOperationException(); @@ -3659,7 +3667,7 @@ /** * Sets the current row with its original value and marks the row as * not updated, thus undoing any changes made to the row since the - * last call to the methods updateRow or deleteRow. + * last call to the methods {@code updateRow} or {@code deleteRow}. * This method should be called only when the cursor is on a row in * this rowset. * @@ -3672,11 +3680,11 @@ /** * Rolls back any updates made to the current row of this - * CachedRowSetImpl object and notifies listeners that + * {@code CachedRowSetImpl} object and notifies listeners that * a row has changed. To have an effect, this method - * must be called after an updateXXX method has been - * called and before the method updateRow has been called. - * If no updates have been made or the method updateRow + * must be called after an {@code updateXXX} method has been + * called and before the method {@code updateRow} has been called. + * If no updates have been made or the method {@code updateRow} * has already been called, this method has no effect. * * @throws SQLException if the cursor is on the insert row, before the @@ -3687,39 +3695,39 @@ } /** - * Moves the cursor for this CachedRowSetImpl object + * Moves the cursor for this {@code CachedRowSetImpl} object * to the insert row. The current row in the rowset is remembered * while the cursor is on the insert row. * * The insert row is a special row associated with an updatable * rowset. It is essentially a buffer where a new row may - * be constructed by calling the appropriate updateXXX + * be constructed by calling the appropriate {@code updateXXX} * methods to assign a value to each column in the row. A complete * row must be constructed; that is, every column that is not nullable * must be assigned a value. In order for the new row to become part - * of this rowset, the method insertRow must be called + * of this rowset, the method {@code insertRow} must be called * before the cursor is moved back to the rowset. * * Only certain methods may be invoked while the cursor is on the insert * row; many methods throw an exception if they are called while the - * cursor is there. In addition to the updateXXX - * and insertRow methods, only the getXXX methods - * may be called when the cursor is on the insert row. A getXXX - * method should be called on a column only after an updateXXX + * cursor is there. In addition to the {@code updateXXX} + * and {@code insertRow} methods, only the {@code getXXX} methods + * may be called when the cursor is on the insert row. A {@code getXXX} + * method should be called on a column only after an {@code updateXXX} * method has been called on that column; otherwise, the value returned is * undetermined. * - * @throws SQLException if this CachedRowSetImpl object is - * ResultSet.CONCUR_READ_ONLY + * @throws SQLException if this {@code CachedRowSetImpl} object is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void moveToInsertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor for this CachedRowSetImpl object to + * Moves the cursor for this {@code CachedRowSetImpl} object to * the current row. The current row is the row the cursor was on - * when the method moveToInsertRow was called. + * when the method {@code moveToInsertRow} was called. * * Calling this method has no effect unless it is called while the * cursor is on the insert row. @@ -3731,9 +3739,9 @@ } /** - * Returns null. + * Returns {@code null}. * - * @return null + * @return {@code null} * @throws SQLException if an error occurs */ public Statement getStatement() throws SQLException { @@ -3742,18 +3750,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column index is out of bounds or * the cursor is not on one of this rowset's rows or its * insert row @@ -3767,17 +3775,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL REF value + * SQL {@code REF} value * @see #getRef(String) */ public Ref getRef(int columnIndex) throws SQLException { @@ -3786,17 +3794,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BLOB value + * SQL {@code BLOB} value * @see #getBlob(String) */ public Blob getBlob(int columnIndex) throws SQLException { @@ -3805,17 +3813,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Clob object representing an SQL CLOB value + * @return a {@code Clob} object representing an SQL {@code CLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL CLOB value + * SQL {@code CLOB} value * @see #getClob(String) */ public Clob getClob(int columnIndex) throws SQLException { @@ -3824,18 +3832,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL ARRAY value + * SQL {@code ARRAY} value * @see #getArray(String) */ public Array getArray(int columnIndex) throws SQLException { @@ -3844,17 +3852,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column name is not the name of * a column in this rowset or the cursor is not on one of * this rowset's rows or its insert row @@ -3867,16 +3875,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the column value - * is not an SQL REF value + * is not an SQL {@code REF} value * @see #getRef(int) */ public Ref getRef(String colName) throws SQLException { @@ -3885,16 +3893,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BLOB value + * column does not store an SQL {@code BLOB} value * @see #getBlob(int) */ public Blob getBlob(String colName) throws SQLException { @@ -3903,17 +3911,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Clob object representing an SQL - * CLOB value + * @return a {@code Clob} object representing an SQL + * {@code CLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CLOB value + * column does not store an SQL {@code CLOB} value * @see #getClob(int) */ public Clob getClob(String colName) throws SQLException { @@ -3922,17 +3930,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming langugage. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL ARRAY value + * column does not store an SQL {@code ARRAY} value * @see #getArray(int) */ public Array getArray(String colName) throws SQLException { @@ -3941,22 +3949,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3964,21 +3972,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3986,22 +3994,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4009,21 +4017,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4031,22 +4039,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Timestamp - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4054,22 +4062,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object, using the given - * Calendar object to construct an appropriate + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object, using the given + * {@code Calendar} object to construct an appropriate * millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE, - * TIME, or TIMESTAMP value + * column does not store an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4080,13 +4088,13 @@ */ /** - * Retrieves the Connection object passed to this - * CachedRowSetImpl object. This connection may be + * Retrieves the {@code Connection} object passed to this + * {@code CachedRowSetImpl} object. This connection may be * used to populate this rowset with data or to write data back * to its underlying data source. * - * @return the Connection object passed to this rowset; - * may be null if there is no connection + * @return the {@code Connection} object passed to this rowset; + * may be {@code null} if there is no connection * @throws SQLException if an error occurs */ public Connection getConnection() throws SQLException{ @@ -4094,10 +4102,10 @@ } /** - * Sets the metadata for this CachedRowSetImpl object - * with the given RowSetMetaData object. + * Sets the metadata for this {@code CachedRowSetImpl} object + * with the given {@code RowSetMetaData} object. * - * @param md a RowSetMetaData object instance containing + * @param md a {@code RowSetMetaData} object instance containing * metadata about the columsn in the rowset * @throws SQLException if invalid meta data is supplied to the * rowset @@ -4108,17 +4116,17 @@ /** * Returns a result set containing the original value of the rowset. The - * original value is the state of the CachedRowSetImpl after the + * original value is the state of the {@code CachedRowSetImpl} after the * last population or synchronization (whichever occurred most recently) with * the data source. * * The cursor is positioned before the first row in the result set. - * Only rows contained in the result set returned by getOriginal() + * Only rows contained in the result set returned by {@code getOriginal()} * are said to have an original value. * * @return the original result set of the rowset * @throws SQLException if an error occurs produce the - * ResultSet object + * {@code ResultSet} object */ public ResultSet getOriginal() throws SQLException { throw new UnsupportedOperationException(); @@ -4127,7 +4135,7 @@ /** * Returns a result set containing the original value of the current * row only. - * The original value is the state of the CachedRowSetImpl after + * The original value is the state of the {@code CachedRowSetImpl} after * the last population or synchronization (whichever occurred most recently) * with the data source. * @@ -4153,7 +4161,7 @@ /** * Marks all rows in this rowset as being original rows. Any updates * made to the rows become the original values for the rowset. - * Calls to the method setOriginal connot be reversed. + * Calls to the method {@code setOriginal} connot be reversed. * * @throws SQLException if an error occurs */ @@ -4165,8 +4173,8 @@ * Returns an identifier for the object (table) that was used to create this * rowset. * - * @return a String object that identifies the table from - * which this CachedRowSetImpl object was derived + * @return a {@code String} object that identifies the table from + * which this {@code CachedRowSetImpl} object was derived * @throws SQLException if an error occurs */ public String getTableName() throws SQLException { @@ -4177,8 +4185,8 @@ * Sets the identifier for the table from which this rowset was derived * to the given table name. * - * @param tabName a String object that identifies the - * table from which this CachedRowSetImpl object + * @param tabName a {@code String} object that identifies the + * table from which this {@code CachedRowSetImpl} object * was derived * @throws SQLException if an error occurs */ @@ -4188,7 +4196,7 @@ /** * Returns the columns that make a key to uniquely identify a - * row in this CachedRowSetImpl object. + * row in this {@code CachedRowSetImpl} object. * * @return an array of column numbers that constitutes a primary * key for this rowset. This array should be empty @@ -4203,16 +4211,16 @@ /** - * Sets this CachedRowSetImpl object's - * keyCols field with the given array of column + * Sets this {@code CachedRowSetImpl} object's + * {@code keyCols} field with the given array of column * numbers, which forms a key for uniquely identifying a row * in this rowset. * - * @param keys an array of int indicating the + * @param keys an array of {@code int} indicating the * columns that form a primary key for this - * CachedRowSetImpl object; every + * {@code CachedRowSetImpl} object; every * element in the array must be greater than - * 0 and less than or equal to the number + * {@code 0} and less than or equal to the number * of columns in this rowset * @throws SQLException if any of the numbers in the * given array is not valid for this rowset @@ -4224,8 +4232,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4236,14 +4244,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4251,8 +4259,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4263,13 +4271,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4277,8 +4285,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4289,14 +4297,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + * + * Absolute URIs * - * rmi://1234@hostname:2099/remoteobjectname - - * Specifies the Java Virtual Machine identified by lvmid - * 1234 on host hostname accessed - * using the rmi: protocol through the rmi remote - * object named remoteobjectname as registered with - * the rmiserver on port 2099 on host - * hostname. - * - * file:/path/file - Identifies a Java Virtual Machine - * through accessing a special file based protocol to use as - * the communications mechanism. - * + * rmi://1234@hostname:2099/remoteobjectname - + * Specifies the Java Virtual Machine identified by lvmid + * 1234 on host hostname accessed + * using the rmi: protocol through the rmi remote + * object named remoteobjectname as registered with + * the rmiserver on port 2099 on host + * hostname. + * + * file:/path/file - Identifies a Java Virtual Machine + * through accessing a special file based protocol to use as + * the communications mechanism. + * * + * * - * * * @see URI * @see HostIdentifier @@ -236,16 +235,14 @@ * missing components will have result in the HostIdentifier assigning * assumed defaults that allow the VmIdentifier to be resolved according * to those defaults. - * * - * For example, a VmIdentifier that specifies only a lvmid + * For example, a VmIdentifier that specifies only a {@code lvmid} * will result in a HostIdentifier for localhost utilizing * the default local protocol, local:. A VmIdentifier that - * specifies both a vmid and a hostname will result + * specifies both a {@code vmid} and a {@code hostname} will result * in a HostIdentifier for the specified host with the default remote * protocol, rmi:, using the protocol defaults for the - * port and servername components. - * + * {@code port} and {@code servername} components. * * @return HostIdentifier - the host identifier for the host containing * the Java Virtual Machine represented by this --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/perfdata/monitor/AbstractPerfDataBuffer.java 2015-06-05 21:04:38.731466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/perfdata/monitor/AbstractPerfDataBuffer.java 2015-06-05 21:04:38.563466071 +0400 @@ -108,7 +108,8 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match * the given pattern. If no instrumentation objects have` * names matching the given pattern, then an empty List --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/perfdata/monitor/PerfDataBufferImpl.java 2015-06-05 21:04:39.235466070 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/perfdata/monitor/PerfDataBufferImpl.java 2015-06-05 21:04:39.063466071 +0400 @@ -266,7 +266,8 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match * the given pattern. If no instrumentation objects have` * names matching the given pattern, then an empty List --- old/src/jdk.naming.dns/share/classes/com/sun/jndi/dns/DnsName.java 2015-06-05 21:04:39.831466070 +0400 +++ new/src/jdk.naming.dns/share/classes/com/sun/jndi/dns/DnsName.java 2015-06-05 21:04:39.659466070 +0400 @@ -580,7 +580,7 @@ * Serializes only the domain name string, for compactness and to avoid * any implementation dependency. * - * @serialdata The domain name string. + * @serialData The domain name string. */ private void writeObject(java.io.ObjectOutputStream s) throws java.io.IOException {
containing the name of the file to + * @param name a {@code String} containing the name of the file to * retreive from the server. * @param local the OutputStream the file should be written to. * @throws IOException if the transfer fails. --- old/src/java.base/share/classes/sun/net/www/MessageHeader.java 2015-06-05 21:04:19.171466087 +0400 +++ new/src/java.base/share/classes/sun/net/www/MessageHeader.java 2015-06-05 21:04:19.007466087 +0400 @@ -411,7 +411,7 @@ } /** Convert a message-id string to canonical form (strips off - leading and trailing <>s) */ + leading and trailing {@literal <>s}) */ public static String canonicalID(String id) { if (id == null) return ""; --- old/src/java.base/share/classes/sun/net/www/http/HttpClient.java 2015-06-05 21:04:19.675466087 +0400 +++ new/src/java.base/share/classes/sun/net/www/http/HttpClient.java 2015-06-05 21:04:19.511466087 +0400 @@ -625,7 +625,7 @@ } /** Parse the first line of the HTTP request. It usually looks - something like: "HTTP/1.0 comment\r\n". */ + something like: {@literal "HTTP/1.0 comment\r\n"}. */ public boolean parseHTTP(MessageHeader responses, ProgressSource pi, HttpURLConnection httpuc) throws IOException { --- old/src/java.base/share/classes/sun/net/www/protocol/ftp/FtpURLConnection.java 2015-06-05 21:04:20.183466086 +0400 +++ new/src/java.base/share/classes/sun/net/www/protocol/ftp/FtpURLConnection.java 2015-06-05 21:04:20.023466086 +0400 @@ -68,13 +68,14 @@ * Disconnect * * You should not have to use it directly in most cases because all will be handled - * in a abstract layer. Here is an example of how to use the class : - * - * URL url = new URL("ftp://ftp.sun.com/pub/test.txt"); - * UrlConnection con = url.openConnection(); - * InputStream is = con.getInputStream(); - * ... - * is.close(); + * in a abstract layer. Here is an example of how to use the class: + * {@code + * URL url = new URL("ftp://ftp.sun.com/pub/test.txt"); + * UrlConnection con = url.openConnection(); + * InputStream is = con.getInputStream(); + * ... + * is.close(); + * } * * @see sun.net.ftp.FtpClient */ @@ -158,7 +159,7 @@ /** * Creates an FtpURLConnection from a URL. * - * @param url The URL to retrieve or store. + * @param url The {@code URL} to retrieve or store. */ public FtpURLConnection(URL url) { this(url, null); @@ -382,7 +383,7 @@ * Get the InputStream to retreive the remote file. It will issue the * "get" (or "dir") command to the ftp server. * - * @return the InputStream to the connection. + * @return the {@code InputStream} to the connection. * * @throws IOException if already opened for output * @throws FtpProtocolException if errors occur during the transfert. @@ -495,7 +496,7 @@ * Get the OutputStream to store the remote file. It will issue the * "put" command to the ftp server. * - * @return the OutputStream to the connection. + * @return the {@code OutputStream} to the connection. * * @throws IOException if already opened for input or the URL * points to a directory @@ -548,9 +549,9 @@ } /** - * Gets the Permission associated with the host & port. + * Gets the {@code Permission} associated with the host and port. * - * @return The Permission object. + * @return The {@code Permission} object. */ @Override public Permission getPermission() { @@ -568,7 +569,7 @@ * exists, overwrite its value with the new value. * * @param key the keyword by which the request is known - * (e.g., "accept"). + * (e.g., "{@code accept}"). * @param value the value associated with it. * @throws IllegalStateException if already connected * @see #getRequestProperty(java.lang.String) --- old/src/java.base/share/classes/sun/net/www/protocol/http/HttpAuthenticator.java 2015-06-05 21:04:20.691466086 +0400 +++ new/src/java.base/share/classes/sun/net/www/protocol/http/HttpAuthenticator.java 2015-06-05 21:04:20.527466086 +0400 @@ -59,6 +59,7 @@ * supplied or could be found. * * Example: + * {@code * --> GET http://www.authorization-required.com/ HTTP/1.0 * <-- HTTP/1.0 403 Unauthorized * <-- WWW-Authenticate: Basic realm="WallyWorld" @@ -67,8 +68,9 @@ * return "QWadhgWERghghWERfdfQ==" * --> GET http://www.authorization-required.com/ HTTP/1.0 * --> Authorization: Basic QWadhgWERghghWERfdfQ== - * <-- HTTP/1.0 200 OK + * <-- HTTP/1.0 200 OK} * YAY!!! + * */ public String authString (URL u, String scheme, String realm); --- old/src/java.base/share/classes/sun/net/www/protocol/http/HttpURLConnection.java 2015-06-05 21:04:21.191466085 +0400 +++ new/src/java.base/share/classes/sun/net/www/protocol/http/HttpURLConnection.java 2015-06-05 21:04:21.027466085 +0400 @@ -1954,7 +1954,7 @@ /** * Set the tunneling status. * - * @param the state + * @param tunnelState the state */ public void setTunnelState(TunnelState tunnelState) { this.tunnelState = tunnelState; --- old/src/java.base/share/classes/sun/net/www/protocol/jar/JarURLConnection.java 2015-06-05 21:04:21.723466085 +0400 +++ new/src/java.base/share/classes/sun/net/www/protocol/jar/JarURLConnection.java 2015-06-05 21:04:21.559466085 +0400 @@ -338,7 +338,7 @@ * Sets the value of the ifModifiedSince field of * this URLConnection to the specified value. * - * @param value the new value. + * @param ifmodifiedsince the new value. * @see java.net.URLConnection#ifModifiedSince */ public void setIfModifiedSince(long ifmodifiedsince) { --- old/src/java.base/share/classes/sun/reflect/annotation/AnnotationParser.java 2015-06-05 21:04:22.227466084 +0400 +++ new/src/java.base/share/classes/sun/reflect/annotation/AnnotationParser.java 2015-06-05 21:04:22.063466085 +0400 @@ -295,7 +295,7 @@ /** * Returns an annotation of the given type backed by the given - * member -> value map. + * member {@literal ->} value map. */ public static Annotation annotationForMap(final Class extends Annotation> type, final Map memberValues) --- old/src/java.base/share/classes/sun/reflect/annotation/AnnotationType.java 2015-06-05 21:04:22.735466084 +0400 +++ new/src/java.base/share/classes/sun/reflect/annotation/AnnotationType.java 2015-06-05 21:04:22.571466084 +0400 @@ -73,8 +73,8 @@ /** * Returns an AnnotationType instance for the specified annotation type. * - * @throw IllegalArgumentException if the specified class object for - * does not represent a valid annotation type + * @throws IllegalArgumentException if the specified class object + * does not represent a valid annotation type */ public static AnnotationType getInstance( Class extends Annotation> annotationClass) @@ -183,7 +183,7 @@ /** * Returns member types for this annotation type - * (member name -> type mapping). + * (member name {@literal ->} type mapping). */ public Map> memberTypes() { return memberTypes; @@ -191,7 +191,7 @@ /** * Returns members of this annotation type - * (member name -> associated Method object mapping). + * (member name {@literal ->} associated Method object mapping). */ public Map members() { return members; @@ -199,7 +199,7 @@ /** * Returns the default values for this annotation type - * (Member name -> default value mapping). + * (Member name {@literal ->} default value mapping). */ public Map memberDefaults() { return memberDefaults; --- old/src/java.base/share/classes/sun/reflect/annotation/TypeAnnotationParser.java 2015-06-05 21:04:23.239466084 +0400 +++ new/src/java.base/share/classes/sun/reflect/annotation/TypeAnnotationParser.java 2015-06-05 21:04:23.075466084 +0400 @@ -199,7 +199,7 @@ * Regular Annotations on TypeVariables are stored in the type * annotation byte[] in the class file. * - * @param genericsDecl the declaration declaring the type variable + * @param genericDecl the declaration declaring the type variable * @param typeVarIndex the 0-based index of this type variable in the declaration */ public static Annotation[] parseTypeVariableAnnotations(D genericDecl, --- old/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/ParameterizedTypeImpl.java 2015-06-05 21:04:23.743466083 +0400 +++ new/src/java.base/share/classes/sun/reflect/generics/reflectiveObjects/ParameterizedTypeImpl.java 2015-06-05 21:04:23.579466083 +0400 @@ -73,17 +73,17 @@ * This method throws a MalformedParameterizedTypeException * under the following circumstances: * If the number of actual type arguments (i.e., the size of the - * array typeArgs) does not correspond to the number of + * array {@code typeArgs}) does not correspond to the number of * formal type arguments. * If any of the actual type arguments is not an instance of the * bounds on the corresponding formal. * @param rawType the Class representing the generic type declaration being * instantiated - * @param actualTypeArguments - a (possibly empty) array of types + * @param actualTypeArguments a (possibly empty) array of types * representing the actual type arguments to the parameterized type - * @param ownerType - the enclosing type, if known. - * @return An instance of ParameterizedType - * @throws MalformedParameterizedTypeException - if the instantiation + * @param ownerType the enclosing type, if known. + * @return An instance of {@code ParameterizedType} + * @throws MalformedParameterizedTypeException if the instantiation * is invalid */ public static ParameterizedTypeImpl make(Class> rawType, @@ -95,18 +95,18 @@ /** - * Returns an array of Type objects representing the actual type + * Returns an array of {@code Type} objects representing the actual type * arguments to this type. * * Note that in some cases, the returned array be empty. This can occur * if this type represents a non-parameterized type nested within * a parameterized type. * - * @return an array of Type objects representing the actual type + * @return an array of {@code Type} objects representing the actual type * arguments to this type - * @throws TypeNotPresentException if any of the + * @throws TypeNotPresentException if any of the * actual type arguments refers to a non-existent type declaration - * @throws MalformedParameterizedTypeException if any of the + * @throws MalformedParameterizedTypeException if any of the * actual type parameters refer to a parameterized type that cannot * be instantiated for any reason * @since 1.5 @@ -116,10 +116,10 @@ } /** - * Returns the Type object representing the class or interface + * Returns the {@code Type} object representing the class or interface * that declared this type. * - * @return the Type object representing the class or interface + * @return the {@code Type} object representing the class or interface * that declared this type */ public Class> getRawType() { @@ -128,18 +128,18 @@ /** - * Returns a Type object representing the type that this type - * is a member of. For example, if this type is O.I, - * return a representation of O. + * Returns a {@code Type} object representing the type that this type + * is a member of. For example, if this type is {@code O.I}, + * return a representation of {@code O}. * - * If this type is a top-level type, null is returned. + * If this type is a top-level type, {@code null} is returned. * - * @return a Type object representing the type that + * @return a {@code Type} object representing the type that * this type is a member of. If this type is a top-level type, - * null is returned - * @throws TypeNotPresentException if the owner type + * {@code null} is returned + * @throws TypeNotPresentException if the owner type * refers to a non-existent type declaration - * @throws MalformedParameterizedTypeException if the owner type + * @throws MalformedParameterizedTypeException if the owner type * refers to a parameterized type that cannot be instantiated * for any reason * --- old/src/java.base/share/classes/sun/reflect/generics/scope/ConstructorScope.java 2015-06-05 21:04:24.251466083 +0400 +++ new/src/java.base/share/classes/sun/reflect/generics/scope/ConstructorScope.java 2015-06-05 21:04:24.087466083 +0400 @@ -56,9 +56,9 @@ } /** - * Factory method. Takes a Constructor object and creates a + * Factory method. Takes a {@code Constructor} object and creates a * scope for it. - * @param m - A Constructor whose scope we want to obtain + * @param c - A Constructor whose scope we want to obtain * @return The type-variable scope for the constructor m */ public static ConstructorScope make(Constructor> c) { --- old/src/java.base/share/classes/sun/util/PreHashedMap.java 2015-06-05 21:04:24.751466082 +0400 +++ new/src/java.base/share/classes/sun/util/PreHashedMap.java 2015-06-05 21:04:24.587466082 +0400 @@ -121,8 +121,7 @@ * This method must construct the map's hash chains and store them into * the appropriate elements of the given hash-table row array. * - * @param rows - * The row array to be initialized + * @param ht The row array to be initialized */ protected abstract void init(Object[] ht); --- old/src/java.base/share/classes/sun/util/calendar/BaseCalendar.java 2015-06-05 21:04:25.251466082 +0400 +++ new/src/java.base/share/classes/sun/util/calendar/BaseCalendar.java 2015-06-05 21:04:25.087466082 +0400 @@ -28,7 +28,7 @@ import java.util.TimeZone; /** - * The BaseCalendar provides basic calendar calculation + * The {@code BaseCalendar} provides basic calendar calculation * functions to support the Julian, Gregorian, and Gregorian-based * calendar systems. * @@ -290,11 +290,11 @@ /** * Returns 366 if the specified date is in a leap year, or 365 * otherwise This method does not perform the normalization with - * the specified CalendarDate. The - * CalendarDate must be normalized to get a correct + * the specified {@code CalendarDate}. The + * {@code CalendarDate} must be normalized to get a correct * value. * - * @param a CalendarDate + * @param date a {@code CalendarDate} * @return a year length in days * @throws ClassCastException if the specified date is not a * {@link BaseCalendar.Date} @@ -412,7 +412,7 @@ /** * Calculates calendar fields and store them in the specified - * CalendarDate. + * {@code CalendarDate}. */ // should be 'protected' public void getCalendarDateFromFixedDate(CalendarDate date, --- old/src/java.base/share/classes/sun/util/calendar/CalendarUtils.java 2015-06-05 21:04:25.759466082 +0400 +++ new/src/java.base/share/classes/sun/util/calendar/CalendarUtils.java 2015-06-05 21:04:25.595466082 +0400 @@ -94,7 +94,7 @@ * 0 and -1%4 is -1. * * @param n the numerator - * @param d a divisor which must be > 0 + * @param d a divisor which must be {@literal > 0} * @param r an array of at least one element in which the value * mod(n, d) is returned. * @return the floor of the quotient. @@ -117,7 +117,7 @@ * 0 and -1%4 is -1. * * @param n the numerator - * @param d a divisor which must be > 0 + * @param d a divisor which must be {@literal > 0} * @param r an array of at least one element in which the value * mod(n, d) is returned. * @return the floor of the quotient. --- old/src/java.base/share/classes/sun/util/calendar/ZoneInfo.java 2015-06-05 21:04:26.263466081 +0400 +++ new/src/java.base/share/classes/sun/util/calendar/ZoneInfo.java 2015-06-05 21:04:26.099466081 +0400 @@ -364,7 +364,7 @@ * 0 for January. * @param day The day-in-month of the given date. * @param dayOfWeek The day-of-week of the given date. - * @param millis The milliseconds in day in standard local time. + * @param milliseconds The milliseconds in day in standard local time. * @return The milliseconds to add to UTC to get local time. */ public int getOffset(int era, int year, int month, int day, --- old/src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java 2015-06-05 21:04:26.771466081 +0400 +++ new/src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java 2015-06-05 21:04:26.607466081 +0400 @@ -72,7 +72,7 @@ * If the name returned cannot be localized according to locale, * (say, the provider does not have a Japanese name for Croatian), * this method returns null. - * @param languageCode the ISO 639 language code string in the form of two + * @param lang the ISO 639 language code string in the form of two * lower-case letters between 'a' (U+0061) and 'z' (U+007A) * @param locale the desired locale * @return the name of the given language code for the specified locale, or null if it's not @@ -129,7 +129,7 @@ * If the name returned cannot be localized according to locale, * (say, the provider does not have a Japanese name for Croatia), * this method returns null. - * @param countryCode the ISO 3166 country code string in the form of two + * @param ctry the ISO 3166 country code string in the form of two * upper-case letters between 'A' (U+0041) and 'Z' (U+005A) * @param locale the desired locale * @return the name of the given country code for the specified locale, or null if it's not @@ -152,7 +152,7 @@ * is appropriate for display to the user. * If the name returned cannot be localized according to locale, * this method returns null. - * @param variant the variant string + * @param vrnt the variant string * @param locale the desired locale * @return the name of the given variant string for the specified locale, or null if it's not * available. --- old/src/java.base/share/classes/sun/util/locale/provider/TimeZoneNameProviderImpl.java 2015-06-05 21:04:27.363466080 +0400 +++ new/src/java.base/share/classes/sun/util/locale/provider/TimeZoneNameProviderImpl.java 2015-06-05 21:04:27.199466080 +0400 @@ -79,7 +79,7 @@ * appropriate for daylight saving time even if the specified time zone * has not observed daylight saving time in the past. * - * @param ID a time zone ID string + * @param id a time zone ID string * @param daylight if true, return the daylight saving name. * @param style either {@link java.util.TimeZone#LONG TimeZone.LONG} or * {@link java.util.TimeZone#SHORT TimeZone.SHORT} --- old/src/java.base/share/classes/sun/util/logging/PlatformLogger.java 2015-06-05 21:04:27.951466080 +0400 +++ new/src/java.base/share/classes/sun/util/logging/PlatformLogger.java 2015-06-05 21:04:27.787466080 +0400 @@ -74,10 +74,10 @@ * java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter * * Limitation: - * /conf/logging.properties is the system-wide logging + * {@code /conf/logging.properties} is the system-wide logging * configuration defined in the specification and read in the * default case to configure any java.util.logging.Logger instances. - * Platform loggers will not detect if /conf/logging.properties + * Platform loggers will not detect if {@code /conf/logging.properties} * is modified. In other words, unless the java.util.logging API * is used at runtime or the logging system properties is set, * the platform loggers will use the default setting described above. --- old/src/java.base/share/classes/sun/util/resources/TimeZoneNamesBundle.java 2015-06-05 21:04:28.459466079 +0400 +++ new/src/java.base/share/classes/sun/util/resources/TimeZoneNamesBundle.java 2015-06-05 21:04:28.295466079 +0400 @@ -55,7 +55,7 @@ * array for the enumeration returned by getKeys. * Inserts the time zone ID (the key of the bundle entries) into * the string arrays returned by handleGetObject. - * + * * All TimeZoneNames resource bundles must extend this * class and implement the getContents method. */ --- old/src/java.base/unix/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:28.963466079 +0400 +++ new/src/java.base/unix/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:28.799466079 +0400 @@ -50,7 +50,7 @@ } /** - * @returns the platform specific path corresponding to the URL + * @return the platform specific path corresponding to the URL * so long as the URL does not contain a hostname in the authority field. */ --- old/src/java.base/unix/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:29.467466078 +0400 +++ new/src/java.base/unix/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:29.303466079 +0400 @@ -113,7 +113,8 @@ Client client; /** * Create a NTLMAuthentication: - * Username may be specified as domainusername in the application Authenticator. + * Username may be specified as {@literal domainusername} + * in the application Authenticator. * If this notation is not used, then the domain will be taken * from a system property: "http.auth.ntlm.domain". */ --- old/src/java.base/windows/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:29.967466078 +0400 +++ new/src/java.base/windows/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:29.803466078 +0400 @@ -46,7 +46,7 @@ } /** - * @returns the platform specific path corresponding to the URL, and in particular + * @return the platform specific path corresponding to the URL, and in particular * returns a UNC when the authority contains a hostname */ --- old/src/java.base/windows/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:30.467466078 +0400 +++ new/src/java.base/windows/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:30.303466078 +0400 @@ -83,7 +83,8 @@ /** * Create a NTLMAuthentication: - * Username may be specified as domainusername in the application Authenticator. + * Username may be specified as {@literal domainusername} + * in the application Authenticator. * If this notation is not used, then the domain will be taken * from a system property: "http.auth.ntlm.domain". */ --- old/src/java.datatransfer/share/classes/sun/datatransfer/DataFlavorUtil.java 2015-06-05 21:04:30.971466077 +0400 +++ new/src/java.datatransfer/share/classes/sun/datatransfer/DataFlavorUtil.java 2015-06-05 21:04:30.807466077 +0400 @@ -55,7 +55,7 @@ /** * Utility class with different datatransfer helper functions * - * @see 1.9 + * @since 1.9 */ public class DataFlavorUtil { --- old/src/java.desktop/macosx/classes/com/apple/eio/FileManager.java 2015-06-05 21:04:31.483466077 +0400 +++ new/src/java.desktop/macosx/classes/com/apple/eio/FileManager.java 2015-06-05 21:04:31.319466077 +0400 @@ -97,7 +97,8 @@ /** - * Converts an OSType (e.g. "macs" from ) into an int. + * Converts an OSType (e.g. "macs" + * from {@literal }) into an int. * * @param type the 4 character type to convert. * @return an int representing the 4 character value @@ -355,7 +356,7 @@ /** * Moves the specified file to the Trash * - * @param file + * @param file the file * @return returns true if the NSFileManager successfully moved the file to the Trash. * @throws FileNotFoundException * --- old/src/java.desktop/share/classes/sun/applet/AppletPanel.java 2015-06-05 21:04:31.991466076 +0400 +++ new/src/java.desktop/share/classes/sun/applet/AppletPanel.java 2015-06-05 21:04:31.823466077 +0400 @@ -344,12 +344,14 @@ * Execute applet events. * Here is the state transition diagram * + * {@literal * Note: (XXX) is the action * APPLET_XXX is the state - * (applet code loaded) --> APPLET_LOAD -- (applet init called)--> APPLET_INIT -- ( - * applet start called) --> APPLET_START -- (applet stop called) -->APPLET_STOP --(applet - * destroyed called) --> APPLET_DESTROY -->(applet gets disposed) --> - * APPLET_DISPOSE -->.... + * (applet code loaded) --> APPLET_LOAD -- (applet init called)--> APPLET_INIT -- + * (applet start called) --> APPLET_START -- (applet stop called) --> APPLET_STOP -- + * (applet destroyed called) --> APPLET_DESTROY --> (applet gets disposed) --> + * APPLET_DISPOSE --> ... + * } * * In the legacy lifecycle model. The applet gets loaded, inited and started. So it stays * in the APPLET_START state unless the applet goes away(refresh page or leave the page). @@ -364,10 +366,9 @@ * APPLET_STOP to APPLET_DESTROY and to APPLET_INIT . * * Also, the applet can jump from APPLET_INIT state to APPLET_DESTROY (in Netscape/Mozilla case). - * Same as APPLET_LOAD to + * Same as APPLET_LOAD to * APPLET_DISPOSE since all of this are triggered by browser. * - * */ @Override public void run() { --- old/src/java.desktop/share/classes/sun/applet/AppletViewer.java 2015-06-05 21:04:32.503466076 +0400 +++ new/src/java.desktop/share/classes/sun/applet/AppletViewer.java 2015-06-05 21:04:32.335466076 +0400 @@ -1093,7 +1093,7 @@ } /** - * Scan an html file for tags + * Scan an html file for {@code } tags */ public static void parse(URL url, String enc) throws IOException { encoding = enc; --- old/src/java.naming/share/classes/com/sun/jndi/ldap/LdapName.java 2015-06-05 21:04:33.107466075 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/LdapName.java 2015-06-05 21:04:32.939466076 +0400 @@ -358,7 +358,7 @@ * Serializes only the unparsed DN, for compactness and to avoid * any implementation dependency. * - * @serialdata The DN string and a boolean indicating whether + * @serialData The DN string and a boolean indicating whether * the values are case sensitive. */ private void writeObject(java.io.ObjectOutputStream s) --- old/src/java.sql.rowset/share/classes/com/sun/rowset/JdbcRowSetImpl.java 2015-06-05 21:04:33.715466075 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/JdbcRowSetImpl.java 2015-06-05 21:04:33.547466075 +0400 @@ -35,7 +35,7 @@ import javax.sql.rowset.*; /** - * The standard implementation of the JdbcRowSet interface. See the interface + * The standard implementation of the {@code JdbcRowSet} interface. See the interface * definition for full behavior and implementation requirements. * * @author Jonathan Bruce, Amit Handa @@ -44,40 +44,40 @@ public class JdbcRowSetImpl extends BaseRowSet implements JdbcRowSet, Joinable { /** - * The Connection object that is this rowset's + * The {@code Connection} object that is this rowset's * current connection to the database. This field is set * internally when the connection is established. */ private Connection conn; /** - * The PreparedStatement object that is this rowset's + * The {@code PreparedStatement} object that is this rowset's * current command. This field is set internally when the method - * execute creates the PreparedStatement + * {@code execute} creates the {@code PreparedStatement} * object. */ private PreparedStatement ps; /** - * The ResultSet object that is this rowset's + * The {@code ResultSet} object that is this rowset's * current result set. This field is set internally when the method - * execute executes the rowset's command and thereby - * creates the rowset's ResultSet object. + * {@code execute} executes the rowset's command and thereby + * creates the rowset's {@code ResultSet} object. */ private ResultSet rs; /** - * The RowSetMetaDataImpl object that is constructed when - * a ResultSet object is passed to the JdbcRowSet + * The {@code RowSetMetaDataImpl} object that is constructed when + * a {@code ResultSet} object is passed to the {@code JdbcRowSet} * constructor. This helps in constructing all metadata associated - * with the ResultSet object using the setter methods of - * RowSetMetaDataImpl. + * with the {@code ResultSet} object using the setter methods of + * {@code RowSetMetaDataImpl}. */ private RowSetMetaDataImpl rowsMD; /** - * The ResultSetMetaData object from which this - * RowSetMetaDataImpl is formed and which helps in getting + * The {@code ResultSetMetaData} object from which this + * {@code RowSetMetaDataImpl} is formed and which helps in getting * the metadata information. */ private ResultSetMetaData resMD; @@ -97,13 +97,13 @@ protected transient JdbcRowSetResourceBundle resBundle; /** - * Constructs a default JdbcRowSet object. - * The new instance of JdbcRowSet will serve as a proxy - * for the ResultSet object it creates, and by so doing, + * Constructs a default {@code JdbcRowSet} object. + * The new instance of {@code JdbcRowSet} will serve as a proxy + * for the {@code ResultSet} object it creates, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -114,17 +114,17 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * - * A newly created JdbcRowSet object must have its - * execute method invoked before other public methods + * A newly created {@code JdbcRowSet} object must have its + * {@code execute} method invoked before other public methods * are called on it; otherwise, such method calls will cause an * exception to be thrown. * * @throws SQLException [1] if any of its public methods are called prior - * to calling the execute method; [2] if invalid JDBC driver + * to calling the {@code execute} method; [2] if invalid JDBC driver * properties are set or [3] if no connection to a data source exists. */ public JdbcRowSetImpl() { @@ -217,14 +217,14 @@ } /** - * Constructs a default JdbcRowSet object given a - * valid Connection object. The new - * instance of JdbcRowSet will serve as a proxy for - * the ResultSet object it creates, and by so doing, + * Constructs a default {@code JdbcRowSet} object given a + * valid {@code Connection} object. The new + * instance of {@code JdbcRowSet} will serve as a proxy for + * the {@code ResultSet} object it creates, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -235,17 +235,17 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * - * A newly created JdbcRowSet object must have its - * execute method invoked before other public methods + * A newly created {@code JdbcRowSet} object must have its + * {@code execute} method invoked before other public methods * are called on it; otherwise, such method calls will cause an * exception to be thrown. * * @throws SQLException [1] if any of its public methods are called prior - * to calling the execute method, [2] if invalid JDBC driver + * to calling the {@code execute} method, [2] if invalid JDBC driver * properties are set, or [3] if no connection to a data source exists. */ public JdbcRowSetImpl(Connection con) throws SQLException { @@ -289,15 +289,15 @@ } /** - * Constructs a default JdbcRowSet object using the + * Constructs a default {@code JdbcRowSet} object using the * URL, username, and password arguments supplied. The new - * instance of JdbcRowSet will serve as a proxy for - * the ResultSet object it creates, and by so doing, + * instance of {@code JdbcRowSet} will serve as a proxy for + * the {@code ResultSet} object it creates, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -308,17 +308,17 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * * - * @param url - a JDBC URL for the database to which this JdbcRowSet + * @param url a JDBC URL for the database to which this {@code JdbcRowSet} * object will be connected. The form for a JDBC URL is - * jdbc:subprotocol:subname. - * @param user - the database user on whose behalf the connection + * {@code jdbc:subprotocol:subname}. + * @param user the database user on whose behalf the connection * is being made - * @param password - the user's password + * @param password the user's password * * @throws SQLException if a database access error occurs * @@ -372,15 +372,15 @@ /** - * Constructs a JdbcRowSet object using the given valid - * ResultSet object. The new - * instance of JdbcRowSet will serve as a proxy for - * the ResultSet object, and by so doing, + * Constructs a {@code JdbcRowSet} object using the given valid + * {@code ResultSet} object. The new + * instance of {@code JdbcRowSet} will serve as a proxy for + * the {@code ResultSet} object, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -391,12 +391,12 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * * - * @param res a valid ResultSet object + * @param res a valid {@code ResultSet} object * * @throws SQLException if a database access occurs due to a non * valid ResultSet handle. @@ -460,13 +460,13 @@ } /** - * Initializes the given RowSetMetaData object with the values - * in the given ResultSetMetaData object. + * Initializes the given {@code RowSetMetaData} object with the values + * in the given {@code ResultSetMetaData} object. * - * @param md the RowSetMetaData object for this - * JdbcRowSetImpl object, which will be set with + * @param md the {@code RowSetMetaData} object for this + * {@code JdbcRowSetImpl} object, which will be set with * values from rsmd - * @param rsmd the ResultSetMetaData object from which new + * @param rsmd the {@code ResultSetMetaData} object from which new * values for md will be read * @throws SQLException if an error occurs */ @@ -511,24 +511,24 @@ //--------------------------------------------------------------------- /** - * Creates the internal ResultSet object for which this - * JdbcRowSet object is a wrapper, effectively + * Creates the internal {@code ResultSet} object for which this + * {@code JdbcRowSet} object is a wrapper, effectively * making the result set a JavaBeans component. * * Certain properties must have been set before this method is called * so that it can establish a connection to a database and execute the - * query that will create the result set. If a DataSource + * query that will create the result set. If a {@code DataSource} * object will be used to create the connection, properties for the * data source name, user name, and password must be set. If the - * DriverManager will be used, the properties for the + * {@code DriverManager} will be used, the properties for the * URL, user name, and password must be set. In either case, the * property for the command must be set. If the command has placeholder * parameters, those must also be set. This method throws * an exception if the required properties are not set. * * Other properties have default values that may optionally be set - * to new values. The execute method will use the value - * for the command property to create a PreparedStatement + * to new values. The {@code execute} method will use the value + * for the command property to create a {@code PreparedStatement} * object and set its properties (escape processing, maximum field * size, maximum number of rows, and query timeout limit) to be those * of this rowset. @@ -784,20 +784,20 @@ } /** - * Moves the cursor for this rowset's ResultSet + * Moves the cursor for this rowset's {@code ResultSet} * object down one row from its current position. - * A ResultSet cursor is initially positioned + * A {@code ResultSet} cursor is initially positioned * before the first row; the first call to the method - * next makes the first row the current row; the + * {@code next} makes the first row the current row; the * second call makes the second row the current row, and so on. * * If an input stream is open for the current row, a call - * to the method next will - * implicitly close it. A ResultSet object's + * to the method {@code next} will + * implicitly close it. A {@code ResultSet} object's * warning chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -811,16 +811,16 @@ } /** - * Releases this rowset's ResultSet object's database and + * Releases this rowset's {@code ResultSet} object's database and * JDBC resources immediately instead of waiting for * this to happen when it is automatically closed. * - * Note: A ResultSet object + * Note: A {@code ResultSet} object * is automatically closed by the - * Statement object that generated it when - * that Statement object is closed, + * {@code Statement} object that generated it when + * that {@code Statement} object is closed, * re-executed, or is used to retrieve the next result from a - * sequence of multiple results. A ResultSet object + * sequence of multiple results. A {@code ResultSet} object * is also automatically closed when it is garbage collected. * * @throws SQLException if a database access error occurs @@ -836,14 +836,14 @@ /** * Reports whether the last column read from this rowset's - * ResultSet object had a value of SQL NULL. - * Note that you must first call one of the getXXX methods + * {@code ResultSet} object had a value of SQL {@code NULL}. + * Note that you must first call one of the {@code getXXX} methods * on a column to try to read its value and then call - * the method wasNull to see if the value read was - * SQL NULL. + * the method {@code wasNull} to see if the value read was + * SQL {@code NULL}. * - * @return true if the last column value read was SQL - * NULL and false otherwise + * @return {@code true} if the last column value read was SQL + * {@code NULL} and {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not have a currently valid connection, * prepared statement, and result set @@ -860,12 +860,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a String. + * of this rowset's {@code ResultSet} object as + * a {@code String}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -878,12 +878,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a boolean. + * of this rowset's {@code ResultSet} object as + * a {@code boolean}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is false + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code false} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -896,12 +896,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte. + * of this rowset's {@code ResultSet} object as + * a {@code byte}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -914,12 +914,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a short. + * of this rowset's {@code ResultSet} object as + * a {@code short}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -932,12 +932,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an int. + * of this rowset's {@code ResultSet} object as + * an {@code int}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -950,12 +950,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a long. + * of this rowset's {@code ResultSet} object as + * a {@code long}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -968,12 +968,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a float. + * of this rowset's {@code ResultSet} object as + * a {@code float}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -986,12 +986,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a double. + * of this rowset's {@code ResultSet} object as + * a {@code double}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1004,13 +1004,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.BigDecimal. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.BigDecimal}. * * @param columnIndex the first column is 1, the second is 2, and so on * @param scale the number of digits to the right of the decimal point - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1025,13 +1025,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte array in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code byte} array in the Java programming language. * The bytes represent the raw values returned by the driver. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1044,12 +1044,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Date object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Date} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1062,12 +1062,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Time object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Time} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1080,12 +1080,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Timestamp object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Timestamp} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1098,25 +1098,25 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as + * of this rowset's {@code ResultSet} object as * a stream of ASCII characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream of one-byte ASCII characters; - * if the value is SQL NULL, the - * value returned is null + * as a stream of one-byte ASCII characters; + * if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) database access error occurs * (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1129,31 +1129,31 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as + * of this rowset's {@code ResultSet} object as * as a stream of Unicode characters. * The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving largeLONGVARCHARvalues. The JDBC driver will + * suitable for retrieving large{@code LONGVARCHAR}values. The JDBC driver will * do any necessary conversion from the database format into Unicode. * The byte format of the Unicode stream must be Java UTF-8, * as specified in the Java virtual machine specification. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream in Java UTF-8 byte format; - * if the value is SQL NULL, the value returned is null + * as a stream in Java UTF-8 byte format; + * if the value is SQL {@code NULL}, the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set - * @deprecated use getCharacterStream in place of - * getUnicodeStream + * @deprecated use {@code getCharacterStream} in place of + * {@code getUnicodeStream} */ @Deprecated public java.io.InputStream getUnicodeStream(int columnIndex) throws SQLException { @@ -1165,22 +1165,22 @@ /** * Gets the value of a column in the current row as a stream of * the value of the designated column in the current row - * of this rowset's ResultSet object as a binary stream of + * of this rowset's {@code ResultSet} object as a binary stream of * uninterpreted bytes. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes; - * if the value is SQL NULL, the value returned is null + * as a stream of uninterpreted bytes; + * if the value is SQL {@code NULL}, the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1198,12 +1198,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a String. + * of this rowset's {@code ResultSet} object as + * a {@code String}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1214,12 +1214,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a boolean. + * of this rowset's {@code ResultSet} object as + * a {@code boolean}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is false + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code false} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1230,12 +1230,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte. + * of this rowset's {@code ResultSet} object as + * a {@code byte}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1246,12 +1246,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a short. + * of this rowset's {@code ResultSet} object as + * a {@code short}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1262,12 +1262,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an int. + * of this rowset's {@code ResultSet} object as + * an {@code int}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1278,12 +1278,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a long. + * of this rowset's {@code ResultSet} object as + * a {@code long}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if a database access error occurs * or this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1294,12 +1294,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a float. + * of this rowset's {@code ResultSet} object as + * a {@code float}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1310,12 +1310,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a double. + * of this rowset's {@code ResultSet} object as + * a {@code double}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1326,13 +1326,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.math.BigDecimal. + * of this rowset's {@code ResultSet} object as + * a {@code java.math.BigDecimal}. * * @param columnName the SQL name of the column * @param scale the number of digits to the right of the decimal point - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) adatabase access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1345,13 +1345,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte array in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code byte} array in the Java programming language. * The bytes represent the raw values returned by the driver. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1362,12 +1362,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Date object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Date} object in the Java programming language. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1378,13 +1378,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Time object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Time} object in the Java programming language. * * @param columnName the SQL name of the column * @return the column value; - * if the value is SQL NULL, - * the value returned is null + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1395,12 +1395,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Timestamp} object. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1411,24 +1411,24 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of + * of this rowset's {@code ResultSet} object as a stream of * ASCII characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of one-byte ASCII characters. - * If the value is SQL NULL, - * the value returned is null. + * as a stream of one-byte ASCII characters. + * If the value is SQL {@code NULL}, + * the value returned is {@code null}. * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1439,10 +1439,10 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of + * of this rowset's {@code ResultSet} object as a stream of * Unicode characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into Unicode. * The byte format of the Unicode stream must be Java UTF-8, @@ -1450,15 +1450,15 @@ * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of two-byte Unicode characters. - * If the value is SQL NULL, - * the value returned is null. + * as a stream of two-byte Unicode characters. + * If the value is SQL {@code NULL}, + * the value returned is {@code null}. * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1471,23 +1471,23 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of uninterpreted - * bytes. + * of this rowset's {@code ResultSet} object as a stream of uninterpreted + * {@code byte}s. * The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARBINARY + * suitable for retrieving large {@code LONGVARBINARY} * values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes; - * if the value is SQL NULL, the result is null + * as a stream of uninterpreted bytes; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1503,21 +1503,21 @@ /** * Returns the first warning reported by calls on this rowset's - * ResultSet object. - * Subsequent warnings on this rowset's ResultSet object - * will be chained to the SQLWarning object that + * {@code ResultSet} object. + * Subsequent warnings on this rowset's {@code ResultSet} object + * will be chained to the {@code SQLWarning} object that * this method returns. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by - * Statement methods + * by {@code ResultSet} methods. Any warning caused by + * {@code Statement} methods * (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * - * @return the first SQLWarning object reported or null + * @return the first {@code SQLWarning} object reported or {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1529,10 +1529,10 @@ } /** - * Clears all warnings reported on this rowset's ResultSet object. - * After this method is called, the method getWarnings - * returns null until a new warning is - * reported for this rowset's ResultSet object. + * Clears all warnings reported on this rowset's {@code ResultSet} object. + * After this method is called, the method {@code getWarnings} + * returns {@code null} until a new warning is + * reported for this rowset's {@code ResultSet} object. * * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, @@ -1545,26 +1545,26 @@ } /** - * Gets the name of the SQL cursor used by this rowset's ResultSet + * Gets the name of the SQL cursor used by this rowset's {@code ResultSet} * object. * * In SQL, a result table is retrieved through a cursor that is * named. The current row of a result set can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To insure that the cursor has the proper isolation - * level to support update, the cursor's select statement should be + * level to support update, the cursor's {@code select} statement should be * of the form 'select for update'. If the 'for update' clause is * omitted, the positioned updates may fail. * * The JDBC API supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. - * The current row of a ResultSet object + * SQL cursor used by a {@code ResultSet} object. + * The current row of a {@code ResultSet} object * is also the current row of this SQL cursor. * * Note: If positioned update is not supported, a - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL name for this rowset's ResultSet object's cursor + * @return the SQL name for this rowset's {@code ResultSet} object's cursor * @throws SQLException if (1) a database access error occurs * or (2) xthis rowset does not have a currently valid connection, * prepared statement, and result set @@ -1577,9 +1577,9 @@ /** * Retrieves the number, types and properties of - * this rowset's ResultSet object's columns. + * this rowset's {@code ResultSet} object's columns. * - * @return the description of this rowset's ResultSet + * @return the description of this rowset's {@code ResultSet} * object's columns * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, @@ -1607,8 +1607,8 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an Object. + * of this rowset's {@code ResultSet} object as + * an {@code Object}. * * This method will return the value of the given column as a * Java object. The type of the Java object will be the default @@ -1620,14 +1620,14 @@ * abstract data types. * * In the JDBC 3.0 API, the behavior of method - * getObject is extended to materialize + * {@code getObject} is extended to materialize * data of SQL user-defined types. When a column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to: getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to: {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return a java.lang.Object holding the column value + * @return a {@code java.lang.Object} holding the column value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1640,8 +1640,8 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an Object. + * of this rowset's {@code ResultSet} object as + * an {@code Object}. * * This method will return the value of the given column as a * Java object. The type of the Java object will be the default @@ -1653,14 +1653,14 @@ * abstract data types. * * In the JDBC 3.0 API, the behavior of the method - * getObject is extended to materialize + * {@code getObject} is extended to materialize * data of SQL user-defined types. When a column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to: getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to: {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * * @param columnName the SQL name of the column - * @return a java.lang.Object holding the column value + * @return a {@code java.lang.Object} holding the column value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1672,9 +1672,9 @@ //---------------------------------------------------------------- /** - * Maps the given JdbcRowSetImpl column name to its - * JdbcRowSetImpl column index and reflects this on - * the internal ResultSet object. + * Maps the given {@code JdbcRowSetImpl} column name to its + * {@code JdbcRowSetImpl} column index and reflects this on + * the internal {@code ResultSet} object. * * @param columnName the name of the column * @return the column index of the given column name @@ -1697,11 +1697,11 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.io.Reader object. - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null. + * of this rowset's {@code ResultSet} object as a + * {@code java.io.Reader} object. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @param columnIndex the first column is 1, the second is 2, and so on * */ @@ -1713,14 +1713,14 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.io.Reader object. + * of this rowset's {@code ResultSet} object as a + * {@code java.io.Reader} object. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @param columnName the name of the column - * @return the value in the specified column as a java.io.Reader + * @return the value in the specified column as a {@code java.io.Reader} * */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { @@ -1729,13 +1729,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.math.BigDecimal with full precision. + * of this rowset's {@code ResultSet} object as a + * {@code java.math.BigDecimal} with full precision. * * @param columnIndex the first column is 1, the second is 2, and so on * @return the column value (full precision); - * if the value is SQL NULL, the value returned is - * null. + * if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1748,13 +1748,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.math.BigDecimal with full precision. + * of this rowset's {@code ResultSet} object as a + * {@code java.math.BigDecimal} with full precision. * * @param columnName the column name * @return the column value (full precision); - * if the value is SQL NULL, the value returned is - * null. + * if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1769,11 +1769,11 @@ /** * Indicates whether the cursor is before the first row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is before the first row; - * false if the cursor is at any other position or the - * result set contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} if the cursor is at any other position or the + * result set contains no rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1786,11 +1786,11 @@ /** * Indicates whether the cursor is after the last row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is after the last row; - * false if the cursor is at any other position or the - * result set contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} if the cursor is at any other position or the + * result set contains no rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1803,10 +1803,10 @@ /** * Indicates whether the cursor is on the first row of - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on the first row; - * false otherwise + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1819,14 +1819,14 @@ /** * Indicates whether the cursor is on the last row of - * this rowset's ResultSet object. - * Note: Calling the method isLast may be expensive + * this rowset's {@code ResultSet} object. + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver * might need to fetch ahead one row in order to determine * whether the current row is the last row in the result set. * - * @return true if the cursor is on the last row; - * false otherwise + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1840,11 +1840,11 @@ /** * Moves the cursor to the front of - * this rowset's ResultSet object, just before the + * this rowset's {@code ResultSet} object, just before the * first row. This method has no effect if the result set contains no rows. * * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1857,10 +1857,10 @@ /** * Moves the cursor to the end of - * this rowset's ResultSet object, just after the + * this rowset's {@code ResultSet} object, just after the * last row. This method has no effect if the result set contains no rows. * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1873,12 +1873,12 @@ /** * Moves the cursor to the first row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on a valid row; - * false if there are no rows in the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if there are no rows in the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1893,12 +1893,12 @@ /** * Moves the cursor to the last row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on a valid row; - * false if there are no rows in the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if there are no rows in the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1914,7 +1914,7 @@ * Retrieves the current row number. The first row is number 1, the * second is number 2, and so on. * - * @return the current row number; 0 if there is no current row + * @return the current row number; {@code 0} if there is no current row * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1927,7 +1927,7 @@ /** * Moves the cursor to the given row number in - * this rowset's internal ResultSet object. + * this rowset's internal {@code ResultSet} object. * * If the row number is positive, the cursor moves to * the given row number with respect to the @@ -1937,23 +1937,23 @@ * If the given row number is negative, the cursor moves to * an absolute row position with respect to * the end of the result set. For example, calling the method - * absolute(-1) positions the - * cursor on the last row, calling the method absolute(-2) + * {@code absolute(-1)} positions the + * cursor on the last row, calling the method {@code absolute(-2)} * moves the cursor to the next-to-last row, and so on. * * An attempt to position the cursor beyond the first/last row in * the result set leaves the cursor before the first row or after * the last row. * - * Note: Calling absolute(1) is the same - * as calling first(). Calling absolute(-1) - * is the same as calling last(). + * Note: Calling {@code absolute(1)} is the same + * as calling {@code first()}. Calling {@code absolute(-1)} + * is the same as calling {@code last()}. * - * @return true if the cursor is on the result set; - * false otherwise + * @return {@code true} if the cursor is on the result set; + * {@code false} otherwise * @throws SQLException if (1) a database access error occurs, - * (2) the row is 0, (3) the result set - * type is TYPE_FORWARD_ONLY, or (4) this + * (2) the row is {@code 0}, (3) the result set + * type is {@code TYPE_FORWARD_ONLY}, or (4) this * rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -1969,21 +1969,21 @@ * Moves the cursor a relative number of rows, either positive or negative. * Attempting to move beyond the first/last row in the * result set positions the cursor before/after the - * the first/last row. Calling relative(0) is valid, but does + * the first/last row. Calling {@code relative(0)} is valid, but does * not change the cursor position. * - * Note: Calling the method relative(1) - * is different from calling the method next() - * because is makes sense to call next() when there + * Note: Calling the method {@code relative(1)} + * is different from calling the method {@code next()} + * because is makes sense to call {@code next()} when there * is no current row, * for example, when the cursor is positioned before the first row * or after the last row of the result set. * - * @return true if the cursor is on a row; - * false otherwise + * @return {@code true} if the cursor is on a row; + * {@code false} otherwise * @throws SQLException if (1) a database access error occurs, * (2) there is no current row, (3) the result set - * type is TYPE_FORWARD_ONLY, or (4) this + * type is {@code TYPE_FORWARD_ONLY}, or (4) this * rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -1997,16 +1997,16 @@ /** * Moves the cursor to the previous row in this - * ResultSet object. + * {@code ResultSet} object. * - * Note: Calling the method previous() is not the same as - * calling the method relative(-1) because it - * makes sense to call previous() when there is no current row. + * Note: Calling the method {@code previous()} is not the same as + * calling the method {@code relative(-1)} because it + * makes sense to call {@code previous()} when there is no current row. * - * @return true if the cursor is on a valid row; - * false if it is off the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is off the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -2020,15 +2020,15 @@ /** * Gives a hint as to the direction in which the rows in this - * ResultSet object will be processed. + * {@code ResultSet} object will be processed. * The initial value is determined by the - * Statement object - * that produced this rowset's ResultSet object. + * {@code Statement} object + * that produced this rowset's {@code ResultSet} object. * The fetch direction may be changed at any time. * * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY - * and the fetch direction is not FETCH_FORWARD, + * (2) the result set type is {@code TYPE_FORWARD_ONLY} + * and the fetch direction is not {@code FETCH_FORWARD}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set * @see java.sql.Statement#setFetchDirection @@ -2041,10 +2041,10 @@ /** * Returns the fetch direction for this - * ResultSet object. + * {@code ResultSet} object. * * @return the current fetch direction for this rowset's - * ResultSet object + * {@code ResultSet} object * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2061,16 +2061,16 @@ /** * Gives the JDBC driver a hint as to the number of rows that should * be fetched from the database when more rows are needed for this - * ResultSet object. + * {@code ResultSet} object. * If the fetch size specified is zero, the JDBC driver * ignores the value and is free to make its own best guess as to what * the fetch size should be. The default value is set by the - * Statement object + * {@code Statement} object * that created the result set. The fetch size may be changed at any time. * * @param rows the number of rows to fetch * @throws SQLException if (1) a database access error occurs, (2) the - * condition 0 <= rows <= this.getMaxRows() is not + * condition {@code 0 <= rows <= this.getMaxRows()} is not * satisfied, or (3) this rowset does not currently have a valid * connection, prepared statement, and result set * @@ -2084,9 +2084,9 @@ /** * * Returns the fetch size for this - * ResultSet object. + * {@code ResultSet} object. * - * @return the current fetch size for this rowset's ResultSet object + * @return the current fetch size for this rowset's {@code ResultSet} object * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2111,12 +2111,12 @@ } /** - * Returns the concurrency mode of this rowset's ResultSet object. + * Returns the concurrency mode of this rowset's {@code ResultSet} object. * The concurrency used is determined by the - * Statement object that created the result set. + * {@code Statement} object that created the result set. * - * @return the concurrency type, either CONCUR_READ_ONLY - * or CONCUR_UPDATABLE + * @return the concurrency type, either {@code CONCUR_READ_ONLY} + * or {@code CONCUR_UPDATABLE} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2138,7 +2138,7 @@ * Indicates whether the current row has been updated. The value returned * depends on whether or not the result set can detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another, and updates are detected * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, @@ -2154,10 +2154,10 @@ /** * Indicates whether the current row has had an insertion. * The value returned depends on whether or not this - * ResultSet object can detect visible inserts. + * {@code ResultSet} object can detect visible inserts. * - * @return true if a row has had an insertion - * and insertions are detected; false otherwise + * @return {@code true} if a row has had an insertion + * and insertions are detected; {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2174,10 +2174,10 @@ * Indicates whether a row has been deleted. A deleted row may leave * a visible "hole" in a result set. This method can be used to * detect holes in a result set. The value returned depends on whether - * or not this rowset's ResultSet object can detect deletions. + * or not this rowset's {@code ResultSet} object can detect deletions. * - * @return true if a row was deleted and deletions are detected; - * false otherwise + * @return {@code true} if a row was deleted and deletions are detected; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2192,10 +2192,10 @@ /** * Gives a nullable column a null value. * - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow - * or insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} + * or {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @throws SQLException if a database access error occurs @@ -2213,11 +2213,11 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2237,11 +2237,11 @@ } /** - * Updates the designated column with a byte value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * * @param columnIndex the first column is 1, the second is 2, and so on @@ -2262,11 +2262,11 @@ } /** - * Updates the designated column with a short value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code short} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2286,11 +2286,11 @@ } /** - * Updates the designated column with an int value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code int} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2309,11 +2309,11 @@ } /** - * Updates the designated column with a long value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code long} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2333,11 +2333,11 @@ } /** - * Updates the designated column with a float value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code float} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2357,11 +2357,11 @@ } /** - * Updates the designated column with a double value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code double} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2381,12 +2381,12 @@ } /** - * Updates the designated column with a java.math.BigDecimal + * Updates the designated column with a {@code java.math.BigDecimal} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2406,11 +2406,11 @@ } /** - * Updates the designated column with a String value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code String} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2430,11 +2430,11 @@ } /** - * Updates the designated column with a byte array value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} array value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2454,11 +2454,11 @@ } /** - * Updates the designated column with a java.sql.Date value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Date} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2479,11 +2479,11 @@ /** - * Updates the designated column with a java.sql.Time value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Time} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2503,12 +2503,12 @@ } /** - * Updates the designated column with a java.sql.Timestamp + * Updates the designated column with a {@code java.sql.Timestamp} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2529,10 +2529,10 @@ /** * Updates the designated column with an ascii stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2554,10 +2554,10 @@ /** * Updates the designated column with a binary stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2579,10 +2579,10 @@ /** * Updates the designated column with a character stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2603,18 +2603,18 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value - * @param scale for java.sql.Types.DECIMAl - * or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types this value will be ignored. + * @param scale for {@code java.sql.Types.DECIMAl} + * or {@code java.sql.Types.NUMERIC} types, + * this is the number of digits after the decimal point. For all other + * types this value will be ignored. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2631,11 +2631,11 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2655,11 +2655,11 @@ } /** - * Updates the designated column with a null value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code null} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @throws SQLException if a database access error occurs @@ -2672,11 +2672,11 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2688,11 +2688,11 @@ } /** - * Updates the designated column with a byte value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2704,11 +2704,11 @@ } /** - * Updates the designated column with a short value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code short} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2720,11 +2720,11 @@ } /** - * Updates the designated column with an int value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code int} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2736,11 +2736,11 @@ } /** - * Updates the designated column with a long value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code long} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2752,11 +2752,11 @@ } /** - * Updates the designated column with a float value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code float } value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2768,11 +2768,11 @@ } /** - * Updates the designated column with a double value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code double} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2784,12 +2784,12 @@ } /** - * Updates the designated column with a java.sql.BigDecimal + * Updates the designated column with a {@code java.sql.BigDecimal} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2801,11 +2801,11 @@ } /** - * Updates the designated column with a String value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code String} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2817,19 +2817,19 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * JDBC 2.0 * * Updates a column with a byte array value. * - * The updateXXX methods are used to update column values in the - * current row, or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or insertRow + * The {@code updateXXX} methods are used to update column values in the + * current row, or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or {@code insertRow} * methods are called to update the database. * * @param columnName the name of the column @@ -2842,11 +2842,11 @@ } /** - * Updates the designated column with a java.sql.Date value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Date} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2858,11 +2858,11 @@ } /** - * Updates the designated column with a java.sql.Time value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Time} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2874,12 +2874,12 @@ } /** - * Updates the designated column with a java.sql.Timestamp + * Updates the designated column with a {@code java.sql.Timestamp} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2892,10 +2892,10 @@ /** * Updates the designated column with an ascii stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2909,10 +2909,10 @@ /** * Updates the designated column with a binary stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2926,14 +2926,14 @@ /** * Updates the designated column with a character stream value. - * The updateXXX methods are used to update column values - * in the current row or the insert row. The updateXXX + * The {@code updateXXX} methods are used to update column values + * in the current row or the insert row. The {@code updateXXX} * methods do not update the underlying database; instead the - * updateRow or insertRow methods are called + * {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column - * @param reader the new column Reader stream value + * @param reader the new column {@code Reader} stream value * @param length the length of the stream * @throws SQLException if a database access error occurs * @@ -2943,16 +2943,16 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value - * @param scale for java.sql.Types.DECIMAL - * or java.sql.Types.NUMERIC types, + * @param scale for {@code java.sql.Types.DECIMAL} + * or {@code java.sql.Types.NUMERIC} types, * this is the number of digits after the decimal point. For all other * types this value will be ignored. * @throws SQLException if a database access error occurs @@ -2963,11 +2963,11 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2980,7 +2980,7 @@ /** * Inserts the contents of the insert row into this - * ResultSet object and into the database + * {@code ResultSet} object and into the database * and also notifies listeners that a row has changed. * The cursor must be on the insert row when this method is called. * @@ -3000,14 +3000,14 @@ /** * Updates the underlying database with the new contents of the - * current row of this rowset's ResultSet object + * current row of this rowset's {@code ResultSet} object * and notifies listeners that a row has changed. * This method cannot be called when the cursor is on the insert row. * * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is * on the insert row, (3) the concurrency of the result - * set is ResultSet.CONCUR_READ_ONLY, or + * set is {@code ResultSet.CONCUR_READ_ONLY}, or * (4) this rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -3019,18 +3019,18 @@ } /** - * Deletes the current row from this rowset's ResultSet object + * Deletes the current row from this rowset's {@code ResultSet} object * and from the underlying database and also notifies listeners that a row * has changed. This method cannot be called when the cursor is on the insert * row. * * @throws SQLException if a database access error occurs - * or if this method is called when the cursor is on the insert row + * or if this method is called when the cursor is on the insert row * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is before the * first row, after the last row, or on the insert row, * (3) the concurrency of this rowset's result - * set is ResultSet.CONCUR_READ_ONLY, or + * set is {@code ResultSet.CONCUR_READ_ONLY}, or * (4) this rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -3042,24 +3042,24 @@ } /** - * Refreshes the current row of this rowset's ResultSet + * Refreshes the current row of this rowset's {@code ResultSet} * object with its most recent value in the database. This method * cannot be called when the cursor is on the insert row. * - * The refreshRow method provides a way for an + * The {@code refreshRow} method provides a way for an * application to explicitly tell the JDBC driver to refetch * a row(s) from the database. An application may want to call - * refreshRow when caching or prefetching is being + * {@code refreshRow} when caching or prefetching is being * done by the JDBC driver to fetch the latest value of a row * from the database. The JDBC driver may actually refresh multiple * rows at once if the fetch size is greater than one. * * All values are refetched subject to the transaction isolation - * level and cursor sensitivity. If refreshRow is called after - * calling an updateXXX method, but before calling - * the method updateRow, then the + * level and cursor sensitivity. If {@code refreshRow} is called after + * calling an {@code updateXXX} method, but before calling + * the method {@code updateRow}, then the * updates made to the row are lost. Calling the method - * refreshRow frequently will likely slow performance. + * {@code refreshRow} frequently will likely slow performance. * * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is @@ -3076,12 +3076,12 @@ /** * Cancels the updates made to the current row in this - * ResultSet object and notifies listeners that a row + * {@code ResultSet} object and notifies listeners that a row * has changed. This method may be called after calling an - * updateXXX method(s) and before calling - * the method updateRow to roll back + * {@code updateXXX} method(s) and before calling + * the method {@code updateRow} to roll back * the updates made to a row. If no updates have been made or - * updateRow has already been called, this method has no + * {@code updateRow} has already been called, this method has no * effect. * * @throws SQLException if (1) a database access error occurs, @@ -3104,19 +3104,19 @@ * * The insert row is a special row associated with an updatable * result set. It is essentially a buffer where a new row may - * be constructed by calling the updateXXX methods prior to + * be constructed by calling the {@code updateXXX} methods prior to * inserting the row into the result set. * - * Only the updateXXX, getXXX, - * and insertRow methods may be + * Only the {@code updateXXX}, {@code getXXX}, + * and {@code insertRow} methods may be * called when the cursor is on the insert row. All of the columns in * a result set must be given a value each time this method is - * called before calling insertRow. - * An updateXXX method must be called before a - * getXXX method can be called on a column value. + * called before calling {@code insertRow}. + * An {@code updateXXX} method must be called before a + * {@code getXXX} method can be called on a column value. * * @throws SQLException if (1) a database access error occurs, - * (2) this rowset's ResultSet object is + * (2) this rowset's {@code ResultSet} object is * not updatable, or (3) this rowset does not * currently have a valid connection, prepared statement, * and result set @@ -3134,7 +3134,7 @@ * the insert row. * * @throws SQLException if (1) a database access error occurs, - * (2) this rowset's ResultSet object is + * (2) this rowset's {@code ResultSet} object is * not updatable, or (3) this rowset does not * currently have a valid connection, prepared statement, * and result set @@ -3146,14 +3146,14 @@ } /** - * Returns the Statement object that produced this - * ResultSet object. + * Returns the {@code Statement} object that produced this + * {@code ResultSet} object. * If the result set was generated some other way, such as by a - * DatabaseMetaData method, this method returns - * null. + * {@code DatabaseMetaData} method, this method returns + * {@code null}. * - * @return the Statement object that produced - * this rowset's ResultSet object or null + * @return the {@code Statement} object that produced + * this rowset's {@code ResultSet} object or {@code null} * if the result set was produced some other way * @throws SQLException if a database access error occurs */ @@ -3169,16 +3169,16 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Object. - * This method uses the given Map object + * of this rowset's {@code ResultSet} object as an {@code Object}. + * This method uses the given {@code Map} object * for the custom mapping of the * SQL structured or distinct type that is being retrieved. * * @param i the first column is 1, the second is 2, and so on - * @param map a java.util.Map object that contains the mapping - * from SQL type names to classes in the Java programming language - * @return an Object in the Java programming language - * representing the SQL value + * @param map a {@code java.util.Map} object that contains the mapping + * from SQL type names to classes in the Java programming language + * @return an {@code Object} in the Java programming language + * representing the SQL value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3193,10 +3193,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Ref object. + * of this rowset's {@code ResultSet} object as a {@code Ref} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL {@code REF} value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3210,10 +3210,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Blob object. + * of this rowset's {@code ResultSet} object as a {@code Blob} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Blob object representing the SQL BLOB + * @return a {@code Blob} object representing the SQL {@code BLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3227,10 +3227,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Clob object. + * of this rowset's {@code ResultSet} object as a {@code Clob} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Clob object representing the SQL CLOB + * @return a {@code Clob} object representing the SQL {@code CLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3244,10 +3244,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Array object. + * of this rowset's {@code ResultSet} object as an {@code Array} object. * * @param i the first column is 1, the second is 2, and so on. - * @return an Array object representing the SQL ARRAY + * @return an {@code Array} object representing the SQL {@code ARRAY} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3261,14 +3261,14 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Object. - * This method uses the specified Map object for + * of this rowset's {@code ResultSet} object as an {@code Object}. + * This method uses the specified {@code Map} object for * custom mapping if appropriate. * * @param colName the name of the column from which to retrieve the value - * @param map a java.util.Map object that contains the mapping + * @param map a {@code java.util.Map} object that contains the mapping * from SQL type names to classes in the Java programming language - * @return an Object representing the SQL + * @return an {@code Object} representing the SQL * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3282,10 +3282,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Ref object. + * of this rowset's {@code ResultSet} object as a {@code Ref} object. * * @param colName the column name - * @return a Ref object representing the SQL REF value in + * @return a {@code Ref} object representing the SQL {@code REF} value in * the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3297,10 +3297,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Blob object. + * of this rowset's {@code ResultSet} object as a {@code Blob} object. * * @param colName the name of the column from which to retrieve the value - * @return a Blob object representing the SQL BLOB + * @return a {@code Blob} object representing the SQL {@code BLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3312,10 +3312,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Clob object. + * of this rowset's {@code ResultSet} object as a {@code Clob} object. * * @param colName the name of the column from which to retrieve the value - * @return a Clob object representing the SQL CLOB + * @return a {@code Clob} object representing the SQL {@code CLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3327,10 +3327,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Array object. + * of this rowset's {@code ResultSet} object as an {@code Array} object. * * @param colName the name of the column from which to retrieve the value - * @return an Array object representing the SQL ARRAY + * @return an {@code Array} object representing the SQL {@code ARRAY} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3342,17 +3342,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Date + * of this rowset's {@code ResultSet} object as a {@code java.sql.Date} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the date - * @return the column value as a java.sql.Date object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Date} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3365,17 +3365,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Date + * of this rowset's {@code ResultSet} object as a {@code java.sql.Date} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column from which to retrieve the value - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the date - * @return the column value as a java.sql.Date object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Date} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3387,17 +3387,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Time + * of this rowset's {@code ResultSet} object as a {@code java.sql.Time} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the time - * @return the column value as a java.sql.Time object; - * if the value is SQL NULL, - * the value returned is null in the Java programming language + * @return the column value as a {@code java.sql.Time} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} in the Java programming language * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3410,17 +3410,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Time + * of this rowset's {@code ResultSet} object as a {@code java.sql.Time} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the time - * @return the column value as a java.sql.Time object; - * if the value is SQL NULL, - * the value returned is null in the Java programming language + * @return the column value as a {@code java.sql.Time} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} in the Java programming language * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3431,18 +3431,18 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as a + * {@code java.sql.Timestamp} object. * This method uses the given calendar to construct an appropriate millisecond * value for the timestamp if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the timestamp - * @return the column value as a java.sql.Timestamp object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Timestamp} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3455,18 +3455,18 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as a + * {@code java.sql.Timestamp} object. * This method uses the given calendar to construct an appropriate millisecond * value for the timestamp if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the timestamp - * @return the column value as a java.sql.Timestamp object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Timestamp} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3478,8 +3478,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3490,14 +3490,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new Ref column value + * @param ref the new {@code Ref} column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { @@ -3507,8 +3507,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3519,13 +3519,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param ref the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { @@ -3534,8 +3534,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3546,14 +3546,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { checkState(); @@ -3563,8 +3563,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3575,13 +3575,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { updateClob(findColumn(columnName), c); @@ -3589,8 +3589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3601,14 +3601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { checkState(); @@ -3617,8 +3617,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3629,13 +3629,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { updateBlob(findColumn(columnName), b); @@ -3643,8 +3643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3655,14 +3655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { checkState(); @@ -3671,8 +3671,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3683,20 +3683,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { updateArray(findColumn(columnName), a); } /** - * Provide interface coverage for getURL(int) in ResultSet->RowSet + * Provide interface coverage for getURL(int) in {@code ResultSet->RowSet} */ public java.net.URL getURL(int columnIndex) throws SQLException { checkState(); @@ -3704,7 +3704,7 @@ } /** - * Provide interface coverage for getURL(String) in ResultSet->RowSet + * Provide interface coverage for getURL(String) in {@code ResultSet->RowSet} */ public java.net.URL getURL(String columnName) throws SQLException { return getURL(findColumn(columnName)); @@ -3712,14 +3712,14 @@ /** * Return the RowSetWarning object for the current row of a - * JdbcRowSetImpl + * {@code JdbcRowSetImpl} */ public RowSetWarning getRowSetWarnings() throws SQLException { return null; } /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3728,8 +3728,8 @@ * @param columnIdxes the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * parameter index is out of bounds or if the columnIdx is + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { @@ -3748,7 +3748,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3757,8 +3757,8 @@ * @param columnIdxes the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * parameter index is out of bounds or if the columnName is + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { @@ -3774,11 +3774,11 @@ } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -3796,10 +3796,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -3829,19 +3829,19 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(int[] columnIdxes) throws SQLException { @@ -3858,17 +3858,17 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(String[] columnNames) throws SQLException { @@ -3883,22 +3883,22 @@ } - /** - * Sets the designated parameter to the given int + /** + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(int columnIdx) throws SQLException { // validate, if col is ok to be set @@ -3912,19 +3912,19 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(String columnName) throws SQLException { // validate, if col is ok to be set @@ -3938,8 +3938,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3948,8 +3948,8 @@ * @param columnIdx the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * parameter index is out of bounds or if the columnIdx is + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { // check if we are unsetting the SAME column @@ -3964,8 +3964,8 @@ } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3974,8 +3974,8 @@ * @param columnName the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * parameter index is out of bounds or if the columnName is + * not the same as set using {@code setMatchColumn(String)} * */ public void unsetMatchColumn(String columnName) throws SQLException { @@ -3992,12 +3992,12 @@ } /** - * Retrieves the DatabaseMetaData associated with + * Retrieves the {@code DatabaseMetaData} associated with * the connection handle associated with this - * JdbcRowSet object. + * {@code JdbcRowSet} object. * - * @return the DatabaseMetadata associated - * with the rowset's connection. + * @return the {@code DatabaseMetadata} associated + * with the rowset's connection. * @throws SQLException if a database access error occurs */ public DatabaseMetaData getDatabaseMetaData() throws SQLException { @@ -4006,12 +4006,12 @@ } /** - * Retrieves the ParameterMetaData associated with + * Retrieves the {@code ParameterMetaData} associated with * the connection handle associated with this - * JdbcRowSet object. + * {@code JdbcRowSet} object. * - * @return the ParameterMetadata associated - * with the rowset's connection. + * @return the {@code ParameterMetadata} associated + * with the rowset's connection. * @throws SQLException if a database access error occurs */ public ParameterMetaData getParameterMetaData() throws SQLException { @@ -4020,18 +4020,18 @@ } /** - * Commits all updates in this JdbcRowSet object by - * wrapping the internal Connection object and calling - * its commit method. - * This method sets this JdbcRowSet object's private field - * rs to null after saving its value to another - * object, but only if the ResultSet - * constant HOLD_CURSORS_OVER_COMMIT has not been set. - * (The field rs is this JdbcRowSet object's - * ResultSet object.) + * Commits all updates in this {@code JdbcRowSet} object by + * wrapping the internal {@code Connection} object and calling + * its {@code commit} method. + * This method sets this {@code JdbcRowSet} object's private field + * {@code rs} to {@code null} after saving its value to another + * object, but only if the {@code ResultSet} + * constant {@code HOLD_CURSORS_OVER_COMMIT} has not been set. + * (The field {@code rs} is this {@code JdbcRowSet} object's + * {@code ResultSet} object.) * * @throws SQLException if autoCommit is set to true or if a database - * access error occurs + * access error occurs */ public void commit() throws SQLException { conn.commit(); @@ -4045,8 +4045,8 @@ } /** - * Sets auto-commit on the internal Connection object with this - * JdbcRowSet + * Sets auto-commit on the internal {@code Connection} object with this + * {@code JdbcRowSet} * * @throws SQLException if a database access error occurs */ @@ -4074,7 +4074,7 @@ } /** - * Returns the auto-commit status with this JdbcRowSet. + * Returns the auto-commit status with this {@code JdbcRowSet}. * * @return true if auto commit is true; false otherwise * @throws SQLException if a database access error occurs @@ -4084,16 +4084,16 @@ } /** - * Rolls back all the updates in this JdbcRowSet object by - * wrapping the internal Connection object and calling its - * rollback method. - * This method sets this JdbcRowSet object's private field - * rs to null after saving its value to another object. - * (The field rs is this JdbcRowSet object's - * internal ResultSet object.) + * Rolls back all the updates in this {@code JdbcRowSet} object by + * wrapping the internal {@code Connection} object and calling its + * {@code rollback} method. + * This method sets this {@code JdbcRowSet} object's private field + * {@code rs} to {@code null} after saving its value to another object. + * (The field {@code rs} is this {@code JdbcRowSet} object's + * internal {@code ResultSet} object.) * * @throws SQLException if autoCommit is set to true or a database - * access error occurs + * access error occurs */ public void rollback() throws SQLException { conn.rollback(); @@ -4106,14 +4106,14 @@ /** - * Rollbacks all the updates in the JdbcRowSet back to the - * last Savepoint transaction marker. Wraps the internal - * Connection object and call it's rollback method + * Rollbacks all the updates in the {@code JdbcRowSet} back to the + * last {@code Savepoint} transaction marker. Wraps the internal + * {@code Connection} object and call it's rollback method * - * @param s the Savepoint transaction marker to roll the - * transaction to. + * @param s the {@code Savepoint} transaction marker to roll the + * transaction to. * @throws SQLException if autoCommit is set to true; or ia a database - * access error occurs + * access error occurs */ public void rollback(Savepoint s) throws SQLException { conn.rollback(s); @@ -4144,10 +4144,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's Connection property + * Gets this {@code JdbcRowSet} object's Connection property * * - * @return the Connection object associated with this rowset; + * @return the {@code Connection} object associated with this rowset; */ protected Connection getConnection() { @@ -4158,10 +4158,10 @@ // Added as per rave requirements /** - * Sets this JdbcRowSet object's connection property - * to the given Connection object. + * Sets this {@code JdbcRowSet} object's connection property + * to the given {@code Connection} object. * - * @param connection the Connection object. + * @param connection the {@code Connection} object. */ protected void setConnection(Connection connection) { @@ -4172,10 +4172,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's PreparedStatement property + * Gets this {@code JdbcRowSet} object's PreparedStatement property * * - * @return the PreparedStatement object associated with this rowset; + * @return the {@code PreparedStatement} object associated with this rowset; */ protected PreparedStatement getPreparedStatement() { @@ -4186,10 +4186,10 @@ // Added as per Rave requirements /** - * Sets this JdbcRowSet object's preparedtsatement property - * to the given PreparedStatemennt object. + * Sets this {@code JdbcRowSet} object's preparedtsatement property + * to the given {@code PreparedStatemennt} object. * - * @param preparedStatement the PreparedStatement object + * @param preparedStatement the {@code PreparedStatement} object * */ protected void setPreparedStatement(PreparedStatement preparedStatement) { @@ -4200,10 +4200,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's ResultSet property + * Gets this {@code JdbcRowSet} object's ResultSet property * * - * @return the ResultSet object associated with this rowset; + * @return the {@code ResultSet} object associated with this rowset; */ protected ResultSet getResultSet() throws SQLException { @@ -4217,10 +4217,10 @@ // Added as per Rave requirements /** - * Sets this JdbcRowSet object's resultset property - * to the given ResultSet object. + * Sets this {@code JdbcRowSet} object's resultset property + * to the given {@code ResultSet} object. * - * @param resultSet the ResultSet object + * @param resultSet the {@code ResultSet} object * */ protected void setResultSet(ResultSet resultSet) { @@ -4228,25 +4228,25 @@ } /** - * Sets this JdbcRowSet object's command property to - * the given String object and clears the parameters, if any, + * Sets this {@code JdbcRowSet} object's {@code command} property to + * the given {@code String} object and clears the parameters, if any, * that were set for the previous command. In addition, - * if the command property has previously been set to a + * if the {@code command} property has previously been set to a * non-null value and it is - * different from the String object supplied, - * this method sets this JdbcRowSet object's private fields - * ps and rs to null. - * (The field ps is its PreparedStatement object, and - * the field rs is its ResultSet object.) + * different from the {@code String} object supplied, + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps} and {@code rs} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, and + * the field {@code rs} is its {@code ResultSet} object.) * - * The command property may not be needed if the RowSet + * The {@code command} property may not be needed if the {@code RowSet} * object gets its data from a source that does not support commands, * such as a spreadsheet or other tabular file. - * Thus, this property is optional and may be null. + * Thus, this property is optional and may be {@code null}. * - * @param command a String object containing an SQL query - * that will be set as this RowSet object's command - * property; may be null but may not be an empty string + * @param command a {@code String} object containing an SQL query + * that will be set as this {@code RowSet} object's command + * property; may be {@code null} but may not be an empty string * @throws SQLException if an empty string is provided as the command value * @see #getCommand */ @@ -4265,32 +4265,32 @@ } /** - * Sets the dataSourceName property for this JdbcRowSet - * object to the given logical name and sets this JdbcRowSet object's - * Url property to null. In addition, if the dataSourceName + * Sets the {@code dataSourceName} property for this {@code JdbcRowSet} + * object to the given logical name and sets this {@code JdbcRowSet} object's + * Url property to {@code null}. In addition, if the {@code dataSourceName} * property has previously been set and is different from the one supplied, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * the field rs is its ResultSet object, and - * the field conn is its Connection object.) + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * the field {@code rs} is its {@code ResultSet} object, and + * the field {@code conn} is its {@code Connection} object.) * * The name supplied to this method must have been bound to a - * DataSource object in a JNDI naming service so that an + * {@code DataSource} object in a JNDI naming service so that an * application can do a lookup using that name to retrieve the - * DataSource object bound to it. The DataSource + * {@code DataSource} object bound to it. The {@code DataSource} * object can then be used to establish a connection to the data source it * represents. * * Users should set either the Url property or the dataSourceName property. * If both properties are set, the driver will use the property set most recently. * - * @param dsName a String object with the name that can be supplied + * @param dsName a {@code String} object with the name that can be supplied * to a naming service based on JNDI technology to retrieve the - * DataSource object that can be used to get a connection; - * may be null + * {@code DataSource} object that can be used to get a connection; + * may be {@code null} * @throws SQLException if there is a problem setting the - * dataSourceName property + * {@code dataSourceName} property * @see #getDataSourceName */ public void setDataSourceName(String dsName) throws SQLException{ @@ -4310,42 +4310,42 @@ /** - * Sets the Url property for this JdbcRowSet object - * to the given String object and sets the dataSource name - * property to null. In addition, if the Url property has - * previously been set to a non null value and its value + * Sets the Url property for this {@code JdbcRowSet} object + * to the given {@code String} object and sets the dataSource name + * property to {@code null}. In addition, if the Url property has + * previously been set to a non {@code null} value and its value * is different from the value to be set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * the field rs is its ResultSet object, and - * the field conn is its Connection object.) + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * the field {@code rs} is its {@code ResultSet} object, and + * the field {@code conn} is its {@code Connection} object.) * * The Url property is a JDBC URL that is used when * the connection is created using a JDBC technology-enabled driver - * ("JDBC driver") and the DriverManager. + * ("JDBC driver") and the {@code DriverManager}. * The correct JDBC URL for the specific driver to be used can be found * in the driver documentation. Although there are guidelines for how * a JDBC URL is formed, - * a driver vendor can specify any String object except - * one with a length of 0 (an empty string). + * a driver vendor can specify any {@code String} object except + * one with a length of {@code 0} (an empty string). * * Setting the Url property is optional if connections are established using - * a DataSource object instead of the DriverManager. + * a {@code DataSource} object instead of the {@code DriverManager}. * The driver will use either the URL property or the * dataSourceName property to create a connection, whichever was * specified most recently. If an application uses a JDBC URL, it * must load a JDBC driver that accepts the JDBC URL before it uses the - * RowSet object to connect to a database. The RowSet + * {@code RowSet} object to connect to a database. The {@code RowSet} * object will use the URL internally to create a database connection in order * to read or write data. * - * @param url a String object that contains the JDBC URL + * @param url a {@code String} object that contains the JDBC URL * that will be used to establish the connection to a database for this - * RowSet object; may be null but must not + * {@code RowSet} object; may be {@code null} but must not * be an empty string * @throws SQLException if an error occurs setting the Url property or the - * parameter supplied is a string with a length of 0 (an + * parameter supplied is a string with a length of {@code 0} (an * empty string) * @see #getUrl */ @@ -4365,24 +4365,24 @@ } } - /** - * Sets the username property for this JdbcRowSet object + /** + * Sets the username property for this {@code JdbcRowSet} object * to the given user name. Because it * is not serialized, the username property is set at run time before - * calling the method execute. In addition, - * if the username property is already set with a - * non-null value and that value is different from the String + * calling the method {@code execute}. In addition, + * if the {@code username} property is already set with a + * non-null value and that value is different from the {@code String} * object to be set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * rs is its ResultSet object, and - * conn is its Connection object.) - * Setting these fields to null ensures that only current + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * {@code rs} is its {@code ResultSet} object, and + * {@code conn} is its {@code Connection} object.) + * Setting these fields to {@code null} ensures that only current * values will be used. * - * @param uname the String object containing the user name that - * is supplied to the data source to create a connection. It may be null. + * @param uname the {@code String} object containing the user name that + * is supplied to the data source to create a connection. It may be null. * @see #getUsername */ public void setUsername(String uname) { @@ -4401,23 +4401,23 @@ } /** - * Sets the password property for this JdbcRowSet object - * to the given String object. Because it + * Sets the password property for this {@code JdbcRowSet} object + * to the given {@code String} object. Because it * is not serialized, the password property is set at run time before - * calling the method execute. Its default valus is - * null. In addition, - * if the password property is already set with a + * calling the method {@code execute}. Its default valus is + * {@code null}. In addition, + * if the {@code password} property is already set with a * non-null value and that value is different from the one being set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * rs is its ResultSet object, and - * conn is its Connection object.) - * Setting these fields to null ensures that only current + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * {@code rs} is its {@code ResultSet} object, and + * {@code conn} is its {@code Connection} object.) + * Setting these fields to {@code null} ensures that only current * values will be used. * - * @param password the String object that represents the password - * that must be supplied to the database to create a connection + * @param password the {@code String} object that represents the password + * that must be supplied to the database to create a connection */ public void setPassword(String password) { @@ -4435,18 +4435,18 @@ } /** - * Sets the type for this RowSet object to the specified type. - * The default type is ResultSet.TYPE_SCROLL_INSENSITIVE. + * Sets the type for this {@code RowSet} object to the specified type. + * The default type is {@code ResultSet.TYPE_SCROLL_INSENSITIVE}. * * @param type one of the following constants: - * ResultSet.TYPE_FORWARD_ONLY, - * ResultSet.TYPE_SCROLL_INSENSITIVE, or - * ResultSet.TYPE_SCROLL_SENSITIVE + * {@code ResultSet.TYPE_FORWARD_ONLY}, + * {@code ResultSet.TYPE_SCROLL_INSENSITIVE}, or + * {@code ResultSet.TYPE_SCROLL_SENSITIVE} * @throws SQLException if the parameter supplied is not one of the * following constants: - * ResultSet.TYPE_FORWARD_ONLY or - * ResultSet.TYPE_SCROLL_INSENSITIVE - * ResultSet.TYPE_SCROLL_SENSITIVE + * {@code ResultSet.TYPE_FORWARD_ONLY} or + * {@code ResultSet.TYPE_SCROLL_INSENSITIVE} + * {@code ResultSet.TYPE_SCROLL_SENSITIVE} * @see #getConcurrency * @see #getType */ @@ -4468,18 +4468,18 @@ } /** - * Sets the concurrency for this RowSet object to - * the specified concurrency. The default concurrency for any RowSet - * object (connected or disconnected) is ResultSet.CONCUR_UPDATABLE, + * Sets the concurrency for this {@code RowSet} object to + * the specified concurrency. The default concurrency for any {@code RowSet} + * object (connected or disconnected) is {@code ResultSet.CONCUR_UPDATABLE}, * but this method may be called at any time to change the concurrency. * * @param concur one of the following constants: - * ResultSet.CONCUR_READ_ONLY or - * ResultSet.CONCUR_UPDATABLE + * {@code ResultSet.CONCUR_READ_ONLY} or + * {@code ResultSet.CONCUR_UPDATABLE} * @throws SQLException if the parameter supplied is not one of the * following constants: - * ResultSet.CONCUR_UPDATABLE or - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_UPDATABLE} or + * {@code ResultSet.CONCUR_READ_ONLY} * @see #getConcurrency * @see #isReadOnly */ @@ -4500,8 +4500,8 @@ } /** - * Retrieves the value of the designated SQL XML parameter as a - * SQLXML object in the Java programming language. + * Retrieves the value of the designated {@code SQL XML} parameter as a + * {@code SQLXML} object in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @return a SQLXML object that maps an SQL XML value * @throws SQLException if a database access error occurs @@ -4512,8 +4512,8 @@ } /** - * Retrieves the value of the designated SQL XML parameter as a - * SQLXML object in the Java programming language. + * Retrieves the value of the designated {@code SQL XML} parameter as a + * {@code SQLXML} object in the Java programming language. * @param colName the name of the column from which to retrieve the value * @return a SQLXML object that maps an SQL XML value * @throws SQLException if a database access error occurs @@ -4524,12 +4524,12 @@ /** * Retrieves the value of the designated column in the current row of this - * ResultSet object as a java.sql.RowId object in the Java + * {@code ResultSet} object as a java.sql.RowId object in the Java * programming language. * * @param columnIndex the first column is 1, the second 2, ... - * @return the column value if the value is a SQL NULL the - * value returned is null + * @return the column value if the value is a SQL {@code NULL} the + * value returned is {@code null} * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4539,12 +4539,12 @@ /** * Retrieves the value of the designated column in the current row of this - * ResultSet object as a java.sql.RowId object in the Java + * {@code ResultSet} object as a java.sql.RowId object in the Java * programming language. * * @param columnName the name of the column - * @return the column value if the value is a SQL NULL the - * value returned is null + * @return the column value if the value is a SQL {@code NULL} the + * value returned is {@code null} * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4553,10 +4553,10 @@ } /** - * Updates the designated column with a RowId value. The updater + * Updates the designated column with a {@code RowId} value. The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnIndex the first column is 1, the second 2, ... @@ -4569,10 +4569,10 @@ } /** - * Updates the designated column with a RowId value. The updater + * Updates the designated column with a {@code RowId} value. The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4631,8 +4631,8 @@ /*o - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnIndex the first column is 1, the second 2, ... * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4643,8 +4643,8 @@ } /** - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnName name of the column * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4656,12 +4656,12 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param i the first column is 1, the second is 2, ... - * @return a NClob object representing the SQL - * NCLOB value in the specified column + * @return a {@code NClob} object representing the SQL + * {@code NCLOB} value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4672,11 +4672,11 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param colName the name of the column from which to retrieve the value - * @return a NClob object representing the SQL NCLOB + * @return a {@code NClob} object representing the SQL {@code NCLOB} * value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 @@ -4694,10 +4694,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * SQL {@code XML} value when it sends it to the database. * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an SQL {@code XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4706,10 +4706,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * {@code SQL XML} value when it sends it to the database. * @param parameterName the name of the parameter - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an {@code SQL XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4718,8 +4718,8 @@ } /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID value when it sends it + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} value when it sends it * to the database * * @param parameterIndex the first parameter is 1, the second is 2, ... @@ -4732,9 +4732,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID when it sends it to the + /** + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} when it sends it to the * database. * * @param parameterName the name of the parameter @@ -4748,18 +4748,18 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR value + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on NVARCHAR values) + * size relative to the driver's limits on {@code NVARCHAR} values) * when it sends it to the database. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNString(int parameterIndex, String value) throws SQLException { @@ -4768,9 +4768,9 @@ /** - * Sets the designated parameter in this RowSet object's command - * to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter in this {@code RowSet} object's command + * to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -4779,14 +4779,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed PreparedStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -4795,14 +4795,14 @@ } /** - * Sets the designated parameter to a java.sql.NClob object. The object - * implements the java.sql.NClob interface. This NClob - * object maps to a SQL NCLOB. + * Sets the designated parameter to a {@code java.sql.NClob} object. The object + * implements the {@code java.sql.NClob} interface. This {@code NClob} + * object maps to a SQL {@code NCLOB}. * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(String parameterName, NClob value) throws SQLException { @@ -4810,17 +4810,17 @@ } - /** + /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @exception SQLException if a database access error occurs * @since 1.6 @@ -4832,16 +4832,16 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the name of the column - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4850,11 +4850,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * @param columnIndex the first column is 1, the second 2, ... * @param xmlObject the value for the column to be updated @@ -4866,11 +4866,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4884,15 +4884,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnIndex the first column is 1, the second is 2, ... - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4902,15 +4902,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4927,9 +4927,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnIndex - the first column is 1, the second is 2, ... - * @param x - the new column value - * @param length - the length of the stream + * @param columnIndex the first column is 1, the second is 2, ... + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4949,9 +4949,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnName - name of the Column - * @param x - the new column value - * @param length - the length of the stream + * @param columnName name of the Column + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4963,26 +4963,27 @@ } /** - * Updates the designated column with a character stream value. The + * Updates the designated column with a character stream value. The * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} or this + * method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -4997,26 +4998,27 @@ * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * the result set concurrency is {@code CONCUR_READ_ONLY} or + * this method is called on a closed result set + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method * @since 1.6 */ public void updateNCharacterStream(String columnLabel, @@ -5027,9 +5029,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5039,16 +5041,16 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5060,9 +5062,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5072,18 +5074,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, + * then the label is the name of the column. * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException { @@ -5092,9 +5096,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5102,23 +5106,23 @@ * Java stream object or your own subclass that implements the * standard interface. * - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException { @@ -5127,9 +5131,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5138,22 +5142,23 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException { @@ -5161,11 +5166,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5175,17 +5180,17 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5193,11 +5198,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5207,17 +5212,18 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5225,33 +5231,33 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader) throws SQLException { @@ -5259,34 +5265,35 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader) throws SQLException { @@ -5294,11 +5301,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5308,19 +5315,19 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5328,11 +5335,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5342,19 +5349,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5362,11 +5370,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5375,22 +5383,22 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader) throws SQLException { @@ -5398,11 +5406,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5411,23 +5419,24 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader) throws SQLException { @@ -5435,22 +5444,22 @@ } - /** + /** * Updates the designated column with an ascii stream value, which will have * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5464,17 +5473,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBinaryStream(int columnIndex, @@ -5488,17 +5497,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5512,17 +5521,19 @@ * the specified number of bytes.. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5535,20 +5546,20 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5560,21 +5571,22 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5588,15 +5600,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5611,18 +5625,18 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5637,19 +5651,20 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5665,18 +5680,20 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5689,20 +5706,20 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5714,22 +5731,23 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5738,97 +5756,98 @@ } - /** - * Sets the designated parameter to the given java.net.URL value. - * The driver converts this to an SQL DATALINK value - * when it sends it to the database. - * - * @param parameterIndex the first parameter is 1, the second is 2, ... - * @param x the java.net.URL object to be set - * @exception SQLException if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.4 - */ + /** + * Sets the designated parameter to the given {@code java.net.URL} value. + * The driver converts this to an SQL {@code DATALINK} value + * when it sends it to the database. + * + * @param parameterIndex the first parameter is 1, the second is 2, ... + * @param x the {@code java.net.URL} object to be set + * @exception SQLException if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * @since 1.4 + */ public void setURL(int parameterIndex, java.net.URL x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB - * Note: Consult your JDBC driver documentation to determine if - * it might be more efficient to use a version of - * setNClob which takes a length parameter. - * - * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param reader An object that contains the data to set the parameter value to. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * - * @since 1.6 - */ + /** + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * Note: Consult your JDBC driver documentation to determine if + * it might be more efficient to use a version of + * {@code setNClob} which takes a length parameter. + * + * @param parameterIndex index of the first parameter is 1, the second is 2, ... + * @param reader An object that contains the data to set the parameter value to. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * + * @since 1.6 + */ public void setNClob(int parameterIndex, Reader reader) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB - * - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national - * character sets; if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * @since 1.6 - */ - public void setNClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. + * The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national + * character sets; if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * @since 1.6 + */ + public void setNClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); - } + } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNClob which takes a length parameter. + * {@code setNClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5839,23 +5858,24 @@ } - /** - ** of characters specified by length otherwise a SQLException will becontain the number - * generated when the PreparedStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method + /** + * of characters specified by length otherwise a {@code SQLException} will becontain the number + * generated when the {@code PreparedStatement} is executed. + * This method differs from the {@code setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5867,14 +5887,14 @@ /** - * Sets the designated parameter to a java.sql.NClob object. The driver converts this to -a - * SQL NCLOB value when it sends it to the database. + * Sets the designated parameter to a {@code java.sql.NClob} object. + * The driver converts this to an + * SQL {@code NCLOB} value when it sends it to the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(int parameterIndex, NClob value) throws SQLException{ @@ -5883,14 +5903,14 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNString(String parameterName, String value) @@ -5899,8 +5919,8 @@ } /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... @@ -5908,7 +5928,7 @@ * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException{ @@ -5918,8 +5938,8 @@ /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterName the name of the column to be set @@ -5935,9 +5955,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + /** + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -5946,14 +5966,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed CallableStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -5962,23 +5982,23 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIMESTAMP value, + * Sets the designated parameter to the given {@code java.sql.Timestamp} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIMESTAMP} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the timestamp + * a {@code Calendar} object, the driver can calculate the timestamp * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use - * to construct the timestamp + * @param cal the {@code Calendar} object the driver will use + * to construct the timestamp * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -5987,28 +6007,29 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } @@ -6016,16 +6037,16 @@ /** - * Sets the designated parameter to the given java.sql.Clob object. - * The driver converts this to an SQL CLOB value when it + * Sets the designated parameter to the given {@code java.sql.Clob} object. + * The driver converts this to an SQL {@code CLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Clob object that maps an SQL CLOB value + * @param x a {@code Clob} object that maps an SQL {@code CLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setClob (String parameterName, Clob x) throws SQLException{ @@ -6033,21 +6054,21 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs or this method is called on - * a closed CallableStatement + * a closed {@code CallableStatement} * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6058,19 +6079,19 @@ } - /** - * Sets the designated parameter to the given java.sql.Date value + /** + * Sets the designated parameter to the given {@code java.sql.Date} value * using the default time zone of the virtual machine that is running * the application. * The driver converts this - * to an SQL DATE value when it sends it to the database. + * to an SQL {@code DATE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6080,23 +6101,23 @@ } /** - * Sets the designated parameter to the given java.sql.Date value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL DATE value, + * Sets the designated parameter to the given {@code java.sql.Date} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code DATE} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the date + * a {@code Calendar} object, the driver can calculate the date * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the date * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6107,16 +6128,16 @@ /** - * Sets the designated parameter to the given java.sql.Time value. + * Sets the designated parameter to the given {@code java.sql.Time} value. * The driver converts this - * to an SQL TIME value when it sends it to the database. + * to an SQL {@code TIME} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6126,23 +6147,23 @@ } /** - * Sets the designated parameter to the given java.sql.Time value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIME value, + * Sets the designated parameter to the given {@code java.sql.Time} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIME} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the time + * a {@code Calendar} object, the driver can calculate the time * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the time * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6152,22 +6173,22 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatementor if parameterIndex does not correspond to a parameter - * marker in the SQL statement + * a closed {@code PreparedStatement}or if parameterIndex does not correspond to a parameter + * marker in the SQL statement * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6179,19 +6200,19 @@ /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - *This method differs from the setCharacterStream (int, Reader, int) method + * Sets the designated parameter to a {@code Reader} object. The reader 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 setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatement, if parameterIndex does not correspond to a parameter + * a closed {@code PreparedStatement}, if parameterIndex does not correspond to a parameter * marker in the SQL statement, or if the length specified is less than zero. * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method @@ -6204,25 +6225,26 @@ /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) + * Sets the designated parameter to a {@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)} * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... + * the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement, - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, if the length specified - * is less than zero or if the number of bytes in the inputstream does not match - * the specified length. + * this method is called on a closed {@code PreparedStatement}, + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, if the length specified + * is less than zero or if the number of bytes in the inputstream does not match + * the specified length. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6233,28 +6255,27 @@ } /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) - * This method differs from the setBinaryStream (int, InputStream) + * Sets the designated parameter to a {@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 - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... - - + * the second is 2, ... + * * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement or - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, + * this method is called on a closed {@code PreparedStatement} or + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6264,72 +6285,72 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length, otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) - * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, - * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB - * - * @param parameterName the name of the parameter to be set - * the second is 2, ... - * - * @param inputStream An object that contains the data to set the parameter - * value to. - * @param length the number of bytes in the parameter data. - * @throws SQLException if parameterIndex does not correspond - * to a parameter marker in the SQL statement, or if the length specified - * is less than zero; if the number of bytes in the inputstream does not match - * the specified length; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setBlob(String parameterName, InputStream inputStream, long length) + /** + * Sets the designated parameter to a {@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)} + * 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, + * the driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * + * @param parameterName the name of the parameter to be set + * the second is 2, ... + * + * @param inputStream An object that contains the data to set the parameter + * value to. + * @param length the number of bytes in the parameter data. + * @throws SQLException if parameterIndex does not correspond + * to a parameter marker in the SQL statement, or if the length specified + * is less than zero; if the number of bytes in the inputstream does not match + * the specified length; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.Blob object. - * The driver converts this to an SQL BLOB value when it + /** + * Sets the designated parameter to the given {@code java.sql.Blob} object. + * The driver converts this to an SQL {@code BLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Blob object that maps an SQL BLOB value + * @param x a {@code Blob} object that maps an SQL {@code BLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setBlob (String parameterName, Blob x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) + /** + * Sets the designated parameter to a {@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 BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARBINARY or a BLOB + * data should be send to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterName the name of the parameter * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6339,22 +6360,22 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. The second * argument must be an object type; for integral values, the - * java.lang equivalent objects should be used. + * {@code java.lang} equivalent objects should be used. * * The given Java object will be converted to the given targetSqlType * before being sent to the database. * * If the object has a custom mapping (is of a class implementing the - * interface SQLData), - * the JDBC driver should call the method SQLData.writeSQL to write it + * interface {@code SQLData}), + * the JDBC driver should call the method {@code SQLData.writeSQL} to write it * to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * Note that this method may be used to pass datatabase- @@ -6365,17 +6386,17 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database. The scale argument may further qualify this type. * @param scale for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types, this value will be ignored. + * this is the number of digits after the decimal point. For all other + * types, this value will be ignored. * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see Types * @see #getObject * @since 1.4 @@ -6387,7 +6408,7 @@ /** * Sets the value of the designated parameter with the given object. - * This method is like the method setObject + * This method is like the method {@code setObject} * above, except that it assumes a scale of zero. * * @param parameterName the name of the parameter @@ -6395,14 +6416,14 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see #getObject * @since 1.4 */ @@ -6411,13 +6432,13 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. - * The second parameter must be of type Object; therefore, the - * java.lang equivalent objects should be used for built-in types. + * The second parameter must be of type {@code Object}; therefore, the + * {@code java.lang} equivalent objects should be used for built-in types. * * The JDBC specification specifies a standard mapping from - * Java Object types to SQL types. The given argument + * Java {@code Object} types to SQL types. The given argument * will be converted to the corresponding SQL type before being * sent to the database. * @@ -6425,13 +6446,13 @@ * specific abstract data types, by using a driver-specific Java * type. * - * If the object is of a class implementing the interface SQLData, - * the JDBC driver should call the method SQLData.writeSQL + * If the object is of a class implementing the interface {@code SQLData}, + * the JDBC driver should call the method {@code SQLData.writeSQL} * to write it to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * This method throws an exception if there is an ambiguity, for example, if the @@ -6440,10 +6461,10 @@ * @param parameterName the name of the parameter * @param x the object containing the input parameter value * @exception SQLException if a database access error occurs, - * this method is called on a closed CallableStatement or if the given - * Object parameter is ambiguous + * this method is called on a closed {@code CallableStatement} or if the given + * {@code Object} parameter is ambiguous * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getObject * @since 1.4 */ @@ -6454,9 +6475,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6468,9 +6489,9 @@ * @param x the Java input stream that contains the ASCII parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setAsciiStream(String parameterName, java.io.InputStream x, int length) @@ -6482,9 +6503,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the stream + * {@code java.io.InputStream} object. The data will be read from the stream * as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6495,9 +6516,9 @@ * @param x the java input stream which contains the binary parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBinaryStream(String parameterName, java.io.InputStream x, @@ -6506,11 +6527,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6519,13 +6540,13 @@ * standard interface. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that + * @param reader the {@code java.io.Reader} object that * contains the UNICODE data used as the designated parameter * @param length the number of characters in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setCharacterStream(String parameterName, @@ -6536,9 +6557,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6547,15 +6568,15 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setAsciiStream which takes a length parameter. + * {@code setAsciiStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the Java input stream that contains the ASCII parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.6 - */ + * @since 1.6 + */ public void setAsciiStream(String parameterName, java.io.InputStream x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); @@ -6564,9 +6585,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the + * {@code java.io.InputStream} object. The data will be read from the * stream as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6574,12 +6595,12 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBinaryStream which takes a length parameter. + * {@code setBinaryStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the java input stream which contains the binary parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6589,11 +6610,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6602,13 +6623,13 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setCharacterStream which takes a length parameter. + * {@code setCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that contains the + * @param reader the {@code java.io.Reader} object that contains the * Unicode data * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6619,16 +6640,16 @@ /** * Sets the designated parameter to the given - * java.math.BigDecimal value. - * The driver converts this to an SQL NUMERIC value when + * {@code java.math.BigDecimal} value. + * The driver converts this to an SQL {@code NUMERIC} value when * it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBigDecimal * @since 1.4 */ @@ -6636,20 +6657,20 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java String value. + /** + * Sets the designated parameter to the given Java {@code String} value. * The driver converts this - * to an SQL VARCHAR or LONGVARCHAR value + * to an SQL {@code VARCHAR} or {@code LONGVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on VARCHAR values) + * size relative to the driver's limits on {@code VARCHAR} values) * when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getString * @since 1.4 */ @@ -6659,19 +6680,19 @@ - /** + /** * Sets the designated parameter to the given Java array of bytes. - * The driver converts this to an SQL VARBINARY or - * LONGVARBINARY (depending on the argument's size relative - * to the driver's limits on VARBINARY values) when it sends + * The driver converts this to an SQL {@code VARBINARY} or + * {@code LONGVARBINARY} (depending on the argument's size relative + * to the driver's limits on {@code VARBINARY} values) when it sends * it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBytes * @since 1.4 */ @@ -6680,17 +6701,17 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value. + * Sets the designated parameter to the given {@code java.sql.Timestamp} value. * The driver - * converts this to an SQL TIMESTAMP value when it sends it to the + * converts this to an SQL {@code TIMESTAMP} value when it sends it to the * database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -6700,16 +6721,16 @@ } /** - * Sets the designated parameter to SQL NULL. + * Sets the designated parameter to SQL {@code NULL}. * * Note: You must specify the parameter's SQL type. * * @param parameterName the name of the parameter - * @param sqlType the SQL type code defined in java.sql.Types + * @param sqlType the SQL type code defined in {@code java.sql.Types} * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull(String parameterName, int sqlType) throws SQLException { @@ -6717,8 +6738,8 @@ } /** - * Sets the designated parameter to SQL NULL. - * This version of the method setNull should + * Sets the designated parameter to SQL {@code NULL}. + * This version of the method {@code setNull} should * be used for user-defined types and REF type parameters. Examples * of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and * named array types. @@ -6738,14 +6759,14 @@ * * * @param parameterName the name of the parameter - * @param sqlType a value from java.sql.Types + * @param sqlType a value from {@code java.sql.Types} * @param typeName the fully-qualified name of an SQL user-defined type; * ignored if the parameter is not a user-defined type or - * SQL REF value + * SQL {@code REF} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull (String parameterName, int sqlType, String typeName) @@ -6754,17 +6775,17 @@ } /** - * Sets the designated parameter to the given Java boolean value. + * Sets the designated parameter to the given Java {@code boolean} value. * The driver converts this - * to an SQL BIT or BOOLEAN value when it sends it to the database. + * to an SQL {@code BIT} or {@code BOOLEAN} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @see #getBoolean * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBoolean(String parameterName, boolean x) throws SQLException{ @@ -6774,16 +6795,16 @@ /** - * Sets the designated parameter to the given Java byte value. + * Sets the designated parameter to the given Java {@code byte} value. * The driver converts this - * to an SQL TINYINT value when it sends it to the database. + * to an SQL {@code TINYINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getByte * @since 1.4 */ @@ -6793,16 +6814,16 @@ /** - * Sets the designated parameter to the given Java short value. + * Sets the designated parameter to the given Java {@code short} value. * The driver converts this - * to an SQL SMALLINT value when it sends it to the database. + * to an SQL {@code SMALLINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getShort * @since 1.4 */ @@ -6812,16 +6833,16 @@ /** - * Sets the designated parameter to the given Java int value. + * Sets the designated parameter to the given Java {@code int} value. * The driver converts this - * to an SQL INTEGER value when it sends it to the database. + * to an SQL {@code INTEGER} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getInt * @since 1.4 */ @@ -6829,17 +6850,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java long value. + /** + * Sets the designated parameter to the given Java {@code long} value. * The driver converts this - * to an SQL BIGINT value when it sends it to the database. + * to an SQL {@code BIGINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getLong * @since 1.4 */ @@ -6848,17 +6869,17 @@ } - /** - * Sets the designated parameter to the given Java float value. + /** + * Sets the designated parameter to the given Java {@code float} value. * The driver converts this - * to an SQL FLOAT value when it sends it to the database. + * to an SQL {@code FLOAT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getFloat * @since 1.4 */ @@ -6866,17 +6887,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java double value. + /** + * Sets the designated parameter to the given Java {@code double} value. * The driver converts this - * to an SQL DOUBLE value when it sends it to the database. + * to an SQL {@code DOUBLE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDouble * @since 1.4 */ @@ -6887,7 +6908,6 @@ /** * This method re populates the resBundle * during the deserialization process - * */ private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException { // Default state initialization happens here --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.803466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.635466074 +0400 @@ -43,22 +43,22 @@ /** - * The facility called on internally by the RIOptimisticProvider implementation to + * The facility called on internally by the {@code RIOptimisticProvider} implementation to * propagate changes back to the data source from which the rowset got its data. * - * A CachedRowSetWriter object, called a writer, has the public - * method writeData for writing modified data to the underlying data source. + * A {@code CachedRowSetWriter} object, called a writer, has the public + * method {@code writeData} for writing modified data to the underlying data source. * This method is invoked by the rowset internally and is never invoked directly by an application. * A writer also has public methods for setting and getting - * the CachedRowSetReader object, called a reader, that is associated + * the {@code CachedRowSetReader} object, called a reader, that is associated * with the writer. The remainder of the methods in this class are private and * are invoked internally, either directly or indirectly, by the method - * writeData. + * {@code writeData}. * - * Typically the SyncFactory manages the RowSetReader and - * the RowSetWriter implementations using SyncProvider objects. + * Typically the {@code SyncFactory} manages the {@code RowSetReader} and + * the {@code RowSetWriter} implementations using {@code SyncProvider} objects. * Standard JDBC RowSet implementations provide an object instance of this - * writer by invoking the SyncProvider.getRowSetWriter() method. + * writer by invoking the {@code SyncProvider.getRowSetWriter()} method. * * @version 0.2 * @author Jonathan Bruce @@ -69,15 +69,15 @@ public class CachedRowSetWriter implements TransactionalWriter, Serializable { /** - * The Connection object that this writer will use to make a + * The {@code Connection} object that this writer will use to make a * connection to the data source to which it will write data. * */ private transient Connection con; /** - * The SQL SELECT command that this writer will call - * internally. The method initSQLStatements builds this + * The SQL {@code SELECT} command that this writer will call + * internally. The method {@code initSQLStatements} builds this * command by supplying the words "SELECT" and "FROM," and using * metadata to get the table name and column names . * @@ -86,9 +86,9 @@ private String selectCmd; /** - * The SQL UPDATE command that this writer will call + * The SQL {@code UPDATE} command that this writer will call * internally to write data to the rowset's underlying data source. - * The method initSQLStatements builds this String + * The method {@code initSQLStatements} builds this {@code String} * object. * * @serial @@ -96,8 +96,8 @@ private String updateCmd; /** - * The SQL WHERE clause the writer will use for update - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for update + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -105,7 +105,7 @@ private String updateWhere; /** - * The SQL DELETE command that this writer will call + * The SQL {@code DELETE} command that this writer will call * internally to delete a row in the rowset's underlying data source. * * @serial @@ -113,8 +113,8 @@ private String deleteCmd; /** - * The SQL WHERE clause the writer will use for delete - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for delete + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -122,9 +122,9 @@ private String deleteWhere; /** - * The SQL INSERT INTO command that this writer will internally use + * The SQL {@code INSERT INTO} command that this writer will internally use * to insert data into the rowset's underlying data source. The method - * initSQLStatements builds this command with a question + * {@code initSQLStatements} builds this command with a question * mark parameter placeholder for each column in the rowset. * * @serial @@ -133,8 +133,8 @@ /** * An array containing the column numbers of the columns that are - * needed to uniquely identify a row in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * needed to uniquely identify a row in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ @@ -142,7 +142,7 @@ /** * An array of the parameters that should be used to set the parameter - * placeholders in a PreparedStatement object that this + * placeholders in a {@code PreparedStatement} object that this * writer will execute. * * @serial @@ -150,33 +150,33 @@ private Object[] params; /** - * The CachedRowSetReader object that has been - * set as the reader for the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code CachedRowSetReader} object that has been + * set as the reader for the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private CachedRowSetReader reader; /** - * The ResultSetMetaData object that contains information - * about the columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code ResultSetMetaData} object that contains information + * about the columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private ResultSetMetaData callerMd; /** - * The number of columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The number of columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private int callerColumnCount; /** - * This CachedRowSet will hold the conflicting values + * This {@code CachedRowSet} will hold the conflicting values * retrieved from the db and hold it. */ private CachedRowSetImpl crsResolve; @@ -209,8 +209,8 @@ } /** - * Propagates changes in the given RowSet object - * back to its underlying data source and returns true + * Propagates changes in the given {@code RowSet} object + * back to its underlying data source and returns {@code true} * if successful. The writer will check to see if * the data in the pre-modified rowset (the original values) differ * from the data in the underlying data source. If data in the data @@ -221,15 +221,15 @@ * access for concurrent users. * * This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. * - * Creates a CachedRowSet object from the given - * RowSet object + * Creates a {@code CachedRowSet} object from the given + * {@code RowSet} object * Makes a connection with the data source * * Disables autocommit mode if it is not already disabled @@ -237,32 +237,32 @@ * * Checks to see if the reader has read new data since the writer * was last called and, if so, calls the method - * initSQLStatements to initialize new SQL statements + * {@code initSQLStatements} to initialize new SQL statements * - * Builds new SELECT, UPDATE, - * INSERT, and DELETE statements - * Uses the CachedRowSet object's metadata to + * Builds new {@code SELECT}, {@code UPDATE}, + * {@code INSERT}, and {@code DELETE} statements + * Uses the {@code CachedRowSet} object's metadata to * determine the table name, column names, and the columns * that make up the primary key * * When there is no conflict, propagates changes made to the - * CachedRowSet object back to its underlying data source + * {@code CachedRowSet} object back to its underlying data source * - * Iterates through each row of the CachedRowSet object + * Iterates through each row of the {@code CachedRowSet} object * to determine whether it has been updated, inserted, or deleted * If the corresponding row in the data source has not been changed * since the rowset last read its * values, the writer will use the appropriate command to update, * insert, or delete the row * If any data in the data source does not match the original values - * for the CachedRowSet object, the writer will roll + * for the {@code CachedRowSet} object, the writer will roll * back any changes it has made to the row in the data source. * * * - * @return true if changes to the rowset were successfully + * @return {@code true} if changes to the rowset were successfully * written to the rowset's underlying data source; - * false otherwise + * {@code false} otherwise */ public boolean writeData(RowSetInternal caller) throws SQLException { long conflicts = 0; @@ -434,25 +434,25 @@ } //end writeData -/** - * Updates the given CachedRowSet object's underlying data - * source so that updates to the rowset are reflected in the original - * data source, and returns false if the update was successful. - * A return value of true indicates that there is a conflict, - * meaning that a value updated in the rowset has already been changed by - * someone else in the underlying data source. A conflict can also exist - * if, for example, more than one row in the data source would be affected - * by the update or if no rows would be affected. In any case, if there is - * a conflict, this method does not update the underlying data source. - * - * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + * + * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - * - * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + * + * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. * - * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - * - * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + * + * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. * * If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. * * The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. * * NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. * * This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. * - * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. * - * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. * * Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. * - * undoUpdateRowSet object backed by the same data as - * that of this CachedRowSetImpl object and sharing a set of cursors + * Returns a new {@code RowSet} object backed by the same data as + * that of this {@code CachedRowSetImpl} object and sharing a set of cursors * with it. This allows cursors to interate over a shared set of rows, providing * multiple views of the underlying data. * - * @return a RowSet object that is a copy of this CachedRowSetImpl + * @return a {@code RowSet} object that is a copy of this {@code CachedRowSetImpl} * object and shares a set of cursors with it * @throws SQLException if an error occurs or cloning is * not supported @@ -750,19 +750,19 @@ } /** - * Returns a new RowSet object containing by the same data - * as this CachedRowSetImpl object. This method - * differs from the method createCopy in that it throws a - * CloneNotSupportedException object instead of an - * SQLException object, as the method createShared - * does. This clone - * method is called internally by the method createShared, - * which catches the CloneNotSupportedException object - * and in turn throws a new SQLException object. + * Returns a new {@code RowSet} object containing by the same data + * as this {@code CachedRowSetImpl} object. This method + * differs from the method {@code createCopy} in that it throws a + * {@code CloneNotSupportedException} object instead of an + * {@code SQLException} object, as the method {@code createShared} + * does. This {@code clone} + * method is called internally by the method {@code createShared}, + * which catches the {@code CloneNotSupportedException} object + * and in turn throws a new {@code SQLException} object. * - * @return a copy of this CachedRowSetImpl object + * @return a copy of this {@code CachedRowSetImpl} object * @throws CloneNotSupportedException if an error occurs when - * attempting to clone this CachedRowSetImpl object + * attempting to clone this {@code CachedRowSetImpl} object * @see #createShared */ protected Object clone() throws CloneNotSupportedException { @@ -770,8 +770,8 @@ } /** - * Creates a RowSet object that is a deep copy of - * this CachedRowSetImpl object's data, including + * Creates a {@code RowSet} object that is a deep copy of + * this {@code CachedRowSetImpl} object's data, including * constraints. Updates made * on a copy are not visible to the original rowset; * a copy of a rowset is completely independent from the original. @@ -780,12 +780,12 @@ * from first principles, which can be quite expensive. * For example, it can eliminate the need to query a * remote database server. - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSet object and is - * completely independent from this CachedRowSetImpl + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSet} object and is + * completely independent from this {@code CachedRowSetImpl} * object. * @throws SQLException if an error occurs in generating the copy of this - * of the CachedRowSetImpl + * of the {@code CachedRowSetImpl} * @see #createShared * @see javax.sql.RowSetEvent * @see javax.sql.RowSetListener @@ -795,21 +795,21 @@ } /** - * Creates a RowSet object that is a copy of - * this CachedRowSetImpl object's table structure + * Creates a {@code RowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's table structure * and the constraints only. * There will be no data in the object being returned. * Updates made on a copy are not visible to the original rowset. * * This helps in getting the underlying XML schema which can - * be used as the basis for populating a WebRowSet. + * be used as the basis for populating a {@code WebRowSet}. * - * @return a new CachedRowSet object that is a copy - * of this CachedRowSetImpl object's schema and + * @return a new {@code CachedRowSet} object that is a copy + * of this {@code CachedRowSetImpl} object's schema and * retains all the constraints on the original rowset but contains * no data * @throws SQLException if an error occurs in generating the copy - * of the CachedRowSet object + * of the {@code CachedRowSet} object * @see #createShared * @see #createCopy * @see #createCopyNoConstraints @@ -821,17 +821,17 @@ } /** - * Creates a CachedRowSet object that is a copy of - * this CachedRowSetImpl object's data only. + * Creates a {@code CachedRowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's data only. * All constraints set in this object will not be there * in the returning object. Updates made * on a copy are not visible to the original rowset. * - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSetImpl object and is - * completely independent from this CachedRowSetImpl object + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSetImpl} object and is + * completely independent from this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the copy of the - * of the CachedRowSet + * of the {@code CachedRowSet} * @see #createShared * @see #createCopy * @see #createCopySchema @@ -843,15 +843,15 @@ } /** - * Converts this CachedRowSetImpl object to a collection - * of tables. The sample implementation utilitizes the TreeMap + * Converts this {@code CachedRowSetImpl} object to a collection + * of tables. The sample implementation utilitizes the {@code TreeMap} * collection type. * This class guarantees that the map will be in ascending key order, * sorted according to the natural order for the key's class. * - * @return a Collection object consisting of tables, + * @return a {@code Collection} object consisting of tables, * each of which is a copy of a row in this - * CachedRowSetImpl object + * {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the collection * @see #toCollection(int) * @see #toCollection(String) @@ -863,16 +863,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -886,16 +886,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -914,25 +914,25 @@ /** - * Returns the SyncProvider implementation being used - * with this CachedRowSetImpl implementation rowset. + * Returns the {@code SyncProvider} implementation being used + * with this {@code CachedRowSetImpl} implementation rowset. * * @return the SyncProvider used by the rowset. If not provider was * set when the rowset was instantiated, the reference * implementation (default) provider is returned. * @throws SQLException if error occurs while return the - * SyncProvider instance. + * {@code SyncProvider} instance. */ public SyncProvider getSyncProvider() throws SQLException { throw new UnsupportedOperationException(); } /** - * Sets the active SyncProvider and attempts to load - * load the new provider using the SyncFactory SPI. + * Sets the active {@code SyncProvider} and attempts to load + * load the new provider using the {@code SyncFactory} SPI. * * @throws SQLException if an error occurs while resetting the - * SyncProvider. + * {@code SyncProvider}. */ public void setSyncProvider(String providerStr) throws SQLException { throw new UnsupportedOperationException(); @@ -953,23 +953,23 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data. + * Populates this {@code CachedRowSetImpl} object with data. * This form of the method uses the rowset's user, password, and url or * data source name properties to create a database * connection. If properties that are needed * have not been set, this method will throw an exception. * - * Another form of this method uses an existing JDBC Connection + * Another form of this method uses an existing JDBC {@code Connection} * object instead of creating a new one; therefore, it ignores the * properties used for establishing a new connection. * * The query specified by the command property is executed to create a - * ResultSet object from which to retrieve data. + * {@code ResultSet} object from which to retrieve data. * The current contents of the rowset are discarded, and the * rowset's metadata is also (re)set. If there are outstanding updates, * they are also ignored. * - * The method execute closes any database connections that it + * The method {@code execute} closes any database connections that it * creates. * * @throws SQLException if an error occurs or the @@ -987,20 +987,20 @@ /** * Moves the cursor down one row from its current position and - * returns true if the new cursor position is a + * returns {@code true} if the new cursor position is a * valid row. - * The cursor for a new ResultSet object is initially + * The cursor for a new {@code ResultSet} object is initially * positioned before the first row. The first call to the method - * next moves the cursor to the first row, making it + * {@code next} moves the cursor to the first row, making it * the current row; the second call makes the second row the * current row, and so on. * * If an input stream from the previous row is open, it is - * implicitly closed. The ResultSet object's warning + * implicitly closed. The {@code ResultSet} object's warning * chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if an error occurs or * the cursor is not positioned in the rowset, before * the first row, or after the last row @@ -1010,9 +1010,9 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the next - * row and returns true if the cursor is still in the rowset; - * returns false if the cursor has moved to the position after + * Moves this {@code CachedRowSetImpl} object's cursor to the next + * row and returns {@code true} if the cursor is still in the rowset; + * returns {@code false} if the cursor has moved to the position after * the last row. * * This method handles the cases where the cursor moves to a row that @@ -1021,15 +1021,15 @@ * that has been deleted, this method moves the cursor to the next * row until the cursor is on a row that has not been deleted. * - * The method internalNext is called by methods such as - * next, absolute, and relative, + * The method {@code internalNext} is called by methods such as + * {@code next}, {@code absolute}, and {@code relative}, * and, as its name implies, is only called internally. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a valid row in this - * rowset; false if it is after the last row + * @return {@code true} if the cursor is on a valid row in this + * rowset; {@code false} if it is after the last row * @throws SQLException if an error occurs */ protected boolean internalNext() throws SQLException { @@ -1037,25 +1037,25 @@ } /** - * Closes this CachedRowSetImpl objecy and releases any resources + * Closes this {@code CachedRowSetImpl} objecy and releases any resources * it was using. * * @throws SQLException if an error occurs when releasing any resources in use - * by this CachedRowSetImpl object + * by this {@code CachedRowSetImpl} object */ public void close() throws SQLException { throw new UnsupportedOperationException(); } /** - * Reports whether the last column read was SQL NULL. - * Note that you must first call the method getXXX + * Reports whether the last column read was SQL {@code NULL}. + * Note that you must first call the method {@code getXXX} * on a column to try to read its value and then call the method - * wasNull to determine whether the value was - * SQL NULL. + * {@code wasNull} to determine whether the value was + * SQL {@code NULL}. * - * @return true if the value in the last column read - * was SQL NULL; false otherwise + * @return {@code true} if the value in the last column read + * was SQL {@code NULL}; {@code false} otherwise * @throws SQLException if an error occurs */ public boolean wasNull() throws SQLException { @@ -1064,9 +1064,9 @@ /** * Returns the insert row or the current row of this - * CachedRowSetImplobject. + * {@code CachedRowSetImpl}object. * - * @return the Row object on which this CachedRowSetImpl + * @return the {@code Row} object on which this {@code CachedRowSetImpl} * objects's cursor is positioned */ protected BaseRow getCurrentRow() { @@ -1077,7 +1077,7 @@ * Removes the row on which the cursor is positioned. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * * @throws SQLException if the cursor is positioned on the insert * row @@ -1089,20 +1089,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * String object. + * of this {@code CachedRowSetImpl} object as a + * {@code String} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} {@code CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type designates the * recommended return type. */ public String getString(int columnIndex) throws SQLException { @@ -1111,18 +1111,18 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * boolean value. + * of this {@code CachedRowSetImpl} object as a + * {@code boolean} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a boolean in the Java progamming language; - * if the value is SQL NULL, the result is false + * @return the column value as a {@code boolean} in the Java progamming language; + * if the value is SQL {@code NULL}, the result is {@code false} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BOOLEAN value + * SQL {@code BOOLEAN} value * @see #getBoolean(String) */ public boolean getBoolean(int columnIndex) throws SQLException { @@ -1131,20 +1131,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type + * SQL {@code TINYINT}, {@code SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type * designates the recommended return type. * @see #getByte(String) */ @@ -1154,21 +1154,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * short value. + * of this {@code CachedRowSetImpl} object as a + * {@code short} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT}, {@code SMALLINT}, + * {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(String) */ public short getShort(int columnIndex) throws SQLException { @@ -1177,21 +1178,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * int value. + * of this {@code CachedRowSetImpl} object as an + * {@code int} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1199,21 +1201,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * long value. + * of this {@code CachedRowSetImpl} object as a + * {@code long} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getLong(String) */ public long getLong(int columnIndex) throws SQLException { @@ -1222,21 +1225,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * float value. + * of this {@code CachedRowSetImpl} object as a + * {@code float} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,} + * {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC, + * BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(int columnIndex) throws SQLException { @@ -1245,21 +1248,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * double value. + * of this {@code CachedRowSetImpl} object as a + * {@code double} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,} + * {@code FLOAT, DOUBLE}, + * {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getDouble(String) * */ @@ -1269,21 +1273,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * This method is deprecated; use the version of getBigDecimal + * This method is deprecated; use the version of {@code getBigDecimal} * that does not take a scale parameter and returns a value with full * precision. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @param scale the number of digits to the right of the decimal point in the * value returned * @return the column value with the specified number of digits to the right - * of the decimal point; if the value is SQL NULL, the - * result is null + * of the decimal point; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails * @deprecated @@ -1295,22 +1299,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte array value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} array value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the - * result is null + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the + * result is {@code null} * * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or + * {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getBytes(String) */ public byte[] getBytes(int columnIndex) throws SQLException { @@ -1319,17 +1323,17 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Date object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Date} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a java.sql.Data object; if - * the value is SQL NULL, the - * result is null + * @return the column value as a {@code java.sql.Data} object; if + * the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, - * the cursor is not on a valid row, or this method fails + * the cursor is not on a valid row, or this method fails */ public java.sql.Date getDate(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1337,14 +1341,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Time object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Time} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1354,14 +1358,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1371,33 +1375,33 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The JDBC + * suitable for retrieving large {@code LONGVARCHAR} values. The JDBC * driver will do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. . Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(String) */ public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException { @@ -1416,8 +1420,8 @@ * stream may return 0 for available() whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of two byte Unicode characters. If the value is SQL NULL @@ -1432,30 +1436,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for - * CachedRowSetImpl.available() whether there is data + * stream may return {@code 0} for + * {@code CachedRowSetImpl.available()} whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes. If the value is SQL NULL - * then the result is null. + * as a stream of uninterpreted bytes. If the value is SQL {@code NULL} + * then the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY}. * The bold type indicates the SQL type that this method is recommened * to retrieve. * @see #getBinaryStream(String) @@ -1472,19 +1476,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a String object. + * of the current row as a {@code String} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR< value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} + * {@code CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. */ public String getString(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1492,17 +1496,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a boolean value. + * of the current row as a {@code boolean} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a boolean in the Java programming - * language; if the value is SQL NULL, - * the result is false + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code boolean} in the Java programming + * language; if the value is SQL {@code NULL}, + * the result is {@code false} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BOOLEAN value + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BOOLEAN} value * @see #getBoolean(int) */ public boolean getBoolean(String columnName) throws SQLException { @@ -1511,19 +1515,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte value. + * of the current row as a {@code byte} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The - * bold type designates the recommended return type + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT}, + * {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} + * value. The bold type designates the recommended return type. */ public byte getByte(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1531,19 +1535,20 @@ /** * Retrieves the value stored in the designated column - * of the current row as a short value. + * of the current row as a {@code short} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT,} + * {@code SMALLINT}, {@code INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(int) */ public short getShort(String columnName) throws SQLException { @@ -1552,20 +1557,21 @@ /** * Retrieves the value stored in the designated column - * of the current row as an int value. + * of the current row as an {@code int} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name - * of a column in this rowset, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * of a column in this rowset, + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1573,19 +1579,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a long value. + * of the current row as a {@code long} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getLong(int) */ public long getLong(String columnName) throws SQLException { @@ -1594,19 +1600,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a float value. + * of the current row as a {@code float} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT,} {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(String columnName) throws SQLException { @@ -1615,20 +1621,20 @@ /** * Retrieves the value stored in the designated column - * of the current row of this CachedRowSetImpl object - * as a double value. + * of the current row of this {@code CachedRowSetImpl} object + * as a {@code double} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return types. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL,} {@code FLOAT, DOUBLE}, {@code DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return types. * @see #getDouble(int) */ public double getDouble(String columnName) throws SQLException { @@ -1637,22 +1643,22 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.math.BigDecimal object. + * of the current row as a {@code java.math.BigDecimal} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @param scale the number of digits to the right of the decimal point - * @return a java.math.BugDecimal object with scale - * number of digits to the right of the decimal point. + * @return a java.math.BugDecimal object with {@code scale} + * number of digits to the right of the decimal point. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve. - * @deprecated Use the getBigDecimal(String columnName) + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. + * @deprecated Use the {@code getBigDecimal(String columnName)} * method instead */ @Deprecated @@ -1662,19 +1668,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte array. + * of the current row as a {@code byte} array. * The bytes represent the raw values returned by the driver. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BINARY, VARBINARY - * or LONGVARBINARY values - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BINARY, VARBINARY} + * or {@code LONGVARBINARY} values. + * The bold SQL type designates the recommended return type. * @see #getBytes(int) */ public byte[] getBytes(String columnName) throws SQLException { @@ -1683,17 +1689,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Date object. + * of the current row as a {@code java.sql.Date} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1701,12 +1707,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Time object. + * of the current row as a {@code java.sql.Time} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1717,12 +1723,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Timestamp object. + * of the current row as a {@code java.sql.Timestamp} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1733,32 +1739,32 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The - * SyncProvider will rely on the JDBC driver to do any necessary + * suitable for retrieving large {@code LONGVARCHAR} values. The + * {@code SyncProvider} will rely on the JDBC driver to do any necessary * conversion from the database format into ASCII format. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * a column in this rowset + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(int) */ public java.io.InputStream getAsciiStream(String columnName) throws SQLException { @@ -1769,23 +1775,23 @@ /** * A column value can be retrieved as a stream of Unicode characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will do any necessary conversion from the database * format into Unicode. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row - * @deprecated use the method getCharacterStream instead + * @deprecated use the method {@code getCharacterStream} instead */ @Deprecated public java.io.InputStream getUnicodeStream(String columnName) throws SQLException { @@ -1794,30 +1800,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of uninterpreted bytes. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is unknown, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY - * The bold type indicates the SQL type that this method is recommened - * to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY} + * The bold type indicates the SQL type that this method is recommened + * to retrieve. * @see #getBinaryStream(int) * */ @@ -1831,17 +1837,17 @@ //===================================================================== /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by statement + * by {@code ResultSet} methods. Any warning caused by statement * methods (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * * @return the first SQLWarning or null */ @@ -1850,10 +1856,10 @@ } /** - * Clears all the warnings reporeted for the CachedRowSetImpl - * object. After a call to this method, the getWarnings method - * returns null until a new warning is reported for this - * CachedRowSetImpl object. + * Clears all the warnings reporeted for the {@code CachedRowSetImpl} + * object. After a call to this method, the {@code getWarnings} method + * returns {@code null} until a new warning is reported for this + * {@code CachedRowSetImpl} object. */ public void clearWarnings() { throw new UnsupportedOperationException(); @@ -1861,25 +1867,25 @@ /** * Retrieves the name of the SQL cursor used by this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * * In SQL, a result table is retrieved through a cursor that is - * named. The current row of a ResultSet can be updated or deleted + * named. The current row of a {@code ResultSet} can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To ensure that the cursor has the proper isolation - * level to support an update operation, the cursor's SELECT - * statement should be of the form select for update. - * If the for update clause + * level to support an update operation, the cursor's {@code SELECT} + * statement should be of the form {@code select for update}. + * If the {@code for update} clause * is omitted, positioned updates may fail. * * JDBC supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. The current row + * SQL cursor used by a {@code ResultSet} object. The current row * of a result set is also the current row of this SQL cursor. * * Note: If positioned updates are not supported, an - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL cursor name for this CachedRowSetImpl object's + * @return the SQL cursor name for this {@code CachedRowSetImpl} object's * cursor * @throws SQLException if an error occurs */ @@ -1888,12 +1894,12 @@ } /** - * Retrieves a ResultSetMetaData object instance that - * contains information about the CachedRowSet object. + * Retrieves a {@code ResultSetMetaData} object instance that + * contains information about the {@code CachedRowSet} object. * However, applications should cast the returned object to a - * RowSetMetaData interface implementation. In the + * {@code RowSetMetaData} interface implementation. In the * reference implementation, this cast can be done on the - * RowSetMetaDataImpl class. + * {@code RowSetMetaDataImpl} class. * * For example: * @@ -1907,10 +1913,10 @@ * crs.setMetaData(metaData); * * - * @return the ResultSetMetaData object that describes this - * CachedRowSetImpl object's columns + * @return the {@code ResultSetMetaData} object that describes this + * {@code CachedRowSetImpl} object's columns * @throws SQLException if an error occurs in generating the RowSet - * meta data; or if the CachedRowSetImpl is empty. + * meta data; or if the {@code CachedRowSetImpl} is empty. * @see javax.sql.RowSetMetaData */ public ResultSetMetaData getMetaData() throws SQLException { @@ -1920,10 +1926,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1931,23 +1937,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes in the Java programming language. * When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(String) */ public Object getObject(int columnIndex) throws SQLException { @@ -1956,10 +1962,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1967,23 +1973,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes * in the Java programming language. When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name does not match one of * this rowset's column names, (2) the cursor is not * on a valid row, or (3) there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(int) */ public Object getObject(String columnName) throws SQLException { @@ -1993,10 +1999,10 @@ //---------------------------------------------------------------- /** - * Maps the given column name for one of this CachedRowSetImpl + * Maps the given column name for one of this {@code CachedRowSetImpl} * object's columns to its column number. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @return the column index of the given column name * @throws SQLException if the given column name does not match one @@ -2014,25 +2020,25 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java character stream that delivers the database column value * as a stream of two-byte unicode characters in a - * java.io.Reader object. If the value is - * SQL NULL, the result is null. + * {@code java.io.Reader} object. If the value is + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR,} {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getCharacterStream(String) */ public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{ @@ -2041,23 +2047,24 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY or LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code CHAR, VARCHAR,} + * {@code LONGVARCHAR}, + * {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -2065,21 +2072,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return types that this method is used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return types that this method is used to retrieve. * @see #getBigDecimal(String) */ public BigDecimal getBigDecimal(int columnIndex) throws SQLException { @@ -2088,21 +2096,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. * @see #getBigDecimal(int) */ public BigDecimal getBigDecimal(String columnName) throws SQLException { @@ -2114,7 +2122,7 @@ //--------------------------------------------------------------------- /** - * Returns the number of rows in this CachedRowSetImpl object. + * Returns the number of rows in this {@code CachedRowSetImpl} object. * * @return number of rows in the rowset */ @@ -2124,10 +2132,10 @@ /** * Indicates whether the cursor is before the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is before the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isBeforeFirst() throws SQLException { @@ -2136,10 +2144,10 @@ /** * Indicates whether the cursor is after the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is after the last row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isAfterLast() throws SQLException { @@ -2148,10 +2156,10 @@ /** * Indicates whether the cursor is on the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is on the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isFirst() throws SQLException { @@ -2160,14 +2168,14 @@ /** * Indicates whether the cursor is on the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * Note: Calling the method isLast may be expensive + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver might need to fetch ahead one row in order * to determine whether the current row is the last row in this rowset. * - * @return true if the cursor is on the last row; - * false otherwise or if this rowset contains no rows + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise or if this rowset contains no rows * @throws SQLException if an error occurs */ public boolean isLast() throws SQLException { @@ -2175,19 +2183,19 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the front of + * Moves this {@code CachedRowSetImpl} object's cursor to the front of * the rowset, just before the first row. This method has no effect if * this rowset contains no rows. * * @throws SQLException if an error occurs or the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public void beforeFirst() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the end of + * Moves this {@code CachedRowSetImpl} object's cursor to the end of * the rowset, just after the last row. This method has no effect if * this rowset contains no rows. * @@ -2198,34 +2206,34 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the first row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the first row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean first() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the first - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the first + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the methods first, - * isFirst, and absolute. - * It in turn calls the method internalNext in order to + * This method is called internally by the methods {@code first}, + * {@code isFirst}, and {@code absolute}. + * It in turn calls the method {@code internalNext} in order to * handle the case where the first row is a deleted row that is not visible. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the first row; - * false otherwise + * @return {@code true} if the cursor moved to the first row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalFirst() throws SQLException { @@ -2233,35 +2241,35 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the last row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the last row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean last() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the last - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the last + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the method last + * This method is called internally by the method {@code last} * when rows have been deleted and the deletions are not visible. - * The method internalLast handles the case where the + * The method {@code internalLast} handles the case where the * last row is a deleted row that is not visible by in turn calling - * the method internalPrevious. + * the method {@code internalPrevious}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the last row; - * false otherwise + * @return {@code true} if the cursor moved to the last row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalLast() throws SQLException { @@ -2269,12 +2277,12 @@ } /** - * Returns the number of the current row in this CachedRowSetImpl + * Returns the number of the current row in this {@code CachedRowSetImpl} * object. The first row is number 1, the second number 2, and so on. * - * @return the number of the current row; 0 if there is no + * @return the number of the current row; {@code 0} if there is no * current row - * @throws SQLException if an error occurs; or if the CacheRowSetImpl + * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl} * is empty */ public int getRow() throws SQLException { @@ -2282,51 +2290,51 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the row number + * Moves this {@code CachedRowSetImpl} object's cursor to the row number * specified. * * If the number is positive, the cursor moves to an absolute row with * respect to the beginning of the rowset. The first row is row 1, the second * is row 2, and so on. For example, the following command, in which - * crs is a CachedRowSetImpl object, moves the cursor + * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor * to the fourth row, starting from the beginning of the rowset. - * + * {@code * * crs.absolute(4); * - * + * } * * If the number is negative, the cursor moves to an absolute row position * with respect to the end of the rowset. For example, calling - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row, counting * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. * * @param row a positive number to indicate the row, starting row numbering from - * the first row, which is 1; a negative number to indicate + * the first row, which is {@code 1}; a negative number to indicate * the row, starting row numbering from the last row, which is - * -1; it must not be 0 - * @return true if the cursor is on the rowset; false + * {@code -1}; it must not be {@code 0} + * @return {@code true} if the cursor is on the rowset; {@code false} * otherwise - * @throws SQLException if the given cursor position is 0 or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * @throws SQLException if the given cursor position is {@code 0} or the + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean absolute( int row ) throws SQLException { throw new UnsupportedOperationException(); @@ -2340,80 +2348,80 @@ * If the number is positive, the cursor moves the specified number of * rows toward the end of the rowset, starting at the current row. * For example, the following command, in which - * crs is a CachedRowSetImpl object with 100 rows, + * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows, * moves the cursor forward four rows from the current row. If the * current row is 50, the cursor would move to row 54. - * + * {@code * * crs.relative(4); * - * + * } * * If the number is negative, the cursor moves back toward the beginning * the specified number of rows, starting at the current row. * For example, calling the method - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. In both cases, this method - * throws an SQLException. + * throws an {@code SQLException}. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). Calling relative(0) + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. Calling {@code relative(0)} * is valid, but it does not change the cursor position. * - * @param rows an int indicating the number of rows to move + * @param rows an {@code int} indicating the number of rows to move * the cursor, starting at the current row; a positive number * moves the cursor forward; a negative number moves the cursor * backward; must not move the cursor past the valid * rows - * @return true if the cursor is on a row in this - * CachedRowSetImpl object; false + * @return {@code true} if the cursor is on a row in this + * {@code CachedRowSetImpl} object; {@code false} * otherwise * @throws SQLException if there are no rows in this rowset, the cursor is * positioned either before the first row or after the last row, or - * the rowset is type ResultSet.TYPE_FORWARD_ONLY + * the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean relative(int rows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the - * previous row and returns true if the cursor is on - * a valid row or false if it is not. + * Moves this {@code CachedRowSetImpl} object's cursor to the + * previous row and returns {@code true} if the cursor is on + * a valid row or {@code false} if it is not. * This method also notifies all listeners registered with this - * CachedRowSetImpl object that its cursor has moved. + * {@code CachedRowSetImpl} object that its cursor has moved. * - * Note: calling the method previous() is not the same - * as calling the method relative(-1). This is true - * because it is possible to call previous() from the insert + * Note: calling the method {@code previous()} is not the same + * as calling the method {@code relative(-1)}. This is true + * because it is possible to call {@code previous()} from the insert * row, from after the last row, or from the current row, whereas - * relative may only be called from the current row. + * {@code relative} may only be called from the current row. * - * The method previous may used in a while + * The method {@code previous} may used in a {@code while} * loop to iterate through a rowset starting after the last row - * and moving toward the beginning. The loop ends when previous - * returns false, meaning that there are no more rows. + * and moving toward the beginning. The loop ends when {@code previous} + * returns {@code false}, meaning that there are no more rows. * For example, the following code fragment retrieves all the data in - * the CachedRowSetImpl object crs, which has + * the {@code CachedRowSetImpl} object {@code crs}, which has * three columns. Note that the cursor must initially be positioned * after the last row so that the first call to the method - * previous places the cursor on the last line. - * + * {@code previous} places the cursor on the last line. + * {@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - * - * This method throws an SQLException if the cursor is not + * } + * This method throws an {@code SQLException} if the cursor is not * on a row in the rowset, before the first row, or after the last row. * - * @return true if the cursor is on a valid row; - * false if it is before the first row or after the + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is before the first row or after the * last row * @throws SQLException if the cursor is not on a valid position or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean previous() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor to the previous row in this CachedRowSetImpl + * Moves the cursor to the previous row in this {@code CachedRowSetImpl} * object, skipping past deleted rows that are not visible; returns - * true if the cursor is on a row in this rowset and - * false when the cursor goes before the first row. + * {@code true} if the cursor is on a row in this rowset and + * {@code false} when the cursor goes before the first row. * - * This method is called internally by the method previous. + * This method is called internally by the method {@code previous}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a row in this rowset; - * false when the cursor reaches the position before + * @return {@code true} if the cursor is on a row in this rowset; + * {@code false} when the cursor reaches the position before * the first row * @throws SQLException if an error occurs */ @@ -2463,14 +2471,14 @@ //--------------------------------------------------------------------- /** - * Indicates whether the current row of this CachedRowSetImpl + * Indicates whether the current row of this {@code CachedRowSetImpl} * object has been updated. The value returned - * depends on whether this rowset can detect updates: false + * depends on whether this rowset can detect updates: {@code false} * will always be returned if it does not detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another and updates are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2482,13 +2490,13 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * * @param idx the index identifier of the column that may be have been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2500,14 +2508,14 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * - * @param columnName the String column name column that may be have + * @param columnName the {@code String} column name column that may be have * been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2521,8 +2529,8 @@ * Indicates whether the current row has been inserted. The value returned * depends on whether or not the rowset can detect visible inserts. * - * @return true if a row has been inserted and inserts are detected; - * false otherwise + * @return {@code true} if a row has been inserted and inserts are detected; + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2536,12 +2544,12 @@ * Indicates whether the current row has been deleted. A deleted row * may leave a visible "hole" in a rowset. This method can be used to * detect such holes if the rowset can detect deletions. This method - * will always return false if this rowset cannot detect + * will always return {@code false} if this rowset cannot detect * deletions. * - * @return true if (1)the current row is blank, indicating that + * @return {@code true} if (1)the current row is blank, indicating that * the row has been deleted, and (2)deletions are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on a valid row in this rowset * @see DatabaseMetaData#deletesAreDetected */ @@ -2551,8 +2559,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset; however, another method must be called to complete @@ -2565,15 +2573,15 @@ * * In order to propagate updates in this rowset to the underlying * data source, an application must call the method {@link #acceptChanges} - * after it calls either updateRow or insertRow. + * after it calls either {@code updateRow} or {@code insertRow}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -2581,8 +2589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2593,14 +2601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(int columnIndex, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -2608,8 +2616,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2620,14 +2628,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(int columnIndex, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -2635,8 +2643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2647,14 +2655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(int columnIndex, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -2662,8 +2670,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2674,14 +2682,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(int columnIndex, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -2689,8 +2697,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2701,14 +2709,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(int columnIndex, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -2717,8 +2725,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2729,14 +2737,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(int columnIndex, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -2744,8 +2752,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2756,14 +2764,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(int columnIndex, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -2771,8 +2779,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2783,14 +2791,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -2798,8 +2806,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2810,17 +2818,17 @@ * as inserted. Both of these methods must be called before the * cursor moves to another row. * - * The method acceptChanges must be called if the + * The method {@code acceptChanges} must be called if the * updated values are to be written back to the underlying database. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(int columnIndex, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -2828,8 +2836,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2840,14 +2848,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(int columnIndex, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -2855,8 +2863,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2867,15 +2875,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(int columnIndex, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -2883,8 +2891,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2895,15 +2903,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL TIME or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code TIME} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(int columnIndex, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -2911,8 +2919,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2923,16 +2931,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE, TIME, or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE}, {@code TIME}, or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -2940,7 +2948,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -2952,8 +2960,8 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -2965,8 +2973,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2977,17 +2985,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not binary, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException { throw new UnsupportedOperationException(); @@ -2995,8 +3003,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3007,19 +3015,19 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.Reader - * containing BINARY, VARBINARY, - * LONGVARBINARY, CHAR, VARCHAR, - * or LONGVARCHAR data + * @param x the new column value; must be a {@code java.io.Reader} + * containing {@code BINARY}, {@code VARBINARY}, + * {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR}, + * or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not a binary or * character type, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3027,11 +3035,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter indicates + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter indicates * the number of digits to the right of the decimal point and is ignored * if the new column value is not a type that will be mapped to an SQL - * DECIMAL or NUMERIC value. + * {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3042,16 +3050,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3059,8 +3067,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3071,14 +3079,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x) throws SQLException { throw new UnsupportedOperationException(); @@ -3087,8 +3095,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3098,12 +3106,12 @@ * must be called, which will insert the new row into both this rowset * and the database. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -3111,8 +3119,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3123,13 +3131,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(String columnName, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -3137,8 +3145,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3149,13 +3157,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(String columnName, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -3163,8 +3171,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3175,13 +3183,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(String columnName, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -3189,8 +3197,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3201,13 +3209,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(String columnName, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -3215,8 +3223,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3227,13 +3235,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(String columnName, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -3241,8 +3249,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3253,13 +3261,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(String columnName, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -3267,8 +3275,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3279,13 +3287,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(String columnName, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -3293,8 +3301,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3305,13 +3313,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -3319,8 +3327,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3331,13 +3339,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(String columnName, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -3345,8 +3353,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3357,13 +3365,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(String columnName, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -3371,8 +3379,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3383,15 +3391,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(String columnName, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -3399,8 +3407,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3411,15 +3419,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL TIME or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code TIME} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(String columnName, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -3427,8 +3435,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3439,7 +3447,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if the given column index is out of bounds or @@ -3448,9 +3456,9 @@ * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE, - * TIME, or TIMESTAMP, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP}, or (4) this + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -3458,7 +3466,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -3470,7 +3478,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -3483,8 +3491,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3495,17 +3503,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not binary, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3513,8 +3521,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3525,18 +3533,18 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param reader the new column value; must be a - * java.io.Reader containing BINARY, - * VARBINARY, LONGVARBINARY, CHAR, - * VARCHAR, or LONGVARCHAR data + * {@code java.io.Reader} containing {@code BINARY}, + * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR}, + * {@code VARCHAR}, or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not a binary or character type, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(String columnName, java.io.Reader reader, @@ -3546,11 +3554,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter * indicates the number of digits to the right of the decimal point * and is ignored if the new column value is not a type that will be - * mapped to an SQL DECIMAL or NUMERIC value. + * mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3561,15 +3569,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3577,8 +3585,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3589,20 +3597,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x) throws SQLException { throw new UnsupportedOperationException(); } /** - * Inserts the contents of this CachedRowSetImpl object's insert + * Inserts the contents of this {@code CachedRowSetImpl} object's insert * row into this rowset immediately following the current row. * If the current row is the * position after the last row or before the first row, the new row will @@ -3614,14 +3622,14 @@ * @throws SQLException if (1) the cursor is not on the insert row, * (2) one or more of the non-nullable columns in the insert * row has not been given a value, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void insertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Marks the current row of this CachedRowSetImpl object as + * Marks the current row of this {@code CachedRowSetImpl} object as * updated and notifies listeners registered with this rowset that the * row has changed. * @@ -3631,26 +3639,26 @@ * and the updates made before the cursor moved will be lost. * * @throws SQLException if the cursor is on the insert row or this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Deletes the current row from this CachedRowSetImpl object and + * Deletes the current row from this {@code CachedRowSetImpl} object and * notifies listeners registered with this rowset that a row has changed. * This method cannot be called when the cursor is on the insert row. * * This method marks the current row as deleted, but it does not delete * the row from the underlying data source. The method - * acceptChanges must be called to delete the row in + * {@code acceptChanges} must be called to delete the row in * the data source. * * @throws SQLException if (1) this method is called when the cursor * is on the insert row, before the first row, or after the * last row or (2) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void deleteRow() throws SQLException { throw new UnsupportedOperationException(); @@ -3659,7 +3667,7 @@ /** * Sets the current row with its original value and marks the row as * not updated, thus undoing any changes made to the row since the - * last call to the methods updateRow or deleteRow. + * last call to the methods {@code updateRow} or {@code deleteRow}. * This method should be called only when the cursor is on a row in * this rowset. * @@ -3672,11 +3680,11 @@ /** * Rolls back any updates made to the current row of this - * CachedRowSetImpl object and notifies listeners that + * {@code CachedRowSetImpl} object and notifies listeners that * a row has changed. To have an effect, this method - * must be called after an updateXXX method has been - * called and before the method updateRow has been called. - * If no updates have been made or the method updateRow + * must be called after an {@code updateXXX} method has been + * called and before the method {@code updateRow} has been called. + * If no updates have been made or the method {@code updateRow} * has already been called, this method has no effect. * * @throws SQLException if the cursor is on the insert row, before the @@ -3687,39 +3695,39 @@ } /** - * Moves the cursor for this CachedRowSetImpl object + * Moves the cursor for this {@code CachedRowSetImpl} object * to the insert row. The current row in the rowset is remembered * while the cursor is on the insert row. * * The insert row is a special row associated with an updatable * rowset. It is essentially a buffer where a new row may - * be constructed by calling the appropriate updateXXX + * be constructed by calling the appropriate {@code updateXXX} * methods to assign a value to each column in the row. A complete * row must be constructed; that is, every column that is not nullable * must be assigned a value. In order for the new row to become part - * of this rowset, the method insertRow must be called + * of this rowset, the method {@code insertRow} must be called * before the cursor is moved back to the rowset. * * Only certain methods may be invoked while the cursor is on the insert * row; many methods throw an exception if they are called while the - * cursor is there. In addition to the updateXXX - * and insertRow methods, only the getXXX methods - * may be called when the cursor is on the insert row. A getXXX - * method should be called on a column only after an updateXXX + * cursor is there. In addition to the {@code updateXXX} + * and {@code insertRow} methods, only the {@code getXXX} methods + * may be called when the cursor is on the insert row. A {@code getXXX} + * method should be called on a column only after an {@code updateXXX} * method has been called on that column; otherwise, the value returned is * undetermined. * - * @throws SQLException if this CachedRowSetImpl object is - * ResultSet.CONCUR_READ_ONLY + * @throws SQLException if this {@code CachedRowSetImpl} object is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void moveToInsertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor for this CachedRowSetImpl object to + * Moves the cursor for this {@code CachedRowSetImpl} object to * the current row. The current row is the row the cursor was on - * when the method moveToInsertRow was called. + * when the method {@code moveToInsertRow} was called. * * Calling this method has no effect unless it is called while the * cursor is on the insert row. @@ -3731,9 +3739,9 @@ } /** - * Returns null. + * Returns {@code null}. * - * @return null + * @return {@code null} * @throws SQLException if an error occurs */ public Statement getStatement() throws SQLException { @@ -3742,18 +3750,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column index is out of bounds or * the cursor is not on one of this rowset's rows or its * insert row @@ -3767,17 +3775,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL REF value + * SQL {@code REF} value * @see #getRef(String) */ public Ref getRef(int columnIndex) throws SQLException { @@ -3786,17 +3794,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BLOB value + * SQL {@code BLOB} value * @see #getBlob(String) */ public Blob getBlob(int columnIndex) throws SQLException { @@ -3805,17 +3813,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Clob object representing an SQL CLOB value + * @return a {@code Clob} object representing an SQL {@code CLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL CLOB value + * SQL {@code CLOB} value * @see #getClob(String) */ public Clob getClob(int columnIndex) throws SQLException { @@ -3824,18 +3832,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL ARRAY value + * SQL {@code ARRAY} value * @see #getArray(String) */ public Array getArray(int columnIndex) throws SQLException { @@ -3844,17 +3852,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column name is not the name of * a column in this rowset or the cursor is not on one of * this rowset's rows or its insert row @@ -3867,16 +3875,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the column value - * is not an SQL REF value + * is not an SQL {@code REF} value * @see #getRef(int) */ public Ref getRef(String colName) throws SQLException { @@ -3885,16 +3893,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BLOB value + * column does not store an SQL {@code BLOB} value * @see #getBlob(int) */ public Blob getBlob(String colName) throws SQLException { @@ -3903,17 +3911,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Clob object representing an SQL - * CLOB value + * @return a {@code Clob} object representing an SQL + * {@code CLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CLOB value + * column does not store an SQL {@code CLOB} value * @see #getClob(int) */ public Clob getClob(String colName) throws SQLException { @@ -3922,17 +3930,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming langugage. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL ARRAY value + * column does not store an SQL {@code ARRAY} value * @see #getArray(int) */ public Array getArray(String colName) throws SQLException { @@ -3941,22 +3949,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3964,21 +3972,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3986,22 +3994,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4009,21 +4017,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4031,22 +4039,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Timestamp - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4054,22 +4062,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object, using the given - * Calendar object to construct an appropriate + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object, using the given + * {@code Calendar} object to construct an appropriate * millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE, - * TIME, or TIMESTAMP value + * column does not store an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4080,13 +4088,13 @@ */ /** - * Retrieves the Connection object passed to this - * CachedRowSetImpl object. This connection may be + * Retrieves the {@code Connection} object passed to this + * {@code CachedRowSetImpl} object. This connection may be * used to populate this rowset with data or to write data back * to its underlying data source. * - * @return the Connection object passed to this rowset; - * may be null if there is no connection + * @return the {@code Connection} object passed to this rowset; + * may be {@code null} if there is no connection * @throws SQLException if an error occurs */ public Connection getConnection() throws SQLException{ @@ -4094,10 +4102,10 @@ } /** - * Sets the metadata for this CachedRowSetImpl object - * with the given RowSetMetaData object. + * Sets the metadata for this {@code CachedRowSetImpl} object + * with the given {@code RowSetMetaData} object. * - * @param md a RowSetMetaData object instance containing + * @param md a {@code RowSetMetaData} object instance containing * metadata about the columsn in the rowset * @throws SQLException if invalid meta data is supplied to the * rowset @@ -4108,17 +4116,17 @@ /** * Returns a result set containing the original value of the rowset. The - * original value is the state of the CachedRowSetImpl after the + * original value is the state of the {@code CachedRowSetImpl} after the * last population or synchronization (whichever occurred most recently) with * the data source. * * The cursor is positioned before the first row in the result set. - * Only rows contained in the result set returned by getOriginal() + * Only rows contained in the result set returned by {@code getOriginal()} * are said to have an original value. * * @return the original result set of the rowset * @throws SQLException if an error occurs produce the - * ResultSet object + * {@code ResultSet} object */ public ResultSet getOriginal() throws SQLException { throw new UnsupportedOperationException(); @@ -4127,7 +4135,7 @@ /** * Returns a result set containing the original value of the current * row only. - * The original value is the state of the CachedRowSetImpl after + * The original value is the state of the {@code CachedRowSetImpl} after * the last population or synchronization (whichever occurred most recently) * with the data source. * @@ -4153,7 +4161,7 @@ /** * Marks all rows in this rowset as being original rows. Any updates * made to the rows become the original values for the rowset. - * Calls to the method setOriginal connot be reversed. + * Calls to the method {@code setOriginal} connot be reversed. * * @throws SQLException if an error occurs */ @@ -4165,8 +4173,8 @@ * Returns an identifier for the object (table) that was used to create this * rowset. * - * @return a String object that identifies the table from - * which this CachedRowSetImpl object was derived + * @return a {@code String} object that identifies the table from + * which this {@code CachedRowSetImpl} object was derived * @throws SQLException if an error occurs */ public String getTableName() throws SQLException { @@ -4177,8 +4185,8 @@ * Sets the identifier for the table from which this rowset was derived * to the given table name. * - * @param tabName a String object that identifies the - * table from which this CachedRowSetImpl object + * @param tabName a {@code String} object that identifies the + * table from which this {@code CachedRowSetImpl} object * was derived * @throws SQLException if an error occurs */ @@ -4188,7 +4196,7 @@ /** * Returns the columns that make a key to uniquely identify a - * row in this CachedRowSetImpl object. + * row in this {@code CachedRowSetImpl} object. * * @return an array of column numbers that constitutes a primary * key for this rowset. This array should be empty @@ -4203,16 +4211,16 @@ /** - * Sets this CachedRowSetImpl object's - * keyCols field with the given array of column + * Sets this {@code CachedRowSetImpl} object's + * {@code keyCols} field with the given array of column * numbers, which forms a key for uniquely identifying a row * in this rowset. * - * @param keys an array of int indicating the + * @param keys an array of {@code int} indicating the * columns that form a primary key for this - * CachedRowSetImpl object; every + * {@code CachedRowSetImpl} object; every * element in the array must be greater than - * 0 and less than or equal to the number + * {@code 0} and less than or equal to the number * of columns in this rowset * @throws SQLException if any of the numbers in the * given array is not valid for this rowset @@ -4224,8 +4232,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4236,14 +4244,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4251,8 +4259,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4263,13 +4271,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4277,8 +4285,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4289,14 +4297,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + * + * Absolute URIs * - * rmi://1234@hostname:2099/remoteobjectname - - * Specifies the Java Virtual Machine identified by lvmid - * 1234 on host hostname accessed - * using the rmi: protocol through the rmi remote - * object named remoteobjectname as registered with - * the rmiserver on port 2099 on host - * hostname. - * - * file:/path/file - Identifies a Java Virtual Machine - * through accessing a special file based protocol to use as - * the communications mechanism. - * + * rmi://1234@hostname:2099/remoteobjectname - + * Specifies the Java Virtual Machine identified by lvmid + * 1234 on host hostname accessed + * using the rmi: protocol through the rmi remote + * object named remoteobjectname as registered with + * the rmiserver on port 2099 on host + * hostname. + * + * file:/path/file - Identifies a Java Virtual Machine + * through accessing a special file based protocol to use as + * the communications mechanism. + * * + * * - * * * @see URI * @see HostIdentifier @@ -236,16 +235,14 @@ * missing components will have result in the HostIdentifier assigning * assumed defaults that allow the VmIdentifier to be resolved according * to those defaults. - * * - * For example, a VmIdentifier that specifies only a lvmid + * For example, a VmIdentifier that specifies only a {@code lvmid} * will result in a HostIdentifier for localhost utilizing * the default local protocol, local:. A VmIdentifier that - * specifies both a vmid and a hostname will result + * specifies both a {@code vmid} and a {@code hostname} will result * in a HostIdentifier for the specified host with the default remote * protocol, rmi:, using the protocol defaults for the - * port and servername components. - * + * {@code port} and {@code servername} components. * * @return HostIdentifier - the host identifier for the host containing * the Java Virtual Machine represented by this --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/perfdata/monitor/AbstractPerfDataBuffer.java 2015-06-05 21:04:38.731466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/perfdata/monitor/AbstractPerfDataBuffer.java 2015-06-05 21:04:38.563466071 +0400 @@ -108,7 +108,8 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match * the given pattern. If no instrumentation objects have` * names matching the given pattern, then an empty List --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/perfdata/monitor/PerfDataBufferImpl.java 2015-06-05 21:04:39.235466070 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/perfdata/monitor/PerfDataBufferImpl.java 2015-06-05 21:04:39.063466071 +0400 @@ -266,7 +266,8 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match * the given pattern. If no instrumentation objects have` * names matching the given pattern, then an empty List --- old/src/jdk.naming.dns/share/classes/com/sun/jndi/dns/DnsName.java 2015-06-05 21:04:39.831466070 +0400 +++ new/src/jdk.naming.dns/share/classes/com/sun/jndi/dns/DnsName.java 2015-06-05 21:04:39.659466070 +0400 @@ -580,7 +580,7 @@ * Serializes only the domain name string, for compactness and to avoid * any implementation dependency. * - * @serialdata The domain name string. + * @serialData The domain name string. */ private void writeObject(java.io.ObjectOutputStream s) throws java.io.IOException {
- * URL url = new URL("ftp://ftp.sun.com/pub/test.txt"); - * UrlConnection con = url.openConnection(); - * InputStream is = con.getInputStream(); - * ... - * is.close(); + * in a abstract layer. Here is an example of how to use the class: + *
URL url = new URL("ftp://ftp.sun.com/pub/test.txt"); - * UrlConnection con = url.openConnection(); - * InputStream is = con.getInputStream(); - * ... - * is.close();
- * UrlConnection con = url.openConnection();
- * InputStream is = con.getInputStream();
- * ...
- * is.close();
{@code + * URL url = new URL("ftp://ftp.sun.com/pub/test.txt"); + * UrlConnection con = url.openConnection(); + * InputStream is = con.getInputStream(); + * ... + * is.close(); + * }
URL
InputStream
Permission
accept
* Example: + *
{@code * --> GET http://www.authorization-required.com/ HTTP/1.0 * <-- HTTP/1.0 403 Unauthorized * <-- WWW-Authenticate: Basic realm="WallyWorld" @@ -67,8 +68,9 @@ * return "QWadhgWERghghWERfdfQ==" * --> GET http://www.authorization-required.com/ HTTP/1.0 * --> Authorization: Basic QWadhgWERghghWERfdfQ== - * <-- HTTP/1.0 200 OK + * <-- HTTP/1.0 200 OK} * YAY!!! + *
ifModifiedSince
URLConnection
This method throws a MalformedParameterizedTypeException * under the following circumstances: * If the number of actual type arguments (i.e., the size of the - * array typeArgs) does not correspond to the number of + * array {@code typeArgs}) does not correspond to the number of * formal type arguments. * If any of the actual type arguments is not an instance of the * bounds on the corresponding formal. * @param rawType the Class representing the generic type declaration being * instantiated - * @param actualTypeArguments - a (possibly empty) array of types + * @param actualTypeArguments a (possibly empty) array of types * representing the actual type arguments to the parameterized type - * @param ownerType - the enclosing type, if known. - * @return An instance of ParameterizedType - * @throws MalformedParameterizedTypeException - if the instantiation + * @param ownerType the enclosing type, if known. + * @return An instance of {@code ParameterizedType} + * @throws MalformedParameterizedTypeException if the instantiation * is invalid */ public static ParameterizedTypeImpl make(Class> rawType, @@ -95,18 +95,18 @@ /** - * Returns an array of Type objects representing the actual type + * Returns an array of {@code Type} objects representing the actual type * arguments to this type. * *
Note that in some cases, the returned array be empty. This can occur * if this type represents a non-parameterized type nested within * a parameterized type. * - * @return an array of Type objects representing the actual type + * @return an array of {@code Type} objects representing the actual type * arguments to this type - * @throws TypeNotPresentException if any of the + * @throws TypeNotPresentException if any of the * actual type arguments refers to a non-existent type declaration - * @throws MalformedParameterizedTypeException if any of the + * @throws MalformedParameterizedTypeException if any of the * actual type parameters refer to a parameterized type that cannot * be instantiated for any reason * @since 1.5 @@ -116,10 +116,10 @@ } /** - * Returns the Type object representing the class or interface + * Returns the {@code Type} object representing the class or interface * that declared this type. * - * @return the Type object representing the class or interface + * @return the {@code Type} object representing the class or interface * that declared this type */ public Class> getRawType() { @@ -128,18 +128,18 @@ /** - * Returns a Type object representing the type that this type - * is a member of. For example, if this type is O.I, - * return a representation of O. + * Returns a {@code Type} object representing the type that this type + * is a member of. For example, if this type is {@code O.I}, + * return a representation of {@code O}. * - * If this type is a top-level type, null is returned. + * If this type is a top-level type, {@code null} is returned. * - * @return a Type object representing the type that + * @return a {@code Type} object representing the type that * this type is a member of. If this type is a top-level type, - * null is returned - * @throws TypeNotPresentException if the owner type + * {@code null} is returned + * @throws TypeNotPresentException if the owner type * refers to a non-existent type declaration - * @throws MalformedParameterizedTypeException if the owner type + * @throws MalformedParameterizedTypeException if the owner type * refers to a parameterized type that cannot be instantiated * for any reason * --- old/src/java.base/share/classes/sun/reflect/generics/scope/ConstructorScope.java 2015-06-05 21:04:24.251466083 +0400 +++ new/src/java.base/share/classes/sun/reflect/generics/scope/ConstructorScope.java 2015-06-05 21:04:24.087466083 +0400 @@ -56,9 +56,9 @@ } /** - * Factory method. Takes a Constructor object and creates a + * Factory method. Takes a {@code Constructor} object and creates a * scope for it. - * @param m - A Constructor whose scope we want to obtain + * @param c - A Constructor whose scope we want to obtain * @return The type-variable scope for the constructor m */ public static ConstructorScope make(Constructor> c) { --- old/src/java.base/share/classes/sun/util/PreHashedMap.java 2015-06-05 21:04:24.751466082 +0400 +++ new/src/java.base/share/classes/sun/util/PreHashedMap.java 2015-06-05 21:04:24.587466082 +0400 @@ -121,8 +121,7 @@ * This method must construct the map's hash chains and store them into * the appropriate elements of the given hash-table row array. * - * @param rows - * The row array to be initialized + * @param ht The row array to be initialized */ protected abstract void init(Object[] ht); --- old/src/java.base/share/classes/sun/util/calendar/BaseCalendar.java 2015-06-05 21:04:25.251466082 +0400 +++ new/src/java.base/share/classes/sun/util/calendar/BaseCalendar.java 2015-06-05 21:04:25.087466082 +0400 @@ -28,7 +28,7 @@ import java.util.TimeZone; /** - * The BaseCalendar provides basic calendar calculation + * The {@code BaseCalendar} provides basic calendar calculation * functions to support the Julian, Gregorian, and Gregorian-based * calendar systems. * @@ -290,11 +290,11 @@ /** * Returns 366 if the specified date is in a leap year, or 365 * otherwise This method does not perform the normalization with - * the specified CalendarDate. The - * CalendarDate must be normalized to get a correct + * the specified {@code CalendarDate}. The + * {@code CalendarDate} must be normalized to get a correct * value. * - * @param a CalendarDate + * @param date a {@code CalendarDate} * @return a year length in days * @throws ClassCastException if the specified date is not a * {@link BaseCalendar.Date} @@ -412,7 +412,7 @@ /** * Calculates calendar fields and store them in the specified - * CalendarDate. + * {@code CalendarDate}. */ // should be 'protected' public void getCalendarDateFromFixedDate(CalendarDate date, --- old/src/java.base/share/classes/sun/util/calendar/CalendarUtils.java 2015-06-05 21:04:25.759466082 +0400 +++ new/src/java.base/share/classes/sun/util/calendar/CalendarUtils.java 2015-06-05 21:04:25.595466082 +0400 @@ -94,7 +94,7 @@ * 0 and -1%4 is -1. * * @param n the numerator - * @param d a divisor which must be > 0 + * @param d a divisor which must be {@literal > 0} * @param r an array of at least one element in which the value * mod(n, d) is returned. * @return the floor of the quotient. @@ -117,7 +117,7 @@ * 0 and -1%4 is -1. * * @param n the numerator - * @param d a divisor which must be > 0 + * @param d a divisor which must be {@literal > 0} * @param r an array of at least one element in which the value * mod(n, d) is returned. * @return the floor of the quotient. --- old/src/java.base/share/classes/sun/util/calendar/ZoneInfo.java 2015-06-05 21:04:26.263466081 +0400 +++ new/src/java.base/share/classes/sun/util/calendar/ZoneInfo.java 2015-06-05 21:04:26.099466081 +0400 @@ -364,7 +364,7 @@ * 0 for January. * @param day The day-in-month of the given date. * @param dayOfWeek The day-of-week of the given date. - * @param millis The milliseconds in day in standard local time. + * @param milliseconds The milliseconds in day in standard local time. * @return The milliseconds to add to UTC to get local time. */ public int getOffset(int era, int year, int month, int day, --- old/src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java 2015-06-05 21:04:26.771466081 +0400 +++ new/src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java 2015-06-05 21:04:26.607466081 +0400 @@ -72,7 +72,7 @@ * If the name returned cannot be localized according to locale, * (say, the provider does not have a Japanese name for Croatian), * this method returns null. - * @param languageCode the ISO 639 language code string in the form of two + * @param lang the ISO 639 language code string in the form of two * lower-case letters between 'a' (U+0061) and 'z' (U+007A) * @param locale the desired locale * @return the name of the given language code for the specified locale, or null if it's not @@ -129,7 +129,7 @@ * If the name returned cannot be localized according to locale, * (say, the provider does not have a Japanese name for Croatia), * this method returns null. - * @param countryCode the ISO 3166 country code string in the form of two + * @param ctry the ISO 3166 country code string in the form of two * upper-case letters between 'A' (U+0041) and 'Z' (U+005A) * @param locale the desired locale * @return the name of the given country code for the specified locale, or null if it's not @@ -152,7 +152,7 @@ * is appropriate for display to the user. * If the name returned cannot be localized according to locale, * this method returns null. - * @param variant the variant string + * @param vrnt the variant string * @param locale the desired locale * @return the name of the given variant string for the specified locale, or null if it's not * available. --- old/src/java.base/share/classes/sun/util/locale/provider/TimeZoneNameProviderImpl.java 2015-06-05 21:04:27.363466080 +0400 +++ new/src/java.base/share/classes/sun/util/locale/provider/TimeZoneNameProviderImpl.java 2015-06-05 21:04:27.199466080 +0400 @@ -79,7 +79,7 @@ * appropriate for daylight saving time even if the specified time zone * has not observed daylight saving time in the past. * - * @param ID a time zone ID string + * @param id a time zone ID string * @param daylight if true, return the daylight saving name. * @param style either {@link java.util.TimeZone#LONG TimeZone.LONG} or * {@link java.util.TimeZone#SHORT TimeZone.SHORT} --- old/src/java.base/share/classes/sun/util/logging/PlatformLogger.java 2015-06-05 21:04:27.951466080 +0400 +++ new/src/java.base/share/classes/sun/util/logging/PlatformLogger.java 2015-06-05 21:04:27.787466080 +0400 @@ -74,10 +74,10 @@ * java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter * * Limitation: - * /conf/logging.properties is the system-wide logging + * {@code /conf/logging.properties} is the system-wide logging * configuration defined in the specification and read in the * default case to configure any java.util.logging.Logger instances. - * Platform loggers will not detect if /conf/logging.properties + * Platform loggers will not detect if {@code /conf/logging.properties} * is modified. In other words, unless the java.util.logging API * is used at runtime or the logging system properties is set, * the platform loggers will use the default setting described above. --- old/src/java.base/share/classes/sun/util/resources/TimeZoneNamesBundle.java 2015-06-05 21:04:28.459466079 +0400 +++ new/src/java.base/share/classes/sun/util/resources/TimeZoneNamesBundle.java 2015-06-05 21:04:28.295466079 +0400 @@ -55,7 +55,7 @@ * array for the enumeration returned by getKeys. * Inserts the time zone ID (the key of the bundle entries) into * the string arrays returned by handleGetObject. - * + * * All TimeZoneNames resource bundles must extend this * class and implement the getContents method. */ --- old/src/java.base/unix/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:28.963466079 +0400 +++ new/src/java.base/unix/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:28.799466079 +0400 @@ -50,7 +50,7 @@ } /** - * @returns the platform specific path corresponding to the URL + * @return the platform specific path corresponding to the URL * so long as the URL does not contain a hostname in the authority field. */ --- old/src/java.base/unix/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:29.467466078 +0400 +++ new/src/java.base/unix/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:29.303466079 +0400 @@ -113,7 +113,8 @@ Client client; /** * Create a NTLMAuthentication: - * Username may be specified as domainusername in the application Authenticator. + * Username may be specified as {@literal domainusername} + * in the application Authenticator. * If this notation is not used, then the domain will be taken * from a system property: "http.auth.ntlm.domain". */ --- old/src/java.base/windows/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:29.967466078 +0400 +++ new/src/java.base/windows/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:29.803466078 +0400 @@ -46,7 +46,7 @@ } /** - * @returns the platform specific path corresponding to the URL, and in particular + * @return the platform specific path corresponding to the URL, and in particular * returns a UNC when the authority contains a hostname */ --- old/src/java.base/windows/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:30.467466078 +0400 +++ new/src/java.base/windows/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:30.303466078 +0400 @@ -83,7 +83,8 @@ /** * Create a NTLMAuthentication: - * Username may be specified as domainusername in the application Authenticator. + * Username may be specified as {@literal domainusername} + * in the application Authenticator. * If this notation is not used, then the domain will be taken * from a system property: "http.auth.ntlm.domain". */ --- old/src/java.datatransfer/share/classes/sun/datatransfer/DataFlavorUtil.java 2015-06-05 21:04:30.971466077 +0400 +++ new/src/java.datatransfer/share/classes/sun/datatransfer/DataFlavorUtil.java 2015-06-05 21:04:30.807466077 +0400 @@ -55,7 +55,7 @@ /** * Utility class with different datatransfer helper functions * - * @see 1.9 + * @since 1.9 */ public class DataFlavorUtil { --- old/src/java.desktop/macosx/classes/com/apple/eio/FileManager.java 2015-06-05 21:04:31.483466077 +0400 +++ new/src/java.desktop/macosx/classes/com/apple/eio/FileManager.java 2015-06-05 21:04:31.319466077 +0400 @@ -97,7 +97,8 @@ /** - * Converts an OSType (e.g. "macs" from ) into an int. + * Converts an OSType (e.g. "macs" + * from {@literal }) into an int. * * @param type the 4 character type to convert. * @return an int representing the 4 character value @@ -355,7 +356,7 @@ /** * Moves the specified file to the Trash * - * @param file + * @param file the file * @return returns true if the NSFileManager successfully moved the file to the Trash. * @throws FileNotFoundException * --- old/src/java.desktop/share/classes/sun/applet/AppletPanel.java 2015-06-05 21:04:31.991466076 +0400 +++ new/src/java.desktop/share/classes/sun/applet/AppletPanel.java 2015-06-05 21:04:31.823466077 +0400 @@ -344,12 +344,14 @@ * Execute applet events. * Here is the state transition diagram * + * {@literal * Note: (XXX) is the action * APPLET_XXX is the state - * (applet code loaded) --> APPLET_LOAD -- (applet init called)--> APPLET_INIT -- ( - * applet start called) --> APPLET_START -- (applet stop called) -->APPLET_STOP --(applet - * destroyed called) --> APPLET_DESTROY -->(applet gets disposed) --> - * APPLET_DISPOSE -->.... + * (applet code loaded) --> APPLET_LOAD -- (applet init called)--> APPLET_INIT -- + * (applet start called) --> APPLET_START -- (applet stop called) --> APPLET_STOP -- + * (applet destroyed called) --> APPLET_DESTROY --> (applet gets disposed) --> + * APPLET_DISPOSE --> ... + * } * * In the legacy lifecycle model. The applet gets loaded, inited and started. So it stays * in the APPLET_START state unless the applet goes away(refresh page or leave the page). @@ -364,10 +366,9 @@ * APPLET_STOP to APPLET_DESTROY and to APPLET_INIT . * * Also, the applet can jump from APPLET_INIT state to APPLET_DESTROY (in Netscape/Mozilla case). - * Same as APPLET_LOAD to + * Same as APPLET_LOAD to * APPLET_DISPOSE since all of this are triggered by browser. * - * */ @Override public void run() { --- old/src/java.desktop/share/classes/sun/applet/AppletViewer.java 2015-06-05 21:04:32.503466076 +0400 +++ new/src/java.desktop/share/classes/sun/applet/AppletViewer.java 2015-06-05 21:04:32.335466076 +0400 @@ -1093,7 +1093,7 @@ } /** - * Scan an html file for tags + * Scan an html file for {@code } tags */ public static void parse(URL url, String enc) throws IOException { encoding = enc; --- old/src/java.naming/share/classes/com/sun/jndi/ldap/LdapName.java 2015-06-05 21:04:33.107466075 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/LdapName.java 2015-06-05 21:04:32.939466076 +0400 @@ -358,7 +358,7 @@ * Serializes only the unparsed DN, for compactness and to avoid * any implementation dependency. * - * @serialdata The DN string and a boolean indicating whether + * @serialData The DN string and a boolean indicating whether * the values are case sensitive. */ private void writeObject(java.io.ObjectOutputStream s) --- old/src/java.sql.rowset/share/classes/com/sun/rowset/JdbcRowSetImpl.java 2015-06-05 21:04:33.715466075 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/JdbcRowSetImpl.java 2015-06-05 21:04:33.547466075 +0400 @@ -35,7 +35,7 @@ import javax.sql.rowset.*; /** - * The standard implementation of the JdbcRowSet interface. See the interface + * The standard implementation of the {@code JdbcRowSet} interface. See the interface * definition for full behavior and implementation requirements. * * @author Jonathan Bruce, Amit Handa @@ -44,40 +44,40 @@ public class JdbcRowSetImpl extends BaseRowSet implements JdbcRowSet, Joinable { /** - * The Connection object that is this rowset's + * The {@code Connection} object that is this rowset's * current connection to the database. This field is set * internally when the connection is established. */ private Connection conn; /** - * The PreparedStatement object that is this rowset's + * The {@code PreparedStatement} object that is this rowset's * current command. This field is set internally when the method - * execute creates the PreparedStatement + * {@code execute} creates the {@code PreparedStatement} * object. */ private PreparedStatement ps; /** - * The ResultSet object that is this rowset's + * The {@code ResultSet} object that is this rowset's * current result set. This field is set internally when the method - * execute executes the rowset's command and thereby - * creates the rowset's ResultSet object. + * {@code execute} executes the rowset's command and thereby + * creates the rowset's {@code ResultSet} object. */ private ResultSet rs; /** - * The RowSetMetaDataImpl object that is constructed when - * a ResultSet object is passed to the JdbcRowSet + * The {@code RowSetMetaDataImpl} object that is constructed when + * a {@code ResultSet} object is passed to the {@code JdbcRowSet} * constructor. This helps in constructing all metadata associated - * with the ResultSet object using the setter methods of - * RowSetMetaDataImpl. + * with the {@code ResultSet} object using the setter methods of + * {@code RowSetMetaDataImpl}. */ private RowSetMetaDataImpl rowsMD; /** - * The ResultSetMetaData object from which this - * RowSetMetaDataImpl is formed and which helps in getting + * The {@code ResultSetMetaData} object from which this + * {@code RowSetMetaDataImpl} is formed and which helps in getting * the metadata information. */ private ResultSetMetaData resMD; @@ -97,13 +97,13 @@ protected transient JdbcRowSetResourceBundle resBundle; /** - * Constructs a default JdbcRowSet object. - * The new instance of JdbcRowSet will serve as a proxy - * for the ResultSet object it creates, and by so doing, + * Constructs a default {@code JdbcRowSet} object. + * The new instance of {@code JdbcRowSet} will serve as a proxy + * for the {@code ResultSet} object it creates, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -114,17 +114,17 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * - * A newly created JdbcRowSet object must have its - * execute method invoked before other public methods + * A newly created {@code JdbcRowSet} object must have its + * {@code execute} method invoked before other public methods * are called on it; otherwise, such method calls will cause an * exception to be thrown. * * @throws SQLException [1] if any of its public methods are called prior - * to calling the execute method; [2] if invalid JDBC driver + * to calling the {@code execute} method; [2] if invalid JDBC driver * properties are set or [3] if no connection to a data source exists. */ public JdbcRowSetImpl() { @@ -217,14 +217,14 @@ } /** - * Constructs a default JdbcRowSet object given a - * valid Connection object. The new - * instance of JdbcRowSet will serve as a proxy for - * the ResultSet object it creates, and by so doing, + * Constructs a default {@code JdbcRowSet} object given a + * valid {@code Connection} object. The new + * instance of {@code JdbcRowSet} will serve as a proxy for + * the {@code ResultSet} object it creates, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -235,17 +235,17 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * - * A newly created JdbcRowSet object must have its - * execute method invoked before other public methods + * A newly created {@code JdbcRowSet} object must have its + * {@code execute} method invoked before other public methods * are called on it; otherwise, such method calls will cause an * exception to be thrown. * * @throws SQLException [1] if any of its public methods are called prior - * to calling the execute method, [2] if invalid JDBC driver + * to calling the {@code execute} method, [2] if invalid JDBC driver * properties are set, or [3] if no connection to a data source exists. */ public JdbcRowSetImpl(Connection con) throws SQLException { @@ -289,15 +289,15 @@ } /** - * Constructs a default JdbcRowSet object using the + * Constructs a default {@code JdbcRowSet} object using the * URL, username, and password arguments supplied. The new - * instance of JdbcRowSet will serve as a proxy for - * the ResultSet object it creates, and by so doing, + * instance of {@code JdbcRowSet} will serve as a proxy for + * the {@code ResultSet} object it creates, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -308,17 +308,17 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * * - * @param url - a JDBC URL for the database to which this JdbcRowSet + * @param url a JDBC URL for the database to which this {@code JdbcRowSet} * object will be connected. The form for a JDBC URL is - * jdbc:subprotocol:subname. - * @param user - the database user on whose behalf the connection + * {@code jdbc:subprotocol:subname}. + * @param user the database user on whose behalf the connection * is being made - * @param password - the user's password + * @param password the user's password * * @throws SQLException if a database access error occurs * @@ -372,15 +372,15 @@ /** - * Constructs a JdbcRowSet object using the given valid - * ResultSet object. The new - * instance of JdbcRowSet will serve as a proxy for - * the ResultSet object, and by so doing, + * Constructs a {@code JdbcRowSet} object using the given valid + * {@code ResultSet} object. The new + * instance of {@code JdbcRowSet} will serve as a proxy for + * the {@code ResultSet} object, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -391,12 +391,12 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * * - * @param res a valid ResultSet object + * @param res a valid {@code ResultSet} object * * @throws SQLException if a database access occurs due to a non * valid ResultSet handle. @@ -460,13 +460,13 @@ } /** - * Initializes the given RowSetMetaData object with the values - * in the given ResultSetMetaData object. + * Initializes the given {@code RowSetMetaData} object with the values + * in the given {@code ResultSetMetaData} object. * - * @param md the RowSetMetaData object for this - * JdbcRowSetImpl object, which will be set with + * @param md the {@code RowSetMetaData} object for this + * {@code JdbcRowSetImpl} object, which will be set with * values from rsmd - * @param rsmd the ResultSetMetaData object from which new + * @param rsmd the {@code ResultSetMetaData} object from which new * values for md will be read * @throws SQLException if an error occurs */ @@ -511,24 +511,24 @@ //--------------------------------------------------------------------- /** - * Creates the internal ResultSet object for which this - * JdbcRowSet object is a wrapper, effectively + * Creates the internal {@code ResultSet} object for which this + * {@code JdbcRowSet} object is a wrapper, effectively * making the result set a JavaBeans component. * * Certain properties must have been set before this method is called * so that it can establish a connection to a database and execute the - * query that will create the result set. If a DataSource + * query that will create the result set. If a {@code DataSource} * object will be used to create the connection, properties for the * data source name, user name, and password must be set. If the - * DriverManager will be used, the properties for the + * {@code DriverManager} will be used, the properties for the * URL, user name, and password must be set. In either case, the * property for the command must be set. If the command has placeholder * parameters, those must also be set. This method throws * an exception if the required properties are not set. * * Other properties have default values that may optionally be set - * to new values. The execute method will use the value - * for the command property to create a PreparedStatement + * to new values. The {@code execute} method will use the value + * for the command property to create a {@code PreparedStatement} * object and set its properties (escape processing, maximum field * size, maximum number of rows, and query timeout limit) to be those * of this rowset. @@ -784,20 +784,20 @@ } /** - * Moves the cursor for this rowset's ResultSet + * Moves the cursor for this rowset's {@code ResultSet} * object down one row from its current position. - * A ResultSet cursor is initially positioned + * A {@code ResultSet} cursor is initially positioned * before the first row; the first call to the method - * next makes the first row the current row; the + * {@code next} makes the first row the current row; the * second call makes the second row the current row, and so on. * * If an input stream is open for the current row, a call - * to the method next will - * implicitly close it. A ResultSet object's + * to the method {@code next} will + * implicitly close it. A {@code ResultSet} object's * warning chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -811,16 +811,16 @@ } /** - * Releases this rowset's ResultSet object's database and + * Releases this rowset's {@code ResultSet} object's database and * JDBC resources immediately instead of waiting for * this to happen when it is automatically closed. * - * Note: A ResultSet object + * Note: A {@code ResultSet} object * is automatically closed by the - * Statement object that generated it when - * that Statement object is closed, + * {@code Statement} object that generated it when + * that {@code Statement} object is closed, * re-executed, or is used to retrieve the next result from a - * sequence of multiple results. A ResultSet object + * sequence of multiple results. A {@code ResultSet} object * is also automatically closed when it is garbage collected. * * @throws SQLException if a database access error occurs @@ -836,14 +836,14 @@ /** * Reports whether the last column read from this rowset's - * ResultSet object had a value of SQL NULL. - * Note that you must first call one of the getXXX methods + * {@code ResultSet} object had a value of SQL {@code NULL}. + * Note that you must first call one of the {@code getXXX} methods * on a column to try to read its value and then call - * the method wasNull to see if the value read was - * SQL NULL. + * the method {@code wasNull} to see if the value read was + * SQL {@code NULL}. * - * @return true if the last column value read was SQL - * NULL and false otherwise + * @return {@code true} if the last column value read was SQL + * {@code NULL} and {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not have a currently valid connection, * prepared statement, and result set @@ -860,12 +860,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a String. + * of this rowset's {@code ResultSet} object as + * a {@code String}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -878,12 +878,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a boolean. + * of this rowset's {@code ResultSet} object as + * a {@code boolean}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is false + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code false} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -896,12 +896,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte. + * of this rowset's {@code ResultSet} object as + * a {@code byte}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -914,12 +914,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a short. + * of this rowset's {@code ResultSet} object as + * a {@code short}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -932,12 +932,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an int. + * of this rowset's {@code ResultSet} object as + * an {@code int}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -950,12 +950,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a long. + * of this rowset's {@code ResultSet} object as + * a {@code long}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -968,12 +968,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a float. + * of this rowset's {@code ResultSet} object as + * a {@code float}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -986,12 +986,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a double. + * of this rowset's {@code ResultSet} object as + * a {@code double}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1004,13 +1004,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.BigDecimal. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.BigDecimal}. * * @param columnIndex the first column is 1, the second is 2, and so on * @param scale the number of digits to the right of the decimal point - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1025,13 +1025,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte array in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code byte} array in the Java programming language. * The bytes represent the raw values returned by the driver. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1044,12 +1044,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Date object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Date} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1062,12 +1062,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Time object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Time} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1080,12 +1080,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Timestamp object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Timestamp} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1098,25 +1098,25 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as + * of this rowset's {@code ResultSet} object as * a stream of ASCII characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream of one-byte ASCII characters; - * if the value is SQL NULL, the - * value returned is null + * as a stream of one-byte ASCII characters; + * if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) database access error occurs * (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1129,31 +1129,31 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as + * of this rowset's {@code ResultSet} object as * as a stream of Unicode characters. * The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving largeLONGVARCHARvalues. The JDBC driver will + * suitable for retrieving large{@code LONGVARCHAR}values. The JDBC driver will * do any necessary conversion from the database format into Unicode. * The byte format of the Unicode stream must be Java UTF-8, * as specified in the Java virtual machine specification. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream in Java UTF-8 byte format; - * if the value is SQL NULL, the value returned is null + * as a stream in Java UTF-8 byte format; + * if the value is SQL {@code NULL}, the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set - * @deprecated use getCharacterStream in place of - * getUnicodeStream + * @deprecated use {@code getCharacterStream} in place of + * {@code getUnicodeStream} */ @Deprecated public java.io.InputStream getUnicodeStream(int columnIndex) throws SQLException { @@ -1165,22 +1165,22 @@ /** * Gets the value of a column in the current row as a stream of * the value of the designated column in the current row - * of this rowset's ResultSet object as a binary stream of + * of this rowset's {@code ResultSet} object as a binary stream of * uninterpreted bytes. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes; - * if the value is SQL NULL, the value returned is null + * as a stream of uninterpreted bytes; + * if the value is SQL {@code NULL}, the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1198,12 +1198,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a String. + * of this rowset's {@code ResultSet} object as + * a {@code String}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1214,12 +1214,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a boolean. + * of this rowset's {@code ResultSet} object as + * a {@code boolean}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is false + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code false} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1230,12 +1230,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte. + * of this rowset's {@code ResultSet} object as + * a {@code byte}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1246,12 +1246,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a short. + * of this rowset's {@code ResultSet} object as + * a {@code short}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1262,12 +1262,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an int. + * of this rowset's {@code ResultSet} object as + * an {@code int}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1278,12 +1278,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a long. + * of this rowset's {@code ResultSet} object as + * a {@code long}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if a database access error occurs * or this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1294,12 +1294,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a float. + * of this rowset's {@code ResultSet} object as + * a {@code float}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1310,12 +1310,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a double. + * of this rowset's {@code ResultSet} object as + * a {@code double}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1326,13 +1326,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.math.BigDecimal. + * of this rowset's {@code ResultSet} object as + * a {@code java.math.BigDecimal}. * * @param columnName the SQL name of the column * @param scale the number of digits to the right of the decimal point - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) adatabase access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1345,13 +1345,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte array in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code byte} array in the Java programming language. * The bytes represent the raw values returned by the driver. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1362,12 +1362,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Date object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Date} object in the Java programming language. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1378,13 +1378,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Time object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Time} object in the Java programming language. * * @param columnName the SQL name of the column * @return the column value; - * if the value is SQL NULL, - * the value returned is null + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1395,12 +1395,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Timestamp} object. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1411,24 +1411,24 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of + * of this rowset's {@code ResultSet} object as a stream of * ASCII characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of one-byte ASCII characters. - * If the value is SQL NULL, - * the value returned is null. + * as a stream of one-byte ASCII characters. + * If the value is SQL {@code NULL}, + * the value returned is {@code null}. * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1439,10 +1439,10 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of + * of this rowset's {@code ResultSet} object as a stream of * Unicode characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into Unicode. * The byte format of the Unicode stream must be Java UTF-8, @@ -1450,15 +1450,15 @@ * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of two-byte Unicode characters. - * If the value is SQL NULL, - * the value returned is null. + * as a stream of two-byte Unicode characters. + * If the value is SQL {@code NULL}, + * the value returned is {@code null}. * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1471,23 +1471,23 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of uninterpreted - * bytes. + * of this rowset's {@code ResultSet} object as a stream of uninterpreted + * {@code byte}s. * The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARBINARY + * suitable for retrieving large {@code LONGVARBINARY} * values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes; - * if the value is SQL NULL, the result is null + * as a stream of uninterpreted bytes; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1503,21 +1503,21 @@ /** * Returns the first warning reported by calls on this rowset's - * ResultSet object. - * Subsequent warnings on this rowset's ResultSet object - * will be chained to the SQLWarning object that + * {@code ResultSet} object. + * Subsequent warnings on this rowset's {@code ResultSet} object + * will be chained to the {@code SQLWarning} object that * this method returns. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by - * Statement methods + * by {@code ResultSet} methods. Any warning caused by + * {@code Statement} methods * (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * - * @return the first SQLWarning object reported or null + * @return the first {@code SQLWarning} object reported or {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1529,10 +1529,10 @@ } /** - * Clears all warnings reported on this rowset's ResultSet object. - * After this method is called, the method getWarnings - * returns null until a new warning is - * reported for this rowset's ResultSet object. + * Clears all warnings reported on this rowset's {@code ResultSet} object. + * After this method is called, the method {@code getWarnings} + * returns {@code null} until a new warning is + * reported for this rowset's {@code ResultSet} object. * * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, @@ -1545,26 +1545,26 @@ } /** - * Gets the name of the SQL cursor used by this rowset's ResultSet + * Gets the name of the SQL cursor used by this rowset's {@code ResultSet} * object. * * In SQL, a result table is retrieved through a cursor that is * named. The current row of a result set can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To insure that the cursor has the proper isolation - * level to support update, the cursor's select statement should be + * level to support update, the cursor's {@code select} statement should be * of the form 'select for update'. If the 'for update' clause is * omitted, the positioned updates may fail. * * The JDBC API supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. - * The current row of a ResultSet object + * SQL cursor used by a {@code ResultSet} object. + * The current row of a {@code ResultSet} object * is also the current row of this SQL cursor. * * Note: If positioned update is not supported, a - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL name for this rowset's ResultSet object's cursor + * @return the SQL name for this rowset's {@code ResultSet} object's cursor * @throws SQLException if (1) a database access error occurs * or (2) xthis rowset does not have a currently valid connection, * prepared statement, and result set @@ -1577,9 +1577,9 @@ /** * Retrieves the number, types and properties of - * this rowset's ResultSet object's columns. + * this rowset's {@code ResultSet} object's columns. * - * @return the description of this rowset's ResultSet + * @return the description of this rowset's {@code ResultSet} * object's columns * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, @@ -1607,8 +1607,8 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an Object. + * of this rowset's {@code ResultSet} object as + * an {@code Object}. * * This method will return the value of the given column as a * Java object. The type of the Java object will be the default @@ -1620,14 +1620,14 @@ * abstract data types. * * In the JDBC 3.0 API, the behavior of method - * getObject is extended to materialize + * {@code getObject} is extended to materialize * data of SQL user-defined types. When a column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to: getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to: {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return a java.lang.Object holding the column value + * @return a {@code java.lang.Object} holding the column value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1640,8 +1640,8 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an Object. + * of this rowset's {@code ResultSet} object as + * an {@code Object}. * * This method will return the value of the given column as a * Java object. The type of the Java object will be the default @@ -1653,14 +1653,14 @@ * abstract data types. * * In the JDBC 3.0 API, the behavior of the method - * getObject is extended to materialize + * {@code getObject} is extended to materialize * data of SQL user-defined types. When a column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to: getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to: {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * * @param columnName the SQL name of the column - * @return a java.lang.Object holding the column value + * @return a {@code java.lang.Object} holding the column value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1672,9 +1672,9 @@ //---------------------------------------------------------------- /** - * Maps the given JdbcRowSetImpl column name to its - * JdbcRowSetImpl column index and reflects this on - * the internal ResultSet object. + * Maps the given {@code JdbcRowSetImpl} column name to its + * {@code JdbcRowSetImpl} column index and reflects this on + * the internal {@code ResultSet} object. * * @param columnName the name of the column * @return the column index of the given column name @@ -1697,11 +1697,11 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.io.Reader object. - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null. + * of this rowset's {@code ResultSet} object as a + * {@code java.io.Reader} object. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @param columnIndex the first column is 1, the second is 2, and so on * */ @@ -1713,14 +1713,14 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.io.Reader object. + * of this rowset's {@code ResultSet} object as a + * {@code java.io.Reader} object. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @param columnName the name of the column - * @return the value in the specified column as a java.io.Reader + * @return the value in the specified column as a {@code java.io.Reader} * */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { @@ -1729,13 +1729,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.math.BigDecimal with full precision. + * of this rowset's {@code ResultSet} object as a + * {@code java.math.BigDecimal} with full precision. * * @param columnIndex the first column is 1, the second is 2, and so on * @return the column value (full precision); - * if the value is SQL NULL, the value returned is - * null. + * if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1748,13 +1748,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.math.BigDecimal with full precision. + * of this rowset's {@code ResultSet} object as a + * {@code java.math.BigDecimal} with full precision. * * @param columnName the column name * @return the column value (full precision); - * if the value is SQL NULL, the value returned is - * null. + * if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1769,11 +1769,11 @@ /** * Indicates whether the cursor is before the first row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is before the first row; - * false if the cursor is at any other position or the - * result set contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} if the cursor is at any other position or the + * result set contains no rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1786,11 +1786,11 @@ /** * Indicates whether the cursor is after the last row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is after the last row; - * false if the cursor is at any other position or the - * result set contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} if the cursor is at any other position or the + * result set contains no rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1803,10 +1803,10 @@ /** * Indicates whether the cursor is on the first row of - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on the first row; - * false otherwise + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1819,14 +1819,14 @@ /** * Indicates whether the cursor is on the last row of - * this rowset's ResultSet object. - * Note: Calling the method isLast may be expensive + * this rowset's {@code ResultSet} object. + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver * might need to fetch ahead one row in order to determine * whether the current row is the last row in the result set. * - * @return true if the cursor is on the last row; - * false otherwise + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1840,11 +1840,11 @@ /** * Moves the cursor to the front of - * this rowset's ResultSet object, just before the + * this rowset's {@code ResultSet} object, just before the * first row. This method has no effect if the result set contains no rows. * * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1857,10 +1857,10 @@ /** * Moves the cursor to the end of - * this rowset's ResultSet object, just after the + * this rowset's {@code ResultSet} object, just after the * last row. This method has no effect if the result set contains no rows. * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1873,12 +1873,12 @@ /** * Moves the cursor to the first row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on a valid row; - * false if there are no rows in the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if there are no rows in the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1893,12 +1893,12 @@ /** * Moves the cursor to the last row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on a valid row; - * false if there are no rows in the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if there are no rows in the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1914,7 +1914,7 @@ * Retrieves the current row number. The first row is number 1, the * second is number 2, and so on. * - * @return the current row number; 0 if there is no current row + * @return the current row number; {@code 0} if there is no current row * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1927,7 +1927,7 @@ /** * Moves the cursor to the given row number in - * this rowset's internal ResultSet object. + * this rowset's internal {@code ResultSet} object. * * If the row number is positive, the cursor moves to * the given row number with respect to the @@ -1937,23 +1937,23 @@ * If the given row number is negative, the cursor moves to * an absolute row position with respect to * the end of the result set. For example, calling the method - * absolute(-1) positions the - * cursor on the last row, calling the method absolute(-2) + * {@code absolute(-1)} positions the + * cursor on the last row, calling the method {@code absolute(-2)} * moves the cursor to the next-to-last row, and so on. * * An attempt to position the cursor beyond the first/last row in * the result set leaves the cursor before the first row or after * the last row. * - * Note: Calling absolute(1) is the same - * as calling first(). Calling absolute(-1) - * is the same as calling last(). + * Note: Calling {@code absolute(1)} is the same + * as calling {@code first()}. Calling {@code absolute(-1)} + * is the same as calling {@code last()}. * - * @return true if the cursor is on the result set; - * false otherwise + * @return {@code true} if the cursor is on the result set; + * {@code false} otherwise * @throws SQLException if (1) a database access error occurs, - * (2) the row is 0, (3) the result set - * type is TYPE_FORWARD_ONLY, or (4) this + * (2) the row is {@code 0}, (3) the result set + * type is {@code TYPE_FORWARD_ONLY}, or (4) this * rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -1969,21 +1969,21 @@ * Moves the cursor a relative number of rows, either positive or negative. * Attempting to move beyond the first/last row in the * result set positions the cursor before/after the - * the first/last row. Calling relative(0) is valid, but does + * the first/last row. Calling {@code relative(0)} is valid, but does * not change the cursor position. * - * Note: Calling the method relative(1) - * is different from calling the method next() - * because is makes sense to call next() when there + * Note: Calling the method {@code relative(1)} + * is different from calling the method {@code next()} + * because is makes sense to call {@code next()} when there * is no current row, * for example, when the cursor is positioned before the first row * or after the last row of the result set. * - * @return true if the cursor is on a row; - * false otherwise + * @return {@code true} if the cursor is on a row; + * {@code false} otherwise * @throws SQLException if (1) a database access error occurs, * (2) there is no current row, (3) the result set - * type is TYPE_FORWARD_ONLY, or (4) this + * type is {@code TYPE_FORWARD_ONLY}, or (4) this * rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -1997,16 +1997,16 @@ /** * Moves the cursor to the previous row in this - * ResultSet object. + * {@code ResultSet} object. * - * Note: Calling the method previous() is not the same as - * calling the method relative(-1) because it - * makes sense to call previous() when there is no current row. + * Note: Calling the method {@code previous()} is not the same as + * calling the method {@code relative(-1)} because it + * makes sense to call {@code previous()} when there is no current row. * - * @return true if the cursor is on a valid row; - * false if it is off the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is off the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -2020,15 +2020,15 @@ /** * Gives a hint as to the direction in which the rows in this - * ResultSet object will be processed. + * {@code ResultSet} object will be processed. * The initial value is determined by the - * Statement object - * that produced this rowset's ResultSet object. + * {@code Statement} object + * that produced this rowset's {@code ResultSet} object. * The fetch direction may be changed at any time. * * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY - * and the fetch direction is not FETCH_FORWARD, + * (2) the result set type is {@code TYPE_FORWARD_ONLY} + * and the fetch direction is not {@code FETCH_FORWARD}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set * @see java.sql.Statement#setFetchDirection @@ -2041,10 +2041,10 @@ /** * Returns the fetch direction for this - * ResultSet object. + * {@code ResultSet} object. * * @return the current fetch direction for this rowset's - * ResultSet object + * {@code ResultSet} object * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2061,16 +2061,16 @@ /** * Gives the JDBC driver a hint as to the number of rows that should * be fetched from the database when more rows are needed for this - * ResultSet object. + * {@code ResultSet} object. * If the fetch size specified is zero, the JDBC driver * ignores the value and is free to make its own best guess as to what * the fetch size should be. The default value is set by the - * Statement object + * {@code Statement} object * that created the result set. The fetch size may be changed at any time. * * @param rows the number of rows to fetch * @throws SQLException if (1) a database access error occurs, (2) the - * condition 0 <= rows <= this.getMaxRows() is not + * condition {@code 0 <= rows <= this.getMaxRows()} is not * satisfied, or (3) this rowset does not currently have a valid * connection, prepared statement, and result set * @@ -2084,9 +2084,9 @@ /** * * Returns the fetch size for this - * ResultSet object. + * {@code ResultSet} object. * - * @return the current fetch size for this rowset's ResultSet object + * @return the current fetch size for this rowset's {@code ResultSet} object * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2111,12 +2111,12 @@ } /** - * Returns the concurrency mode of this rowset's ResultSet object. + * Returns the concurrency mode of this rowset's {@code ResultSet} object. * The concurrency used is determined by the - * Statement object that created the result set. + * {@code Statement} object that created the result set. * - * @return the concurrency type, either CONCUR_READ_ONLY - * or CONCUR_UPDATABLE + * @return the concurrency type, either {@code CONCUR_READ_ONLY} + * or {@code CONCUR_UPDATABLE} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2138,7 +2138,7 @@ * Indicates whether the current row has been updated. The value returned * depends on whether or not the result set can detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another, and updates are detected * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, @@ -2154,10 +2154,10 @@ /** * Indicates whether the current row has had an insertion. * The value returned depends on whether or not this - * ResultSet object can detect visible inserts. + * {@code ResultSet} object can detect visible inserts. * - * @return true if a row has had an insertion - * and insertions are detected; false otherwise + * @return {@code true} if a row has had an insertion + * and insertions are detected; {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2174,10 +2174,10 @@ * Indicates whether a row has been deleted. A deleted row may leave * a visible "hole" in a result set. This method can be used to * detect holes in a result set. The value returned depends on whether - * or not this rowset's ResultSet object can detect deletions. + * or not this rowset's {@code ResultSet} object can detect deletions. * - * @return true if a row was deleted and deletions are detected; - * false otherwise + * @return {@code true} if a row was deleted and deletions are detected; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2192,10 +2192,10 @@ /** * Gives a nullable column a null value. * - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow - * or insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} + * or {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @throws SQLException if a database access error occurs @@ -2213,11 +2213,11 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2237,11 +2237,11 @@ } /** - * Updates the designated column with a byte value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * * @param columnIndex the first column is 1, the second is 2, and so on @@ -2262,11 +2262,11 @@ } /** - * Updates the designated column with a short value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code short} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2286,11 +2286,11 @@ } /** - * Updates the designated column with an int value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code int} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2309,11 +2309,11 @@ } /** - * Updates the designated column with a long value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code long} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2333,11 +2333,11 @@ } /** - * Updates the designated column with a float value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code float} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2357,11 +2357,11 @@ } /** - * Updates the designated column with a double value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code double} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2381,12 +2381,12 @@ } /** - * Updates the designated column with a java.math.BigDecimal + * Updates the designated column with a {@code java.math.BigDecimal} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2406,11 +2406,11 @@ } /** - * Updates the designated column with a String value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code String} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2430,11 +2430,11 @@ } /** - * Updates the designated column with a byte array value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} array value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2454,11 +2454,11 @@ } /** - * Updates the designated column with a java.sql.Date value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Date} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2479,11 +2479,11 @@ /** - * Updates the designated column with a java.sql.Time value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Time} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2503,12 +2503,12 @@ } /** - * Updates the designated column with a java.sql.Timestamp + * Updates the designated column with a {@code java.sql.Timestamp} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2529,10 +2529,10 @@ /** * Updates the designated column with an ascii stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2554,10 +2554,10 @@ /** * Updates the designated column with a binary stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2579,10 +2579,10 @@ /** * Updates the designated column with a character stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2603,18 +2603,18 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value - * @param scale for java.sql.Types.DECIMAl - * or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types this value will be ignored. + * @param scale for {@code java.sql.Types.DECIMAl} + * or {@code java.sql.Types.NUMERIC} types, + * this is the number of digits after the decimal point. For all other + * types this value will be ignored. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2631,11 +2631,11 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2655,11 +2655,11 @@ } /** - * Updates the designated column with a null value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code null} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @throws SQLException if a database access error occurs @@ -2672,11 +2672,11 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2688,11 +2688,11 @@ } /** - * Updates the designated column with a byte value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2704,11 +2704,11 @@ } /** - * Updates the designated column with a short value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code short} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2720,11 +2720,11 @@ } /** - * Updates the designated column with an int value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code int} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2736,11 +2736,11 @@ } /** - * Updates the designated column with a long value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code long} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2752,11 +2752,11 @@ } /** - * Updates the designated column with a float value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code float } value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2768,11 +2768,11 @@ } /** - * Updates the designated column with a double value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code double} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2784,12 +2784,12 @@ } /** - * Updates the designated column with a java.sql.BigDecimal + * Updates the designated column with a {@code java.sql.BigDecimal} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2801,11 +2801,11 @@ } /** - * Updates the designated column with a String value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code String} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2817,19 +2817,19 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * JDBC 2.0 * * Updates a column with a byte array value. * - * The updateXXX methods are used to update column values in the - * current row, or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or insertRow + * The {@code updateXXX} methods are used to update column values in the + * current row, or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or {@code insertRow} * methods are called to update the database. * * @param columnName the name of the column @@ -2842,11 +2842,11 @@ } /** - * Updates the designated column with a java.sql.Date value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Date} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2858,11 +2858,11 @@ } /** - * Updates the designated column with a java.sql.Time value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Time} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2874,12 +2874,12 @@ } /** - * Updates the designated column with a java.sql.Timestamp + * Updates the designated column with a {@code java.sql.Timestamp} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2892,10 +2892,10 @@ /** * Updates the designated column with an ascii stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2909,10 +2909,10 @@ /** * Updates the designated column with a binary stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2926,14 +2926,14 @@ /** * Updates the designated column with a character stream value. - * The updateXXX methods are used to update column values - * in the current row or the insert row. The updateXXX + * The {@code updateXXX} methods are used to update column values + * in the current row or the insert row. The {@code updateXXX} * methods do not update the underlying database; instead the - * updateRow or insertRow methods are called + * {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column - * @param reader the new column Reader stream value + * @param reader the new column {@code Reader} stream value * @param length the length of the stream * @throws SQLException if a database access error occurs * @@ -2943,16 +2943,16 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value - * @param scale for java.sql.Types.DECIMAL - * or java.sql.Types.NUMERIC types, + * @param scale for {@code java.sql.Types.DECIMAL} + * or {@code java.sql.Types.NUMERIC} types, * this is the number of digits after the decimal point. For all other * types this value will be ignored. * @throws SQLException if a database access error occurs @@ -2963,11 +2963,11 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2980,7 +2980,7 @@ /** * Inserts the contents of the insert row into this - * ResultSet object and into the database + * {@code ResultSet} object and into the database * and also notifies listeners that a row has changed. * The cursor must be on the insert row when this method is called. * @@ -3000,14 +3000,14 @@ /** * Updates the underlying database with the new contents of the - * current row of this rowset's ResultSet object + * current row of this rowset's {@code ResultSet} object * and notifies listeners that a row has changed. * This method cannot be called when the cursor is on the insert row. * * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is * on the insert row, (3) the concurrency of the result - * set is ResultSet.CONCUR_READ_ONLY, or + * set is {@code ResultSet.CONCUR_READ_ONLY}, or * (4) this rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -3019,18 +3019,18 @@ } /** - * Deletes the current row from this rowset's ResultSet object + * Deletes the current row from this rowset's {@code ResultSet} object * and from the underlying database and also notifies listeners that a row * has changed. This method cannot be called when the cursor is on the insert * row. * * @throws SQLException if a database access error occurs - * or if this method is called when the cursor is on the insert row + * or if this method is called when the cursor is on the insert row * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is before the * first row, after the last row, or on the insert row, * (3) the concurrency of this rowset's result - * set is ResultSet.CONCUR_READ_ONLY, or + * set is {@code ResultSet.CONCUR_READ_ONLY}, or * (4) this rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -3042,24 +3042,24 @@ } /** - * Refreshes the current row of this rowset's ResultSet + * Refreshes the current row of this rowset's {@code ResultSet} * object with its most recent value in the database. This method * cannot be called when the cursor is on the insert row. * - * The refreshRow method provides a way for an + * The {@code refreshRow} method provides a way for an * application to explicitly tell the JDBC driver to refetch * a row(s) from the database. An application may want to call - * refreshRow when caching or prefetching is being + * {@code refreshRow} when caching or prefetching is being * done by the JDBC driver to fetch the latest value of a row * from the database. The JDBC driver may actually refresh multiple * rows at once if the fetch size is greater than one. * * All values are refetched subject to the transaction isolation - * level and cursor sensitivity. If refreshRow is called after - * calling an updateXXX method, but before calling - * the method updateRow, then the + * level and cursor sensitivity. If {@code refreshRow} is called after + * calling an {@code updateXXX} method, but before calling + * the method {@code updateRow}, then the * updates made to the row are lost. Calling the method - * refreshRow frequently will likely slow performance. + * {@code refreshRow} frequently will likely slow performance. * * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is @@ -3076,12 +3076,12 @@ /** * Cancels the updates made to the current row in this - * ResultSet object and notifies listeners that a row + * {@code ResultSet} object and notifies listeners that a row * has changed. This method may be called after calling an - * updateXXX method(s) and before calling - * the method updateRow to roll back + * {@code updateXXX} method(s) and before calling + * the method {@code updateRow} to roll back * the updates made to a row. If no updates have been made or - * updateRow has already been called, this method has no + * {@code updateRow} has already been called, this method has no * effect. * * @throws SQLException if (1) a database access error occurs, @@ -3104,19 +3104,19 @@ * * The insert row is a special row associated with an updatable * result set. It is essentially a buffer where a new row may - * be constructed by calling the updateXXX methods prior to + * be constructed by calling the {@code updateXXX} methods prior to * inserting the row into the result set. * - * Only the updateXXX, getXXX, - * and insertRow methods may be + * Only the {@code updateXXX}, {@code getXXX}, + * and {@code insertRow} methods may be * called when the cursor is on the insert row. All of the columns in * a result set must be given a value each time this method is - * called before calling insertRow. - * An updateXXX method must be called before a - * getXXX method can be called on a column value. + * called before calling {@code insertRow}. + * An {@code updateXXX} method must be called before a + * {@code getXXX} method can be called on a column value. * * @throws SQLException if (1) a database access error occurs, - * (2) this rowset's ResultSet object is + * (2) this rowset's {@code ResultSet} object is * not updatable, or (3) this rowset does not * currently have a valid connection, prepared statement, * and result set @@ -3134,7 +3134,7 @@ * the insert row. * * @throws SQLException if (1) a database access error occurs, - * (2) this rowset's ResultSet object is + * (2) this rowset's {@code ResultSet} object is * not updatable, or (3) this rowset does not * currently have a valid connection, prepared statement, * and result set @@ -3146,14 +3146,14 @@ } /** - * Returns the Statement object that produced this - * ResultSet object. + * Returns the {@code Statement} object that produced this + * {@code ResultSet} object. * If the result set was generated some other way, such as by a - * DatabaseMetaData method, this method returns - * null. + * {@code DatabaseMetaData} method, this method returns + * {@code null}. * - * @return the Statement object that produced - * this rowset's ResultSet object or null + * @return the {@code Statement} object that produced + * this rowset's {@code ResultSet} object or {@code null} * if the result set was produced some other way * @throws SQLException if a database access error occurs */ @@ -3169,16 +3169,16 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Object. - * This method uses the given Map object + * of this rowset's {@code ResultSet} object as an {@code Object}. + * This method uses the given {@code Map} object * for the custom mapping of the * SQL structured or distinct type that is being retrieved. * * @param i the first column is 1, the second is 2, and so on - * @param map a java.util.Map object that contains the mapping - * from SQL type names to classes in the Java programming language - * @return an Object in the Java programming language - * representing the SQL value + * @param map a {@code java.util.Map} object that contains the mapping + * from SQL type names to classes in the Java programming language + * @return an {@code Object} in the Java programming language + * representing the SQL value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3193,10 +3193,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Ref object. + * of this rowset's {@code ResultSet} object as a {@code Ref} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL {@code REF} value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3210,10 +3210,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Blob object. + * of this rowset's {@code ResultSet} object as a {@code Blob} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Blob object representing the SQL BLOB + * @return a {@code Blob} object representing the SQL {@code BLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3227,10 +3227,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Clob object. + * of this rowset's {@code ResultSet} object as a {@code Clob} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Clob object representing the SQL CLOB + * @return a {@code Clob} object representing the SQL {@code CLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3244,10 +3244,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Array object. + * of this rowset's {@code ResultSet} object as an {@code Array} object. * * @param i the first column is 1, the second is 2, and so on. - * @return an Array object representing the SQL ARRAY + * @return an {@code Array} object representing the SQL {@code ARRAY} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3261,14 +3261,14 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Object. - * This method uses the specified Map object for + * of this rowset's {@code ResultSet} object as an {@code Object}. + * This method uses the specified {@code Map} object for * custom mapping if appropriate. * * @param colName the name of the column from which to retrieve the value - * @param map a java.util.Map object that contains the mapping + * @param map a {@code java.util.Map} object that contains the mapping * from SQL type names to classes in the Java programming language - * @return an Object representing the SQL + * @return an {@code Object} representing the SQL * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3282,10 +3282,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Ref object. + * of this rowset's {@code ResultSet} object as a {@code Ref} object. * * @param colName the column name - * @return a Ref object representing the SQL REF value in + * @return a {@code Ref} object representing the SQL {@code REF} value in * the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3297,10 +3297,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Blob object. + * of this rowset's {@code ResultSet} object as a {@code Blob} object. * * @param colName the name of the column from which to retrieve the value - * @return a Blob object representing the SQL BLOB + * @return a {@code Blob} object representing the SQL {@code BLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3312,10 +3312,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Clob object. + * of this rowset's {@code ResultSet} object as a {@code Clob} object. * * @param colName the name of the column from which to retrieve the value - * @return a Clob object representing the SQL CLOB + * @return a {@code Clob} object representing the SQL {@code CLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3327,10 +3327,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Array object. + * of this rowset's {@code ResultSet} object as an {@code Array} object. * * @param colName the name of the column from which to retrieve the value - * @return an Array object representing the SQL ARRAY + * @return an {@code Array} object representing the SQL {@code ARRAY} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3342,17 +3342,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Date + * of this rowset's {@code ResultSet} object as a {@code java.sql.Date} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the date - * @return the column value as a java.sql.Date object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Date} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3365,17 +3365,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Date + * of this rowset's {@code ResultSet} object as a {@code java.sql.Date} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column from which to retrieve the value - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the date - * @return the column value as a java.sql.Date object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Date} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3387,17 +3387,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Time + * of this rowset's {@code ResultSet} object as a {@code java.sql.Time} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the time - * @return the column value as a java.sql.Time object; - * if the value is SQL NULL, - * the value returned is null in the Java programming language + * @return the column value as a {@code java.sql.Time} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} in the Java programming language * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3410,17 +3410,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Time + * of this rowset's {@code ResultSet} object as a {@code java.sql.Time} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the time - * @return the column value as a java.sql.Time object; - * if the value is SQL NULL, - * the value returned is null in the Java programming language + * @return the column value as a {@code java.sql.Time} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} in the Java programming language * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3431,18 +3431,18 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as a + * {@code java.sql.Timestamp} object. * This method uses the given calendar to construct an appropriate millisecond * value for the timestamp if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the timestamp - * @return the column value as a java.sql.Timestamp object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Timestamp} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3455,18 +3455,18 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as a + * {@code java.sql.Timestamp} object. * This method uses the given calendar to construct an appropriate millisecond * value for the timestamp if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the timestamp - * @return the column value as a java.sql.Timestamp object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Timestamp} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3478,8 +3478,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3490,14 +3490,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new Ref column value + * @param ref the new {@code Ref} column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { @@ -3507,8 +3507,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3519,13 +3519,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param ref the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { @@ -3534,8 +3534,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3546,14 +3546,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { checkState(); @@ -3563,8 +3563,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3575,13 +3575,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { updateClob(findColumn(columnName), c); @@ -3589,8 +3589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3601,14 +3601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { checkState(); @@ -3617,8 +3617,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3629,13 +3629,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { updateBlob(findColumn(columnName), b); @@ -3643,8 +3643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3655,14 +3655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { checkState(); @@ -3671,8 +3671,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3683,20 +3683,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { updateArray(findColumn(columnName), a); } /** - * Provide interface coverage for getURL(int) in ResultSet->RowSet + * Provide interface coverage for getURL(int) in {@code ResultSet->RowSet} */ public java.net.URL getURL(int columnIndex) throws SQLException { checkState(); @@ -3704,7 +3704,7 @@ } /** - * Provide interface coverage for getURL(String) in ResultSet->RowSet + * Provide interface coverage for getURL(String) in {@code ResultSet->RowSet} */ public java.net.URL getURL(String columnName) throws SQLException { return getURL(findColumn(columnName)); @@ -3712,14 +3712,14 @@ /** * Return the RowSetWarning object for the current row of a - * JdbcRowSetImpl + * {@code JdbcRowSetImpl} */ public RowSetWarning getRowSetWarnings() throws SQLException { return null; } /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3728,8 +3728,8 @@ * @param columnIdxes the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * parameter index is out of bounds or if the columnIdx is + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { @@ -3748,7 +3748,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3757,8 +3757,8 @@ * @param columnIdxes the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * parameter index is out of bounds or if the columnName is + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { @@ -3774,11 +3774,11 @@ } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -3796,10 +3796,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -3829,19 +3829,19 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(int[] columnIdxes) throws SQLException { @@ -3858,17 +3858,17 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(String[] columnNames) throws SQLException { @@ -3883,22 +3883,22 @@ } - /** - * Sets the designated parameter to the given int + /** + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(int columnIdx) throws SQLException { // validate, if col is ok to be set @@ -3912,19 +3912,19 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(String columnName) throws SQLException { // validate, if col is ok to be set @@ -3938,8 +3938,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3948,8 +3948,8 @@ * @param columnIdx the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * parameter index is out of bounds or if the columnIdx is + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { // check if we are unsetting the SAME column @@ -3964,8 +3964,8 @@ } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3974,8 +3974,8 @@ * @param columnName the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * parameter index is out of bounds or if the columnName is + * not the same as set using {@code setMatchColumn(String)} * */ public void unsetMatchColumn(String columnName) throws SQLException { @@ -3992,12 +3992,12 @@ } /** - * Retrieves the DatabaseMetaData associated with + * Retrieves the {@code DatabaseMetaData} associated with * the connection handle associated with this - * JdbcRowSet object. + * {@code JdbcRowSet} object. * - * @return the DatabaseMetadata associated - * with the rowset's connection. + * @return the {@code DatabaseMetadata} associated + * with the rowset's connection. * @throws SQLException if a database access error occurs */ public DatabaseMetaData getDatabaseMetaData() throws SQLException { @@ -4006,12 +4006,12 @@ } /** - * Retrieves the ParameterMetaData associated with + * Retrieves the {@code ParameterMetaData} associated with * the connection handle associated with this - * JdbcRowSet object. + * {@code JdbcRowSet} object. * - * @return the ParameterMetadata associated - * with the rowset's connection. + * @return the {@code ParameterMetadata} associated + * with the rowset's connection. * @throws SQLException if a database access error occurs */ public ParameterMetaData getParameterMetaData() throws SQLException { @@ -4020,18 +4020,18 @@ } /** - * Commits all updates in this JdbcRowSet object by - * wrapping the internal Connection object and calling - * its commit method. - * This method sets this JdbcRowSet object's private field - * rs to null after saving its value to another - * object, but only if the ResultSet - * constant HOLD_CURSORS_OVER_COMMIT has not been set. - * (The field rs is this JdbcRowSet object's - * ResultSet object.) + * Commits all updates in this {@code JdbcRowSet} object by + * wrapping the internal {@code Connection} object and calling + * its {@code commit} method. + * This method sets this {@code JdbcRowSet} object's private field + * {@code rs} to {@code null} after saving its value to another + * object, but only if the {@code ResultSet} + * constant {@code HOLD_CURSORS_OVER_COMMIT} has not been set. + * (The field {@code rs} is this {@code JdbcRowSet} object's + * {@code ResultSet} object.) * * @throws SQLException if autoCommit is set to true or if a database - * access error occurs + * access error occurs */ public void commit() throws SQLException { conn.commit(); @@ -4045,8 +4045,8 @@ } /** - * Sets auto-commit on the internal Connection object with this - * JdbcRowSet + * Sets auto-commit on the internal {@code Connection} object with this + * {@code JdbcRowSet} * * @throws SQLException if a database access error occurs */ @@ -4074,7 +4074,7 @@ } /** - * Returns the auto-commit status with this JdbcRowSet. + * Returns the auto-commit status with this {@code JdbcRowSet}. * * @return true if auto commit is true; false otherwise * @throws SQLException if a database access error occurs @@ -4084,16 +4084,16 @@ } /** - * Rolls back all the updates in this JdbcRowSet object by - * wrapping the internal Connection object and calling its - * rollback method. - * This method sets this JdbcRowSet object's private field - * rs to null after saving its value to another object. - * (The field rs is this JdbcRowSet object's - * internal ResultSet object.) + * Rolls back all the updates in this {@code JdbcRowSet} object by + * wrapping the internal {@code Connection} object and calling its + * {@code rollback} method. + * This method sets this {@code JdbcRowSet} object's private field + * {@code rs} to {@code null} after saving its value to another object. + * (The field {@code rs} is this {@code JdbcRowSet} object's + * internal {@code ResultSet} object.) * * @throws SQLException if autoCommit is set to true or a database - * access error occurs + * access error occurs */ public void rollback() throws SQLException { conn.rollback(); @@ -4106,14 +4106,14 @@ /** - * Rollbacks all the updates in the JdbcRowSet back to the - * last Savepoint transaction marker. Wraps the internal - * Connection object and call it's rollback method + * Rollbacks all the updates in the {@code JdbcRowSet} back to the + * last {@code Savepoint} transaction marker. Wraps the internal + * {@code Connection} object and call it's rollback method * - * @param s the Savepoint transaction marker to roll the - * transaction to. + * @param s the {@code Savepoint} transaction marker to roll the + * transaction to. * @throws SQLException if autoCommit is set to true; or ia a database - * access error occurs + * access error occurs */ public void rollback(Savepoint s) throws SQLException { conn.rollback(s); @@ -4144,10 +4144,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's Connection property + * Gets this {@code JdbcRowSet} object's Connection property * * - * @return the Connection object associated with this rowset; + * @return the {@code Connection} object associated with this rowset; */ protected Connection getConnection() { @@ -4158,10 +4158,10 @@ // Added as per rave requirements /** - * Sets this JdbcRowSet object's connection property - * to the given Connection object. + * Sets this {@code JdbcRowSet} object's connection property + * to the given {@code Connection} object. * - * @param connection the Connection object. + * @param connection the {@code Connection} object. */ protected void setConnection(Connection connection) { @@ -4172,10 +4172,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's PreparedStatement property + * Gets this {@code JdbcRowSet} object's PreparedStatement property * * - * @return the PreparedStatement object associated with this rowset; + * @return the {@code PreparedStatement} object associated with this rowset; */ protected PreparedStatement getPreparedStatement() { @@ -4186,10 +4186,10 @@ // Added as per Rave requirements /** - * Sets this JdbcRowSet object's preparedtsatement property - * to the given PreparedStatemennt object. + * Sets this {@code JdbcRowSet} object's preparedtsatement property + * to the given {@code PreparedStatemennt} object. * - * @param preparedStatement the PreparedStatement object + * @param preparedStatement the {@code PreparedStatement} object * */ protected void setPreparedStatement(PreparedStatement preparedStatement) { @@ -4200,10 +4200,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's ResultSet property + * Gets this {@code JdbcRowSet} object's ResultSet property * * - * @return the ResultSet object associated with this rowset; + * @return the {@code ResultSet} object associated with this rowset; */ protected ResultSet getResultSet() throws SQLException { @@ -4217,10 +4217,10 @@ // Added as per Rave requirements /** - * Sets this JdbcRowSet object's resultset property - * to the given ResultSet object. + * Sets this {@code JdbcRowSet} object's resultset property + * to the given {@code ResultSet} object. * - * @param resultSet the ResultSet object + * @param resultSet the {@code ResultSet} object * */ protected void setResultSet(ResultSet resultSet) { @@ -4228,25 +4228,25 @@ } /** - * Sets this JdbcRowSet object's command property to - * the given String object and clears the parameters, if any, + * Sets this {@code JdbcRowSet} object's {@code command} property to + * the given {@code String} object and clears the parameters, if any, * that were set for the previous command. In addition, - * if the command property has previously been set to a + * if the {@code command} property has previously been set to a * non-null value and it is - * different from the String object supplied, - * this method sets this JdbcRowSet object's private fields - * ps and rs to null. - * (The field ps is its PreparedStatement object, and - * the field rs is its ResultSet object.) + * different from the {@code String} object supplied, + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps} and {@code rs} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, and + * the field {@code rs} is its {@code ResultSet} object.) * - * The command property may not be needed if the RowSet + * The {@code command} property may not be needed if the {@code RowSet} * object gets its data from a source that does not support commands, * such as a spreadsheet or other tabular file. - * Thus, this property is optional and may be null. + * Thus, this property is optional and may be {@code null}. * - * @param command a String object containing an SQL query - * that will be set as this RowSet object's command - * property; may be null but may not be an empty string + * @param command a {@code String} object containing an SQL query + * that will be set as this {@code RowSet} object's command + * property; may be {@code null} but may not be an empty string * @throws SQLException if an empty string is provided as the command value * @see #getCommand */ @@ -4265,32 +4265,32 @@ } /** - * Sets the dataSourceName property for this JdbcRowSet - * object to the given logical name and sets this JdbcRowSet object's - * Url property to null. In addition, if the dataSourceName + * Sets the {@code dataSourceName} property for this {@code JdbcRowSet} + * object to the given logical name and sets this {@code JdbcRowSet} object's + * Url property to {@code null}. In addition, if the {@code dataSourceName} * property has previously been set and is different from the one supplied, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * the field rs is its ResultSet object, and - * the field conn is its Connection object.) + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * the field {@code rs} is its {@code ResultSet} object, and + * the field {@code conn} is its {@code Connection} object.) * * The name supplied to this method must have been bound to a - * DataSource object in a JNDI naming service so that an + * {@code DataSource} object in a JNDI naming service so that an * application can do a lookup using that name to retrieve the - * DataSource object bound to it. The DataSource + * {@code DataSource} object bound to it. The {@code DataSource} * object can then be used to establish a connection to the data source it * represents. * * Users should set either the Url property or the dataSourceName property. * If both properties are set, the driver will use the property set most recently. * - * @param dsName a String object with the name that can be supplied + * @param dsName a {@code String} object with the name that can be supplied * to a naming service based on JNDI technology to retrieve the - * DataSource object that can be used to get a connection; - * may be null + * {@code DataSource} object that can be used to get a connection; + * may be {@code null} * @throws SQLException if there is a problem setting the - * dataSourceName property + * {@code dataSourceName} property * @see #getDataSourceName */ public void setDataSourceName(String dsName) throws SQLException{ @@ -4310,42 +4310,42 @@ /** - * Sets the Url property for this JdbcRowSet object - * to the given String object and sets the dataSource name - * property to null. In addition, if the Url property has - * previously been set to a non null value and its value + * Sets the Url property for this {@code JdbcRowSet} object + * to the given {@code String} object and sets the dataSource name + * property to {@code null}. In addition, if the Url property has + * previously been set to a non {@code null} value and its value * is different from the value to be set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * the field rs is its ResultSet object, and - * the field conn is its Connection object.) + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * the field {@code rs} is its {@code ResultSet} object, and + * the field {@code conn} is its {@code Connection} object.) * * The Url property is a JDBC URL that is used when * the connection is created using a JDBC technology-enabled driver - * ("JDBC driver") and the DriverManager. + * ("JDBC driver") and the {@code DriverManager}. * The correct JDBC URL for the specific driver to be used can be found * in the driver documentation. Although there are guidelines for how * a JDBC URL is formed, - * a driver vendor can specify any String object except - * one with a length of 0 (an empty string). + * a driver vendor can specify any {@code String} object except + * one with a length of {@code 0} (an empty string). * * Setting the Url property is optional if connections are established using - * a DataSource object instead of the DriverManager. + * a {@code DataSource} object instead of the {@code DriverManager}. * The driver will use either the URL property or the * dataSourceName property to create a connection, whichever was * specified most recently. If an application uses a JDBC URL, it * must load a JDBC driver that accepts the JDBC URL before it uses the - * RowSet object to connect to a database. The RowSet + * {@code RowSet} object to connect to a database. The {@code RowSet} * object will use the URL internally to create a database connection in order * to read or write data. * - * @param url a String object that contains the JDBC URL + * @param url a {@code String} object that contains the JDBC URL * that will be used to establish the connection to a database for this - * RowSet object; may be null but must not + * {@code RowSet} object; may be {@code null} but must not * be an empty string * @throws SQLException if an error occurs setting the Url property or the - * parameter supplied is a string with a length of 0 (an + * parameter supplied is a string with a length of {@code 0} (an * empty string) * @see #getUrl */ @@ -4365,24 +4365,24 @@ } } - /** - * Sets the username property for this JdbcRowSet object + /** + * Sets the username property for this {@code JdbcRowSet} object * to the given user name. Because it * is not serialized, the username property is set at run time before - * calling the method execute. In addition, - * if the username property is already set with a - * non-null value and that value is different from the String + * calling the method {@code execute}. In addition, + * if the {@code username} property is already set with a + * non-null value and that value is different from the {@code String} * object to be set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * rs is its ResultSet object, and - * conn is its Connection object.) - * Setting these fields to null ensures that only current + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * {@code rs} is its {@code ResultSet} object, and + * {@code conn} is its {@code Connection} object.) + * Setting these fields to {@code null} ensures that only current * values will be used. * - * @param uname the String object containing the user name that - * is supplied to the data source to create a connection. It may be null. + * @param uname the {@code String} object containing the user name that + * is supplied to the data source to create a connection. It may be null. * @see #getUsername */ public void setUsername(String uname) { @@ -4401,23 +4401,23 @@ } /** - * Sets the password property for this JdbcRowSet object - * to the given String object. Because it + * Sets the password property for this {@code JdbcRowSet} object + * to the given {@code String} object. Because it * is not serialized, the password property is set at run time before - * calling the method execute. Its default valus is - * null. In addition, - * if the password property is already set with a + * calling the method {@code execute}. Its default valus is + * {@code null}. In addition, + * if the {@code password} property is already set with a * non-null value and that value is different from the one being set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * rs is its ResultSet object, and - * conn is its Connection object.) - * Setting these fields to null ensures that only current + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * {@code rs} is its {@code ResultSet} object, and + * {@code conn} is its {@code Connection} object.) + * Setting these fields to {@code null} ensures that only current * values will be used. * - * @param password the String object that represents the password - * that must be supplied to the database to create a connection + * @param password the {@code String} object that represents the password + * that must be supplied to the database to create a connection */ public void setPassword(String password) { @@ -4435,18 +4435,18 @@ } /** - * Sets the type for this RowSet object to the specified type. - * The default type is ResultSet.TYPE_SCROLL_INSENSITIVE. + * Sets the type for this {@code RowSet} object to the specified type. + * The default type is {@code ResultSet.TYPE_SCROLL_INSENSITIVE}. * * @param type one of the following constants: - * ResultSet.TYPE_FORWARD_ONLY, - * ResultSet.TYPE_SCROLL_INSENSITIVE, or - * ResultSet.TYPE_SCROLL_SENSITIVE + * {@code ResultSet.TYPE_FORWARD_ONLY}, + * {@code ResultSet.TYPE_SCROLL_INSENSITIVE}, or + * {@code ResultSet.TYPE_SCROLL_SENSITIVE} * @throws SQLException if the parameter supplied is not one of the * following constants: - * ResultSet.TYPE_FORWARD_ONLY or - * ResultSet.TYPE_SCROLL_INSENSITIVE - * ResultSet.TYPE_SCROLL_SENSITIVE + * {@code ResultSet.TYPE_FORWARD_ONLY} or + * {@code ResultSet.TYPE_SCROLL_INSENSITIVE} + * {@code ResultSet.TYPE_SCROLL_SENSITIVE} * @see #getConcurrency * @see #getType */ @@ -4468,18 +4468,18 @@ } /** - * Sets the concurrency for this RowSet object to - * the specified concurrency. The default concurrency for any RowSet - * object (connected or disconnected) is ResultSet.CONCUR_UPDATABLE, + * Sets the concurrency for this {@code RowSet} object to + * the specified concurrency. The default concurrency for any {@code RowSet} + * object (connected or disconnected) is {@code ResultSet.CONCUR_UPDATABLE}, * but this method may be called at any time to change the concurrency. * * @param concur one of the following constants: - * ResultSet.CONCUR_READ_ONLY or - * ResultSet.CONCUR_UPDATABLE + * {@code ResultSet.CONCUR_READ_ONLY} or + * {@code ResultSet.CONCUR_UPDATABLE} * @throws SQLException if the parameter supplied is not one of the * following constants: - * ResultSet.CONCUR_UPDATABLE or - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_UPDATABLE} or + * {@code ResultSet.CONCUR_READ_ONLY} * @see #getConcurrency * @see #isReadOnly */ @@ -4500,8 +4500,8 @@ } /** - * Retrieves the value of the designated SQL XML parameter as a - * SQLXML object in the Java programming language. + * Retrieves the value of the designated {@code SQL XML} parameter as a + * {@code SQLXML} object in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @return a SQLXML object that maps an SQL XML value * @throws SQLException if a database access error occurs @@ -4512,8 +4512,8 @@ } /** - * Retrieves the value of the designated SQL XML parameter as a - * SQLXML object in the Java programming language. + * Retrieves the value of the designated {@code SQL XML} parameter as a + * {@code SQLXML} object in the Java programming language. * @param colName the name of the column from which to retrieve the value * @return a SQLXML object that maps an SQL XML value * @throws SQLException if a database access error occurs @@ -4524,12 +4524,12 @@ /** * Retrieves the value of the designated column in the current row of this - * ResultSet object as a java.sql.RowId object in the Java + * {@code ResultSet} object as a java.sql.RowId object in the Java * programming language. * * @param columnIndex the first column is 1, the second 2, ... - * @return the column value if the value is a SQL NULL the - * value returned is null + * @return the column value if the value is a SQL {@code NULL} the + * value returned is {@code null} * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4539,12 +4539,12 @@ /** * Retrieves the value of the designated column in the current row of this - * ResultSet object as a java.sql.RowId object in the Java + * {@code ResultSet} object as a java.sql.RowId object in the Java * programming language. * * @param columnName the name of the column - * @return the column value if the value is a SQL NULL the - * value returned is null + * @return the column value if the value is a SQL {@code NULL} the + * value returned is {@code null} * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4553,10 +4553,10 @@ } /** - * Updates the designated column with a RowId value. The updater + * Updates the designated column with a {@code RowId} value. The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnIndex the first column is 1, the second 2, ... @@ -4569,10 +4569,10 @@ } /** - * Updates the designated column with a RowId value. The updater + * Updates the designated column with a {@code RowId} value. The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4631,8 +4631,8 @@ /*o - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnIndex the first column is 1, the second 2, ... * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4643,8 +4643,8 @@ } /** - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnName name of the column * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4656,12 +4656,12 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param i the first column is 1, the second is 2, ... - * @return a NClob object representing the SQL - * NCLOB value in the specified column + * @return a {@code NClob} object representing the SQL + * {@code NCLOB} value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4672,11 +4672,11 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param colName the name of the column from which to retrieve the value - * @return a NClob object representing the SQL NCLOB + * @return a {@code NClob} object representing the SQL {@code NCLOB} * value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 @@ -4694,10 +4694,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * SQL {@code XML} value when it sends it to the database. * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an SQL {@code XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4706,10 +4706,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * {@code SQL XML} value when it sends it to the database. * @param parameterName the name of the parameter - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an {@code SQL XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4718,8 +4718,8 @@ } /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID value when it sends it + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} value when it sends it * to the database * * @param parameterIndex the first parameter is 1, the second is 2, ... @@ -4732,9 +4732,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID when it sends it to the + /** + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} when it sends it to the * database. * * @param parameterName the name of the parameter @@ -4748,18 +4748,18 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR value + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on NVARCHAR values) + * size relative to the driver's limits on {@code NVARCHAR} values) * when it sends it to the database. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNString(int parameterIndex, String value) throws SQLException { @@ -4768,9 +4768,9 @@ /** - * Sets the designated parameter in this RowSet object's command - * to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter in this {@code RowSet} object's command + * to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -4779,14 +4779,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed PreparedStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -4795,14 +4795,14 @@ } /** - * Sets the designated parameter to a java.sql.NClob object. The object - * implements the java.sql.NClob interface. This NClob - * object maps to a SQL NCLOB. + * Sets the designated parameter to a {@code java.sql.NClob} object. The object + * implements the {@code java.sql.NClob} interface. This {@code NClob} + * object maps to a SQL {@code NCLOB}. * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(String parameterName, NClob value) throws SQLException { @@ -4810,17 +4810,17 @@ } - /** + /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @exception SQLException if a database access error occurs * @since 1.6 @@ -4832,16 +4832,16 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the name of the column - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4850,11 +4850,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * @param columnIndex the first column is 1, the second 2, ... * @param xmlObject the value for the column to be updated @@ -4866,11 +4866,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4884,15 +4884,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnIndex the first column is 1, the second is 2, ... - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4902,15 +4902,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4927,9 +4927,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnIndex - the first column is 1, the second is 2, ... - * @param x - the new column value - * @param length - the length of the stream + * @param columnIndex the first column is 1, the second is 2, ... + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4949,9 +4949,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnName - name of the Column - * @param x - the new column value - * @param length - the length of the stream + * @param columnName name of the Column + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4963,26 +4963,27 @@ } /** - * Updates the designated column with a character stream value. The + * Updates the designated column with a character stream value. The * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} or this + * method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -4997,26 +4998,27 @@ * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * the result set concurrency is {@code CONCUR_READ_ONLY} or + * this method is called on a closed result set + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method * @since 1.6 */ public void updateNCharacterStream(String columnLabel, @@ -5027,9 +5029,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5039,16 +5041,16 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5060,9 +5062,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5072,18 +5074,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, + * then the label is the name of the column. * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException { @@ -5092,9 +5096,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5102,23 +5106,23 @@ * Java stream object or your own subclass that implements the * standard interface. * - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException { @@ -5127,9 +5131,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5138,22 +5142,23 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException { @@ -5161,11 +5166,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5175,17 +5180,17 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5193,11 +5198,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5207,17 +5212,18 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5225,33 +5231,33 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader) throws SQLException { @@ -5259,34 +5265,35 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader) throws SQLException { @@ -5294,11 +5301,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5308,19 +5315,19 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5328,11 +5335,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5342,19 +5349,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5362,11 +5370,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5375,22 +5383,22 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader) throws SQLException { @@ -5398,11 +5406,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5411,23 +5419,24 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader) throws SQLException { @@ -5435,22 +5444,22 @@ } - /** + /** * Updates the designated column with an ascii stream value, which will have * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5464,17 +5473,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBinaryStream(int columnIndex, @@ -5488,17 +5497,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5512,17 +5521,19 @@ * the specified number of bytes.. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5535,20 +5546,20 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5560,21 +5571,22 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5588,15 +5600,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5611,18 +5625,18 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5637,19 +5651,20 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5665,18 +5680,20 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5689,20 +5706,20 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5714,22 +5731,23 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5738,97 +5756,98 @@ } - /** - * Sets the designated parameter to the given java.net.URL value. - * The driver converts this to an SQL DATALINK value - * when it sends it to the database. - * - * @param parameterIndex the first parameter is 1, the second is 2, ... - * @param x the java.net.URL object to be set - * @exception SQLException if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.4 - */ + /** + * Sets the designated parameter to the given {@code java.net.URL} value. + * The driver converts this to an SQL {@code DATALINK} value + * when it sends it to the database. + * + * @param parameterIndex the first parameter is 1, the second is 2, ... + * @param x the {@code java.net.URL} object to be set + * @exception SQLException if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * @since 1.4 + */ public void setURL(int parameterIndex, java.net.URL x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB - * Note: Consult your JDBC driver documentation to determine if - * it might be more efficient to use a version of - * setNClob which takes a length parameter. - * - * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param reader An object that contains the data to set the parameter value to. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * - * @since 1.6 - */ + /** + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * Note: Consult your JDBC driver documentation to determine if + * it might be more efficient to use a version of + * {@code setNClob} which takes a length parameter. + * + * @param parameterIndex index of the first parameter is 1, the second is 2, ... + * @param reader An object that contains the data to set the parameter value to. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * + * @since 1.6 + */ public void setNClob(int parameterIndex, Reader reader) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB - * - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national - * character sets; if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * @since 1.6 - */ - public void setNClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. + * The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national + * character sets; if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * @since 1.6 + */ + public void setNClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); - } + } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNClob which takes a length parameter. + * {@code setNClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5839,23 +5858,24 @@ } - /** - ** of characters specified by length otherwise a SQLException will becontain the number - * generated when the PreparedStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method + /** + * of characters specified by length otherwise a {@code SQLException} will becontain the number + * generated when the {@code PreparedStatement} is executed. + * This method differs from the {@code setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5867,14 +5887,14 @@ /** - * Sets the designated parameter to a java.sql.NClob object. The driver converts this to -a - * SQL NCLOB value when it sends it to the database. + * Sets the designated parameter to a {@code java.sql.NClob} object. + * The driver converts this to an + * SQL {@code NCLOB} value when it sends it to the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(int parameterIndex, NClob value) throws SQLException{ @@ -5883,14 +5903,14 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNString(String parameterName, String value) @@ -5899,8 +5919,8 @@ } /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... @@ -5908,7 +5928,7 @@ * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException{ @@ -5918,8 +5938,8 @@ /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterName the name of the column to be set @@ -5935,9 +5955,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + /** + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -5946,14 +5966,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed CallableStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -5962,23 +5982,23 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIMESTAMP value, + * Sets the designated parameter to the given {@code java.sql.Timestamp} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIMESTAMP} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the timestamp + * a {@code Calendar} object, the driver can calculate the timestamp * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use - * to construct the timestamp + * @param cal the {@code Calendar} object the driver will use + * to construct the timestamp * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -5987,28 +6007,29 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } @@ -6016,16 +6037,16 @@ /** - * Sets the designated parameter to the given java.sql.Clob object. - * The driver converts this to an SQL CLOB value when it + * Sets the designated parameter to the given {@code java.sql.Clob} object. + * The driver converts this to an SQL {@code CLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Clob object that maps an SQL CLOB value + * @param x a {@code Clob} object that maps an SQL {@code CLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setClob (String parameterName, Clob x) throws SQLException{ @@ -6033,21 +6054,21 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs or this method is called on - * a closed CallableStatement + * a closed {@code CallableStatement} * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6058,19 +6079,19 @@ } - /** - * Sets the designated parameter to the given java.sql.Date value + /** + * Sets the designated parameter to the given {@code java.sql.Date} value * using the default time zone of the virtual machine that is running * the application. * The driver converts this - * to an SQL DATE value when it sends it to the database. + * to an SQL {@code DATE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6080,23 +6101,23 @@ } /** - * Sets the designated parameter to the given java.sql.Date value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL DATE value, + * Sets the designated parameter to the given {@code java.sql.Date} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code DATE} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the date + * a {@code Calendar} object, the driver can calculate the date * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the date * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6107,16 +6128,16 @@ /** - * Sets the designated parameter to the given java.sql.Time value. + * Sets the designated parameter to the given {@code java.sql.Time} value. * The driver converts this - * to an SQL TIME value when it sends it to the database. + * to an SQL {@code TIME} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6126,23 +6147,23 @@ } /** - * Sets the designated parameter to the given java.sql.Time value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIME value, + * Sets the designated parameter to the given {@code java.sql.Time} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIME} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the time + * a {@code Calendar} object, the driver can calculate the time * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the time * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6152,22 +6173,22 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatementor if parameterIndex does not correspond to a parameter - * marker in the SQL statement + * a closed {@code PreparedStatement}or if parameterIndex does not correspond to a parameter + * marker in the SQL statement * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6179,19 +6200,19 @@ /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - *This method differs from the setCharacterStream (int, Reader, int) method + * Sets the designated parameter to a {@code Reader} object. The reader 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 setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatement, if parameterIndex does not correspond to a parameter + * a closed {@code PreparedStatement}, if parameterIndex does not correspond to a parameter * marker in the SQL statement, or if the length specified is less than zero. * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method @@ -6204,25 +6225,26 @@ /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) + * Sets the designated parameter to a {@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)} * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... + * the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement, - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, if the length specified - * is less than zero or if the number of bytes in the inputstream does not match - * the specified length. + * this method is called on a closed {@code PreparedStatement}, + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, if the length specified + * is less than zero or if the number of bytes in the inputstream does not match + * the specified length. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6233,28 +6255,27 @@ } /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) - * This method differs from the setBinaryStream (int, InputStream) + * Sets the designated parameter to a {@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 - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... - - + * the second is 2, ... + * * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement or - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, + * this method is called on a closed {@code PreparedStatement} or + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6264,72 +6285,72 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length, otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) - * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, - * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB - * - * @param parameterName the name of the parameter to be set - * the second is 2, ... - * - * @param inputStream An object that contains the data to set the parameter - * value to. - * @param length the number of bytes in the parameter data. - * @throws SQLException if parameterIndex does not correspond - * to a parameter marker in the SQL statement, or if the length specified - * is less than zero; if the number of bytes in the inputstream does not match - * the specified length; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setBlob(String parameterName, InputStream inputStream, long length) + /** + * Sets the designated parameter to a {@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)} + * 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, + * the driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * + * @param parameterName the name of the parameter to be set + * the second is 2, ... + * + * @param inputStream An object that contains the data to set the parameter + * value to. + * @param length the number of bytes in the parameter data. + * @throws SQLException if parameterIndex does not correspond + * to a parameter marker in the SQL statement, or if the length specified + * is less than zero; if the number of bytes in the inputstream does not match + * the specified length; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.Blob object. - * The driver converts this to an SQL BLOB value when it + /** + * Sets the designated parameter to the given {@code java.sql.Blob} object. + * The driver converts this to an SQL {@code BLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Blob object that maps an SQL BLOB value + * @param x a {@code Blob} object that maps an SQL {@code BLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setBlob (String parameterName, Blob x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) + /** + * Sets the designated parameter to a {@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 BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARBINARY or a BLOB + * data should be send to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterName the name of the parameter * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6339,22 +6360,22 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. The second * argument must be an object type; for integral values, the - * java.lang equivalent objects should be used. + * {@code java.lang} equivalent objects should be used. * * The given Java object will be converted to the given targetSqlType * before being sent to the database. * * If the object has a custom mapping (is of a class implementing the - * interface SQLData), - * the JDBC driver should call the method SQLData.writeSQL to write it + * interface {@code SQLData}), + * the JDBC driver should call the method {@code SQLData.writeSQL} to write it * to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * Note that this method may be used to pass datatabase- @@ -6365,17 +6386,17 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database. The scale argument may further qualify this type. * @param scale for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types, this value will be ignored. + * this is the number of digits after the decimal point. For all other + * types, this value will be ignored. * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see Types * @see #getObject * @since 1.4 @@ -6387,7 +6408,7 @@ /** * Sets the value of the designated parameter with the given object. - * This method is like the method setObject + * This method is like the method {@code setObject} * above, except that it assumes a scale of zero. * * @param parameterName the name of the parameter @@ -6395,14 +6416,14 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see #getObject * @since 1.4 */ @@ -6411,13 +6432,13 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. - * The second parameter must be of type Object; therefore, the - * java.lang equivalent objects should be used for built-in types. + * The second parameter must be of type {@code Object}; therefore, the + * {@code java.lang} equivalent objects should be used for built-in types. * * The JDBC specification specifies a standard mapping from - * Java Object types to SQL types. The given argument + * Java {@code Object} types to SQL types. The given argument * will be converted to the corresponding SQL type before being * sent to the database. * @@ -6425,13 +6446,13 @@ * specific abstract data types, by using a driver-specific Java * type. * - * If the object is of a class implementing the interface SQLData, - * the JDBC driver should call the method SQLData.writeSQL + * If the object is of a class implementing the interface {@code SQLData}, + * the JDBC driver should call the method {@code SQLData.writeSQL} * to write it to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * This method throws an exception if there is an ambiguity, for example, if the @@ -6440,10 +6461,10 @@ * @param parameterName the name of the parameter * @param x the object containing the input parameter value * @exception SQLException if a database access error occurs, - * this method is called on a closed CallableStatement or if the given - * Object parameter is ambiguous + * this method is called on a closed {@code CallableStatement} or if the given + * {@code Object} parameter is ambiguous * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getObject * @since 1.4 */ @@ -6454,9 +6475,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6468,9 +6489,9 @@ * @param x the Java input stream that contains the ASCII parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setAsciiStream(String parameterName, java.io.InputStream x, int length) @@ -6482,9 +6503,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the stream + * {@code java.io.InputStream} object. The data will be read from the stream * as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6495,9 +6516,9 @@ * @param x the java input stream which contains the binary parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBinaryStream(String parameterName, java.io.InputStream x, @@ -6506,11 +6527,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6519,13 +6540,13 @@ * standard interface. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that + * @param reader the {@code java.io.Reader} object that * contains the UNICODE data used as the designated parameter * @param length the number of characters in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setCharacterStream(String parameterName, @@ -6536,9 +6557,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6547,15 +6568,15 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setAsciiStream which takes a length parameter. + * {@code setAsciiStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the Java input stream that contains the ASCII parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.6 - */ + * @since 1.6 + */ public void setAsciiStream(String parameterName, java.io.InputStream x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); @@ -6564,9 +6585,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the + * {@code java.io.InputStream} object. The data will be read from the * stream as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6574,12 +6595,12 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBinaryStream which takes a length parameter. + * {@code setBinaryStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the java input stream which contains the binary parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6589,11 +6610,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6602,13 +6623,13 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setCharacterStream which takes a length parameter. + * {@code setCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that contains the + * @param reader the {@code java.io.Reader} object that contains the * Unicode data * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6619,16 +6640,16 @@ /** * Sets the designated parameter to the given - * java.math.BigDecimal value. - * The driver converts this to an SQL NUMERIC value when + * {@code java.math.BigDecimal} value. + * The driver converts this to an SQL {@code NUMERIC} value when * it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBigDecimal * @since 1.4 */ @@ -6636,20 +6657,20 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java String value. + /** + * Sets the designated parameter to the given Java {@code String} value. * The driver converts this - * to an SQL VARCHAR or LONGVARCHAR value + * to an SQL {@code VARCHAR} or {@code LONGVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on VARCHAR values) + * size relative to the driver's limits on {@code VARCHAR} values) * when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getString * @since 1.4 */ @@ -6659,19 +6680,19 @@ - /** + /** * Sets the designated parameter to the given Java array of bytes. - * The driver converts this to an SQL VARBINARY or - * LONGVARBINARY (depending on the argument's size relative - * to the driver's limits on VARBINARY values) when it sends + * The driver converts this to an SQL {@code VARBINARY} or + * {@code LONGVARBINARY} (depending on the argument's size relative + * to the driver's limits on {@code VARBINARY} values) when it sends * it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBytes * @since 1.4 */ @@ -6680,17 +6701,17 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value. + * Sets the designated parameter to the given {@code java.sql.Timestamp} value. * The driver - * converts this to an SQL TIMESTAMP value when it sends it to the + * converts this to an SQL {@code TIMESTAMP} value when it sends it to the * database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -6700,16 +6721,16 @@ } /** - * Sets the designated parameter to SQL NULL. + * Sets the designated parameter to SQL {@code NULL}. * * Note: You must specify the parameter's SQL type. * * @param parameterName the name of the parameter - * @param sqlType the SQL type code defined in java.sql.Types + * @param sqlType the SQL type code defined in {@code java.sql.Types} * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull(String parameterName, int sqlType) throws SQLException { @@ -6717,8 +6738,8 @@ } /** - * Sets the designated parameter to SQL NULL. - * This version of the method setNull should + * Sets the designated parameter to SQL {@code NULL}. + * This version of the method {@code setNull} should * be used for user-defined types and REF type parameters. Examples * of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and * named array types. @@ -6738,14 +6759,14 @@ * * * @param parameterName the name of the parameter - * @param sqlType a value from java.sql.Types + * @param sqlType a value from {@code java.sql.Types} * @param typeName the fully-qualified name of an SQL user-defined type; * ignored if the parameter is not a user-defined type or - * SQL REF value + * SQL {@code REF} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull (String parameterName, int sqlType, String typeName) @@ -6754,17 +6775,17 @@ } /** - * Sets the designated parameter to the given Java boolean value. + * Sets the designated parameter to the given Java {@code boolean} value. * The driver converts this - * to an SQL BIT or BOOLEAN value when it sends it to the database. + * to an SQL {@code BIT} or {@code BOOLEAN} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @see #getBoolean * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBoolean(String parameterName, boolean x) throws SQLException{ @@ -6774,16 +6795,16 @@ /** - * Sets the designated parameter to the given Java byte value. + * Sets the designated parameter to the given Java {@code byte} value. * The driver converts this - * to an SQL TINYINT value when it sends it to the database. + * to an SQL {@code TINYINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getByte * @since 1.4 */ @@ -6793,16 +6814,16 @@ /** - * Sets the designated parameter to the given Java short value. + * Sets the designated parameter to the given Java {@code short} value. * The driver converts this - * to an SQL SMALLINT value when it sends it to the database. + * to an SQL {@code SMALLINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getShort * @since 1.4 */ @@ -6812,16 +6833,16 @@ /** - * Sets the designated parameter to the given Java int value. + * Sets the designated parameter to the given Java {@code int} value. * The driver converts this - * to an SQL INTEGER value when it sends it to the database. + * to an SQL {@code INTEGER} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getInt * @since 1.4 */ @@ -6829,17 +6850,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java long value. + /** + * Sets the designated parameter to the given Java {@code long} value. * The driver converts this - * to an SQL BIGINT value when it sends it to the database. + * to an SQL {@code BIGINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getLong * @since 1.4 */ @@ -6848,17 +6869,17 @@ } - /** - * Sets the designated parameter to the given Java float value. + /** + * Sets the designated parameter to the given Java {@code float} value. * The driver converts this - * to an SQL FLOAT value when it sends it to the database. + * to an SQL {@code FLOAT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getFloat * @since 1.4 */ @@ -6866,17 +6887,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java double value. + /** + * Sets the designated parameter to the given Java {@code double} value. * The driver converts this - * to an SQL DOUBLE value when it sends it to the database. + * to an SQL {@code DOUBLE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDouble * @since 1.4 */ @@ -6887,7 +6908,6 @@ /** * This method re populates the resBundle * during the deserialization process - * */ private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException { // Default state initialization happens here --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.803466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.635466074 +0400 @@ -43,22 +43,22 @@ /** - * The facility called on internally by the RIOptimisticProvider implementation to + * The facility called on internally by the {@code RIOptimisticProvider} implementation to * propagate changes back to the data source from which the rowset got its data. * - * A CachedRowSetWriter object, called a writer, has the public - * method writeData for writing modified data to the underlying data source. + * A {@code CachedRowSetWriter} object, called a writer, has the public + * method {@code writeData} for writing modified data to the underlying data source. * This method is invoked by the rowset internally and is never invoked directly by an application. * A writer also has public methods for setting and getting - * the CachedRowSetReader object, called a reader, that is associated + * the {@code CachedRowSetReader} object, called a reader, that is associated * with the writer. The remainder of the methods in this class are private and * are invoked internally, either directly or indirectly, by the method - * writeData. + * {@code writeData}. * - * Typically the SyncFactory manages the RowSetReader and - * the RowSetWriter implementations using SyncProvider objects. + * Typically the {@code SyncFactory} manages the {@code RowSetReader} and + * the {@code RowSetWriter} implementations using {@code SyncProvider} objects. * Standard JDBC RowSet implementations provide an object instance of this - * writer by invoking the SyncProvider.getRowSetWriter() method. + * writer by invoking the {@code SyncProvider.getRowSetWriter()} method. * * @version 0.2 * @author Jonathan Bruce @@ -69,15 +69,15 @@ public class CachedRowSetWriter implements TransactionalWriter, Serializable { /** - * The Connection object that this writer will use to make a + * The {@code Connection} object that this writer will use to make a * connection to the data source to which it will write data. * */ private transient Connection con; /** - * The SQL SELECT command that this writer will call - * internally. The method initSQLStatements builds this + * The SQL {@code SELECT} command that this writer will call + * internally. The method {@code initSQLStatements} builds this * command by supplying the words "SELECT" and "FROM," and using * metadata to get the table name and column names . * @@ -86,9 +86,9 @@ private String selectCmd; /** - * The SQL UPDATE command that this writer will call + * The SQL {@code UPDATE} command that this writer will call * internally to write data to the rowset's underlying data source. - * The method initSQLStatements builds this String + * The method {@code initSQLStatements} builds this {@code String} * object. * * @serial @@ -96,8 +96,8 @@ private String updateCmd; /** - * The SQL WHERE clause the writer will use for update - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for update + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -105,7 +105,7 @@ private String updateWhere; /** - * The SQL DELETE command that this writer will call + * The SQL {@code DELETE} command that this writer will call * internally to delete a row in the rowset's underlying data source. * * @serial @@ -113,8 +113,8 @@ private String deleteCmd; /** - * The SQL WHERE clause the writer will use for delete - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for delete + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -122,9 +122,9 @@ private String deleteWhere; /** - * The SQL INSERT INTO command that this writer will internally use + * The SQL {@code INSERT INTO} command that this writer will internally use * to insert data into the rowset's underlying data source. The method - * initSQLStatements builds this command with a question + * {@code initSQLStatements} builds this command with a question * mark parameter placeholder for each column in the rowset. * * @serial @@ -133,8 +133,8 @@ /** * An array containing the column numbers of the columns that are - * needed to uniquely identify a row in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * needed to uniquely identify a row in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ @@ -142,7 +142,7 @@ /** * An array of the parameters that should be used to set the parameter - * placeholders in a PreparedStatement object that this + * placeholders in a {@code PreparedStatement} object that this * writer will execute. * * @serial @@ -150,33 +150,33 @@ private Object[] params; /** - * The CachedRowSetReader object that has been - * set as the reader for the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code CachedRowSetReader} object that has been + * set as the reader for the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private CachedRowSetReader reader; /** - * The ResultSetMetaData object that contains information - * about the columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code ResultSetMetaData} object that contains information + * about the columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private ResultSetMetaData callerMd; /** - * The number of columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The number of columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private int callerColumnCount; /** - * This CachedRowSet will hold the conflicting values + * This {@code CachedRowSet} will hold the conflicting values * retrieved from the db and hold it. */ private CachedRowSetImpl crsResolve; @@ -209,8 +209,8 @@ } /** - * Propagates changes in the given RowSet object - * back to its underlying data source and returns true + * Propagates changes in the given {@code RowSet} object + * back to its underlying data source and returns {@code true} * if successful. The writer will check to see if * the data in the pre-modified rowset (the original values) differ * from the data in the underlying data source. If data in the data @@ -221,15 +221,15 @@ * access for concurrent users. * * This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. * - * Creates a CachedRowSet object from the given - * RowSet object + * Creates a {@code CachedRowSet} object from the given + * {@code RowSet} object * Makes a connection with the data source * * Disables autocommit mode if it is not already disabled @@ -237,32 +237,32 @@ * * Checks to see if the reader has read new data since the writer * was last called and, if so, calls the method - * initSQLStatements to initialize new SQL statements + * {@code initSQLStatements} to initialize new SQL statements * - * Builds new SELECT, UPDATE, - * INSERT, and DELETE statements - * Uses the CachedRowSet object's metadata to + * Builds new {@code SELECT}, {@code UPDATE}, + * {@code INSERT}, and {@code DELETE} statements + * Uses the {@code CachedRowSet} object's metadata to * determine the table name, column names, and the columns * that make up the primary key * * When there is no conflict, propagates changes made to the - * CachedRowSet object back to its underlying data source + * {@code CachedRowSet} object back to its underlying data source * - * Iterates through each row of the CachedRowSet object + * Iterates through each row of the {@code CachedRowSet} object * to determine whether it has been updated, inserted, or deleted * If the corresponding row in the data source has not been changed * since the rowset last read its * values, the writer will use the appropriate command to update, * insert, or delete the row * If any data in the data source does not match the original values - * for the CachedRowSet object, the writer will roll + * for the {@code CachedRowSet} object, the writer will roll * back any changes it has made to the row in the data source. * * * - * @return true if changes to the rowset were successfully + * @return {@code true} if changes to the rowset were successfully * written to the rowset's underlying data source; - * false otherwise + * {@code false} otherwise */ public boolean writeData(RowSetInternal caller) throws SQLException { long conflicts = 0; @@ -434,25 +434,25 @@ } //end writeData -/** - * Updates the given CachedRowSet object's underlying data - * source so that updates to the rowset are reflected in the original - * data source, and returns false if the update was successful. - * A return value of true indicates that there is a conflict, - * meaning that a value updated in the rowset has already been changed by - * someone else in the underlying data source. A conflict can also exist - * if, for example, more than one row in the data source would be affected - * by the update or if no rows would be affected. In any case, if there is - * a conflict, this method does not update the underlying data source. - * - * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + * + * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - * - * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + * + * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. * - * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - * - * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + * + * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. * * If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. * * The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. * * NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. * * This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. * - * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. * - * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. * * Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. * - * undoUpdateRowSet object backed by the same data as - * that of this CachedRowSetImpl object and sharing a set of cursors + * Returns a new {@code RowSet} object backed by the same data as + * that of this {@code CachedRowSetImpl} object and sharing a set of cursors * with it. This allows cursors to interate over a shared set of rows, providing * multiple views of the underlying data. * - * @return a RowSet object that is a copy of this CachedRowSetImpl + * @return a {@code RowSet} object that is a copy of this {@code CachedRowSetImpl} * object and shares a set of cursors with it * @throws SQLException if an error occurs or cloning is * not supported @@ -750,19 +750,19 @@ } /** - * Returns a new RowSet object containing by the same data - * as this CachedRowSetImpl object. This method - * differs from the method createCopy in that it throws a - * CloneNotSupportedException object instead of an - * SQLException object, as the method createShared - * does. This clone - * method is called internally by the method createShared, - * which catches the CloneNotSupportedException object - * and in turn throws a new SQLException object. + * Returns a new {@code RowSet} object containing by the same data + * as this {@code CachedRowSetImpl} object. This method + * differs from the method {@code createCopy} in that it throws a + * {@code CloneNotSupportedException} object instead of an + * {@code SQLException} object, as the method {@code createShared} + * does. This {@code clone} + * method is called internally by the method {@code createShared}, + * which catches the {@code CloneNotSupportedException} object + * and in turn throws a new {@code SQLException} object. * - * @return a copy of this CachedRowSetImpl object + * @return a copy of this {@code CachedRowSetImpl} object * @throws CloneNotSupportedException if an error occurs when - * attempting to clone this CachedRowSetImpl object + * attempting to clone this {@code CachedRowSetImpl} object * @see #createShared */ protected Object clone() throws CloneNotSupportedException { @@ -770,8 +770,8 @@ } /** - * Creates a RowSet object that is a deep copy of - * this CachedRowSetImpl object's data, including + * Creates a {@code RowSet} object that is a deep copy of + * this {@code CachedRowSetImpl} object's data, including * constraints. Updates made * on a copy are not visible to the original rowset; * a copy of a rowset is completely independent from the original. @@ -780,12 +780,12 @@ * from first principles, which can be quite expensive. * For example, it can eliminate the need to query a * remote database server. - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSet object and is - * completely independent from this CachedRowSetImpl + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSet} object and is + * completely independent from this {@code CachedRowSetImpl} * object. * @throws SQLException if an error occurs in generating the copy of this - * of the CachedRowSetImpl + * of the {@code CachedRowSetImpl} * @see #createShared * @see javax.sql.RowSetEvent * @see javax.sql.RowSetListener @@ -795,21 +795,21 @@ } /** - * Creates a RowSet object that is a copy of - * this CachedRowSetImpl object's table structure + * Creates a {@code RowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's table structure * and the constraints only. * There will be no data in the object being returned. * Updates made on a copy are not visible to the original rowset. * * This helps in getting the underlying XML schema which can - * be used as the basis for populating a WebRowSet. + * be used as the basis for populating a {@code WebRowSet}. * - * @return a new CachedRowSet object that is a copy - * of this CachedRowSetImpl object's schema and + * @return a new {@code CachedRowSet} object that is a copy + * of this {@code CachedRowSetImpl} object's schema and * retains all the constraints on the original rowset but contains * no data * @throws SQLException if an error occurs in generating the copy - * of the CachedRowSet object + * of the {@code CachedRowSet} object * @see #createShared * @see #createCopy * @see #createCopyNoConstraints @@ -821,17 +821,17 @@ } /** - * Creates a CachedRowSet object that is a copy of - * this CachedRowSetImpl object's data only. + * Creates a {@code CachedRowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's data only. * All constraints set in this object will not be there * in the returning object. Updates made * on a copy are not visible to the original rowset. * - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSetImpl object and is - * completely independent from this CachedRowSetImpl object + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSetImpl} object and is + * completely independent from this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the copy of the - * of the CachedRowSet + * of the {@code CachedRowSet} * @see #createShared * @see #createCopy * @see #createCopySchema @@ -843,15 +843,15 @@ } /** - * Converts this CachedRowSetImpl object to a collection - * of tables. The sample implementation utilitizes the TreeMap + * Converts this {@code CachedRowSetImpl} object to a collection + * of tables. The sample implementation utilitizes the {@code TreeMap} * collection type. * This class guarantees that the map will be in ascending key order, * sorted according to the natural order for the key's class. * - * @return a Collection object consisting of tables, + * @return a {@code Collection} object consisting of tables, * each of which is a copy of a row in this - * CachedRowSetImpl object + * {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the collection * @see #toCollection(int) * @see #toCollection(String) @@ -863,16 +863,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -886,16 +886,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -914,25 +914,25 @@ /** - * Returns the SyncProvider implementation being used - * with this CachedRowSetImpl implementation rowset. + * Returns the {@code SyncProvider} implementation being used + * with this {@code CachedRowSetImpl} implementation rowset. * * @return the SyncProvider used by the rowset. If not provider was * set when the rowset was instantiated, the reference * implementation (default) provider is returned. * @throws SQLException if error occurs while return the - * SyncProvider instance. + * {@code SyncProvider} instance. */ public SyncProvider getSyncProvider() throws SQLException { throw new UnsupportedOperationException(); } /** - * Sets the active SyncProvider and attempts to load - * load the new provider using the SyncFactory SPI. + * Sets the active {@code SyncProvider} and attempts to load + * load the new provider using the {@code SyncFactory} SPI. * * @throws SQLException if an error occurs while resetting the - * SyncProvider. + * {@code SyncProvider}. */ public void setSyncProvider(String providerStr) throws SQLException { throw new UnsupportedOperationException(); @@ -953,23 +953,23 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data. + * Populates this {@code CachedRowSetImpl} object with data. * This form of the method uses the rowset's user, password, and url or * data source name properties to create a database * connection. If properties that are needed * have not been set, this method will throw an exception. * - * Another form of this method uses an existing JDBC Connection + * Another form of this method uses an existing JDBC {@code Connection} * object instead of creating a new one; therefore, it ignores the * properties used for establishing a new connection. * * The query specified by the command property is executed to create a - * ResultSet object from which to retrieve data. + * {@code ResultSet} object from which to retrieve data. * The current contents of the rowset are discarded, and the * rowset's metadata is also (re)set. If there are outstanding updates, * they are also ignored. * - * The method execute closes any database connections that it + * The method {@code execute} closes any database connections that it * creates. * * @throws SQLException if an error occurs or the @@ -987,20 +987,20 @@ /** * Moves the cursor down one row from its current position and - * returns true if the new cursor position is a + * returns {@code true} if the new cursor position is a * valid row. - * The cursor for a new ResultSet object is initially + * The cursor for a new {@code ResultSet} object is initially * positioned before the first row. The first call to the method - * next moves the cursor to the first row, making it + * {@code next} moves the cursor to the first row, making it * the current row; the second call makes the second row the * current row, and so on. * * If an input stream from the previous row is open, it is - * implicitly closed. The ResultSet object's warning + * implicitly closed. The {@code ResultSet} object's warning * chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if an error occurs or * the cursor is not positioned in the rowset, before * the first row, or after the last row @@ -1010,9 +1010,9 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the next - * row and returns true if the cursor is still in the rowset; - * returns false if the cursor has moved to the position after + * Moves this {@code CachedRowSetImpl} object's cursor to the next + * row and returns {@code true} if the cursor is still in the rowset; + * returns {@code false} if the cursor has moved to the position after * the last row. * * This method handles the cases where the cursor moves to a row that @@ -1021,15 +1021,15 @@ * that has been deleted, this method moves the cursor to the next * row until the cursor is on a row that has not been deleted. * - * The method internalNext is called by methods such as - * next, absolute, and relative, + * The method {@code internalNext} is called by methods such as + * {@code next}, {@code absolute}, and {@code relative}, * and, as its name implies, is only called internally. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a valid row in this - * rowset; false if it is after the last row + * @return {@code true} if the cursor is on a valid row in this + * rowset; {@code false} if it is after the last row * @throws SQLException if an error occurs */ protected boolean internalNext() throws SQLException { @@ -1037,25 +1037,25 @@ } /** - * Closes this CachedRowSetImpl objecy and releases any resources + * Closes this {@code CachedRowSetImpl} objecy and releases any resources * it was using. * * @throws SQLException if an error occurs when releasing any resources in use - * by this CachedRowSetImpl object + * by this {@code CachedRowSetImpl} object */ public void close() throws SQLException { throw new UnsupportedOperationException(); } /** - * Reports whether the last column read was SQL NULL. - * Note that you must first call the method getXXX + * Reports whether the last column read was SQL {@code NULL}. + * Note that you must first call the method {@code getXXX} * on a column to try to read its value and then call the method - * wasNull to determine whether the value was - * SQL NULL. + * {@code wasNull} to determine whether the value was + * SQL {@code NULL}. * - * @return true if the value in the last column read - * was SQL NULL; false otherwise + * @return {@code true} if the value in the last column read + * was SQL {@code NULL}; {@code false} otherwise * @throws SQLException if an error occurs */ public boolean wasNull() throws SQLException { @@ -1064,9 +1064,9 @@ /** * Returns the insert row or the current row of this - * CachedRowSetImplobject. + * {@code CachedRowSetImpl}object. * - * @return the Row object on which this CachedRowSetImpl + * @return the {@code Row} object on which this {@code CachedRowSetImpl} * objects's cursor is positioned */ protected BaseRow getCurrentRow() { @@ -1077,7 +1077,7 @@ * Removes the row on which the cursor is positioned. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * * @throws SQLException if the cursor is positioned on the insert * row @@ -1089,20 +1089,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * String object. + * of this {@code CachedRowSetImpl} object as a + * {@code String} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} {@code CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type designates the * recommended return type. */ public String getString(int columnIndex) throws SQLException { @@ -1111,18 +1111,18 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * boolean value. + * of this {@code CachedRowSetImpl} object as a + * {@code boolean} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a boolean in the Java progamming language; - * if the value is SQL NULL, the result is false + * @return the column value as a {@code boolean} in the Java progamming language; + * if the value is SQL {@code NULL}, the result is {@code false} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BOOLEAN value + * SQL {@code BOOLEAN} value * @see #getBoolean(String) */ public boolean getBoolean(int columnIndex) throws SQLException { @@ -1131,20 +1131,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type + * SQL {@code TINYINT}, {@code SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type * designates the recommended return type. * @see #getByte(String) */ @@ -1154,21 +1154,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * short value. + * of this {@code CachedRowSetImpl} object as a + * {@code short} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT}, {@code SMALLINT}, + * {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(String) */ public short getShort(int columnIndex) throws SQLException { @@ -1177,21 +1178,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * int value. + * of this {@code CachedRowSetImpl} object as an + * {@code int} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1199,21 +1201,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * long value. + * of this {@code CachedRowSetImpl} object as a + * {@code long} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getLong(String) */ public long getLong(int columnIndex) throws SQLException { @@ -1222,21 +1225,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * float value. + * of this {@code CachedRowSetImpl} object as a + * {@code float} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,} + * {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC, + * BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(int columnIndex) throws SQLException { @@ -1245,21 +1248,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * double value. + * of this {@code CachedRowSetImpl} object as a + * {@code double} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,} + * {@code FLOAT, DOUBLE}, + * {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getDouble(String) * */ @@ -1269,21 +1273,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * This method is deprecated; use the version of getBigDecimal + * This method is deprecated; use the version of {@code getBigDecimal} * that does not take a scale parameter and returns a value with full * precision. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @param scale the number of digits to the right of the decimal point in the * value returned * @return the column value with the specified number of digits to the right - * of the decimal point; if the value is SQL NULL, the - * result is null + * of the decimal point; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails * @deprecated @@ -1295,22 +1299,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte array value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} array value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the - * result is null + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the + * result is {@code null} * * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or + * {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getBytes(String) */ public byte[] getBytes(int columnIndex) throws SQLException { @@ -1319,17 +1323,17 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Date object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Date} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a java.sql.Data object; if - * the value is SQL NULL, the - * result is null + * @return the column value as a {@code java.sql.Data} object; if + * the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, - * the cursor is not on a valid row, or this method fails + * the cursor is not on a valid row, or this method fails */ public java.sql.Date getDate(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1337,14 +1341,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Time object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Time} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1354,14 +1358,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1371,33 +1375,33 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The JDBC + * suitable for retrieving large {@code LONGVARCHAR} values. The JDBC * driver will do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. . Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(String) */ public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException { @@ -1416,8 +1420,8 @@ * stream may return 0 for available() whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of two byte Unicode characters. If the value is SQL NULL @@ -1432,30 +1436,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for - * CachedRowSetImpl.available() whether there is data + * stream may return {@code 0} for + * {@code CachedRowSetImpl.available()} whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes. If the value is SQL NULL - * then the result is null. + * as a stream of uninterpreted bytes. If the value is SQL {@code NULL} + * then the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY}. * The bold type indicates the SQL type that this method is recommened * to retrieve. * @see #getBinaryStream(String) @@ -1472,19 +1476,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a String object. + * of the current row as a {@code String} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR< value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} + * {@code CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. */ public String getString(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1492,17 +1496,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a boolean value. + * of the current row as a {@code boolean} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a boolean in the Java programming - * language; if the value is SQL NULL, - * the result is false + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code boolean} in the Java programming + * language; if the value is SQL {@code NULL}, + * the result is {@code false} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BOOLEAN value + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BOOLEAN} value * @see #getBoolean(int) */ public boolean getBoolean(String columnName) throws SQLException { @@ -1511,19 +1515,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte value. + * of the current row as a {@code byte} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The - * bold type designates the recommended return type + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT}, + * {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} + * value. The bold type designates the recommended return type. */ public byte getByte(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1531,19 +1535,20 @@ /** * Retrieves the value stored in the designated column - * of the current row as a short value. + * of the current row as a {@code short} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT,} + * {@code SMALLINT}, {@code INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(int) */ public short getShort(String columnName) throws SQLException { @@ -1552,20 +1557,21 @@ /** * Retrieves the value stored in the designated column - * of the current row as an int value. + * of the current row as an {@code int} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name - * of a column in this rowset, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * of a column in this rowset, + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1573,19 +1579,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a long value. + * of the current row as a {@code long} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getLong(int) */ public long getLong(String columnName) throws SQLException { @@ -1594,19 +1600,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a float value. + * of the current row as a {@code float} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT,} {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(String columnName) throws SQLException { @@ -1615,20 +1621,20 @@ /** * Retrieves the value stored in the designated column - * of the current row of this CachedRowSetImpl object - * as a double value. + * of the current row of this {@code CachedRowSetImpl} object + * as a {@code double} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return types. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL,} {@code FLOAT, DOUBLE}, {@code DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return types. * @see #getDouble(int) */ public double getDouble(String columnName) throws SQLException { @@ -1637,22 +1643,22 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.math.BigDecimal object. + * of the current row as a {@code java.math.BigDecimal} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @param scale the number of digits to the right of the decimal point - * @return a java.math.BugDecimal object with scale - * number of digits to the right of the decimal point. + * @return a java.math.BugDecimal object with {@code scale} + * number of digits to the right of the decimal point. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve. - * @deprecated Use the getBigDecimal(String columnName) + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. + * @deprecated Use the {@code getBigDecimal(String columnName)} * method instead */ @Deprecated @@ -1662,19 +1668,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte array. + * of the current row as a {@code byte} array. * The bytes represent the raw values returned by the driver. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BINARY, VARBINARY - * or LONGVARBINARY values - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BINARY, VARBINARY} + * or {@code LONGVARBINARY} values. + * The bold SQL type designates the recommended return type. * @see #getBytes(int) */ public byte[] getBytes(String columnName) throws SQLException { @@ -1683,17 +1689,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Date object. + * of the current row as a {@code java.sql.Date} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1701,12 +1707,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Time object. + * of the current row as a {@code java.sql.Time} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1717,12 +1723,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Timestamp object. + * of the current row as a {@code java.sql.Timestamp} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1733,32 +1739,32 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The - * SyncProvider will rely on the JDBC driver to do any necessary + * suitable for retrieving large {@code LONGVARCHAR} values. The + * {@code SyncProvider} will rely on the JDBC driver to do any necessary * conversion from the database format into ASCII format. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * a column in this rowset + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(int) */ public java.io.InputStream getAsciiStream(String columnName) throws SQLException { @@ -1769,23 +1775,23 @@ /** * A column value can be retrieved as a stream of Unicode characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will do any necessary conversion from the database * format into Unicode. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row - * @deprecated use the method getCharacterStream instead + * @deprecated use the method {@code getCharacterStream} instead */ @Deprecated public java.io.InputStream getUnicodeStream(String columnName) throws SQLException { @@ -1794,30 +1800,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of uninterpreted bytes. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is unknown, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY - * The bold type indicates the SQL type that this method is recommened - * to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY} + * The bold type indicates the SQL type that this method is recommened + * to retrieve. * @see #getBinaryStream(int) * */ @@ -1831,17 +1837,17 @@ //===================================================================== /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by statement + * by {@code ResultSet} methods. Any warning caused by statement * methods (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * * @return the first SQLWarning or null */ @@ -1850,10 +1856,10 @@ } /** - * Clears all the warnings reporeted for the CachedRowSetImpl - * object. After a call to this method, the getWarnings method - * returns null until a new warning is reported for this - * CachedRowSetImpl object. + * Clears all the warnings reporeted for the {@code CachedRowSetImpl} + * object. After a call to this method, the {@code getWarnings} method + * returns {@code null} until a new warning is reported for this + * {@code CachedRowSetImpl} object. */ public void clearWarnings() { throw new UnsupportedOperationException(); @@ -1861,25 +1867,25 @@ /** * Retrieves the name of the SQL cursor used by this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * * In SQL, a result table is retrieved through a cursor that is - * named. The current row of a ResultSet can be updated or deleted + * named. The current row of a {@code ResultSet} can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To ensure that the cursor has the proper isolation - * level to support an update operation, the cursor's SELECT - * statement should be of the form select for update. - * If the for update clause + * level to support an update operation, the cursor's {@code SELECT} + * statement should be of the form {@code select for update}. + * If the {@code for update} clause * is omitted, positioned updates may fail. * * JDBC supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. The current row + * SQL cursor used by a {@code ResultSet} object. The current row * of a result set is also the current row of this SQL cursor. * * Note: If positioned updates are not supported, an - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL cursor name for this CachedRowSetImpl object's + * @return the SQL cursor name for this {@code CachedRowSetImpl} object's * cursor * @throws SQLException if an error occurs */ @@ -1888,12 +1894,12 @@ } /** - * Retrieves a ResultSetMetaData object instance that - * contains information about the CachedRowSet object. + * Retrieves a {@code ResultSetMetaData} object instance that + * contains information about the {@code CachedRowSet} object. * However, applications should cast the returned object to a - * RowSetMetaData interface implementation. In the + * {@code RowSetMetaData} interface implementation. In the * reference implementation, this cast can be done on the - * RowSetMetaDataImpl class. + * {@code RowSetMetaDataImpl} class. * * For example: * @@ -1907,10 +1913,10 @@ * crs.setMetaData(metaData); * * - * @return the ResultSetMetaData object that describes this - * CachedRowSetImpl object's columns + * @return the {@code ResultSetMetaData} object that describes this + * {@code CachedRowSetImpl} object's columns * @throws SQLException if an error occurs in generating the RowSet - * meta data; or if the CachedRowSetImpl is empty. + * meta data; or if the {@code CachedRowSetImpl} is empty. * @see javax.sql.RowSetMetaData */ public ResultSetMetaData getMetaData() throws SQLException { @@ -1920,10 +1926,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1931,23 +1937,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes in the Java programming language. * When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(String) */ public Object getObject(int columnIndex) throws SQLException { @@ -1956,10 +1962,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1967,23 +1973,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes * in the Java programming language. When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name does not match one of * this rowset's column names, (2) the cursor is not * on a valid row, or (3) there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(int) */ public Object getObject(String columnName) throws SQLException { @@ -1993,10 +1999,10 @@ //---------------------------------------------------------------- /** - * Maps the given column name for one of this CachedRowSetImpl + * Maps the given column name for one of this {@code CachedRowSetImpl} * object's columns to its column number. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @return the column index of the given column name * @throws SQLException if the given column name does not match one @@ -2014,25 +2020,25 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java character stream that delivers the database column value * as a stream of two-byte unicode characters in a - * java.io.Reader object. If the value is - * SQL NULL, the result is null. + * {@code java.io.Reader} object. If the value is + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR,} {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getCharacterStream(String) */ public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{ @@ -2041,23 +2047,24 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY or LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code CHAR, VARCHAR,} + * {@code LONGVARCHAR}, + * {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -2065,21 +2072,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return types that this method is used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return types that this method is used to retrieve. * @see #getBigDecimal(String) */ public BigDecimal getBigDecimal(int columnIndex) throws SQLException { @@ -2088,21 +2096,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. * @see #getBigDecimal(int) */ public BigDecimal getBigDecimal(String columnName) throws SQLException { @@ -2114,7 +2122,7 @@ //--------------------------------------------------------------------- /** - * Returns the number of rows in this CachedRowSetImpl object. + * Returns the number of rows in this {@code CachedRowSetImpl} object. * * @return number of rows in the rowset */ @@ -2124,10 +2132,10 @@ /** * Indicates whether the cursor is before the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is before the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isBeforeFirst() throws SQLException { @@ -2136,10 +2144,10 @@ /** * Indicates whether the cursor is after the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is after the last row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isAfterLast() throws SQLException { @@ -2148,10 +2156,10 @@ /** * Indicates whether the cursor is on the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is on the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isFirst() throws SQLException { @@ -2160,14 +2168,14 @@ /** * Indicates whether the cursor is on the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * Note: Calling the method isLast may be expensive + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver might need to fetch ahead one row in order * to determine whether the current row is the last row in this rowset. * - * @return true if the cursor is on the last row; - * false otherwise or if this rowset contains no rows + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise or if this rowset contains no rows * @throws SQLException if an error occurs */ public boolean isLast() throws SQLException { @@ -2175,19 +2183,19 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the front of + * Moves this {@code CachedRowSetImpl} object's cursor to the front of * the rowset, just before the first row. This method has no effect if * this rowset contains no rows. * * @throws SQLException if an error occurs or the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public void beforeFirst() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the end of + * Moves this {@code CachedRowSetImpl} object's cursor to the end of * the rowset, just after the last row. This method has no effect if * this rowset contains no rows. * @@ -2198,34 +2206,34 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the first row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the first row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean first() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the first - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the first + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the methods first, - * isFirst, and absolute. - * It in turn calls the method internalNext in order to + * This method is called internally by the methods {@code first}, + * {@code isFirst}, and {@code absolute}. + * It in turn calls the method {@code internalNext} in order to * handle the case where the first row is a deleted row that is not visible. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the first row; - * false otherwise + * @return {@code true} if the cursor moved to the first row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalFirst() throws SQLException { @@ -2233,35 +2241,35 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the last row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the last row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean last() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the last - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the last + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the method last + * This method is called internally by the method {@code last} * when rows have been deleted and the deletions are not visible. - * The method internalLast handles the case where the + * The method {@code internalLast} handles the case where the * last row is a deleted row that is not visible by in turn calling - * the method internalPrevious. + * the method {@code internalPrevious}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the last row; - * false otherwise + * @return {@code true} if the cursor moved to the last row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalLast() throws SQLException { @@ -2269,12 +2277,12 @@ } /** - * Returns the number of the current row in this CachedRowSetImpl + * Returns the number of the current row in this {@code CachedRowSetImpl} * object. The first row is number 1, the second number 2, and so on. * - * @return the number of the current row; 0 if there is no + * @return the number of the current row; {@code 0} if there is no * current row - * @throws SQLException if an error occurs; or if the CacheRowSetImpl + * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl} * is empty */ public int getRow() throws SQLException { @@ -2282,51 +2290,51 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the row number + * Moves this {@code CachedRowSetImpl} object's cursor to the row number * specified. * * If the number is positive, the cursor moves to an absolute row with * respect to the beginning of the rowset. The first row is row 1, the second * is row 2, and so on. For example, the following command, in which - * crs is a CachedRowSetImpl object, moves the cursor + * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor * to the fourth row, starting from the beginning of the rowset. - * + * {@code * * crs.absolute(4); * - * + * } * * If the number is negative, the cursor moves to an absolute row position * with respect to the end of the rowset. For example, calling - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row, counting * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. * * @param row a positive number to indicate the row, starting row numbering from - * the first row, which is 1; a negative number to indicate + * the first row, which is {@code 1}; a negative number to indicate * the row, starting row numbering from the last row, which is - * -1; it must not be 0 - * @return true if the cursor is on the rowset; false + * {@code -1}; it must not be {@code 0} + * @return {@code true} if the cursor is on the rowset; {@code false} * otherwise - * @throws SQLException if the given cursor position is 0 or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * @throws SQLException if the given cursor position is {@code 0} or the + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean absolute( int row ) throws SQLException { throw new UnsupportedOperationException(); @@ -2340,80 +2348,80 @@ * If the number is positive, the cursor moves the specified number of * rows toward the end of the rowset, starting at the current row. * For example, the following command, in which - * crs is a CachedRowSetImpl object with 100 rows, + * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows, * moves the cursor forward four rows from the current row. If the * current row is 50, the cursor would move to row 54. - * + * {@code * * crs.relative(4); * - * + * } * * If the number is negative, the cursor moves back toward the beginning * the specified number of rows, starting at the current row. * For example, calling the method - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. In both cases, this method - * throws an SQLException. + * throws an {@code SQLException}. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). Calling relative(0) + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. Calling {@code relative(0)} * is valid, but it does not change the cursor position. * - * @param rows an int indicating the number of rows to move + * @param rows an {@code int} indicating the number of rows to move * the cursor, starting at the current row; a positive number * moves the cursor forward; a negative number moves the cursor * backward; must not move the cursor past the valid * rows - * @return true if the cursor is on a row in this - * CachedRowSetImpl object; false + * @return {@code true} if the cursor is on a row in this + * {@code CachedRowSetImpl} object; {@code false} * otherwise * @throws SQLException if there are no rows in this rowset, the cursor is * positioned either before the first row or after the last row, or - * the rowset is type ResultSet.TYPE_FORWARD_ONLY + * the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean relative(int rows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the - * previous row and returns true if the cursor is on - * a valid row or false if it is not. + * Moves this {@code CachedRowSetImpl} object's cursor to the + * previous row and returns {@code true} if the cursor is on + * a valid row or {@code false} if it is not. * This method also notifies all listeners registered with this - * CachedRowSetImpl object that its cursor has moved. + * {@code CachedRowSetImpl} object that its cursor has moved. * - * Note: calling the method previous() is not the same - * as calling the method relative(-1). This is true - * because it is possible to call previous() from the insert + * Note: calling the method {@code previous()} is not the same + * as calling the method {@code relative(-1)}. This is true + * because it is possible to call {@code previous()} from the insert * row, from after the last row, or from the current row, whereas - * relative may only be called from the current row. + * {@code relative} may only be called from the current row. * - * The method previous may used in a while + * The method {@code previous} may used in a {@code while} * loop to iterate through a rowset starting after the last row - * and moving toward the beginning. The loop ends when previous - * returns false, meaning that there are no more rows. + * and moving toward the beginning. The loop ends when {@code previous} + * returns {@code false}, meaning that there are no more rows. * For example, the following code fragment retrieves all the data in - * the CachedRowSetImpl object crs, which has + * the {@code CachedRowSetImpl} object {@code crs}, which has * three columns. Note that the cursor must initially be positioned * after the last row so that the first call to the method - * previous places the cursor on the last line. - * + * {@code previous} places the cursor on the last line. + * {@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - * - * This method throws an SQLException if the cursor is not + * } + * This method throws an {@code SQLException} if the cursor is not * on a row in the rowset, before the first row, or after the last row. * - * @return true if the cursor is on a valid row; - * false if it is before the first row or after the + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is before the first row or after the * last row * @throws SQLException if the cursor is not on a valid position or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean previous() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor to the previous row in this CachedRowSetImpl + * Moves the cursor to the previous row in this {@code CachedRowSetImpl} * object, skipping past deleted rows that are not visible; returns - * true if the cursor is on a row in this rowset and - * false when the cursor goes before the first row. + * {@code true} if the cursor is on a row in this rowset and + * {@code false} when the cursor goes before the first row. * - * This method is called internally by the method previous. + * This method is called internally by the method {@code previous}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a row in this rowset; - * false when the cursor reaches the position before + * @return {@code true} if the cursor is on a row in this rowset; + * {@code false} when the cursor reaches the position before * the first row * @throws SQLException if an error occurs */ @@ -2463,14 +2471,14 @@ //--------------------------------------------------------------------- /** - * Indicates whether the current row of this CachedRowSetImpl + * Indicates whether the current row of this {@code CachedRowSetImpl} * object has been updated. The value returned - * depends on whether this rowset can detect updates: false + * depends on whether this rowset can detect updates: {@code false} * will always be returned if it does not detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another and updates are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2482,13 +2490,13 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * * @param idx the index identifier of the column that may be have been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2500,14 +2508,14 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * - * @param columnName the String column name column that may be have + * @param columnName the {@code String} column name column that may be have * been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2521,8 +2529,8 @@ * Indicates whether the current row has been inserted. The value returned * depends on whether or not the rowset can detect visible inserts. * - * @return true if a row has been inserted and inserts are detected; - * false otherwise + * @return {@code true} if a row has been inserted and inserts are detected; + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2536,12 +2544,12 @@ * Indicates whether the current row has been deleted. A deleted row * may leave a visible "hole" in a rowset. This method can be used to * detect such holes if the rowset can detect deletions. This method - * will always return false if this rowset cannot detect + * will always return {@code false} if this rowset cannot detect * deletions. * - * @return true if (1)the current row is blank, indicating that + * @return {@code true} if (1)the current row is blank, indicating that * the row has been deleted, and (2)deletions are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on a valid row in this rowset * @see DatabaseMetaData#deletesAreDetected */ @@ -2551,8 +2559,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset; however, another method must be called to complete @@ -2565,15 +2573,15 @@ * * In order to propagate updates in this rowset to the underlying * data source, an application must call the method {@link #acceptChanges} - * after it calls either updateRow or insertRow. + * after it calls either {@code updateRow} or {@code insertRow}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -2581,8 +2589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2593,14 +2601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(int columnIndex, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -2608,8 +2616,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2620,14 +2628,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(int columnIndex, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -2635,8 +2643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2647,14 +2655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(int columnIndex, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -2662,8 +2670,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2674,14 +2682,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(int columnIndex, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -2689,8 +2697,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2701,14 +2709,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(int columnIndex, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -2717,8 +2725,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2729,14 +2737,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(int columnIndex, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -2744,8 +2752,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2756,14 +2764,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(int columnIndex, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -2771,8 +2779,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2783,14 +2791,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -2798,8 +2806,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2810,17 +2818,17 @@ * as inserted. Both of these methods must be called before the * cursor moves to another row. * - * The method acceptChanges must be called if the + * The method {@code acceptChanges} must be called if the * updated values are to be written back to the underlying database. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(int columnIndex, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -2828,8 +2836,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2840,14 +2848,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(int columnIndex, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -2855,8 +2863,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2867,15 +2875,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(int columnIndex, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -2883,8 +2891,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2895,15 +2903,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL TIME or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code TIME} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(int columnIndex, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -2911,8 +2919,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2923,16 +2931,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE, TIME, or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE}, {@code TIME}, or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -2940,7 +2948,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -2952,8 +2960,8 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -2965,8 +2973,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2977,17 +2985,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not binary, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException { throw new UnsupportedOperationException(); @@ -2995,8 +3003,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3007,19 +3015,19 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.Reader - * containing BINARY, VARBINARY, - * LONGVARBINARY, CHAR, VARCHAR, - * or LONGVARCHAR data + * @param x the new column value; must be a {@code java.io.Reader} + * containing {@code BINARY}, {@code VARBINARY}, + * {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR}, + * or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not a binary or * character type, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3027,11 +3035,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter indicates + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter indicates * the number of digits to the right of the decimal point and is ignored * if the new column value is not a type that will be mapped to an SQL - * DECIMAL or NUMERIC value. + * {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3042,16 +3050,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3059,8 +3067,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3071,14 +3079,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x) throws SQLException { throw new UnsupportedOperationException(); @@ -3087,8 +3095,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3098,12 +3106,12 @@ * must be called, which will insert the new row into both this rowset * and the database. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -3111,8 +3119,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3123,13 +3131,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(String columnName, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -3137,8 +3145,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3149,13 +3157,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(String columnName, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -3163,8 +3171,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3175,13 +3183,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(String columnName, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -3189,8 +3197,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3201,13 +3209,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(String columnName, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -3215,8 +3223,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3227,13 +3235,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(String columnName, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -3241,8 +3249,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3253,13 +3261,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(String columnName, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -3267,8 +3275,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3279,13 +3287,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(String columnName, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -3293,8 +3301,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3305,13 +3313,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -3319,8 +3327,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3331,13 +3339,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(String columnName, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -3345,8 +3353,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3357,13 +3365,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(String columnName, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -3371,8 +3379,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3383,15 +3391,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(String columnName, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -3399,8 +3407,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3411,15 +3419,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL TIME or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code TIME} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(String columnName, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -3427,8 +3435,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3439,7 +3447,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if the given column index is out of bounds or @@ -3448,9 +3456,9 @@ * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE, - * TIME, or TIMESTAMP, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP}, or (4) this + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -3458,7 +3466,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -3470,7 +3478,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -3483,8 +3491,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3495,17 +3503,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not binary, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3513,8 +3521,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3525,18 +3533,18 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param reader the new column value; must be a - * java.io.Reader containing BINARY, - * VARBINARY, LONGVARBINARY, CHAR, - * VARCHAR, or LONGVARCHAR data + * {@code java.io.Reader} containing {@code BINARY}, + * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR}, + * {@code VARCHAR}, or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not a binary or character type, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(String columnName, java.io.Reader reader, @@ -3546,11 +3554,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter * indicates the number of digits to the right of the decimal point * and is ignored if the new column value is not a type that will be - * mapped to an SQL DECIMAL or NUMERIC value. + * mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3561,15 +3569,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3577,8 +3585,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3589,20 +3597,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x) throws SQLException { throw new UnsupportedOperationException(); } /** - * Inserts the contents of this CachedRowSetImpl object's insert + * Inserts the contents of this {@code CachedRowSetImpl} object's insert * row into this rowset immediately following the current row. * If the current row is the * position after the last row or before the first row, the new row will @@ -3614,14 +3622,14 @@ * @throws SQLException if (1) the cursor is not on the insert row, * (2) one or more of the non-nullable columns in the insert * row has not been given a value, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void insertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Marks the current row of this CachedRowSetImpl object as + * Marks the current row of this {@code CachedRowSetImpl} object as * updated and notifies listeners registered with this rowset that the * row has changed. * @@ -3631,26 +3639,26 @@ * and the updates made before the cursor moved will be lost. * * @throws SQLException if the cursor is on the insert row or this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Deletes the current row from this CachedRowSetImpl object and + * Deletes the current row from this {@code CachedRowSetImpl} object and * notifies listeners registered with this rowset that a row has changed. * This method cannot be called when the cursor is on the insert row. * * This method marks the current row as deleted, but it does not delete * the row from the underlying data source. The method - * acceptChanges must be called to delete the row in + * {@code acceptChanges} must be called to delete the row in * the data source. * * @throws SQLException if (1) this method is called when the cursor * is on the insert row, before the first row, or after the * last row or (2) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void deleteRow() throws SQLException { throw new UnsupportedOperationException(); @@ -3659,7 +3667,7 @@ /** * Sets the current row with its original value and marks the row as * not updated, thus undoing any changes made to the row since the - * last call to the methods updateRow or deleteRow. + * last call to the methods {@code updateRow} or {@code deleteRow}. * This method should be called only when the cursor is on a row in * this rowset. * @@ -3672,11 +3680,11 @@ /** * Rolls back any updates made to the current row of this - * CachedRowSetImpl object and notifies listeners that + * {@code CachedRowSetImpl} object and notifies listeners that * a row has changed. To have an effect, this method - * must be called after an updateXXX method has been - * called and before the method updateRow has been called. - * If no updates have been made or the method updateRow + * must be called after an {@code updateXXX} method has been + * called and before the method {@code updateRow} has been called. + * If no updates have been made or the method {@code updateRow} * has already been called, this method has no effect. * * @throws SQLException if the cursor is on the insert row, before the @@ -3687,39 +3695,39 @@ } /** - * Moves the cursor for this CachedRowSetImpl object + * Moves the cursor for this {@code CachedRowSetImpl} object * to the insert row. The current row in the rowset is remembered * while the cursor is on the insert row. * * The insert row is a special row associated with an updatable * rowset. It is essentially a buffer where a new row may - * be constructed by calling the appropriate updateXXX + * be constructed by calling the appropriate {@code updateXXX} * methods to assign a value to each column in the row. A complete * row must be constructed; that is, every column that is not nullable * must be assigned a value. In order for the new row to become part - * of this rowset, the method insertRow must be called + * of this rowset, the method {@code insertRow} must be called * before the cursor is moved back to the rowset. * * Only certain methods may be invoked while the cursor is on the insert * row; many methods throw an exception if they are called while the - * cursor is there. In addition to the updateXXX - * and insertRow methods, only the getXXX methods - * may be called when the cursor is on the insert row. A getXXX - * method should be called on a column only after an updateXXX + * cursor is there. In addition to the {@code updateXXX} + * and {@code insertRow} methods, only the {@code getXXX} methods + * may be called when the cursor is on the insert row. A {@code getXXX} + * method should be called on a column only after an {@code updateXXX} * method has been called on that column; otherwise, the value returned is * undetermined. * - * @throws SQLException if this CachedRowSetImpl object is - * ResultSet.CONCUR_READ_ONLY + * @throws SQLException if this {@code CachedRowSetImpl} object is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void moveToInsertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor for this CachedRowSetImpl object to + * Moves the cursor for this {@code CachedRowSetImpl} object to * the current row. The current row is the row the cursor was on - * when the method moveToInsertRow was called. + * when the method {@code moveToInsertRow} was called. * * Calling this method has no effect unless it is called while the * cursor is on the insert row. @@ -3731,9 +3739,9 @@ } /** - * Returns null. + * Returns {@code null}. * - * @return null + * @return {@code null} * @throws SQLException if an error occurs */ public Statement getStatement() throws SQLException { @@ -3742,18 +3750,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column index is out of bounds or * the cursor is not on one of this rowset's rows or its * insert row @@ -3767,17 +3775,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL REF value + * SQL {@code REF} value * @see #getRef(String) */ public Ref getRef(int columnIndex) throws SQLException { @@ -3786,17 +3794,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BLOB value + * SQL {@code BLOB} value * @see #getBlob(String) */ public Blob getBlob(int columnIndex) throws SQLException { @@ -3805,17 +3813,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Clob object representing an SQL CLOB value + * @return a {@code Clob} object representing an SQL {@code CLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL CLOB value + * SQL {@code CLOB} value * @see #getClob(String) */ public Clob getClob(int columnIndex) throws SQLException { @@ -3824,18 +3832,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL ARRAY value + * SQL {@code ARRAY} value * @see #getArray(String) */ public Array getArray(int columnIndex) throws SQLException { @@ -3844,17 +3852,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column name is not the name of * a column in this rowset or the cursor is not on one of * this rowset's rows or its insert row @@ -3867,16 +3875,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the column value - * is not an SQL REF value + * is not an SQL {@code REF} value * @see #getRef(int) */ public Ref getRef(String colName) throws SQLException { @@ -3885,16 +3893,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BLOB value + * column does not store an SQL {@code BLOB} value * @see #getBlob(int) */ public Blob getBlob(String colName) throws SQLException { @@ -3903,17 +3911,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Clob object representing an SQL - * CLOB value + * @return a {@code Clob} object representing an SQL + * {@code CLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CLOB value + * column does not store an SQL {@code CLOB} value * @see #getClob(int) */ public Clob getClob(String colName) throws SQLException { @@ -3922,17 +3930,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming langugage. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL ARRAY value + * column does not store an SQL {@code ARRAY} value * @see #getArray(int) */ public Array getArray(String colName) throws SQLException { @@ -3941,22 +3949,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3964,21 +3972,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3986,22 +3994,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4009,21 +4017,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4031,22 +4039,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Timestamp - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4054,22 +4062,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object, using the given - * Calendar object to construct an appropriate + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object, using the given + * {@code Calendar} object to construct an appropriate * millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE, - * TIME, or TIMESTAMP value + * column does not store an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4080,13 +4088,13 @@ */ /** - * Retrieves the Connection object passed to this - * CachedRowSetImpl object. This connection may be + * Retrieves the {@code Connection} object passed to this + * {@code CachedRowSetImpl} object. This connection may be * used to populate this rowset with data or to write data back * to its underlying data source. * - * @return the Connection object passed to this rowset; - * may be null if there is no connection + * @return the {@code Connection} object passed to this rowset; + * may be {@code null} if there is no connection * @throws SQLException if an error occurs */ public Connection getConnection() throws SQLException{ @@ -4094,10 +4102,10 @@ } /** - * Sets the metadata for this CachedRowSetImpl object - * with the given RowSetMetaData object. + * Sets the metadata for this {@code CachedRowSetImpl} object + * with the given {@code RowSetMetaData} object. * - * @param md a RowSetMetaData object instance containing + * @param md a {@code RowSetMetaData} object instance containing * metadata about the columsn in the rowset * @throws SQLException if invalid meta data is supplied to the * rowset @@ -4108,17 +4116,17 @@ /** * Returns a result set containing the original value of the rowset. The - * original value is the state of the CachedRowSetImpl after the + * original value is the state of the {@code CachedRowSetImpl} after the * last population or synchronization (whichever occurred most recently) with * the data source. * * The cursor is positioned before the first row in the result set. - * Only rows contained in the result set returned by getOriginal() + * Only rows contained in the result set returned by {@code getOriginal()} * are said to have an original value. * * @return the original result set of the rowset * @throws SQLException if an error occurs produce the - * ResultSet object + * {@code ResultSet} object */ public ResultSet getOriginal() throws SQLException { throw new UnsupportedOperationException(); @@ -4127,7 +4135,7 @@ /** * Returns a result set containing the original value of the current * row only. - * The original value is the state of the CachedRowSetImpl after + * The original value is the state of the {@code CachedRowSetImpl} after * the last population or synchronization (whichever occurred most recently) * with the data source. * @@ -4153,7 +4161,7 @@ /** * Marks all rows in this rowset as being original rows. Any updates * made to the rows become the original values for the rowset. - * Calls to the method setOriginal connot be reversed. + * Calls to the method {@code setOriginal} connot be reversed. * * @throws SQLException if an error occurs */ @@ -4165,8 +4173,8 @@ * Returns an identifier for the object (table) that was used to create this * rowset. * - * @return a String object that identifies the table from - * which this CachedRowSetImpl object was derived + * @return a {@code String} object that identifies the table from + * which this {@code CachedRowSetImpl} object was derived * @throws SQLException if an error occurs */ public String getTableName() throws SQLException { @@ -4177,8 +4185,8 @@ * Sets the identifier for the table from which this rowset was derived * to the given table name. * - * @param tabName a String object that identifies the - * table from which this CachedRowSetImpl object + * @param tabName a {@code String} object that identifies the + * table from which this {@code CachedRowSetImpl} object * was derived * @throws SQLException if an error occurs */ @@ -4188,7 +4196,7 @@ /** * Returns the columns that make a key to uniquely identify a - * row in this CachedRowSetImpl object. + * row in this {@code CachedRowSetImpl} object. * * @return an array of column numbers that constitutes a primary * key for this rowset. This array should be empty @@ -4203,16 +4211,16 @@ /** - * Sets this CachedRowSetImpl object's - * keyCols field with the given array of column + * Sets this {@code CachedRowSetImpl} object's + * {@code keyCols} field with the given array of column * numbers, which forms a key for uniquely identifying a row * in this rowset. * - * @param keys an array of int indicating the + * @param keys an array of {@code int} indicating the * columns that form a primary key for this - * CachedRowSetImpl object; every + * {@code CachedRowSetImpl} object; every * element in the array must be greater than - * 0 and less than or equal to the number + * {@code 0} and less than or equal to the number * of columns in this rowset * @throws SQLException if any of the numbers in the * given array is not valid for this rowset @@ -4224,8 +4232,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4236,14 +4244,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4251,8 +4259,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4263,13 +4271,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4277,8 +4285,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4289,14 +4297,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + * + * Absolute URIs * - * rmi://1234@hostname:2099/remoteobjectname - - * Specifies the Java Virtual Machine identified by lvmid - * 1234 on host hostname accessed - * using the rmi: protocol through the rmi remote - * object named remoteobjectname as registered with - * the rmiserver on port 2099 on host - * hostname. - * - * file:/path/file - Identifies a Java Virtual Machine - * through accessing a special file based protocol to use as - * the communications mechanism. - * + * rmi://1234@hostname:2099/remoteobjectname - + * Specifies the Java Virtual Machine identified by lvmid + * 1234 on host hostname accessed + * using the rmi: protocol through the rmi remote + * object named remoteobjectname as registered with + * the rmiserver on port 2099 on host + * hostname. + * + * file:/path/file - Identifies a Java Virtual Machine + * through accessing a special file based protocol to use as + * the communications mechanism. + * * + * * - * * * @see URI * @see HostIdentifier @@ -236,16 +235,14 @@ * missing components will have result in the HostIdentifier assigning * assumed defaults that allow the VmIdentifier to be resolved according * to those defaults. - *
If this type is a top-level type, null is returned. + *
If this type is a top-level type, {@code null} is returned. * - * @return a Type object representing the type that + * @return a {@code Type} object representing the type that * this type is a member of. If this type is a top-level type, - * null is returned - * @throws TypeNotPresentException if the owner type + * {@code null} is returned + * @throws TypeNotPresentException if the owner type * refers to a non-existent type declaration - * @throws MalformedParameterizedTypeException if the owner type + * @throws MalformedParameterizedTypeException if the owner type * refers to a parameterized type that cannot be instantiated * for any reason * --- old/src/java.base/share/classes/sun/reflect/generics/scope/ConstructorScope.java 2015-06-05 21:04:24.251466083 +0400 +++ new/src/java.base/share/classes/sun/reflect/generics/scope/ConstructorScope.java 2015-06-05 21:04:24.087466083 +0400 @@ -56,9 +56,9 @@ } /** - * Factory method. Takes a Constructor object and creates a + * Factory method. Takes a {@code Constructor} object and creates a * scope for it. - * @param m - A Constructor whose scope we want to obtain + * @param c - A Constructor whose scope we want to obtain * @return The type-variable scope for the constructor m */ public static ConstructorScope make(Constructor> c) { --- old/src/java.base/share/classes/sun/util/PreHashedMap.java 2015-06-05 21:04:24.751466082 +0400 +++ new/src/java.base/share/classes/sun/util/PreHashedMap.java 2015-06-05 21:04:24.587466082 +0400 @@ -121,8 +121,7 @@ *
This method must construct the map's hash chains and store them into * the appropriate elements of the given hash-table row array. * - * @param rows - * The row array to be initialized + * @param ht The row array to be initialized */ protected abstract void init(Object[] ht); --- old/src/java.base/share/classes/sun/util/calendar/BaseCalendar.java 2015-06-05 21:04:25.251466082 +0400 +++ new/src/java.base/share/classes/sun/util/calendar/BaseCalendar.java 2015-06-05 21:04:25.087466082 +0400 @@ -28,7 +28,7 @@ import java.util.TimeZone; /** - * The BaseCalendar provides basic calendar calculation + * The {@code BaseCalendar} provides basic calendar calculation * functions to support the Julian, Gregorian, and Gregorian-based * calendar systems. * @@ -290,11 +290,11 @@ /** * Returns 366 if the specified date is in a leap year, or 365 * otherwise This method does not perform the normalization with - * the specified CalendarDate. The - * CalendarDate must be normalized to get a correct + * the specified {@code CalendarDate}. The + * {@code CalendarDate} must be normalized to get a correct * value. * - * @param a CalendarDate + * @param date a {@code CalendarDate} * @return a year length in days * @throws ClassCastException if the specified date is not a * {@link BaseCalendar.Date} @@ -412,7 +412,7 @@ /** * Calculates calendar fields and store them in the specified - * CalendarDate. + * {@code CalendarDate}. */ // should be 'protected' public void getCalendarDateFromFixedDate(CalendarDate date, --- old/src/java.base/share/classes/sun/util/calendar/CalendarUtils.java 2015-06-05 21:04:25.759466082 +0400 +++ new/src/java.base/share/classes/sun/util/calendar/CalendarUtils.java 2015-06-05 21:04:25.595466082 +0400 @@ -94,7 +94,7 @@ * 0 and -1%4 is -1. * * @param n the numerator - * @param d a divisor which must be > 0 + * @param d a divisor which must be {@literal > 0} * @param r an array of at least one element in which the value * mod(n, d) is returned. * @return the floor of the quotient. @@ -117,7 +117,7 @@ * 0 and -1%4 is -1. * * @param n the numerator - * @param d a divisor which must be > 0 + * @param d a divisor which must be {@literal > 0} * @param r an array of at least one element in which the value * mod(n, d) is returned. * @return the floor of the quotient. --- old/src/java.base/share/classes/sun/util/calendar/ZoneInfo.java 2015-06-05 21:04:26.263466081 +0400 +++ new/src/java.base/share/classes/sun/util/calendar/ZoneInfo.java 2015-06-05 21:04:26.099466081 +0400 @@ -364,7 +364,7 @@ * 0 for January. * @param day The day-in-month of the given date. * @param dayOfWeek The day-of-week of the given date. - * @param millis The milliseconds in day in standard local time. + * @param milliseconds The milliseconds in day in standard local time. * @return The milliseconds to add to UTC to get local time. */ public int getOffset(int era, int year, int month, int day, --- old/src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java 2015-06-05 21:04:26.771466081 +0400 +++ new/src/java.base/share/classes/sun/util/locale/provider/LocaleNameProviderImpl.java 2015-06-05 21:04:26.607466081 +0400 @@ -72,7 +72,7 @@ * If the name returned cannot be localized according to locale, * (say, the provider does not have a Japanese name for Croatian), * this method returns null. - * @param languageCode the ISO 639 language code string in the form of two + * @param lang the ISO 639 language code string in the form of two * lower-case letters between 'a' (U+0061) and 'z' (U+007A) * @param locale the desired locale * @return the name of the given language code for the specified locale, or null if it's not @@ -129,7 +129,7 @@ * If the name returned cannot be localized according to locale, * (say, the provider does not have a Japanese name for Croatia), * this method returns null. - * @param countryCode the ISO 3166 country code string in the form of two + * @param ctry the ISO 3166 country code string in the form of two * upper-case letters between 'A' (U+0041) and 'Z' (U+005A) * @param locale the desired locale * @return the name of the given country code for the specified locale, or null if it's not @@ -152,7 +152,7 @@ * is appropriate for display to the user. * If the name returned cannot be localized according to locale, * this method returns null. - * @param variant the variant string + * @param vrnt the variant string * @param locale the desired locale * @return the name of the given variant string for the specified locale, or null if it's not * available. --- old/src/java.base/share/classes/sun/util/locale/provider/TimeZoneNameProviderImpl.java 2015-06-05 21:04:27.363466080 +0400 +++ new/src/java.base/share/classes/sun/util/locale/provider/TimeZoneNameProviderImpl.java 2015-06-05 21:04:27.199466080 +0400 @@ -79,7 +79,7 @@ * appropriate for daylight saving time even if the specified time zone * has not observed daylight saving time in the past. * - * @param ID a time zone ID string + * @param id a time zone ID string * @param daylight if true, return the daylight saving name. * @param style either {@link java.util.TimeZone#LONG TimeZone.LONG} or * {@link java.util.TimeZone#SHORT TimeZone.SHORT} --- old/src/java.base/share/classes/sun/util/logging/PlatformLogger.java 2015-06-05 21:04:27.951466080 +0400 +++ new/src/java.base/share/classes/sun/util/logging/PlatformLogger.java 2015-06-05 21:04:27.787466080 +0400 @@ -74,10 +74,10 @@ * java.util.logging.ConsoleHandler.formatter = java.util.logging.SimpleFormatter * * Limitation: - * /conf/logging.properties is the system-wide logging + * {@code /conf/logging.properties} is the system-wide logging * configuration defined in the specification and read in the * default case to configure any java.util.logging.Logger instances. - * Platform loggers will not detect if /conf/logging.properties + * Platform loggers will not detect if {@code /conf/logging.properties} * is modified. In other words, unless the java.util.logging API * is used at runtime or the logging system properties is set, * the platform loggers will use the default setting described above. --- old/src/java.base/share/classes/sun/util/resources/TimeZoneNamesBundle.java 2015-06-05 21:04:28.459466079 +0400 +++ new/src/java.base/share/classes/sun/util/resources/TimeZoneNamesBundle.java 2015-06-05 21:04:28.295466079 +0400 @@ -55,7 +55,7 @@ * array for the enumeration returned by getKeys. * Inserts the time zone ID (the key of the bundle entries) into * the string arrays returned by handleGetObject. - * + * * All TimeZoneNames resource bundles must extend this * class and implement the getContents method. */ --- old/src/java.base/unix/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:28.963466079 +0400 +++ new/src/java.base/unix/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:28.799466079 +0400 @@ -50,7 +50,7 @@ } /** - * @returns the platform specific path corresponding to the URL + * @return the platform specific path corresponding to the URL * so long as the URL does not contain a hostname in the authority field. */ --- old/src/java.base/unix/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:29.467466078 +0400 +++ new/src/java.base/unix/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:29.303466079 +0400 @@ -113,7 +113,8 @@ Client client; /** * Create a NTLMAuthentication: - * Username may be specified as domainusername in the application Authenticator. + * Username may be specified as {@literal domainusername} + * in the application Authenticator. * If this notation is not used, then the domain will be taken * from a system property: "http.auth.ntlm.domain". */ --- old/src/java.base/windows/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:29.967466078 +0400 +++ new/src/java.base/windows/classes/sun/misc/FileURLMapper.java 2015-06-05 21:04:29.803466078 +0400 @@ -46,7 +46,7 @@ } /** - * @returns the platform specific path corresponding to the URL, and in particular + * @return the platform specific path corresponding to the URL, and in particular * returns a UNC when the authority contains a hostname */ --- old/src/java.base/windows/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:30.467466078 +0400 +++ new/src/java.base/windows/classes/sun/net/www/protocol/http/ntlm/NTLMAuthentication.java 2015-06-05 21:04:30.303466078 +0400 @@ -83,7 +83,8 @@ /** * Create a NTLMAuthentication: - * Username may be specified as domainusername in the application Authenticator. + * Username may be specified as {@literal domainusername} + * in the application Authenticator. * If this notation is not used, then the domain will be taken * from a system property: "http.auth.ntlm.domain". */ --- old/src/java.datatransfer/share/classes/sun/datatransfer/DataFlavorUtil.java 2015-06-05 21:04:30.971466077 +0400 +++ new/src/java.datatransfer/share/classes/sun/datatransfer/DataFlavorUtil.java 2015-06-05 21:04:30.807466077 +0400 @@ -55,7 +55,7 @@ /** * Utility class with different datatransfer helper functions * - * @see 1.9 + * @since 1.9 */ public class DataFlavorUtil { --- old/src/java.desktop/macosx/classes/com/apple/eio/FileManager.java 2015-06-05 21:04:31.483466077 +0400 +++ new/src/java.desktop/macosx/classes/com/apple/eio/FileManager.java 2015-06-05 21:04:31.319466077 +0400 @@ -97,7 +97,8 @@ /** - * Converts an OSType (e.g. "macs" from ) into an int. + * Converts an OSType (e.g. "macs" + * from {@literal }) into an int. * * @param type the 4 character type to convert. * @return an int representing the 4 character value @@ -355,7 +356,7 @@ /** * Moves the specified file to the Trash * - * @param file + * @param file the file * @return returns true if the NSFileManager successfully moved the file to the Trash. * @throws FileNotFoundException * --- old/src/java.desktop/share/classes/sun/applet/AppletPanel.java 2015-06-05 21:04:31.991466076 +0400 +++ new/src/java.desktop/share/classes/sun/applet/AppletPanel.java 2015-06-05 21:04:31.823466077 +0400 @@ -344,12 +344,14 @@ * Execute applet events. * Here is the state transition diagram * + * {@literal * Note: (XXX) is the action * APPLET_XXX is the state - * (applet code loaded) --> APPLET_LOAD -- (applet init called)--> APPLET_INIT -- ( - * applet start called) --> APPLET_START -- (applet stop called) -->APPLET_STOP --(applet - * destroyed called) --> APPLET_DESTROY -->(applet gets disposed) --> - * APPLET_DISPOSE -->.... + * (applet code loaded) --> APPLET_LOAD -- (applet init called)--> APPLET_INIT -- + * (applet start called) --> APPLET_START -- (applet stop called) --> APPLET_STOP -- + * (applet destroyed called) --> APPLET_DESTROY --> (applet gets disposed) --> + * APPLET_DISPOSE --> ... + * } * * In the legacy lifecycle model. The applet gets loaded, inited and started. So it stays * in the APPLET_START state unless the applet goes away(refresh page or leave the page). @@ -364,10 +366,9 @@ * APPLET_STOP to APPLET_DESTROY and to APPLET_INIT . * * Also, the applet can jump from APPLET_INIT state to APPLET_DESTROY (in Netscape/Mozilla case). - * Same as APPLET_LOAD to + * Same as APPLET_LOAD to * APPLET_DISPOSE since all of this are triggered by browser. * - * */ @Override public void run() { --- old/src/java.desktop/share/classes/sun/applet/AppletViewer.java 2015-06-05 21:04:32.503466076 +0400 +++ new/src/java.desktop/share/classes/sun/applet/AppletViewer.java 2015-06-05 21:04:32.335466076 +0400 @@ -1093,7 +1093,7 @@ } /** - * Scan an html file for tags + * Scan an html file for {@code } tags */ public static void parse(URL url, String enc) throws IOException { encoding = enc; --- old/src/java.naming/share/classes/com/sun/jndi/ldap/LdapName.java 2015-06-05 21:04:33.107466075 +0400 +++ new/src/java.naming/share/classes/com/sun/jndi/ldap/LdapName.java 2015-06-05 21:04:32.939466076 +0400 @@ -358,7 +358,7 @@ * Serializes only the unparsed DN, for compactness and to avoid * any implementation dependency. * - * @serialdata The DN string and a boolean indicating whether + * @serialData The DN string and a boolean indicating whether * the values are case sensitive. */ private void writeObject(java.io.ObjectOutputStream s) --- old/src/java.sql.rowset/share/classes/com/sun/rowset/JdbcRowSetImpl.java 2015-06-05 21:04:33.715466075 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/JdbcRowSetImpl.java 2015-06-05 21:04:33.547466075 +0400 @@ -35,7 +35,7 @@ import javax.sql.rowset.*; /** - * The standard implementation of the JdbcRowSet interface. See the interface + * The standard implementation of the {@code JdbcRowSet} interface. See the interface * definition for full behavior and implementation requirements. * * @author Jonathan Bruce, Amit Handa @@ -44,40 +44,40 @@ public class JdbcRowSetImpl extends BaseRowSet implements JdbcRowSet, Joinable { /** - * The Connection object that is this rowset's + * The {@code Connection} object that is this rowset's * current connection to the database. This field is set * internally when the connection is established. */ private Connection conn; /** - * The PreparedStatement object that is this rowset's + * The {@code PreparedStatement} object that is this rowset's * current command. This field is set internally when the method - * execute creates the PreparedStatement + * {@code execute} creates the {@code PreparedStatement} * object. */ private PreparedStatement ps; /** - * The ResultSet object that is this rowset's + * The {@code ResultSet} object that is this rowset's * current result set. This field is set internally when the method - * execute executes the rowset's command and thereby - * creates the rowset's ResultSet object. + * {@code execute} executes the rowset's command and thereby + * creates the rowset's {@code ResultSet} object. */ private ResultSet rs; /** - * The RowSetMetaDataImpl object that is constructed when - * a ResultSet object is passed to the JdbcRowSet + * The {@code RowSetMetaDataImpl} object that is constructed when + * a {@code ResultSet} object is passed to the {@code JdbcRowSet} * constructor. This helps in constructing all metadata associated - * with the ResultSet object using the setter methods of - * RowSetMetaDataImpl. + * with the {@code ResultSet} object using the setter methods of + * {@code RowSetMetaDataImpl}. */ private RowSetMetaDataImpl rowsMD; /** - * The ResultSetMetaData object from which this - * RowSetMetaDataImpl is formed and which helps in getting + * The {@code ResultSetMetaData} object from which this + * {@code RowSetMetaDataImpl} is formed and which helps in getting * the metadata information. */ private ResultSetMetaData resMD; @@ -97,13 +97,13 @@ protected transient JdbcRowSetResourceBundle resBundle; /** - * Constructs a default JdbcRowSet object. - * The new instance of JdbcRowSet will serve as a proxy - * for the ResultSet object it creates, and by so doing, + * Constructs a default {@code JdbcRowSet} object. + * The new instance of {@code JdbcRowSet} will serve as a proxy + * for the {@code ResultSet} object it creates, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -114,17 +114,17 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * - * A newly created JdbcRowSet object must have its - * execute method invoked before other public methods + * A newly created {@code JdbcRowSet} object must have its + * {@code execute} method invoked before other public methods * are called on it; otherwise, such method calls will cause an * exception to be thrown. * * @throws SQLException [1] if any of its public methods are called prior - * to calling the execute method; [2] if invalid JDBC driver + * to calling the {@code execute} method; [2] if invalid JDBC driver * properties are set or [3] if no connection to a data source exists. */ public JdbcRowSetImpl() { @@ -217,14 +217,14 @@ } /** - * Constructs a default JdbcRowSet object given a - * valid Connection object. The new - * instance of JdbcRowSet will serve as a proxy for - * the ResultSet object it creates, and by so doing, + * Constructs a default {@code JdbcRowSet} object given a + * valid {@code Connection} object. The new + * instance of {@code JdbcRowSet} will serve as a proxy for + * the {@code ResultSet} object it creates, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -235,17 +235,17 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * - * A newly created JdbcRowSet object must have its - * execute method invoked before other public methods + * A newly created {@code JdbcRowSet} object must have its + * {@code execute} method invoked before other public methods * are called on it; otherwise, such method calls will cause an * exception to be thrown. * * @throws SQLException [1] if any of its public methods are called prior - * to calling the execute method, [2] if invalid JDBC driver + * to calling the {@code execute} method, [2] if invalid JDBC driver * properties are set, or [3] if no connection to a data source exists. */ public JdbcRowSetImpl(Connection con) throws SQLException { @@ -289,15 +289,15 @@ } /** - * Constructs a default JdbcRowSet object using the + * Constructs a default {@code JdbcRowSet} object using the * URL, username, and password arguments supplied. The new - * instance of JdbcRowSet will serve as a proxy for - * the ResultSet object it creates, and by so doing, + * instance of {@code JdbcRowSet} will serve as a proxy for + * the {@code ResultSet} object it creates, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -308,17 +308,17 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * * - * @param url - a JDBC URL for the database to which this JdbcRowSet + * @param url a JDBC URL for the database to which this {@code JdbcRowSet} * object will be connected. The form for a JDBC URL is - * jdbc:subprotocol:subname. - * @param user - the database user on whose behalf the connection + * {@code jdbc:subprotocol:subname}. + * @param user the database user on whose behalf the connection * is being made - * @param password - the user's password + * @param password the user's password * * @throws SQLException if a database access error occurs * @@ -372,15 +372,15 @@ /** - * Constructs a JdbcRowSet object using the given valid - * ResultSet object. The new - * instance of JdbcRowSet will serve as a proxy for - * the ResultSet object, and by so doing, + * Constructs a {@code JdbcRowSet} object using the given valid + * {@code ResultSet} object. The new + * instance of {@code JdbcRowSet} will serve as a proxy for + * the {@code ResultSet} object, and by so doing, * it will make it possible to use the result set as a JavaBeans * component. * * - * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: * * Does not show deleted rows * Has no time limit for how long a driver may take to @@ -391,12 +391,12 @@ * made by others * Will not see uncommitted data (make "dirty" reads) * Has escape processing turned on - * Has its connection's type map set to null - * Has an empty Hashtable object for storing any + * Has its connection's type map set to {@code null} + * Has an empty {@code Hashtable} object for storing any * parameters that are set * * - * @param res a valid ResultSet object + * @param res a valid {@code ResultSet} object * * @throws SQLException if a database access occurs due to a non * valid ResultSet handle. @@ -460,13 +460,13 @@ } /** - * Initializes the given RowSetMetaData object with the values - * in the given ResultSetMetaData object. + * Initializes the given {@code RowSetMetaData} object with the values + * in the given {@code ResultSetMetaData} object. * - * @param md the RowSetMetaData object for this - * JdbcRowSetImpl object, which will be set with + * @param md the {@code RowSetMetaData} object for this + * {@code JdbcRowSetImpl} object, which will be set with * values from rsmd - * @param rsmd the ResultSetMetaData object from which new + * @param rsmd the {@code ResultSetMetaData} object from which new * values for md will be read * @throws SQLException if an error occurs */ @@ -511,24 +511,24 @@ //--------------------------------------------------------------------- /** - * Creates the internal ResultSet object for which this - * JdbcRowSet object is a wrapper, effectively + * Creates the internal {@code ResultSet} object for which this + * {@code JdbcRowSet} object is a wrapper, effectively * making the result set a JavaBeans component. * * Certain properties must have been set before this method is called * so that it can establish a connection to a database and execute the - * query that will create the result set. If a DataSource + * query that will create the result set. If a {@code DataSource} * object will be used to create the connection, properties for the * data source name, user name, and password must be set. If the - * DriverManager will be used, the properties for the + * {@code DriverManager} will be used, the properties for the * URL, user name, and password must be set. In either case, the * property for the command must be set. If the command has placeholder * parameters, those must also be set. This method throws * an exception if the required properties are not set. * * Other properties have default values that may optionally be set - * to new values. The execute method will use the value - * for the command property to create a PreparedStatement + * to new values. The {@code execute} method will use the value + * for the command property to create a {@code PreparedStatement} * object and set its properties (escape processing, maximum field * size, maximum number of rows, and query timeout limit) to be those * of this rowset. @@ -784,20 +784,20 @@ } /** - * Moves the cursor for this rowset's ResultSet + * Moves the cursor for this rowset's {@code ResultSet} * object down one row from its current position. - * A ResultSet cursor is initially positioned + * A {@code ResultSet} cursor is initially positioned * before the first row; the first call to the method - * next makes the first row the current row; the + * {@code next} makes the first row the current row; the * second call makes the second row the current row, and so on. * * If an input stream is open for the current row, a call - * to the method next will - * implicitly close it. A ResultSet object's + * to the method {@code next} will + * implicitly close it. A {@code ResultSet} object's * warning chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -811,16 +811,16 @@ } /** - * Releases this rowset's ResultSet object's database and + * Releases this rowset's {@code ResultSet} object's database and * JDBC resources immediately instead of waiting for * this to happen when it is automatically closed. * - * Note: A ResultSet object + * Note: A {@code ResultSet} object * is automatically closed by the - * Statement object that generated it when - * that Statement object is closed, + * {@code Statement} object that generated it when + * that {@code Statement} object is closed, * re-executed, or is used to retrieve the next result from a - * sequence of multiple results. A ResultSet object + * sequence of multiple results. A {@code ResultSet} object * is also automatically closed when it is garbage collected. * * @throws SQLException if a database access error occurs @@ -836,14 +836,14 @@ /** * Reports whether the last column read from this rowset's - * ResultSet object had a value of SQL NULL. - * Note that you must first call one of the getXXX methods + * {@code ResultSet} object had a value of SQL {@code NULL}. + * Note that you must first call one of the {@code getXXX} methods * on a column to try to read its value and then call - * the method wasNull to see if the value read was - * SQL NULL. + * the method {@code wasNull} to see if the value read was + * SQL {@code NULL}. * - * @return true if the last column value read was SQL - * NULL and false otherwise + * @return {@code true} if the last column value read was SQL + * {@code NULL} and {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not have a currently valid connection, * prepared statement, and result set @@ -860,12 +860,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a String. + * of this rowset's {@code ResultSet} object as + * a {@code String}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -878,12 +878,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a boolean. + * of this rowset's {@code ResultSet} object as + * a {@code boolean}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is false + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code false} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -896,12 +896,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte. + * of this rowset's {@code ResultSet} object as + * a {@code byte}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -914,12 +914,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a short. + * of this rowset's {@code ResultSet} object as + * a {@code short}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -932,12 +932,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an int. + * of this rowset's {@code ResultSet} object as + * an {@code int}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -950,12 +950,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a long. + * of this rowset's {@code ResultSet} object as + * a {@code long}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -968,12 +968,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a float. + * of this rowset's {@code ResultSet} object as + * a {@code float}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -986,12 +986,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a double. + * of this rowset's {@code ResultSet} object as + * a {@code double}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1004,13 +1004,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.BigDecimal. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.BigDecimal}. * * @param columnIndex the first column is 1, the second is 2, and so on * @param scale the number of digits to the right of the decimal point - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1025,13 +1025,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte array in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code byte} array in the Java programming language. * The bytes represent the raw values returned by the driver. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1044,12 +1044,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Date object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Date} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1062,12 +1062,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Time object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Time} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1080,12 +1080,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Timestamp object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Timestamp} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1098,25 +1098,25 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as + * of this rowset's {@code ResultSet} object as * a stream of ASCII characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream of one-byte ASCII characters; - * if the value is SQL NULL, the - * value returned is null + * as a stream of one-byte ASCII characters; + * if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) database access error occurs * (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1129,31 +1129,31 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as + * of this rowset's {@code ResultSet} object as * as a stream of Unicode characters. * The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving largeLONGVARCHARvalues. The JDBC driver will + * suitable for retrieving large{@code LONGVARCHAR}values. The JDBC driver will * do any necessary conversion from the database format into Unicode. * The byte format of the Unicode stream must be Java UTF-8, * as specified in the Java virtual machine specification. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream in Java UTF-8 byte format; - * if the value is SQL NULL, the value returned is null + * as a stream in Java UTF-8 byte format; + * if the value is SQL {@code NULL}, the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set - * @deprecated use getCharacterStream in place of - * getUnicodeStream + * @deprecated use {@code getCharacterStream} in place of + * {@code getUnicodeStream} */ @Deprecated public java.io.InputStream getUnicodeStream(int columnIndex) throws SQLException { @@ -1165,22 +1165,22 @@ /** * Gets the value of a column in the current row as a stream of * the value of the designated column in the current row - * of this rowset's ResultSet object as a binary stream of + * of this rowset's {@code ResultSet} object as a binary stream of * uninterpreted bytes. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes; - * if the value is SQL NULL, the value returned is null + * as a stream of uninterpreted bytes; + * if the value is SQL {@code NULL}, the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1198,12 +1198,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a String. + * of this rowset's {@code ResultSet} object as + * a {@code String}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1214,12 +1214,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a boolean. + * of this rowset's {@code ResultSet} object as + * a {@code boolean}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is false + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code false} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1230,12 +1230,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte. + * of this rowset's {@code ResultSet} object as + * a {@code byte}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1246,12 +1246,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a short. + * of this rowset's {@code ResultSet} object as + * a {@code short}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1262,12 +1262,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an int. + * of this rowset's {@code ResultSet} object as + * an {@code int}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1278,12 +1278,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a long. + * of this rowset's {@code ResultSet} object as + * a {@code long}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if a database access error occurs * or this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1294,12 +1294,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a float. + * of this rowset's {@code ResultSet} object as + * a {@code float}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1310,12 +1310,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a double. + * of this rowset's {@code ResultSet} object as + * a {@code double}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1326,13 +1326,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.math.BigDecimal. + * of this rowset's {@code ResultSet} object as + * a {@code java.math.BigDecimal}. * * @param columnName the SQL name of the column * @param scale the number of digits to the right of the decimal point - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) adatabase access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1345,13 +1345,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte array in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code byte} array in the Java programming language. * The bytes represent the raw values returned by the driver. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1362,12 +1362,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Date object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Date} object in the Java programming language. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1378,13 +1378,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Time object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Time} object in the Java programming language. * * @param columnName the SQL name of the column * @return the column value; - * if the value is SQL NULL, - * the value returned is null + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1395,12 +1395,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Timestamp} object. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1411,24 +1411,24 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of + * of this rowset's {@code ResultSet} object as a stream of * ASCII characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of one-byte ASCII characters. - * If the value is SQL NULL, - * the value returned is null. + * as a stream of one-byte ASCII characters. + * If the value is SQL {@code NULL}, + * the value returned is {@code null}. * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1439,10 +1439,10 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of + * of this rowset's {@code ResultSet} object as a stream of * Unicode characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into Unicode. * The byte format of the Unicode stream must be Java UTF-8, @@ -1450,15 +1450,15 @@ * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of two-byte Unicode characters. - * If the value is SQL NULL, - * the value returned is null. + * as a stream of two-byte Unicode characters. + * If the value is SQL {@code NULL}, + * the value returned is {@code null}. * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1471,23 +1471,23 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of uninterpreted - * bytes. + * of this rowset's {@code ResultSet} object as a stream of uninterpreted + * {@code byte}s. * The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARBINARY + * suitable for retrieving large {@code LONGVARBINARY} * values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes; - * if the value is SQL NULL, the result is null + * as a stream of uninterpreted bytes; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1503,21 +1503,21 @@ /** * Returns the first warning reported by calls on this rowset's - * ResultSet object. - * Subsequent warnings on this rowset's ResultSet object - * will be chained to the SQLWarning object that + * {@code ResultSet} object. + * Subsequent warnings on this rowset's {@code ResultSet} object + * will be chained to the {@code SQLWarning} object that * this method returns. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by - * Statement methods + * by {@code ResultSet} methods. Any warning caused by + * {@code Statement} methods * (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * - * @return the first SQLWarning object reported or null + * @return the first {@code SQLWarning} object reported or {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1529,10 +1529,10 @@ } /** - * Clears all warnings reported on this rowset's ResultSet object. - * After this method is called, the method getWarnings - * returns null until a new warning is - * reported for this rowset's ResultSet object. + * Clears all warnings reported on this rowset's {@code ResultSet} object. + * After this method is called, the method {@code getWarnings} + * returns {@code null} until a new warning is + * reported for this rowset's {@code ResultSet} object. * * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, @@ -1545,26 +1545,26 @@ } /** - * Gets the name of the SQL cursor used by this rowset's ResultSet + * Gets the name of the SQL cursor used by this rowset's {@code ResultSet} * object. * * In SQL, a result table is retrieved through a cursor that is * named. The current row of a result set can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To insure that the cursor has the proper isolation - * level to support update, the cursor's select statement should be + * level to support update, the cursor's {@code select} statement should be * of the form 'select for update'. If the 'for update' clause is * omitted, the positioned updates may fail. * * The JDBC API supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. - * The current row of a ResultSet object + * SQL cursor used by a {@code ResultSet} object. + * The current row of a {@code ResultSet} object * is also the current row of this SQL cursor. * * Note: If positioned update is not supported, a - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL name for this rowset's ResultSet object's cursor + * @return the SQL name for this rowset's {@code ResultSet} object's cursor * @throws SQLException if (1) a database access error occurs * or (2) xthis rowset does not have a currently valid connection, * prepared statement, and result set @@ -1577,9 +1577,9 @@ /** * Retrieves the number, types and properties of - * this rowset's ResultSet object's columns. + * this rowset's {@code ResultSet} object's columns. * - * @return the description of this rowset's ResultSet + * @return the description of this rowset's {@code ResultSet} * object's columns * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, @@ -1607,8 +1607,8 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an Object. + * of this rowset's {@code ResultSet} object as + * an {@code Object}. * * This method will return the value of the given column as a * Java object. The type of the Java object will be the default @@ -1620,14 +1620,14 @@ * abstract data types. * * In the JDBC 3.0 API, the behavior of method - * getObject is extended to materialize + * {@code getObject} is extended to materialize * data of SQL user-defined types. When a column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to: getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to: {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return a java.lang.Object holding the column value + * @return a {@code java.lang.Object} holding the column value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1640,8 +1640,8 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an Object. + * of this rowset's {@code ResultSet} object as + * an {@code Object}. * * This method will return the value of the given column as a * Java object. The type of the Java object will be the default @@ -1653,14 +1653,14 @@ * abstract data types. * * In the JDBC 3.0 API, the behavior of the method - * getObject is extended to materialize + * {@code getObject} is extended to materialize * data of SQL user-defined types. When a column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to: getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to: {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * * @param columnName the SQL name of the column - * @return a java.lang.Object holding the column value + * @return a {@code java.lang.Object} holding the column value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1672,9 +1672,9 @@ //---------------------------------------------------------------- /** - * Maps the given JdbcRowSetImpl column name to its - * JdbcRowSetImpl column index and reflects this on - * the internal ResultSet object. + * Maps the given {@code JdbcRowSetImpl} column name to its + * {@code JdbcRowSetImpl} column index and reflects this on + * the internal {@code ResultSet} object. * * @param columnName the name of the column * @return the column index of the given column name @@ -1697,11 +1697,11 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.io.Reader object. - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null. + * of this rowset's {@code ResultSet} object as a + * {@code java.io.Reader} object. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @param columnIndex the first column is 1, the second is 2, and so on * */ @@ -1713,14 +1713,14 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.io.Reader object. + * of this rowset's {@code ResultSet} object as a + * {@code java.io.Reader} object. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @param columnName the name of the column - * @return the value in the specified column as a java.io.Reader + * @return the value in the specified column as a {@code java.io.Reader} * */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { @@ -1729,13 +1729,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.math.BigDecimal with full precision. + * of this rowset's {@code ResultSet} object as a + * {@code java.math.BigDecimal} with full precision. * * @param columnIndex the first column is 1, the second is 2, and so on * @return the column value (full precision); - * if the value is SQL NULL, the value returned is - * null. + * if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1748,13 +1748,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.math.BigDecimal with full precision. + * of this rowset's {@code ResultSet} object as a + * {@code java.math.BigDecimal} with full precision. * * @param columnName the column name * @return the column value (full precision); - * if the value is SQL NULL, the value returned is - * null. + * if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1769,11 +1769,11 @@ /** * Indicates whether the cursor is before the first row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is before the first row; - * false if the cursor is at any other position or the - * result set contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} if the cursor is at any other position or the + * result set contains no rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1786,11 +1786,11 @@ /** * Indicates whether the cursor is after the last row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is after the last row; - * false if the cursor is at any other position or the - * result set contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} if the cursor is at any other position or the + * result set contains no rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1803,10 +1803,10 @@ /** * Indicates whether the cursor is on the first row of - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on the first row; - * false otherwise + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1819,14 +1819,14 @@ /** * Indicates whether the cursor is on the last row of - * this rowset's ResultSet object. - * Note: Calling the method isLast may be expensive + * this rowset's {@code ResultSet} object. + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver * might need to fetch ahead one row in order to determine * whether the current row is the last row in the result set. * - * @return true if the cursor is on the last row; - * false otherwise + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1840,11 +1840,11 @@ /** * Moves the cursor to the front of - * this rowset's ResultSet object, just before the + * this rowset's {@code ResultSet} object, just before the * first row. This method has no effect if the result set contains no rows. * * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1857,10 +1857,10 @@ /** * Moves the cursor to the end of - * this rowset's ResultSet object, just after the + * this rowset's {@code ResultSet} object, just after the * last row. This method has no effect if the result set contains no rows. * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1873,12 +1873,12 @@ /** * Moves the cursor to the first row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on a valid row; - * false if there are no rows in the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if there are no rows in the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1893,12 +1893,12 @@ /** * Moves the cursor to the last row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on a valid row; - * false if there are no rows in the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if there are no rows in the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1914,7 +1914,7 @@ * Retrieves the current row number. The first row is number 1, the * second is number 2, and so on. * - * @return the current row number; 0 if there is no current row + * @return the current row number; {@code 0} if there is no current row * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1927,7 +1927,7 @@ /** * Moves the cursor to the given row number in - * this rowset's internal ResultSet object. + * this rowset's internal {@code ResultSet} object. * * If the row number is positive, the cursor moves to * the given row number with respect to the @@ -1937,23 +1937,23 @@ * If the given row number is negative, the cursor moves to * an absolute row position with respect to * the end of the result set. For example, calling the method - * absolute(-1) positions the - * cursor on the last row, calling the method absolute(-2) + * {@code absolute(-1)} positions the + * cursor on the last row, calling the method {@code absolute(-2)} * moves the cursor to the next-to-last row, and so on. * * An attempt to position the cursor beyond the first/last row in * the result set leaves the cursor before the first row or after * the last row. * - * Note: Calling absolute(1) is the same - * as calling first(). Calling absolute(-1) - * is the same as calling last(). + * Note: Calling {@code absolute(1)} is the same + * as calling {@code first()}. Calling {@code absolute(-1)} + * is the same as calling {@code last()}. * - * @return true if the cursor is on the result set; - * false otherwise + * @return {@code true} if the cursor is on the result set; + * {@code false} otherwise * @throws SQLException if (1) a database access error occurs, - * (2) the row is 0, (3) the result set - * type is TYPE_FORWARD_ONLY, or (4) this + * (2) the row is {@code 0}, (3) the result set + * type is {@code TYPE_FORWARD_ONLY}, or (4) this * rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -1969,21 +1969,21 @@ * Moves the cursor a relative number of rows, either positive or negative. * Attempting to move beyond the first/last row in the * result set positions the cursor before/after the - * the first/last row. Calling relative(0) is valid, but does + * the first/last row. Calling {@code relative(0)} is valid, but does * not change the cursor position. * - * Note: Calling the method relative(1) - * is different from calling the method next() - * because is makes sense to call next() when there + * Note: Calling the method {@code relative(1)} + * is different from calling the method {@code next()} + * because is makes sense to call {@code next()} when there * is no current row, * for example, when the cursor is positioned before the first row * or after the last row of the result set. * - * @return true if the cursor is on a row; - * false otherwise + * @return {@code true} if the cursor is on a row; + * {@code false} otherwise * @throws SQLException if (1) a database access error occurs, * (2) there is no current row, (3) the result set - * type is TYPE_FORWARD_ONLY, or (4) this + * type is {@code TYPE_FORWARD_ONLY}, or (4) this * rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -1997,16 +1997,16 @@ /** * Moves the cursor to the previous row in this - * ResultSet object. + * {@code ResultSet} object. * - * Note: Calling the method previous() is not the same as - * calling the method relative(-1) because it - * makes sense to call previous() when there is no current row. + * Note: Calling the method {@code previous()} is not the same as + * calling the method {@code relative(-1)} because it + * makes sense to call {@code previous()} when there is no current row. * - * @return true if the cursor is on a valid row; - * false if it is off the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is off the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -2020,15 +2020,15 @@ /** * Gives a hint as to the direction in which the rows in this - * ResultSet object will be processed. + * {@code ResultSet} object will be processed. * The initial value is determined by the - * Statement object - * that produced this rowset's ResultSet object. + * {@code Statement} object + * that produced this rowset's {@code ResultSet} object. * The fetch direction may be changed at any time. * * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY - * and the fetch direction is not FETCH_FORWARD, + * (2) the result set type is {@code TYPE_FORWARD_ONLY} + * and the fetch direction is not {@code FETCH_FORWARD}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set * @see java.sql.Statement#setFetchDirection @@ -2041,10 +2041,10 @@ /** * Returns the fetch direction for this - * ResultSet object. + * {@code ResultSet} object. * * @return the current fetch direction for this rowset's - * ResultSet object + * {@code ResultSet} object * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2061,16 +2061,16 @@ /** * Gives the JDBC driver a hint as to the number of rows that should * be fetched from the database when more rows are needed for this - * ResultSet object. + * {@code ResultSet} object. * If the fetch size specified is zero, the JDBC driver * ignores the value and is free to make its own best guess as to what * the fetch size should be. The default value is set by the - * Statement object + * {@code Statement} object * that created the result set. The fetch size may be changed at any time. * * @param rows the number of rows to fetch * @throws SQLException if (1) a database access error occurs, (2) the - * condition 0 <= rows <= this.getMaxRows() is not + * condition {@code 0 <= rows <= this.getMaxRows()} is not * satisfied, or (3) this rowset does not currently have a valid * connection, prepared statement, and result set * @@ -2084,9 +2084,9 @@ /** * * Returns the fetch size for this - * ResultSet object. + * {@code ResultSet} object. * - * @return the current fetch size for this rowset's ResultSet object + * @return the current fetch size for this rowset's {@code ResultSet} object * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2111,12 +2111,12 @@ } /** - * Returns the concurrency mode of this rowset's ResultSet object. + * Returns the concurrency mode of this rowset's {@code ResultSet} object. * The concurrency used is determined by the - * Statement object that created the result set. + * {@code Statement} object that created the result set. * - * @return the concurrency type, either CONCUR_READ_ONLY - * or CONCUR_UPDATABLE + * @return the concurrency type, either {@code CONCUR_READ_ONLY} + * or {@code CONCUR_UPDATABLE} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2138,7 +2138,7 @@ * Indicates whether the current row has been updated. The value returned * depends on whether or not the result set can detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another, and updates are detected * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, @@ -2154,10 +2154,10 @@ /** * Indicates whether the current row has had an insertion. * The value returned depends on whether or not this - * ResultSet object can detect visible inserts. + * {@code ResultSet} object can detect visible inserts. * - * @return true if a row has had an insertion - * and insertions are detected; false otherwise + * @return {@code true} if a row has had an insertion + * and insertions are detected; {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2174,10 +2174,10 @@ * Indicates whether a row has been deleted. A deleted row may leave * a visible "hole" in a result set. This method can be used to * detect holes in a result set. The value returned depends on whether - * or not this rowset's ResultSet object can detect deletions. + * or not this rowset's {@code ResultSet} object can detect deletions. * - * @return true if a row was deleted and deletions are detected; - * false otherwise + * @return {@code true} if a row was deleted and deletions are detected; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2192,10 +2192,10 @@ /** * Gives a nullable column a null value. * - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow - * or insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} + * or {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @throws SQLException if a database access error occurs @@ -2213,11 +2213,11 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2237,11 +2237,11 @@ } /** - * Updates the designated column with a byte value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * * @param columnIndex the first column is 1, the second is 2, and so on @@ -2262,11 +2262,11 @@ } /** - * Updates the designated column with a short value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code short} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2286,11 +2286,11 @@ } /** - * Updates the designated column with an int value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code int} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2309,11 +2309,11 @@ } /** - * Updates the designated column with a long value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code long} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2333,11 +2333,11 @@ } /** - * Updates the designated column with a float value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code float} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2357,11 +2357,11 @@ } /** - * Updates the designated column with a double value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code double} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2381,12 +2381,12 @@ } /** - * Updates the designated column with a java.math.BigDecimal + * Updates the designated column with a {@code java.math.BigDecimal} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2406,11 +2406,11 @@ } /** - * Updates the designated column with a String value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code String} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2430,11 +2430,11 @@ } /** - * Updates the designated column with a byte array value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} array value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2454,11 +2454,11 @@ } /** - * Updates the designated column with a java.sql.Date value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Date} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2479,11 +2479,11 @@ /** - * Updates the designated column with a java.sql.Time value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Time} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2503,12 +2503,12 @@ } /** - * Updates the designated column with a java.sql.Timestamp + * Updates the designated column with a {@code java.sql.Timestamp} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2529,10 +2529,10 @@ /** * Updates the designated column with an ascii stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2554,10 +2554,10 @@ /** * Updates the designated column with a binary stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2579,10 +2579,10 @@ /** * Updates the designated column with a character stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2603,18 +2603,18 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value - * @param scale for java.sql.Types.DECIMAl - * or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types this value will be ignored. + * @param scale for {@code java.sql.Types.DECIMAl} + * or {@code java.sql.Types.NUMERIC} types, + * this is the number of digits after the decimal point. For all other + * types this value will be ignored. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2631,11 +2631,11 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2655,11 +2655,11 @@ } /** - * Updates the designated column with a null value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code null} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @throws SQLException if a database access error occurs @@ -2672,11 +2672,11 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2688,11 +2688,11 @@ } /** - * Updates the designated column with a byte value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2704,11 +2704,11 @@ } /** - * Updates the designated column with a short value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code short} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2720,11 +2720,11 @@ } /** - * Updates the designated column with an int value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code int} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2736,11 +2736,11 @@ } /** - * Updates the designated column with a long value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code long} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2752,11 +2752,11 @@ } /** - * Updates the designated column with a float value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code float } value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2768,11 +2768,11 @@ } /** - * Updates the designated column with a double value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code double} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2784,12 +2784,12 @@ } /** - * Updates the designated column with a java.sql.BigDecimal + * Updates the designated column with a {@code java.sql.BigDecimal} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2801,11 +2801,11 @@ } /** - * Updates the designated column with a String value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code String} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2817,19 +2817,19 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * JDBC 2.0 * * Updates a column with a byte array value. * - * The updateXXX methods are used to update column values in the - * current row, or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or insertRow + * The {@code updateXXX} methods are used to update column values in the + * current row, or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or {@code insertRow} * methods are called to update the database. * * @param columnName the name of the column @@ -2842,11 +2842,11 @@ } /** - * Updates the designated column with a java.sql.Date value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Date} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2858,11 +2858,11 @@ } /** - * Updates the designated column with a java.sql.Time value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Time} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2874,12 +2874,12 @@ } /** - * Updates the designated column with a java.sql.Timestamp + * Updates the designated column with a {@code java.sql.Timestamp} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2892,10 +2892,10 @@ /** * Updates the designated column with an ascii stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2909,10 +2909,10 @@ /** * Updates the designated column with a binary stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2926,14 +2926,14 @@ /** * Updates the designated column with a character stream value. - * The updateXXX methods are used to update column values - * in the current row or the insert row. The updateXXX + * The {@code updateXXX} methods are used to update column values + * in the current row or the insert row. The {@code updateXXX} * methods do not update the underlying database; instead the - * updateRow or insertRow methods are called + * {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column - * @param reader the new column Reader stream value + * @param reader the new column {@code Reader} stream value * @param length the length of the stream * @throws SQLException if a database access error occurs * @@ -2943,16 +2943,16 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value - * @param scale for java.sql.Types.DECIMAL - * or java.sql.Types.NUMERIC types, + * @param scale for {@code java.sql.Types.DECIMAL} + * or {@code java.sql.Types.NUMERIC} types, * this is the number of digits after the decimal point. For all other * types this value will be ignored. * @throws SQLException if a database access error occurs @@ -2963,11 +2963,11 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2980,7 +2980,7 @@ /** * Inserts the contents of the insert row into this - * ResultSet object and into the database + * {@code ResultSet} object and into the database * and also notifies listeners that a row has changed. * The cursor must be on the insert row when this method is called. * @@ -3000,14 +3000,14 @@ /** * Updates the underlying database with the new contents of the - * current row of this rowset's ResultSet object + * current row of this rowset's {@code ResultSet} object * and notifies listeners that a row has changed. * This method cannot be called when the cursor is on the insert row. * * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is * on the insert row, (3) the concurrency of the result - * set is ResultSet.CONCUR_READ_ONLY, or + * set is {@code ResultSet.CONCUR_READ_ONLY}, or * (4) this rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -3019,18 +3019,18 @@ } /** - * Deletes the current row from this rowset's ResultSet object + * Deletes the current row from this rowset's {@code ResultSet} object * and from the underlying database and also notifies listeners that a row * has changed. This method cannot be called when the cursor is on the insert * row. * * @throws SQLException if a database access error occurs - * or if this method is called when the cursor is on the insert row + * or if this method is called when the cursor is on the insert row * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is before the * first row, after the last row, or on the insert row, * (3) the concurrency of this rowset's result - * set is ResultSet.CONCUR_READ_ONLY, or + * set is {@code ResultSet.CONCUR_READ_ONLY}, or * (4) this rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -3042,24 +3042,24 @@ } /** - * Refreshes the current row of this rowset's ResultSet + * Refreshes the current row of this rowset's {@code ResultSet} * object with its most recent value in the database. This method * cannot be called when the cursor is on the insert row. * - * The refreshRow method provides a way for an + * The {@code refreshRow} method provides a way for an * application to explicitly tell the JDBC driver to refetch * a row(s) from the database. An application may want to call - * refreshRow when caching or prefetching is being + * {@code refreshRow} when caching or prefetching is being * done by the JDBC driver to fetch the latest value of a row * from the database. The JDBC driver may actually refresh multiple * rows at once if the fetch size is greater than one. * * All values are refetched subject to the transaction isolation - * level and cursor sensitivity. If refreshRow is called after - * calling an updateXXX method, but before calling - * the method updateRow, then the + * level and cursor sensitivity. If {@code refreshRow} is called after + * calling an {@code updateXXX} method, but before calling + * the method {@code updateRow}, then the * updates made to the row are lost. Calling the method - * refreshRow frequently will likely slow performance. + * {@code refreshRow} frequently will likely slow performance. * * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is @@ -3076,12 +3076,12 @@ /** * Cancels the updates made to the current row in this - * ResultSet object and notifies listeners that a row + * {@code ResultSet} object and notifies listeners that a row * has changed. This method may be called after calling an - * updateXXX method(s) and before calling - * the method updateRow to roll back + * {@code updateXXX} method(s) and before calling + * the method {@code updateRow} to roll back * the updates made to a row. If no updates have been made or - * updateRow has already been called, this method has no + * {@code updateRow} has already been called, this method has no * effect. * * @throws SQLException if (1) a database access error occurs, @@ -3104,19 +3104,19 @@ * * The insert row is a special row associated with an updatable * result set. It is essentially a buffer where a new row may - * be constructed by calling the updateXXX methods prior to + * be constructed by calling the {@code updateXXX} methods prior to * inserting the row into the result set. * - * Only the updateXXX, getXXX, - * and insertRow methods may be + * Only the {@code updateXXX}, {@code getXXX}, + * and {@code insertRow} methods may be * called when the cursor is on the insert row. All of the columns in * a result set must be given a value each time this method is - * called before calling insertRow. - * An updateXXX method must be called before a - * getXXX method can be called on a column value. + * called before calling {@code insertRow}. + * An {@code updateXXX} method must be called before a + * {@code getXXX} method can be called on a column value. * * @throws SQLException if (1) a database access error occurs, - * (2) this rowset's ResultSet object is + * (2) this rowset's {@code ResultSet} object is * not updatable, or (3) this rowset does not * currently have a valid connection, prepared statement, * and result set @@ -3134,7 +3134,7 @@ * the insert row. * * @throws SQLException if (1) a database access error occurs, - * (2) this rowset's ResultSet object is + * (2) this rowset's {@code ResultSet} object is * not updatable, or (3) this rowset does not * currently have a valid connection, prepared statement, * and result set @@ -3146,14 +3146,14 @@ } /** - * Returns the Statement object that produced this - * ResultSet object. + * Returns the {@code Statement} object that produced this + * {@code ResultSet} object. * If the result set was generated some other way, such as by a - * DatabaseMetaData method, this method returns - * null. + * {@code DatabaseMetaData} method, this method returns + * {@code null}. * - * @return the Statement object that produced - * this rowset's ResultSet object or null + * @return the {@code Statement} object that produced + * this rowset's {@code ResultSet} object or {@code null} * if the result set was produced some other way * @throws SQLException if a database access error occurs */ @@ -3169,16 +3169,16 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Object. - * This method uses the given Map object + * of this rowset's {@code ResultSet} object as an {@code Object}. + * This method uses the given {@code Map} object * for the custom mapping of the * SQL structured or distinct type that is being retrieved. * * @param i the first column is 1, the second is 2, and so on - * @param map a java.util.Map object that contains the mapping - * from SQL type names to classes in the Java programming language - * @return an Object in the Java programming language - * representing the SQL value + * @param map a {@code java.util.Map} object that contains the mapping + * from SQL type names to classes in the Java programming language + * @return an {@code Object} in the Java programming language + * representing the SQL value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3193,10 +3193,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Ref object. + * of this rowset's {@code ResultSet} object as a {@code Ref} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL {@code REF} value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3210,10 +3210,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Blob object. + * of this rowset's {@code ResultSet} object as a {@code Blob} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Blob object representing the SQL BLOB + * @return a {@code Blob} object representing the SQL {@code BLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3227,10 +3227,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Clob object. + * of this rowset's {@code ResultSet} object as a {@code Clob} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Clob object representing the SQL CLOB + * @return a {@code Clob} object representing the SQL {@code CLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3244,10 +3244,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Array object. + * of this rowset's {@code ResultSet} object as an {@code Array} object. * * @param i the first column is 1, the second is 2, and so on. - * @return an Array object representing the SQL ARRAY + * @return an {@code Array} object representing the SQL {@code ARRAY} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3261,14 +3261,14 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Object. - * This method uses the specified Map object for + * of this rowset's {@code ResultSet} object as an {@code Object}. + * This method uses the specified {@code Map} object for * custom mapping if appropriate. * * @param colName the name of the column from which to retrieve the value - * @param map a java.util.Map object that contains the mapping + * @param map a {@code java.util.Map} object that contains the mapping * from SQL type names to classes in the Java programming language - * @return an Object representing the SQL + * @return an {@code Object} representing the SQL * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3282,10 +3282,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Ref object. + * of this rowset's {@code ResultSet} object as a {@code Ref} object. * * @param colName the column name - * @return a Ref object representing the SQL REF value in + * @return a {@code Ref} object representing the SQL {@code REF} value in * the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3297,10 +3297,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Blob object. + * of this rowset's {@code ResultSet} object as a {@code Blob} object. * * @param colName the name of the column from which to retrieve the value - * @return a Blob object representing the SQL BLOB + * @return a {@code Blob} object representing the SQL {@code BLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3312,10 +3312,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Clob object. + * of this rowset's {@code ResultSet} object as a {@code Clob} object. * * @param colName the name of the column from which to retrieve the value - * @return a Clob object representing the SQL CLOB + * @return a {@code Clob} object representing the SQL {@code CLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3327,10 +3327,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Array object. + * of this rowset's {@code ResultSet} object as an {@code Array} object. * * @param colName the name of the column from which to retrieve the value - * @return an Array object representing the SQL ARRAY + * @return an {@code Array} object representing the SQL {@code ARRAY} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3342,17 +3342,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Date + * of this rowset's {@code ResultSet} object as a {@code java.sql.Date} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the date - * @return the column value as a java.sql.Date object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Date} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3365,17 +3365,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Date + * of this rowset's {@code ResultSet} object as a {@code java.sql.Date} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column from which to retrieve the value - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the date - * @return the column value as a java.sql.Date object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Date} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3387,17 +3387,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Time + * of this rowset's {@code ResultSet} object as a {@code java.sql.Time} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the time - * @return the column value as a java.sql.Time object; - * if the value is SQL NULL, - * the value returned is null in the Java programming language + * @return the column value as a {@code java.sql.Time} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} in the Java programming language * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3410,17 +3410,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Time + * of this rowset's {@code ResultSet} object as a {@code java.sql.Time} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the time - * @return the column value as a java.sql.Time object; - * if the value is SQL NULL, - * the value returned is null in the Java programming language + * @return the column value as a {@code java.sql.Time} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} in the Java programming language * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3431,18 +3431,18 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as a + * {@code java.sql.Timestamp} object. * This method uses the given calendar to construct an appropriate millisecond * value for the timestamp if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the timestamp - * @return the column value as a java.sql.Timestamp object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Timestamp} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3455,18 +3455,18 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as a + * {@code java.sql.Timestamp} object. * This method uses the given calendar to construct an appropriate millisecond * value for the timestamp if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the timestamp - * @return the column value as a java.sql.Timestamp object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Timestamp} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3478,8 +3478,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3490,14 +3490,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new Ref column value + * @param ref the new {@code Ref} column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { @@ -3507,8 +3507,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3519,13 +3519,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param ref the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { @@ -3534,8 +3534,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3546,14 +3546,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { checkState(); @@ -3563,8 +3563,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3575,13 +3575,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { updateClob(findColumn(columnName), c); @@ -3589,8 +3589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3601,14 +3601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { checkState(); @@ -3617,8 +3617,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3629,13 +3629,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { updateBlob(findColumn(columnName), b); @@ -3643,8 +3643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3655,14 +3655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { checkState(); @@ -3671,8 +3671,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3683,20 +3683,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { updateArray(findColumn(columnName), a); } /** - * Provide interface coverage for getURL(int) in ResultSet->RowSet + * Provide interface coverage for getURL(int) in {@code ResultSet->RowSet} */ public java.net.URL getURL(int columnIndex) throws SQLException { checkState(); @@ -3704,7 +3704,7 @@ } /** - * Provide interface coverage for getURL(String) in ResultSet->RowSet + * Provide interface coverage for getURL(String) in {@code ResultSet->RowSet} */ public java.net.URL getURL(String columnName) throws SQLException { return getURL(findColumn(columnName)); @@ -3712,14 +3712,14 @@ /** * Return the RowSetWarning object for the current row of a - * JdbcRowSetImpl + * {@code JdbcRowSetImpl} */ public RowSetWarning getRowSetWarnings() throws SQLException { return null; } /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3728,8 +3728,8 @@ * @param columnIdxes the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * parameter index is out of bounds or if the columnIdx is + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { @@ -3748,7 +3748,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3757,8 +3757,8 @@ * @param columnIdxes the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * parameter index is out of bounds or if the columnName is + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { @@ -3774,11 +3774,11 @@ } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -3796,10 +3796,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -3829,19 +3829,19 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(int[] columnIdxes) throws SQLException { @@ -3858,17 +3858,17 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(String[] columnNames) throws SQLException { @@ -3883,22 +3883,22 @@ } - /** - * Sets the designated parameter to the given int + /** + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(int columnIdx) throws SQLException { // validate, if col is ok to be set @@ -3912,19 +3912,19 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(String columnName) throws SQLException { // validate, if col is ok to be set @@ -3938,8 +3938,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3948,8 +3948,8 @@ * @param columnIdx the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * parameter index is out of bounds or if the columnIdx is + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { // check if we are unsetting the SAME column @@ -3964,8 +3964,8 @@ } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -3974,8 +3974,8 @@ * @param columnName the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * parameter index is out of bounds or if the columnName is + * not the same as set using {@code setMatchColumn(String)} * */ public void unsetMatchColumn(String columnName) throws SQLException { @@ -3992,12 +3992,12 @@ } /** - * Retrieves the DatabaseMetaData associated with + * Retrieves the {@code DatabaseMetaData} associated with * the connection handle associated with this - * JdbcRowSet object. + * {@code JdbcRowSet} object. * - * @return the DatabaseMetadata associated - * with the rowset's connection. + * @return the {@code DatabaseMetadata} associated + * with the rowset's connection. * @throws SQLException if a database access error occurs */ public DatabaseMetaData getDatabaseMetaData() throws SQLException { @@ -4006,12 +4006,12 @@ } /** - * Retrieves the ParameterMetaData associated with + * Retrieves the {@code ParameterMetaData} associated with * the connection handle associated with this - * JdbcRowSet object. + * {@code JdbcRowSet} object. * - * @return the ParameterMetadata associated - * with the rowset's connection. + * @return the {@code ParameterMetadata} associated + * with the rowset's connection. * @throws SQLException if a database access error occurs */ public ParameterMetaData getParameterMetaData() throws SQLException { @@ -4020,18 +4020,18 @@ } /** - * Commits all updates in this JdbcRowSet object by - * wrapping the internal Connection object and calling - * its commit method. - * This method sets this JdbcRowSet object's private field - * rs to null after saving its value to another - * object, but only if the ResultSet - * constant HOLD_CURSORS_OVER_COMMIT has not been set. - * (The field rs is this JdbcRowSet object's - * ResultSet object.) + * Commits all updates in this {@code JdbcRowSet} object by + * wrapping the internal {@code Connection} object and calling + * its {@code commit} method. + * This method sets this {@code JdbcRowSet} object's private field + * {@code rs} to {@code null} after saving its value to another + * object, but only if the {@code ResultSet} + * constant {@code HOLD_CURSORS_OVER_COMMIT} has not been set. + * (The field {@code rs} is this {@code JdbcRowSet} object's + * {@code ResultSet} object.) * * @throws SQLException if autoCommit is set to true or if a database - * access error occurs + * access error occurs */ public void commit() throws SQLException { conn.commit(); @@ -4045,8 +4045,8 @@ } /** - * Sets auto-commit on the internal Connection object with this - * JdbcRowSet + * Sets auto-commit on the internal {@code Connection} object with this + * {@code JdbcRowSet} * * @throws SQLException if a database access error occurs */ @@ -4074,7 +4074,7 @@ } /** - * Returns the auto-commit status with this JdbcRowSet. + * Returns the auto-commit status with this {@code JdbcRowSet}. * * @return true if auto commit is true; false otherwise * @throws SQLException if a database access error occurs @@ -4084,16 +4084,16 @@ } /** - * Rolls back all the updates in this JdbcRowSet object by - * wrapping the internal Connection object and calling its - * rollback method. - * This method sets this JdbcRowSet object's private field - * rs to null after saving its value to another object. - * (The field rs is this JdbcRowSet object's - * internal ResultSet object.) + * Rolls back all the updates in this {@code JdbcRowSet} object by + * wrapping the internal {@code Connection} object and calling its + * {@code rollback} method. + * This method sets this {@code JdbcRowSet} object's private field + * {@code rs} to {@code null} after saving its value to another object. + * (The field {@code rs} is this {@code JdbcRowSet} object's + * internal {@code ResultSet} object.) * * @throws SQLException if autoCommit is set to true or a database - * access error occurs + * access error occurs */ public void rollback() throws SQLException { conn.rollback(); @@ -4106,14 +4106,14 @@ /** - * Rollbacks all the updates in the JdbcRowSet back to the - * last Savepoint transaction marker. Wraps the internal - * Connection object and call it's rollback method + * Rollbacks all the updates in the {@code JdbcRowSet} back to the + * last {@code Savepoint} transaction marker. Wraps the internal + * {@code Connection} object and call it's rollback method * - * @param s the Savepoint transaction marker to roll the - * transaction to. + * @param s the {@code Savepoint} transaction marker to roll the + * transaction to. * @throws SQLException if autoCommit is set to true; or ia a database - * access error occurs + * access error occurs */ public void rollback(Savepoint s) throws SQLException { conn.rollback(s); @@ -4144,10 +4144,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's Connection property + * Gets this {@code JdbcRowSet} object's Connection property * * - * @return the Connection object associated with this rowset; + * @return the {@code Connection} object associated with this rowset; */ protected Connection getConnection() { @@ -4158,10 +4158,10 @@ // Added as per rave requirements /** - * Sets this JdbcRowSet object's connection property - * to the given Connection object. + * Sets this {@code JdbcRowSet} object's connection property + * to the given {@code Connection} object. * - * @param connection the Connection object. + * @param connection the {@code Connection} object. */ protected void setConnection(Connection connection) { @@ -4172,10 +4172,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's PreparedStatement property + * Gets this {@code JdbcRowSet} object's PreparedStatement property * * - * @return the PreparedStatement object associated with this rowset; + * @return the {@code PreparedStatement} object associated with this rowset; */ protected PreparedStatement getPreparedStatement() { @@ -4186,10 +4186,10 @@ // Added as per Rave requirements /** - * Sets this JdbcRowSet object's preparedtsatement property - * to the given PreparedStatemennt object. + * Sets this {@code JdbcRowSet} object's preparedtsatement property + * to the given {@code PreparedStatemennt} object. * - * @param preparedStatement the PreparedStatement object + * @param preparedStatement the {@code PreparedStatement} object * */ protected void setPreparedStatement(PreparedStatement preparedStatement) { @@ -4200,10 +4200,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's ResultSet property + * Gets this {@code JdbcRowSet} object's ResultSet property * * - * @return the ResultSet object associated with this rowset; + * @return the {@code ResultSet} object associated with this rowset; */ protected ResultSet getResultSet() throws SQLException { @@ -4217,10 +4217,10 @@ // Added as per Rave requirements /** - * Sets this JdbcRowSet object's resultset property - * to the given ResultSet object. + * Sets this {@code JdbcRowSet} object's resultset property + * to the given {@code ResultSet} object. * - * @param resultSet the ResultSet object + * @param resultSet the {@code ResultSet} object * */ protected void setResultSet(ResultSet resultSet) { @@ -4228,25 +4228,25 @@ } /** - * Sets this JdbcRowSet object's command property to - * the given String object and clears the parameters, if any, + * Sets this {@code JdbcRowSet} object's {@code command} property to + * the given {@code String} object and clears the parameters, if any, * that were set for the previous command. In addition, - * if the command property has previously been set to a + * if the {@code command} property has previously been set to a * non-null value and it is - * different from the String object supplied, - * this method sets this JdbcRowSet object's private fields - * ps and rs to null. - * (The field ps is its PreparedStatement object, and - * the field rs is its ResultSet object.) + * different from the {@code String} object supplied, + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps} and {@code rs} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, and + * the field {@code rs} is its {@code ResultSet} object.) * - * The command property may not be needed if the RowSet + * The {@code command} property may not be needed if the {@code RowSet} * object gets its data from a source that does not support commands, * such as a spreadsheet or other tabular file. - * Thus, this property is optional and may be null. + * Thus, this property is optional and may be {@code null}. * - * @param command a String object containing an SQL query - * that will be set as this RowSet object's command - * property; may be null but may not be an empty string + * @param command a {@code String} object containing an SQL query + * that will be set as this {@code RowSet} object's command + * property; may be {@code null} but may not be an empty string * @throws SQLException if an empty string is provided as the command value * @see #getCommand */ @@ -4265,32 +4265,32 @@ } /** - * Sets the dataSourceName property for this JdbcRowSet - * object to the given logical name and sets this JdbcRowSet object's - * Url property to null. In addition, if the dataSourceName + * Sets the {@code dataSourceName} property for this {@code JdbcRowSet} + * object to the given logical name and sets this {@code JdbcRowSet} object's + * Url property to {@code null}. In addition, if the {@code dataSourceName} * property has previously been set and is different from the one supplied, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * the field rs is its ResultSet object, and - * the field conn is its Connection object.) + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * the field {@code rs} is its {@code ResultSet} object, and + * the field {@code conn} is its {@code Connection} object.) * * The name supplied to this method must have been bound to a - * DataSource object in a JNDI naming service so that an + * {@code DataSource} object in a JNDI naming service so that an * application can do a lookup using that name to retrieve the - * DataSource object bound to it. The DataSource + * {@code DataSource} object bound to it. The {@code DataSource} * object can then be used to establish a connection to the data source it * represents. * * Users should set either the Url property or the dataSourceName property. * If both properties are set, the driver will use the property set most recently. * - * @param dsName a String object with the name that can be supplied + * @param dsName a {@code String} object with the name that can be supplied * to a naming service based on JNDI technology to retrieve the - * DataSource object that can be used to get a connection; - * may be null + * {@code DataSource} object that can be used to get a connection; + * may be {@code null} * @throws SQLException if there is a problem setting the - * dataSourceName property + * {@code dataSourceName} property * @see #getDataSourceName */ public void setDataSourceName(String dsName) throws SQLException{ @@ -4310,42 +4310,42 @@ /** - * Sets the Url property for this JdbcRowSet object - * to the given String object and sets the dataSource name - * property to null. In addition, if the Url property has - * previously been set to a non null value and its value + * Sets the Url property for this {@code JdbcRowSet} object + * to the given {@code String} object and sets the dataSource name + * property to {@code null}. In addition, if the Url property has + * previously been set to a non {@code null} value and its value * is different from the value to be set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * the field rs is its ResultSet object, and - * the field conn is its Connection object.) + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * the field {@code rs} is its {@code ResultSet} object, and + * the field {@code conn} is its {@code Connection} object.) * * The Url property is a JDBC URL that is used when * the connection is created using a JDBC technology-enabled driver - * ("JDBC driver") and the DriverManager. + * ("JDBC driver") and the {@code DriverManager}. * The correct JDBC URL for the specific driver to be used can be found * in the driver documentation. Although there are guidelines for how * a JDBC URL is formed, - * a driver vendor can specify any String object except - * one with a length of 0 (an empty string). + * a driver vendor can specify any {@code String} object except + * one with a length of {@code 0} (an empty string). * * Setting the Url property is optional if connections are established using - * a DataSource object instead of the DriverManager. + * a {@code DataSource} object instead of the {@code DriverManager}. * The driver will use either the URL property or the * dataSourceName property to create a connection, whichever was * specified most recently. If an application uses a JDBC URL, it * must load a JDBC driver that accepts the JDBC URL before it uses the - * RowSet object to connect to a database. The RowSet + * {@code RowSet} object to connect to a database. The {@code RowSet} * object will use the URL internally to create a database connection in order * to read or write data. * - * @param url a String object that contains the JDBC URL + * @param url a {@code String} object that contains the JDBC URL * that will be used to establish the connection to a database for this - * RowSet object; may be null but must not + * {@code RowSet} object; may be {@code null} but must not * be an empty string * @throws SQLException if an error occurs setting the Url property or the - * parameter supplied is a string with a length of 0 (an + * parameter supplied is a string with a length of {@code 0} (an * empty string) * @see #getUrl */ @@ -4365,24 +4365,24 @@ } } - /** - * Sets the username property for this JdbcRowSet object + /** + * Sets the username property for this {@code JdbcRowSet} object * to the given user name. Because it * is not serialized, the username property is set at run time before - * calling the method execute. In addition, - * if the username property is already set with a - * non-null value and that value is different from the String + * calling the method {@code execute}. In addition, + * if the {@code username} property is already set with a + * non-null value and that value is different from the {@code String} * object to be set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * rs is its ResultSet object, and - * conn is its Connection object.) - * Setting these fields to null ensures that only current + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * {@code rs} is its {@code ResultSet} object, and + * {@code conn} is its {@code Connection} object.) + * Setting these fields to {@code null} ensures that only current * values will be used. * - * @param uname the String object containing the user name that - * is supplied to the data source to create a connection. It may be null. + * @param uname the {@code String} object containing the user name that + * is supplied to the data source to create a connection. It may be null. * @see #getUsername */ public void setUsername(String uname) { @@ -4401,23 +4401,23 @@ } /** - * Sets the password property for this JdbcRowSet object - * to the given String object. Because it + * Sets the password property for this {@code JdbcRowSet} object + * to the given {@code String} object. Because it * is not serialized, the password property is set at run time before - * calling the method execute. Its default valus is - * null. In addition, - * if the password property is already set with a + * calling the method {@code execute}. Its default valus is + * {@code null}. In addition, + * if the {@code password} property is already set with a * non-null value and that value is different from the one being set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * rs is its ResultSet object, and - * conn is its Connection object.) - * Setting these fields to null ensures that only current + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * {@code rs} is its {@code ResultSet} object, and + * {@code conn} is its {@code Connection} object.) + * Setting these fields to {@code null} ensures that only current * values will be used. * - * @param password the String object that represents the password - * that must be supplied to the database to create a connection + * @param password the {@code String} object that represents the password + * that must be supplied to the database to create a connection */ public void setPassword(String password) { @@ -4435,18 +4435,18 @@ } /** - * Sets the type for this RowSet object to the specified type. - * The default type is ResultSet.TYPE_SCROLL_INSENSITIVE. + * Sets the type for this {@code RowSet} object to the specified type. + * The default type is {@code ResultSet.TYPE_SCROLL_INSENSITIVE}. * * @param type one of the following constants: - * ResultSet.TYPE_FORWARD_ONLY, - * ResultSet.TYPE_SCROLL_INSENSITIVE, or - * ResultSet.TYPE_SCROLL_SENSITIVE + * {@code ResultSet.TYPE_FORWARD_ONLY}, + * {@code ResultSet.TYPE_SCROLL_INSENSITIVE}, or + * {@code ResultSet.TYPE_SCROLL_SENSITIVE} * @throws SQLException if the parameter supplied is not one of the * following constants: - * ResultSet.TYPE_FORWARD_ONLY or - * ResultSet.TYPE_SCROLL_INSENSITIVE - * ResultSet.TYPE_SCROLL_SENSITIVE + * {@code ResultSet.TYPE_FORWARD_ONLY} or + * {@code ResultSet.TYPE_SCROLL_INSENSITIVE} + * {@code ResultSet.TYPE_SCROLL_SENSITIVE} * @see #getConcurrency * @see #getType */ @@ -4468,18 +4468,18 @@ } /** - * Sets the concurrency for this RowSet object to - * the specified concurrency. The default concurrency for any RowSet - * object (connected or disconnected) is ResultSet.CONCUR_UPDATABLE, + * Sets the concurrency for this {@code RowSet} object to + * the specified concurrency. The default concurrency for any {@code RowSet} + * object (connected or disconnected) is {@code ResultSet.CONCUR_UPDATABLE}, * but this method may be called at any time to change the concurrency. * * @param concur one of the following constants: - * ResultSet.CONCUR_READ_ONLY or - * ResultSet.CONCUR_UPDATABLE + * {@code ResultSet.CONCUR_READ_ONLY} or + * {@code ResultSet.CONCUR_UPDATABLE} * @throws SQLException if the parameter supplied is not one of the * following constants: - * ResultSet.CONCUR_UPDATABLE or - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_UPDATABLE} or + * {@code ResultSet.CONCUR_READ_ONLY} * @see #getConcurrency * @see #isReadOnly */ @@ -4500,8 +4500,8 @@ } /** - * Retrieves the value of the designated SQL XML parameter as a - * SQLXML object in the Java programming language. + * Retrieves the value of the designated {@code SQL XML} parameter as a + * {@code SQLXML} object in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @return a SQLXML object that maps an SQL XML value * @throws SQLException if a database access error occurs @@ -4512,8 +4512,8 @@ } /** - * Retrieves the value of the designated SQL XML parameter as a - * SQLXML object in the Java programming language. + * Retrieves the value of the designated {@code SQL XML} parameter as a + * {@code SQLXML} object in the Java programming language. * @param colName the name of the column from which to retrieve the value * @return a SQLXML object that maps an SQL XML value * @throws SQLException if a database access error occurs @@ -4524,12 +4524,12 @@ /** * Retrieves the value of the designated column in the current row of this - * ResultSet object as a java.sql.RowId object in the Java + * {@code ResultSet} object as a java.sql.RowId object in the Java * programming language. * * @param columnIndex the first column is 1, the second 2, ... - * @return the column value if the value is a SQL NULL the - * value returned is null + * @return the column value if the value is a SQL {@code NULL} the + * value returned is {@code null} * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4539,12 +4539,12 @@ /** * Retrieves the value of the designated column in the current row of this - * ResultSet object as a java.sql.RowId object in the Java + * {@code ResultSet} object as a java.sql.RowId object in the Java * programming language. * * @param columnName the name of the column - * @return the column value if the value is a SQL NULL the - * value returned is null + * @return the column value if the value is a SQL {@code NULL} the + * value returned is {@code null} * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4553,10 +4553,10 @@ } /** - * Updates the designated column with a RowId value. The updater + * Updates the designated column with a {@code RowId} value. The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnIndex the first column is 1, the second 2, ... @@ -4569,10 +4569,10 @@ } /** - * Updates the designated column with a RowId value. The updater + * Updates the designated column with a {@code RowId} value. The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4631,8 +4631,8 @@ /*o - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnIndex the first column is 1, the second 2, ... * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4643,8 +4643,8 @@ } /** - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnName name of the column * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4656,12 +4656,12 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param i the first column is 1, the second is 2, ... - * @return a NClob object representing the SQL - * NCLOB value in the specified column + * @return a {@code NClob} object representing the SQL + * {@code NCLOB} value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4672,11 +4672,11 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param colName the name of the column from which to retrieve the value - * @return a NClob object representing the SQL NCLOB + * @return a {@code NClob} object representing the SQL {@code NCLOB} * value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 @@ -4694,10 +4694,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * SQL {@code XML} value when it sends it to the database. * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an SQL {@code XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4706,10 +4706,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * {@code SQL XML} value when it sends it to the database. * @param parameterName the name of the parameter - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an {@code SQL XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4718,8 +4718,8 @@ } /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID value when it sends it + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} value when it sends it * to the database * * @param parameterIndex the first parameter is 1, the second is 2, ... @@ -4732,9 +4732,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID when it sends it to the + /** + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} when it sends it to the * database. * * @param parameterName the name of the parameter @@ -4748,18 +4748,18 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR value + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on NVARCHAR values) + * size relative to the driver's limits on {@code NVARCHAR} values) * when it sends it to the database. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNString(int parameterIndex, String value) throws SQLException { @@ -4768,9 +4768,9 @@ /** - * Sets the designated parameter in this RowSet object's command - * to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter in this {@code RowSet} object's command + * to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -4779,14 +4779,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed PreparedStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -4795,14 +4795,14 @@ } /** - * Sets the designated parameter to a java.sql.NClob object. The object - * implements the java.sql.NClob interface. This NClob - * object maps to a SQL NCLOB. + * Sets the designated parameter to a {@code java.sql.NClob} object. The object + * implements the {@code java.sql.NClob} interface. This {@code NClob} + * object maps to a SQL {@code NCLOB}. * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(String parameterName, NClob value) throws SQLException { @@ -4810,17 +4810,17 @@ } - /** + /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @exception SQLException if a database access error occurs * @since 1.6 @@ -4832,16 +4832,16 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the name of the column - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4850,11 +4850,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * @param columnIndex the first column is 1, the second 2, ... * @param xmlObject the value for the column to be updated @@ -4866,11 +4866,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4884,15 +4884,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnIndex the first column is 1, the second is 2, ... - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4902,15 +4902,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4927,9 +4927,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnIndex - the first column is 1, the second is 2, ... - * @param x - the new column value - * @param length - the length of the stream + * @param columnIndex the first column is 1, the second is 2, ... + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4949,9 +4949,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnName - name of the Column - * @param x - the new column value - * @param length - the length of the stream + * @param columnName name of the Column + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4963,26 +4963,27 @@ } /** - * Updates the designated column with a character stream value. The + * Updates the designated column with a character stream value. The * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} or this + * method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -4997,26 +4998,27 @@ * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * the result set concurrency is {@code CONCUR_READ_ONLY} or + * this method is called on a closed result set + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method * @since 1.6 */ public void updateNCharacterStream(String columnLabel, @@ -5027,9 +5029,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5039,16 +5041,16 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5060,9 +5062,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5072,18 +5074,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, + * then the label is the name of the column. * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException { @@ -5092,9 +5096,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5102,23 +5106,23 @@ * Java stream object or your own subclass that implements the * standard interface. * - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException { @@ -5127,9 +5131,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5138,22 +5142,23 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException { @@ -5161,11 +5166,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5175,17 +5180,17 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5193,11 +5198,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5207,17 +5212,18 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5225,33 +5231,33 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader) throws SQLException { @@ -5259,34 +5265,35 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader) throws SQLException { @@ -5294,11 +5301,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5308,19 +5315,19 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5328,11 +5335,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5342,19 +5349,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5362,11 +5370,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5375,22 +5383,22 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader) throws SQLException { @@ -5398,11 +5406,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5411,23 +5419,24 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader) throws SQLException { @@ -5435,22 +5444,22 @@ } - /** + /** * Updates the designated column with an ascii stream value, which will have * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5464,17 +5473,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBinaryStream(int columnIndex, @@ -5488,17 +5497,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5512,17 +5521,19 @@ * the specified number of bytes.. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5535,20 +5546,20 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5560,21 +5571,22 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5588,15 +5600,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5611,18 +5625,18 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5637,19 +5651,20 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5665,18 +5680,20 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5689,20 +5706,20 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5714,22 +5731,23 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5738,97 +5756,98 @@ } - /** - * Sets the designated parameter to the given java.net.URL value. - * The driver converts this to an SQL DATALINK value - * when it sends it to the database. - * - * @param parameterIndex the first parameter is 1, the second is 2, ... - * @param x the java.net.URL object to be set - * @exception SQLException if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.4 - */ + /** + * Sets the designated parameter to the given {@code java.net.URL} value. + * The driver converts this to an SQL {@code DATALINK} value + * when it sends it to the database. + * + * @param parameterIndex the first parameter is 1, the second is 2, ... + * @param x the {@code java.net.URL} object to be set + * @exception SQLException if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * @since 1.4 + */ public void setURL(int parameterIndex, java.net.URL x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB - * Note: Consult your JDBC driver documentation to determine if - * it might be more efficient to use a version of - * setNClob which takes a length parameter. - * - * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param reader An object that contains the data to set the parameter value to. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * - * @since 1.6 - */ + /** + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * Note: Consult your JDBC driver documentation to determine if + * it might be more efficient to use a version of + * {@code setNClob} which takes a length parameter. + * + * @param parameterIndex index of the first parameter is 1, the second is 2, ... + * @param reader An object that contains the data to set the parameter value to. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * + * @since 1.6 + */ public void setNClob(int parameterIndex, Reader reader) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB - * - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national - * character sets; if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * @since 1.6 - */ - public void setNClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. + * The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national + * character sets; if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * @since 1.6 + */ + public void setNClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); - } + } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNClob which takes a length parameter. + * {@code setNClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5839,23 +5858,24 @@ } - /** - ** of characters specified by length otherwise a SQLException will becontain the number - * generated when the PreparedStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method + /** + * of characters specified by length otherwise a {@code SQLException} will becontain the number + * generated when the {@code PreparedStatement} is executed. + * This method differs from the {@code setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5867,14 +5887,14 @@ /** - * Sets the designated parameter to a java.sql.NClob object. The driver converts this to -a - * SQL NCLOB value when it sends it to the database. + * Sets the designated parameter to a {@code java.sql.NClob} object. + * The driver converts this to an + * SQL {@code NCLOB} value when it sends it to the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(int parameterIndex, NClob value) throws SQLException{ @@ -5883,14 +5903,14 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNString(String parameterName, String value) @@ -5899,8 +5919,8 @@ } /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... @@ -5908,7 +5928,7 @@ * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException{ @@ -5918,8 +5938,8 @@ /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterName the name of the column to be set @@ -5935,9 +5955,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + /** + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -5946,14 +5966,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed CallableStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -5962,23 +5982,23 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIMESTAMP value, + * Sets the designated parameter to the given {@code java.sql.Timestamp} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIMESTAMP} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the timestamp + * a {@code Calendar} object, the driver can calculate the timestamp * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use - * to construct the timestamp + * @param cal the {@code Calendar} object the driver will use + * to construct the timestamp * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -5987,28 +6007,29 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } @@ -6016,16 +6037,16 @@ /** - * Sets the designated parameter to the given java.sql.Clob object. - * The driver converts this to an SQL CLOB value when it + * Sets the designated parameter to the given {@code java.sql.Clob} object. + * The driver converts this to an SQL {@code CLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Clob object that maps an SQL CLOB value + * @param x a {@code Clob} object that maps an SQL {@code CLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setClob (String parameterName, Clob x) throws SQLException{ @@ -6033,21 +6054,21 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs or this method is called on - * a closed CallableStatement + * a closed {@code CallableStatement} * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6058,19 +6079,19 @@ } - /** - * Sets the designated parameter to the given java.sql.Date value + /** + * Sets the designated parameter to the given {@code java.sql.Date} value * using the default time zone of the virtual machine that is running * the application. * The driver converts this - * to an SQL DATE value when it sends it to the database. + * to an SQL {@code DATE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6080,23 +6101,23 @@ } /** - * Sets the designated parameter to the given java.sql.Date value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL DATE value, + * Sets the designated parameter to the given {@code java.sql.Date} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code DATE} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the date + * a {@code Calendar} object, the driver can calculate the date * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the date * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6107,16 +6128,16 @@ /** - * Sets the designated parameter to the given java.sql.Time value. + * Sets the designated parameter to the given {@code java.sql.Time} value. * The driver converts this - * to an SQL TIME value when it sends it to the database. + * to an SQL {@code TIME} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6126,23 +6147,23 @@ } /** - * Sets the designated parameter to the given java.sql.Time value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIME value, + * Sets the designated parameter to the given {@code java.sql.Time} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIME} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the time + * a {@code Calendar} object, the driver can calculate the time * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the time * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6152,22 +6173,22 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatementor if parameterIndex does not correspond to a parameter - * marker in the SQL statement + * a closed {@code PreparedStatement}or if parameterIndex does not correspond to a parameter + * marker in the SQL statement * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6179,19 +6200,19 @@ /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - *This method differs from the setCharacterStream (int, Reader, int) method + * Sets the designated parameter to a {@code Reader} object. The reader 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 setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatement, if parameterIndex does not correspond to a parameter + * a closed {@code PreparedStatement}, if parameterIndex does not correspond to a parameter * marker in the SQL statement, or if the length specified is less than zero. * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method @@ -6204,25 +6225,26 @@ /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) + * Sets the designated parameter to a {@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)} * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... + * the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement, - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, if the length specified - * is less than zero or if the number of bytes in the inputstream does not match - * the specified length. + * this method is called on a closed {@code PreparedStatement}, + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, if the length specified + * is less than zero or if the number of bytes in the inputstream does not match + * the specified length. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6233,28 +6255,27 @@ } /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) - * This method differs from the setBinaryStream (int, InputStream) + * Sets the designated parameter to a {@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 - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... - - + * the second is 2, ... + * * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement or - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, + * this method is called on a closed {@code PreparedStatement} or + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6264,72 +6285,72 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length, otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) - * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, - * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB - * - * @param parameterName the name of the parameter to be set - * the second is 2, ... - * - * @param inputStream An object that contains the data to set the parameter - * value to. - * @param length the number of bytes in the parameter data. - * @throws SQLException if parameterIndex does not correspond - * to a parameter marker in the SQL statement, or if the length specified - * is less than zero; if the number of bytes in the inputstream does not match - * the specified length; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setBlob(String parameterName, InputStream inputStream, long length) + /** + * Sets the designated parameter to a {@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)} + * 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, + * the driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * + * @param parameterName the name of the parameter to be set + * the second is 2, ... + * + * @param inputStream An object that contains the data to set the parameter + * value to. + * @param length the number of bytes in the parameter data. + * @throws SQLException if parameterIndex does not correspond + * to a parameter marker in the SQL statement, or if the length specified + * is less than zero; if the number of bytes in the inputstream does not match + * the specified length; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.Blob object. - * The driver converts this to an SQL BLOB value when it + /** + * Sets the designated parameter to the given {@code java.sql.Blob} object. + * The driver converts this to an SQL {@code BLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Blob object that maps an SQL BLOB value + * @param x a {@code Blob} object that maps an SQL {@code BLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setBlob (String parameterName, Blob x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) + /** + * Sets the designated parameter to a {@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 BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARBINARY or a BLOB + * data should be send to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterName the name of the parameter * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6339,22 +6360,22 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. The second * argument must be an object type; for integral values, the - * java.lang equivalent objects should be used. + * {@code java.lang} equivalent objects should be used. * * The given Java object will be converted to the given targetSqlType * before being sent to the database. * * If the object has a custom mapping (is of a class implementing the - * interface SQLData), - * the JDBC driver should call the method SQLData.writeSQL to write it + * interface {@code SQLData}), + * the JDBC driver should call the method {@code SQLData.writeSQL} to write it * to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * Note that this method may be used to pass datatabase- @@ -6365,17 +6386,17 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database. The scale argument may further qualify this type. * @param scale for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types, this value will be ignored. + * this is the number of digits after the decimal point. For all other + * types, this value will be ignored. * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see Types * @see #getObject * @since 1.4 @@ -6387,7 +6408,7 @@ /** * Sets the value of the designated parameter with the given object. - * This method is like the method setObject + * This method is like the method {@code setObject} * above, except that it assumes a scale of zero. * * @param parameterName the name of the parameter @@ -6395,14 +6416,14 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see #getObject * @since 1.4 */ @@ -6411,13 +6432,13 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. - * The second parameter must be of type Object; therefore, the - * java.lang equivalent objects should be used for built-in types. + * The second parameter must be of type {@code Object}; therefore, the + * {@code java.lang} equivalent objects should be used for built-in types. * * The JDBC specification specifies a standard mapping from - * Java Object types to SQL types. The given argument + * Java {@code Object} types to SQL types. The given argument * will be converted to the corresponding SQL type before being * sent to the database. * @@ -6425,13 +6446,13 @@ * specific abstract data types, by using a driver-specific Java * type. * - * If the object is of a class implementing the interface SQLData, - * the JDBC driver should call the method SQLData.writeSQL + * If the object is of a class implementing the interface {@code SQLData}, + * the JDBC driver should call the method {@code SQLData.writeSQL} * to write it to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * This method throws an exception if there is an ambiguity, for example, if the @@ -6440,10 +6461,10 @@ * @param parameterName the name of the parameter * @param x the object containing the input parameter value * @exception SQLException if a database access error occurs, - * this method is called on a closed CallableStatement or if the given - * Object parameter is ambiguous + * this method is called on a closed {@code CallableStatement} or if the given + * {@code Object} parameter is ambiguous * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getObject * @since 1.4 */ @@ -6454,9 +6475,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6468,9 +6489,9 @@ * @param x the Java input stream that contains the ASCII parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setAsciiStream(String parameterName, java.io.InputStream x, int length) @@ -6482,9 +6503,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the stream + * {@code java.io.InputStream} object. The data will be read from the stream * as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6495,9 +6516,9 @@ * @param x the java input stream which contains the binary parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBinaryStream(String parameterName, java.io.InputStream x, @@ -6506,11 +6527,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6519,13 +6540,13 @@ * standard interface. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that + * @param reader the {@code java.io.Reader} object that * contains the UNICODE data used as the designated parameter * @param length the number of characters in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setCharacterStream(String parameterName, @@ -6536,9 +6557,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6547,15 +6568,15 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setAsciiStream which takes a length parameter. + * {@code setAsciiStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the Java input stream that contains the ASCII parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.6 - */ + * @since 1.6 + */ public void setAsciiStream(String parameterName, java.io.InputStream x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); @@ -6564,9 +6585,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the + * {@code java.io.InputStream} object. The data will be read from the * stream as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6574,12 +6595,12 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBinaryStream which takes a length parameter. + * {@code setBinaryStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the java input stream which contains the binary parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6589,11 +6610,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6602,13 +6623,13 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setCharacterStream which takes a length parameter. + * {@code setCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that contains the + * @param reader the {@code java.io.Reader} object that contains the * Unicode data * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6619,16 +6640,16 @@ /** * Sets the designated parameter to the given - * java.math.BigDecimal value. - * The driver converts this to an SQL NUMERIC value when + * {@code java.math.BigDecimal} value. + * The driver converts this to an SQL {@code NUMERIC} value when * it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBigDecimal * @since 1.4 */ @@ -6636,20 +6657,20 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java String value. + /** + * Sets the designated parameter to the given Java {@code String} value. * The driver converts this - * to an SQL VARCHAR or LONGVARCHAR value + * to an SQL {@code VARCHAR} or {@code LONGVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on VARCHAR values) + * size relative to the driver's limits on {@code VARCHAR} values) * when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getString * @since 1.4 */ @@ -6659,19 +6680,19 @@ - /** + /** * Sets the designated parameter to the given Java array of bytes. - * The driver converts this to an SQL VARBINARY or - * LONGVARBINARY (depending on the argument's size relative - * to the driver's limits on VARBINARY values) when it sends + * The driver converts this to an SQL {@code VARBINARY} or + * {@code LONGVARBINARY} (depending on the argument's size relative + * to the driver's limits on {@code VARBINARY} values) when it sends * it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBytes * @since 1.4 */ @@ -6680,17 +6701,17 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value. + * Sets the designated parameter to the given {@code java.sql.Timestamp} value. * The driver - * converts this to an SQL TIMESTAMP value when it sends it to the + * converts this to an SQL {@code TIMESTAMP} value when it sends it to the * database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -6700,16 +6721,16 @@ } /** - * Sets the designated parameter to SQL NULL. + * Sets the designated parameter to SQL {@code NULL}. * * Note: You must specify the parameter's SQL type. * * @param parameterName the name of the parameter - * @param sqlType the SQL type code defined in java.sql.Types + * @param sqlType the SQL type code defined in {@code java.sql.Types} * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull(String parameterName, int sqlType) throws SQLException { @@ -6717,8 +6738,8 @@ } /** - * Sets the designated parameter to SQL NULL. - * This version of the method setNull should + * Sets the designated parameter to SQL {@code NULL}. + * This version of the method {@code setNull} should * be used for user-defined types and REF type parameters. Examples * of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and * named array types. @@ -6738,14 +6759,14 @@ * * * @param parameterName the name of the parameter - * @param sqlType a value from java.sql.Types + * @param sqlType a value from {@code java.sql.Types} * @param typeName the fully-qualified name of an SQL user-defined type; * ignored if the parameter is not a user-defined type or - * SQL REF value + * SQL {@code REF} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull (String parameterName, int sqlType, String typeName) @@ -6754,17 +6775,17 @@ } /** - * Sets the designated parameter to the given Java boolean value. + * Sets the designated parameter to the given Java {@code boolean} value. * The driver converts this - * to an SQL BIT or BOOLEAN value when it sends it to the database. + * to an SQL {@code BIT} or {@code BOOLEAN} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @see #getBoolean * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBoolean(String parameterName, boolean x) throws SQLException{ @@ -6774,16 +6795,16 @@ /** - * Sets the designated parameter to the given Java byte value. + * Sets the designated parameter to the given Java {@code byte} value. * The driver converts this - * to an SQL TINYINT value when it sends it to the database. + * to an SQL {@code TINYINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getByte * @since 1.4 */ @@ -6793,16 +6814,16 @@ /** - * Sets the designated parameter to the given Java short value. + * Sets the designated parameter to the given Java {@code short} value. * The driver converts this - * to an SQL SMALLINT value when it sends it to the database. + * to an SQL {@code SMALLINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getShort * @since 1.4 */ @@ -6812,16 +6833,16 @@ /** - * Sets the designated parameter to the given Java int value. + * Sets the designated parameter to the given Java {@code int} value. * The driver converts this - * to an SQL INTEGER value when it sends it to the database. + * to an SQL {@code INTEGER} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getInt * @since 1.4 */ @@ -6829,17 +6850,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java long value. + /** + * Sets the designated parameter to the given Java {@code long} value. * The driver converts this - * to an SQL BIGINT value when it sends it to the database. + * to an SQL {@code BIGINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getLong * @since 1.4 */ @@ -6848,17 +6869,17 @@ } - /** - * Sets the designated parameter to the given Java float value. + /** + * Sets the designated parameter to the given Java {@code float} value. * The driver converts this - * to an SQL FLOAT value when it sends it to the database. + * to an SQL {@code FLOAT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getFloat * @since 1.4 */ @@ -6866,17 +6887,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java double value. + /** + * Sets the designated parameter to the given Java {@code double} value. * The driver converts this - * to an SQL DOUBLE value when it sends it to the database. + * to an SQL {@code DOUBLE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDouble * @since 1.4 */ @@ -6887,7 +6908,6 @@ /** * This method re populates the resBundle * during the deserialization process - * */ private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException { // Default state initialization happens here --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.803466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.635466074 +0400 @@ -43,22 +43,22 @@ /** - * The facility called on internally by the RIOptimisticProvider implementation to + * The facility called on internally by the {@code RIOptimisticProvider} implementation to * propagate changes back to the data source from which the rowset got its data. * - * A CachedRowSetWriter object, called a writer, has the public - * method writeData for writing modified data to the underlying data source. + * A {@code CachedRowSetWriter} object, called a writer, has the public + * method {@code writeData} for writing modified data to the underlying data source. * This method is invoked by the rowset internally and is never invoked directly by an application. * A writer also has public methods for setting and getting - * the CachedRowSetReader object, called a reader, that is associated + * the {@code CachedRowSetReader} object, called a reader, that is associated * with the writer. The remainder of the methods in this class are private and * are invoked internally, either directly or indirectly, by the method - * writeData. + * {@code writeData}. * - * Typically the SyncFactory manages the RowSetReader and - * the RowSetWriter implementations using SyncProvider objects. + * Typically the {@code SyncFactory} manages the {@code RowSetReader} and + * the {@code RowSetWriter} implementations using {@code SyncProvider} objects. * Standard JDBC RowSet implementations provide an object instance of this - * writer by invoking the SyncProvider.getRowSetWriter() method. + * writer by invoking the {@code SyncProvider.getRowSetWriter()} method. * * @version 0.2 * @author Jonathan Bruce @@ -69,15 +69,15 @@ public class CachedRowSetWriter implements TransactionalWriter, Serializable { /** - * The Connection object that this writer will use to make a + * The {@code Connection} object that this writer will use to make a * connection to the data source to which it will write data. * */ private transient Connection con; /** - * The SQL SELECT command that this writer will call - * internally. The method initSQLStatements builds this + * The SQL {@code SELECT} command that this writer will call + * internally. The method {@code initSQLStatements} builds this * command by supplying the words "SELECT" and "FROM," and using * metadata to get the table name and column names . * @@ -86,9 +86,9 @@ private String selectCmd; /** - * The SQL UPDATE command that this writer will call + * The SQL {@code UPDATE} command that this writer will call * internally to write data to the rowset's underlying data source. - * The method initSQLStatements builds this String + * The method {@code initSQLStatements} builds this {@code String} * object. * * @serial @@ -96,8 +96,8 @@ private String updateCmd; /** - * The SQL WHERE clause the writer will use for update - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for update + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -105,7 +105,7 @@ private String updateWhere; /** - * The SQL DELETE command that this writer will call + * The SQL {@code DELETE} command that this writer will call * internally to delete a row in the rowset's underlying data source. * * @serial @@ -113,8 +113,8 @@ private String deleteCmd; /** - * The SQL WHERE clause the writer will use for delete - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for delete + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -122,9 +122,9 @@ private String deleteWhere; /** - * The SQL INSERT INTO command that this writer will internally use + * The SQL {@code INSERT INTO} command that this writer will internally use * to insert data into the rowset's underlying data source. The method - * initSQLStatements builds this command with a question + * {@code initSQLStatements} builds this command with a question * mark parameter placeholder for each column in the rowset. * * @serial @@ -133,8 +133,8 @@ /** * An array containing the column numbers of the columns that are - * needed to uniquely identify a row in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * needed to uniquely identify a row in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ @@ -142,7 +142,7 @@ /** * An array of the parameters that should be used to set the parameter - * placeholders in a PreparedStatement object that this + * placeholders in a {@code PreparedStatement} object that this * writer will execute. * * @serial @@ -150,33 +150,33 @@ private Object[] params; /** - * The CachedRowSetReader object that has been - * set as the reader for the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code CachedRowSetReader} object that has been + * set as the reader for the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private CachedRowSetReader reader; /** - * The ResultSetMetaData object that contains information - * about the columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code ResultSetMetaData} object that contains information + * about the columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private ResultSetMetaData callerMd; /** - * The number of columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The number of columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private int callerColumnCount; /** - * This CachedRowSet will hold the conflicting values + * This {@code CachedRowSet} will hold the conflicting values * retrieved from the db and hold it. */ private CachedRowSetImpl crsResolve; @@ -209,8 +209,8 @@ } /** - * Propagates changes in the given RowSet object - * back to its underlying data source and returns true + * Propagates changes in the given {@code RowSet} object + * back to its underlying data source and returns {@code true} * if successful. The writer will check to see if * the data in the pre-modified rowset (the original values) differ * from the data in the underlying data source. If data in the data @@ -221,15 +221,15 @@ * access for concurrent users. * * This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. * - * Creates a CachedRowSet object from the given - * RowSet object + * Creates a {@code CachedRowSet} object from the given + * {@code RowSet} object * Makes a connection with the data source * * Disables autocommit mode if it is not already disabled @@ -237,32 +237,32 @@ * * Checks to see if the reader has read new data since the writer * was last called and, if so, calls the method - * initSQLStatements to initialize new SQL statements + * {@code initSQLStatements} to initialize new SQL statements * - * Builds new SELECT, UPDATE, - * INSERT, and DELETE statements - * Uses the CachedRowSet object's metadata to + * Builds new {@code SELECT}, {@code UPDATE}, + * {@code INSERT}, and {@code DELETE} statements + * Uses the {@code CachedRowSet} object's metadata to * determine the table name, column names, and the columns * that make up the primary key * * When there is no conflict, propagates changes made to the - * CachedRowSet object back to its underlying data source + * {@code CachedRowSet} object back to its underlying data source * - * Iterates through each row of the CachedRowSet object + * Iterates through each row of the {@code CachedRowSet} object * to determine whether it has been updated, inserted, or deleted * If the corresponding row in the data source has not been changed * since the rowset last read its * values, the writer will use the appropriate command to update, * insert, or delete the row * If any data in the data source does not match the original values - * for the CachedRowSet object, the writer will roll + * for the {@code CachedRowSet} object, the writer will roll * back any changes it has made to the row in the data source. * * * - * @return true if changes to the rowset were successfully + * @return {@code true} if changes to the rowset were successfully * written to the rowset's underlying data source; - * false otherwise + * {@code false} otherwise */ public boolean writeData(RowSetInternal caller) throws SQLException { long conflicts = 0; @@ -434,25 +434,25 @@ } //end writeData -/** - * Updates the given CachedRowSet object's underlying data - * source so that updates to the rowset are reflected in the original - * data source, and returns false if the update was successful. - * A return value of true indicates that there is a conflict, - * meaning that a value updated in the rowset has already been changed by - * someone else in the underlying data source. A conflict can also exist - * if, for example, more than one row in the data source would be affected - * by the update or if no rows would be affected. In any case, if there is - * a conflict, this method does not update the underlying data source. - * - * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + * + * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - * - * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + * + * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. * - * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - * - * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + * + * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. * * If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. * * The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. * * NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. * * This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. * - * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. * - * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. * * Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. * - * undoUpdateRowSet object backed by the same data as - * that of this CachedRowSetImpl object and sharing a set of cursors + * Returns a new {@code RowSet} object backed by the same data as + * that of this {@code CachedRowSetImpl} object and sharing a set of cursors * with it. This allows cursors to interate over a shared set of rows, providing * multiple views of the underlying data. * - * @return a RowSet object that is a copy of this CachedRowSetImpl + * @return a {@code RowSet} object that is a copy of this {@code CachedRowSetImpl} * object and shares a set of cursors with it * @throws SQLException if an error occurs or cloning is * not supported @@ -750,19 +750,19 @@ } /** - * Returns a new RowSet object containing by the same data - * as this CachedRowSetImpl object. This method - * differs from the method createCopy in that it throws a - * CloneNotSupportedException object instead of an - * SQLException object, as the method createShared - * does. This clone - * method is called internally by the method createShared, - * which catches the CloneNotSupportedException object - * and in turn throws a new SQLException object. + * Returns a new {@code RowSet} object containing by the same data + * as this {@code CachedRowSetImpl} object. This method + * differs from the method {@code createCopy} in that it throws a + * {@code CloneNotSupportedException} object instead of an + * {@code SQLException} object, as the method {@code createShared} + * does. This {@code clone} + * method is called internally by the method {@code createShared}, + * which catches the {@code CloneNotSupportedException} object + * and in turn throws a new {@code SQLException} object. * - * @return a copy of this CachedRowSetImpl object + * @return a copy of this {@code CachedRowSetImpl} object * @throws CloneNotSupportedException if an error occurs when - * attempting to clone this CachedRowSetImpl object + * attempting to clone this {@code CachedRowSetImpl} object * @see #createShared */ protected Object clone() throws CloneNotSupportedException { @@ -770,8 +770,8 @@ } /** - * Creates a RowSet object that is a deep copy of - * this CachedRowSetImpl object's data, including + * Creates a {@code RowSet} object that is a deep copy of + * this {@code CachedRowSetImpl} object's data, including * constraints. Updates made * on a copy are not visible to the original rowset; * a copy of a rowset is completely independent from the original. @@ -780,12 +780,12 @@ * from first principles, which can be quite expensive. * For example, it can eliminate the need to query a * remote database server. - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSet object and is - * completely independent from this CachedRowSetImpl + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSet} object and is + * completely independent from this {@code CachedRowSetImpl} * object. * @throws SQLException if an error occurs in generating the copy of this - * of the CachedRowSetImpl + * of the {@code CachedRowSetImpl} * @see #createShared * @see javax.sql.RowSetEvent * @see javax.sql.RowSetListener @@ -795,21 +795,21 @@ } /** - * Creates a RowSet object that is a copy of - * this CachedRowSetImpl object's table structure + * Creates a {@code RowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's table structure * and the constraints only. * There will be no data in the object being returned. * Updates made on a copy are not visible to the original rowset. * * This helps in getting the underlying XML schema which can - * be used as the basis for populating a WebRowSet. + * be used as the basis for populating a {@code WebRowSet}. * - * @return a new CachedRowSet object that is a copy - * of this CachedRowSetImpl object's schema and + * @return a new {@code CachedRowSet} object that is a copy + * of this {@code CachedRowSetImpl} object's schema and * retains all the constraints on the original rowset but contains * no data * @throws SQLException if an error occurs in generating the copy - * of the CachedRowSet object + * of the {@code CachedRowSet} object * @see #createShared * @see #createCopy * @see #createCopyNoConstraints @@ -821,17 +821,17 @@ } /** - * Creates a CachedRowSet object that is a copy of - * this CachedRowSetImpl object's data only. + * Creates a {@code CachedRowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's data only. * All constraints set in this object will not be there * in the returning object. Updates made * on a copy are not visible to the original rowset. * - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSetImpl object and is - * completely independent from this CachedRowSetImpl object + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSetImpl} object and is + * completely independent from this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the copy of the - * of the CachedRowSet + * of the {@code CachedRowSet} * @see #createShared * @see #createCopy * @see #createCopySchema @@ -843,15 +843,15 @@ } /** - * Converts this CachedRowSetImpl object to a collection - * of tables. The sample implementation utilitizes the TreeMap + * Converts this {@code CachedRowSetImpl} object to a collection + * of tables. The sample implementation utilitizes the {@code TreeMap} * collection type. * This class guarantees that the map will be in ascending key order, * sorted according to the natural order for the key's class. * - * @return a Collection object consisting of tables, + * @return a {@code Collection} object consisting of tables, * each of which is a copy of a row in this - * CachedRowSetImpl object + * {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the collection * @see #toCollection(int) * @see #toCollection(String) @@ -863,16 +863,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -886,16 +886,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -914,25 +914,25 @@ /** - * Returns the SyncProvider implementation being used - * with this CachedRowSetImpl implementation rowset. + * Returns the {@code SyncProvider} implementation being used + * with this {@code CachedRowSetImpl} implementation rowset. * * @return the SyncProvider used by the rowset. If not provider was * set when the rowset was instantiated, the reference * implementation (default) provider is returned. * @throws SQLException if error occurs while return the - * SyncProvider instance. + * {@code SyncProvider} instance. */ public SyncProvider getSyncProvider() throws SQLException { throw new UnsupportedOperationException(); } /** - * Sets the active SyncProvider and attempts to load - * load the new provider using the SyncFactory SPI. + * Sets the active {@code SyncProvider} and attempts to load + * load the new provider using the {@code SyncFactory} SPI. * * @throws SQLException if an error occurs while resetting the - * SyncProvider. + * {@code SyncProvider}. */ public void setSyncProvider(String providerStr) throws SQLException { throw new UnsupportedOperationException(); @@ -953,23 +953,23 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data. + * Populates this {@code CachedRowSetImpl} object with data. * This form of the method uses the rowset's user, password, and url or * data source name properties to create a database * connection. If properties that are needed * have not been set, this method will throw an exception. * - * Another form of this method uses an existing JDBC Connection + * Another form of this method uses an existing JDBC {@code Connection} * object instead of creating a new one; therefore, it ignores the * properties used for establishing a new connection. * * The query specified by the command property is executed to create a - * ResultSet object from which to retrieve data. + * {@code ResultSet} object from which to retrieve data. * The current contents of the rowset are discarded, and the * rowset's metadata is also (re)set. If there are outstanding updates, * they are also ignored. * - * The method execute closes any database connections that it + * The method {@code execute} closes any database connections that it * creates. * * @throws SQLException if an error occurs or the @@ -987,20 +987,20 @@ /** * Moves the cursor down one row from its current position and - * returns true if the new cursor position is a + * returns {@code true} if the new cursor position is a * valid row. - * The cursor for a new ResultSet object is initially + * The cursor for a new {@code ResultSet} object is initially * positioned before the first row. The first call to the method - * next moves the cursor to the first row, making it + * {@code next} moves the cursor to the first row, making it * the current row; the second call makes the second row the * current row, and so on. * * If an input stream from the previous row is open, it is - * implicitly closed. The ResultSet object's warning + * implicitly closed. The {@code ResultSet} object's warning * chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if an error occurs or * the cursor is not positioned in the rowset, before * the first row, or after the last row @@ -1010,9 +1010,9 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the next - * row and returns true if the cursor is still in the rowset; - * returns false if the cursor has moved to the position after + * Moves this {@code CachedRowSetImpl} object's cursor to the next + * row and returns {@code true} if the cursor is still in the rowset; + * returns {@code false} if the cursor has moved to the position after * the last row. * * This method handles the cases where the cursor moves to a row that @@ -1021,15 +1021,15 @@ * that has been deleted, this method moves the cursor to the next * row until the cursor is on a row that has not been deleted. * - * The method internalNext is called by methods such as - * next, absolute, and relative, + * The method {@code internalNext} is called by methods such as + * {@code next}, {@code absolute}, and {@code relative}, * and, as its name implies, is only called internally. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a valid row in this - * rowset; false if it is after the last row + * @return {@code true} if the cursor is on a valid row in this + * rowset; {@code false} if it is after the last row * @throws SQLException if an error occurs */ protected boolean internalNext() throws SQLException { @@ -1037,25 +1037,25 @@ } /** - * Closes this CachedRowSetImpl objecy and releases any resources + * Closes this {@code CachedRowSetImpl} objecy and releases any resources * it was using. * * @throws SQLException if an error occurs when releasing any resources in use - * by this CachedRowSetImpl object + * by this {@code CachedRowSetImpl} object */ public void close() throws SQLException { throw new UnsupportedOperationException(); } /** - * Reports whether the last column read was SQL NULL. - * Note that you must first call the method getXXX + * Reports whether the last column read was SQL {@code NULL}. + * Note that you must first call the method {@code getXXX} * on a column to try to read its value and then call the method - * wasNull to determine whether the value was - * SQL NULL. + * {@code wasNull} to determine whether the value was + * SQL {@code NULL}. * - * @return true if the value in the last column read - * was SQL NULL; false otherwise + * @return {@code true} if the value in the last column read + * was SQL {@code NULL}; {@code false} otherwise * @throws SQLException if an error occurs */ public boolean wasNull() throws SQLException { @@ -1064,9 +1064,9 @@ /** * Returns the insert row or the current row of this - * CachedRowSetImplobject. + * {@code CachedRowSetImpl}object. * - * @return the Row object on which this CachedRowSetImpl + * @return the {@code Row} object on which this {@code CachedRowSetImpl} * objects's cursor is positioned */ protected BaseRow getCurrentRow() { @@ -1077,7 +1077,7 @@ * Removes the row on which the cursor is positioned. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * * @throws SQLException if the cursor is positioned on the insert * row @@ -1089,20 +1089,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * String object. + * of this {@code CachedRowSetImpl} object as a + * {@code String} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} {@code CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type designates the * recommended return type. */ public String getString(int columnIndex) throws SQLException { @@ -1111,18 +1111,18 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * boolean value. + * of this {@code CachedRowSetImpl} object as a + * {@code boolean} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a boolean in the Java progamming language; - * if the value is SQL NULL, the result is false + * @return the column value as a {@code boolean} in the Java progamming language; + * if the value is SQL {@code NULL}, the result is {@code false} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BOOLEAN value + * SQL {@code BOOLEAN} value * @see #getBoolean(String) */ public boolean getBoolean(int columnIndex) throws SQLException { @@ -1131,20 +1131,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type + * SQL {@code TINYINT}, {@code SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type * designates the recommended return type. * @see #getByte(String) */ @@ -1154,21 +1154,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * short value. + * of this {@code CachedRowSetImpl} object as a + * {@code short} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT}, {@code SMALLINT}, + * {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(String) */ public short getShort(int columnIndex) throws SQLException { @@ -1177,21 +1178,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * int value. + * of this {@code CachedRowSetImpl} object as an + * {@code int} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1199,21 +1201,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * long value. + * of this {@code CachedRowSetImpl} object as a + * {@code long} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getLong(String) */ public long getLong(int columnIndex) throws SQLException { @@ -1222,21 +1225,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * float value. + * of this {@code CachedRowSetImpl} object as a + * {@code float} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,} + * {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC, + * BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(int columnIndex) throws SQLException { @@ -1245,21 +1248,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * double value. + * of this {@code CachedRowSetImpl} object as a + * {@code double} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,} + * {@code FLOAT, DOUBLE}, + * {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getDouble(String) * */ @@ -1269,21 +1273,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * This method is deprecated; use the version of getBigDecimal + * This method is deprecated; use the version of {@code getBigDecimal} * that does not take a scale parameter and returns a value with full * precision. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @param scale the number of digits to the right of the decimal point in the * value returned * @return the column value with the specified number of digits to the right - * of the decimal point; if the value is SQL NULL, the - * result is null + * of the decimal point; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails * @deprecated @@ -1295,22 +1299,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte array value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} array value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the - * result is null + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the + * result is {@code null} * * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or + * {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getBytes(String) */ public byte[] getBytes(int columnIndex) throws SQLException { @@ -1319,17 +1323,17 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Date object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Date} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a java.sql.Data object; if - * the value is SQL NULL, the - * result is null + * @return the column value as a {@code java.sql.Data} object; if + * the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, - * the cursor is not on a valid row, or this method fails + * the cursor is not on a valid row, or this method fails */ public java.sql.Date getDate(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1337,14 +1341,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Time object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Time} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1354,14 +1358,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1371,33 +1375,33 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The JDBC + * suitable for retrieving large {@code LONGVARCHAR} values. The JDBC * driver will do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. . Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(String) */ public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException { @@ -1416,8 +1420,8 @@ * stream may return 0 for available() whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of two byte Unicode characters. If the value is SQL NULL @@ -1432,30 +1436,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for - * CachedRowSetImpl.available() whether there is data + * stream may return {@code 0} for + * {@code CachedRowSetImpl.available()} whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes. If the value is SQL NULL - * then the result is null. + * as a stream of uninterpreted bytes. If the value is SQL {@code NULL} + * then the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY}. * The bold type indicates the SQL type that this method is recommened * to retrieve. * @see #getBinaryStream(String) @@ -1472,19 +1476,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a String object. + * of the current row as a {@code String} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR< value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} + * {@code CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. */ public String getString(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1492,17 +1496,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a boolean value. + * of the current row as a {@code boolean} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a boolean in the Java programming - * language; if the value is SQL NULL, - * the result is false + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code boolean} in the Java programming + * language; if the value is SQL {@code NULL}, + * the result is {@code false} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BOOLEAN value + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BOOLEAN} value * @see #getBoolean(int) */ public boolean getBoolean(String columnName) throws SQLException { @@ -1511,19 +1515,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte value. + * of the current row as a {@code byte} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The - * bold type designates the recommended return type + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT}, + * {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} + * value. The bold type designates the recommended return type. */ public byte getByte(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1531,19 +1535,20 @@ /** * Retrieves the value stored in the designated column - * of the current row as a short value. + * of the current row as a {@code short} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT,} + * {@code SMALLINT}, {@code INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(int) */ public short getShort(String columnName) throws SQLException { @@ -1552,20 +1557,21 @@ /** * Retrieves the value stored in the designated column - * of the current row as an int value. + * of the current row as an {@code int} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name - * of a column in this rowset, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * of a column in this rowset, + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1573,19 +1579,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a long value. + * of the current row as a {@code long} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getLong(int) */ public long getLong(String columnName) throws SQLException { @@ -1594,19 +1600,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a float value. + * of the current row as a {@code float} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT,} {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(String columnName) throws SQLException { @@ -1615,20 +1621,20 @@ /** * Retrieves the value stored in the designated column - * of the current row of this CachedRowSetImpl object - * as a double value. + * of the current row of this {@code CachedRowSetImpl} object + * as a {@code double} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return types. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL,} {@code FLOAT, DOUBLE}, {@code DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return types. * @see #getDouble(int) */ public double getDouble(String columnName) throws SQLException { @@ -1637,22 +1643,22 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.math.BigDecimal object. + * of the current row as a {@code java.math.BigDecimal} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @param scale the number of digits to the right of the decimal point - * @return a java.math.BugDecimal object with scale - * number of digits to the right of the decimal point. + * @return a java.math.BugDecimal object with {@code scale} + * number of digits to the right of the decimal point. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve. - * @deprecated Use the getBigDecimal(String columnName) + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. + * @deprecated Use the {@code getBigDecimal(String columnName)} * method instead */ @Deprecated @@ -1662,19 +1668,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte array. + * of the current row as a {@code byte} array. * The bytes represent the raw values returned by the driver. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BINARY, VARBINARY - * or LONGVARBINARY values - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BINARY, VARBINARY} + * or {@code LONGVARBINARY} values. + * The bold SQL type designates the recommended return type. * @see #getBytes(int) */ public byte[] getBytes(String columnName) throws SQLException { @@ -1683,17 +1689,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Date object. + * of the current row as a {@code java.sql.Date} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1701,12 +1707,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Time object. + * of the current row as a {@code java.sql.Time} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1717,12 +1723,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Timestamp object. + * of the current row as a {@code java.sql.Timestamp} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1733,32 +1739,32 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The - * SyncProvider will rely on the JDBC driver to do any necessary + * suitable for retrieving large {@code LONGVARCHAR} values. The + * {@code SyncProvider} will rely on the JDBC driver to do any necessary * conversion from the database format into ASCII format. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * a column in this rowset + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(int) */ public java.io.InputStream getAsciiStream(String columnName) throws SQLException { @@ -1769,23 +1775,23 @@ /** * A column value can be retrieved as a stream of Unicode characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will do any necessary conversion from the database * format into Unicode. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row - * @deprecated use the method getCharacterStream instead + * @deprecated use the method {@code getCharacterStream} instead */ @Deprecated public java.io.InputStream getUnicodeStream(String columnName) throws SQLException { @@ -1794,30 +1800,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of uninterpreted bytes. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is unknown, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY - * The bold type indicates the SQL type that this method is recommened - * to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY} + * The bold type indicates the SQL type that this method is recommened + * to retrieve. * @see #getBinaryStream(int) * */ @@ -1831,17 +1837,17 @@ //===================================================================== /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by statement + * by {@code ResultSet} methods. Any warning caused by statement * methods (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * * @return the first SQLWarning or null */ @@ -1850,10 +1856,10 @@ } /** - * Clears all the warnings reporeted for the CachedRowSetImpl - * object. After a call to this method, the getWarnings method - * returns null until a new warning is reported for this - * CachedRowSetImpl object. + * Clears all the warnings reporeted for the {@code CachedRowSetImpl} + * object. After a call to this method, the {@code getWarnings} method + * returns {@code null} until a new warning is reported for this + * {@code CachedRowSetImpl} object. */ public void clearWarnings() { throw new UnsupportedOperationException(); @@ -1861,25 +1867,25 @@ /** * Retrieves the name of the SQL cursor used by this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * * In SQL, a result table is retrieved through a cursor that is - * named. The current row of a ResultSet can be updated or deleted + * named. The current row of a {@code ResultSet} can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To ensure that the cursor has the proper isolation - * level to support an update operation, the cursor's SELECT - * statement should be of the form select for update. - * If the for update clause + * level to support an update operation, the cursor's {@code SELECT} + * statement should be of the form {@code select for update}. + * If the {@code for update} clause * is omitted, positioned updates may fail. * * JDBC supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. The current row + * SQL cursor used by a {@code ResultSet} object. The current row * of a result set is also the current row of this SQL cursor. * * Note: If positioned updates are not supported, an - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL cursor name for this CachedRowSetImpl object's + * @return the SQL cursor name for this {@code CachedRowSetImpl} object's * cursor * @throws SQLException if an error occurs */ @@ -1888,12 +1894,12 @@ } /** - * Retrieves a ResultSetMetaData object instance that - * contains information about the CachedRowSet object. + * Retrieves a {@code ResultSetMetaData} object instance that + * contains information about the {@code CachedRowSet} object. * However, applications should cast the returned object to a - * RowSetMetaData interface implementation. In the + * {@code RowSetMetaData} interface implementation. In the * reference implementation, this cast can be done on the - * RowSetMetaDataImpl class. + * {@code RowSetMetaDataImpl} class. * * For example: * @@ -1907,10 +1913,10 @@ * crs.setMetaData(metaData); * * - * @return the ResultSetMetaData object that describes this - * CachedRowSetImpl object's columns + * @return the {@code ResultSetMetaData} object that describes this + * {@code CachedRowSetImpl} object's columns * @throws SQLException if an error occurs in generating the RowSet - * meta data; or if the CachedRowSetImpl is empty. + * meta data; or if the {@code CachedRowSetImpl} is empty. * @see javax.sql.RowSetMetaData */ public ResultSetMetaData getMetaData() throws SQLException { @@ -1920,10 +1926,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1931,23 +1937,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes in the Java programming language. * When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(String) */ public Object getObject(int columnIndex) throws SQLException { @@ -1956,10 +1962,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1967,23 +1973,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes * in the Java programming language. When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name does not match one of * this rowset's column names, (2) the cursor is not * on a valid row, or (3) there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(int) */ public Object getObject(String columnName) throws SQLException { @@ -1993,10 +1999,10 @@ //---------------------------------------------------------------- /** - * Maps the given column name for one of this CachedRowSetImpl + * Maps the given column name for one of this {@code CachedRowSetImpl} * object's columns to its column number. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @return the column index of the given column name * @throws SQLException if the given column name does not match one @@ -2014,25 +2020,25 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java character stream that delivers the database column value * as a stream of two-byte unicode characters in a - * java.io.Reader object. If the value is - * SQL NULL, the result is null. + * {@code java.io.Reader} object. If the value is + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR,} {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getCharacterStream(String) */ public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{ @@ -2041,23 +2047,24 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY or LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code CHAR, VARCHAR,} + * {@code LONGVARCHAR}, + * {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -2065,21 +2072,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return types that this method is used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return types that this method is used to retrieve. * @see #getBigDecimal(String) */ public BigDecimal getBigDecimal(int columnIndex) throws SQLException { @@ -2088,21 +2096,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. * @see #getBigDecimal(int) */ public BigDecimal getBigDecimal(String columnName) throws SQLException { @@ -2114,7 +2122,7 @@ //--------------------------------------------------------------------- /** - * Returns the number of rows in this CachedRowSetImpl object. + * Returns the number of rows in this {@code CachedRowSetImpl} object. * * @return number of rows in the rowset */ @@ -2124,10 +2132,10 @@ /** * Indicates whether the cursor is before the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is before the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isBeforeFirst() throws SQLException { @@ -2136,10 +2144,10 @@ /** * Indicates whether the cursor is after the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is after the last row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isAfterLast() throws SQLException { @@ -2148,10 +2156,10 @@ /** * Indicates whether the cursor is on the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is on the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isFirst() throws SQLException { @@ -2160,14 +2168,14 @@ /** * Indicates whether the cursor is on the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * Note: Calling the method isLast may be expensive + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver might need to fetch ahead one row in order * to determine whether the current row is the last row in this rowset. * - * @return true if the cursor is on the last row; - * false otherwise or if this rowset contains no rows + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise or if this rowset contains no rows * @throws SQLException if an error occurs */ public boolean isLast() throws SQLException { @@ -2175,19 +2183,19 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the front of + * Moves this {@code CachedRowSetImpl} object's cursor to the front of * the rowset, just before the first row. This method has no effect if * this rowset contains no rows. * * @throws SQLException if an error occurs or the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public void beforeFirst() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the end of + * Moves this {@code CachedRowSetImpl} object's cursor to the end of * the rowset, just after the last row. This method has no effect if * this rowset contains no rows. * @@ -2198,34 +2206,34 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the first row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the first row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean first() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the first - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the first + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the methods first, - * isFirst, and absolute. - * It in turn calls the method internalNext in order to + * This method is called internally by the methods {@code first}, + * {@code isFirst}, and {@code absolute}. + * It in turn calls the method {@code internalNext} in order to * handle the case where the first row is a deleted row that is not visible. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the first row; - * false otherwise + * @return {@code true} if the cursor moved to the first row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalFirst() throws SQLException { @@ -2233,35 +2241,35 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the last row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the last row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean last() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the last - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the last + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the method last + * This method is called internally by the method {@code last} * when rows have been deleted and the deletions are not visible. - * The method internalLast handles the case where the + * The method {@code internalLast} handles the case where the * last row is a deleted row that is not visible by in turn calling - * the method internalPrevious. + * the method {@code internalPrevious}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the last row; - * false otherwise + * @return {@code true} if the cursor moved to the last row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalLast() throws SQLException { @@ -2269,12 +2277,12 @@ } /** - * Returns the number of the current row in this CachedRowSetImpl + * Returns the number of the current row in this {@code CachedRowSetImpl} * object. The first row is number 1, the second number 2, and so on. * - * @return the number of the current row; 0 if there is no + * @return the number of the current row; {@code 0} if there is no * current row - * @throws SQLException if an error occurs; or if the CacheRowSetImpl + * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl} * is empty */ public int getRow() throws SQLException { @@ -2282,51 +2290,51 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the row number + * Moves this {@code CachedRowSetImpl} object's cursor to the row number * specified. * * If the number is positive, the cursor moves to an absolute row with * respect to the beginning of the rowset. The first row is row 1, the second * is row 2, and so on. For example, the following command, in which - * crs is a CachedRowSetImpl object, moves the cursor + * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor * to the fourth row, starting from the beginning of the rowset. - * + * {@code * * crs.absolute(4); * - * + * } * * If the number is negative, the cursor moves to an absolute row position * with respect to the end of the rowset. For example, calling - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row, counting * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. * * @param row a positive number to indicate the row, starting row numbering from - * the first row, which is 1; a negative number to indicate + * the first row, which is {@code 1}; a negative number to indicate * the row, starting row numbering from the last row, which is - * -1; it must not be 0 - * @return true if the cursor is on the rowset; false + * {@code -1}; it must not be {@code 0} + * @return {@code true} if the cursor is on the rowset; {@code false} * otherwise - * @throws SQLException if the given cursor position is 0 or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * @throws SQLException if the given cursor position is {@code 0} or the + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean absolute( int row ) throws SQLException { throw new UnsupportedOperationException(); @@ -2340,80 +2348,80 @@ * If the number is positive, the cursor moves the specified number of * rows toward the end of the rowset, starting at the current row. * For example, the following command, in which - * crs is a CachedRowSetImpl object with 100 rows, + * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows, * moves the cursor forward four rows from the current row. If the * current row is 50, the cursor would move to row 54. - * + * {@code * * crs.relative(4); * - * + * } * * If the number is negative, the cursor moves back toward the beginning * the specified number of rows, starting at the current row. * For example, calling the method - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. In both cases, this method - * throws an SQLException. + * throws an {@code SQLException}. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). Calling relative(0) + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. Calling {@code relative(0)} * is valid, but it does not change the cursor position. * - * @param rows an int indicating the number of rows to move + * @param rows an {@code int} indicating the number of rows to move * the cursor, starting at the current row; a positive number * moves the cursor forward; a negative number moves the cursor * backward; must not move the cursor past the valid * rows - * @return true if the cursor is on a row in this - * CachedRowSetImpl object; false + * @return {@code true} if the cursor is on a row in this + * {@code CachedRowSetImpl} object; {@code false} * otherwise * @throws SQLException if there are no rows in this rowset, the cursor is * positioned either before the first row or after the last row, or - * the rowset is type ResultSet.TYPE_FORWARD_ONLY + * the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean relative(int rows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the - * previous row and returns true if the cursor is on - * a valid row or false if it is not. + * Moves this {@code CachedRowSetImpl} object's cursor to the + * previous row and returns {@code true} if the cursor is on + * a valid row or {@code false} if it is not. * This method also notifies all listeners registered with this - * CachedRowSetImpl object that its cursor has moved. + * {@code CachedRowSetImpl} object that its cursor has moved. * - * Note: calling the method previous() is not the same - * as calling the method relative(-1). This is true - * because it is possible to call previous() from the insert + * Note: calling the method {@code previous()} is not the same + * as calling the method {@code relative(-1)}. This is true + * because it is possible to call {@code previous()} from the insert * row, from after the last row, or from the current row, whereas - * relative may only be called from the current row. + * {@code relative} may only be called from the current row. * - * The method previous may used in a while + * The method {@code previous} may used in a {@code while} * loop to iterate through a rowset starting after the last row - * and moving toward the beginning. The loop ends when previous - * returns false, meaning that there are no more rows. + * and moving toward the beginning. The loop ends when {@code previous} + * returns {@code false}, meaning that there are no more rows. * For example, the following code fragment retrieves all the data in - * the CachedRowSetImpl object crs, which has + * the {@code CachedRowSetImpl} object {@code crs}, which has * three columns. Note that the cursor must initially be positioned * after the last row so that the first call to the method - * previous places the cursor on the last line. - * + * {@code previous} places the cursor on the last line. + * {@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - * - * This method throws an SQLException if the cursor is not + * } + * This method throws an {@code SQLException} if the cursor is not * on a row in the rowset, before the first row, or after the last row. * - * @return true if the cursor is on a valid row; - * false if it is before the first row or after the + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is before the first row or after the * last row * @throws SQLException if the cursor is not on a valid position or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean previous() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor to the previous row in this CachedRowSetImpl + * Moves the cursor to the previous row in this {@code CachedRowSetImpl} * object, skipping past deleted rows that are not visible; returns - * true if the cursor is on a row in this rowset and - * false when the cursor goes before the first row. + * {@code true} if the cursor is on a row in this rowset and + * {@code false} when the cursor goes before the first row. * - * This method is called internally by the method previous. + * This method is called internally by the method {@code previous}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a row in this rowset; - * false when the cursor reaches the position before + * @return {@code true} if the cursor is on a row in this rowset; + * {@code false} when the cursor reaches the position before * the first row * @throws SQLException if an error occurs */ @@ -2463,14 +2471,14 @@ //--------------------------------------------------------------------- /** - * Indicates whether the current row of this CachedRowSetImpl + * Indicates whether the current row of this {@code CachedRowSetImpl} * object has been updated. The value returned - * depends on whether this rowset can detect updates: false + * depends on whether this rowset can detect updates: {@code false} * will always be returned if it does not detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another and updates are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2482,13 +2490,13 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * * @param idx the index identifier of the column that may be have been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2500,14 +2508,14 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * - * @param columnName the String column name column that may be have + * @param columnName the {@code String} column name column that may be have * been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2521,8 +2529,8 @@ * Indicates whether the current row has been inserted. The value returned * depends on whether or not the rowset can detect visible inserts. * - * @return true if a row has been inserted and inserts are detected; - * false otherwise + * @return {@code true} if a row has been inserted and inserts are detected; + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2536,12 +2544,12 @@ * Indicates whether the current row has been deleted. A deleted row * may leave a visible "hole" in a rowset. This method can be used to * detect such holes if the rowset can detect deletions. This method - * will always return false if this rowset cannot detect + * will always return {@code false} if this rowset cannot detect * deletions. * - * @return true if (1)the current row is blank, indicating that + * @return {@code true} if (1)the current row is blank, indicating that * the row has been deleted, and (2)deletions are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on a valid row in this rowset * @see DatabaseMetaData#deletesAreDetected */ @@ -2551,8 +2559,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset; however, another method must be called to complete @@ -2565,15 +2573,15 @@ * * In order to propagate updates in this rowset to the underlying * data source, an application must call the method {@link #acceptChanges} - * after it calls either updateRow or insertRow. + * after it calls either {@code updateRow} or {@code insertRow}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -2581,8 +2589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2593,14 +2601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(int columnIndex, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -2608,8 +2616,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2620,14 +2628,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(int columnIndex, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -2635,8 +2643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2647,14 +2655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(int columnIndex, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -2662,8 +2670,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2674,14 +2682,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(int columnIndex, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -2689,8 +2697,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2701,14 +2709,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(int columnIndex, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -2717,8 +2725,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2729,14 +2737,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(int columnIndex, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -2744,8 +2752,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2756,14 +2764,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(int columnIndex, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -2771,8 +2779,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2783,14 +2791,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -2798,8 +2806,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2810,17 +2818,17 @@ * as inserted. Both of these methods must be called before the * cursor moves to another row. * - * The method acceptChanges must be called if the + * The method {@code acceptChanges} must be called if the * updated values are to be written back to the underlying database. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(int columnIndex, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -2828,8 +2836,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2840,14 +2848,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(int columnIndex, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -2855,8 +2863,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2867,15 +2875,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(int columnIndex, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -2883,8 +2891,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2895,15 +2903,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL TIME or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code TIME} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(int columnIndex, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -2911,8 +2919,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2923,16 +2931,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE, TIME, or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE}, {@code TIME}, or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -2940,7 +2948,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -2952,8 +2960,8 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -2965,8 +2973,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2977,17 +2985,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not binary, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException { throw new UnsupportedOperationException(); @@ -2995,8 +3003,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3007,19 +3015,19 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.Reader - * containing BINARY, VARBINARY, - * LONGVARBINARY, CHAR, VARCHAR, - * or LONGVARCHAR data + * @param x the new column value; must be a {@code java.io.Reader} + * containing {@code BINARY}, {@code VARBINARY}, + * {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR}, + * or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not a binary or * character type, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3027,11 +3035,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter indicates + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter indicates * the number of digits to the right of the decimal point and is ignored * if the new column value is not a type that will be mapped to an SQL - * DECIMAL or NUMERIC value. + * {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3042,16 +3050,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3059,8 +3067,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3071,14 +3079,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x) throws SQLException { throw new UnsupportedOperationException(); @@ -3087,8 +3095,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3098,12 +3106,12 @@ * must be called, which will insert the new row into both this rowset * and the database. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -3111,8 +3119,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3123,13 +3131,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(String columnName, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -3137,8 +3145,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3149,13 +3157,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(String columnName, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -3163,8 +3171,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3175,13 +3183,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(String columnName, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -3189,8 +3197,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3201,13 +3209,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(String columnName, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -3215,8 +3223,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3227,13 +3235,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(String columnName, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -3241,8 +3249,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3253,13 +3261,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(String columnName, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -3267,8 +3275,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3279,13 +3287,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(String columnName, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -3293,8 +3301,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3305,13 +3313,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -3319,8 +3327,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3331,13 +3339,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(String columnName, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -3345,8 +3353,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3357,13 +3365,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(String columnName, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -3371,8 +3379,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3383,15 +3391,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(String columnName, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -3399,8 +3407,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3411,15 +3419,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL TIME or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code TIME} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(String columnName, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -3427,8 +3435,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3439,7 +3447,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if the given column index is out of bounds or @@ -3448,9 +3456,9 @@ * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE, - * TIME, or TIMESTAMP, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP}, or (4) this + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -3458,7 +3466,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -3470,7 +3478,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -3483,8 +3491,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3495,17 +3503,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not binary, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3513,8 +3521,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3525,18 +3533,18 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param reader the new column value; must be a - * java.io.Reader containing BINARY, - * VARBINARY, LONGVARBINARY, CHAR, - * VARCHAR, or LONGVARCHAR data + * {@code java.io.Reader} containing {@code BINARY}, + * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR}, + * {@code VARCHAR}, or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not a binary or character type, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(String columnName, java.io.Reader reader, @@ -3546,11 +3554,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter * indicates the number of digits to the right of the decimal point * and is ignored if the new column value is not a type that will be - * mapped to an SQL DECIMAL or NUMERIC value. + * mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3561,15 +3569,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3577,8 +3585,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3589,20 +3597,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x) throws SQLException { throw new UnsupportedOperationException(); } /** - * Inserts the contents of this CachedRowSetImpl object's insert + * Inserts the contents of this {@code CachedRowSetImpl} object's insert * row into this rowset immediately following the current row. * If the current row is the * position after the last row or before the first row, the new row will @@ -3614,14 +3622,14 @@ * @throws SQLException if (1) the cursor is not on the insert row, * (2) one or more of the non-nullable columns in the insert * row has not been given a value, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void insertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Marks the current row of this CachedRowSetImpl object as + * Marks the current row of this {@code CachedRowSetImpl} object as * updated and notifies listeners registered with this rowset that the * row has changed. * @@ -3631,26 +3639,26 @@ * and the updates made before the cursor moved will be lost. * * @throws SQLException if the cursor is on the insert row or this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Deletes the current row from this CachedRowSetImpl object and + * Deletes the current row from this {@code CachedRowSetImpl} object and * notifies listeners registered with this rowset that a row has changed. * This method cannot be called when the cursor is on the insert row. * * This method marks the current row as deleted, but it does not delete * the row from the underlying data source. The method - * acceptChanges must be called to delete the row in + * {@code acceptChanges} must be called to delete the row in * the data source. * * @throws SQLException if (1) this method is called when the cursor * is on the insert row, before the first row, or after the * last row or (2) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void deleteRow() throws SQLException { throw new UnsupportedOperationException(); @@ -3659,7 +3667,7 @@ /** * Sets the current row with its original value and marks the row as * not updated, thus undoing any changes made to the row since the - * last call to the methods updateRow or deleteRow. + * last call to the methods {@code updateRow} or {@code deleteRow}. * This method should be called only when the cursor is on a row in * this rowset. * @@ -3672,11 +3680,11 @@ /** * Rolls back any updates made to the current row of this - * CachedRowSetImpl object and notifies listeners that + * {@code CachedRowSetImpl} object and notifies listeners that * a row has changed. To have an effect, this method - * must be called after an updateXXX method has been - * called and before the method updateRow has been called. - * If no updates have been made or the method updateRow + * must be called after an {@code updateXXX} method has been + * called and before the method {@code updateRow} has been called. + * If no updates have been made or the method {@code updateRow} * has already been called, this method has no effect. * * @throws SQLException if the cursor is on the insert row, before the @@ -3687,39 +3695,39 @@ } /** - * Moves the cursor for this CachedRowSetImpl object + * Moves the cursor for this {@code CachedRowSetImpl} object * to the insert row. The current row in the rowset is remembered * while the cursor is on the insert row. * * The insert row is a special row associated with an updatable * rowset. It is essentially a buffer where a new row may - * be constructed by calling the appropriate updateXXX + * be constructed by calling the appropriate {@code updateXXX} * methods to assign a value to each column in the row. A complete * row must be constructed; that is, every column that is not nullable * must be assigned a value. In order for the new row to become part - * of this rowset, the method insertRow must be called + * of this rowset, the method {@code insertRow} must be called * before the cursor is moved back to the rowset. * * Only certain methods may be invoked while the cursor is on the insert * row; many methods throw an exception if they are called while the - * cursor is there. In addition to the updateXXX - * and insertRow methods, only the getXXX methods - * may be called when the cursor is on the insert row. A getXXX - * method should be called on a column only after an updateXXX + * cursor is there. In addition to the {@code updateXXX} + * and {@code insertRow} methods, only the {@code getXXX} methods + * may be called when the cursor is on the insert row. A {@code getXXX} + * method should be called on a column only after an {@code updateXXX} * method has been called on that column; otherwise, the value returned is * undetermined. * - * @throws SQLException if this CachedRowSetImpl object is - * ResultSet.CONCUR_READ_ONLY + * @throws SQLException if this {@code CachedRowSetImpl} object is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void moveToInsertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor for this CachedRowSetImpl object to + * Moves the cursor for this {@code CachedRowSetImpl} object to * the current row. The current row is the row the cursor was on - * when the method moveToInsertRow was called. + * when the method {@code moveToInsertRow} was called. * * Calling this method has no effect unless it is called while the * cursor is on the insert row. @@ -3731,9 +3739,9 @@ } /** - * Returns null. + * Returns {@code null}. * - * @return null + * @return {@code null} * @throws SQLException if an error occurs */ public Statement getStatement() throws SQLException { @@ -3742,18 +3750,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column index is out of bounds or * the cursor is not on one of this rowset's rows or its * insert row @@ -3767,17 +3775,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL REF value + * SQL {@code REF} value * @see #getRef(String) */ public Ref getRef(int columnIndex) throws SQLException { @@ -3786,17 +3794,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BLOB value + * SQL {@code BLOB} value * @see #getBlob(String) */ public Blob getBlob(int columnIndex) throws SQLException { @@ -3805,17 +3813,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Clob object representing an SQL CLOB value + * @return a {@code Clob} object representing an SQL {@code CLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL CLOB value + * SQL {@code CLOB} value * @see #getClob(String) */ public Clob getClob(int columnIndex) throws SQLException { @@ -3824,18 +3832,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL ARRAY value + * SQL {@code ARRAY} value * @see #getArray(String) */ public Array getArray(int columnIndex) throws SQLException { @@ -3844,17 +3852,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column name is not the name of * a column in this rowset or the cursor is not on one of * this rowset's rows or its insert row @@ -3867,16 +3875,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the column value - * is not an SQL REF value + * is not an SQL {@code REF} value * @see #getRef(int) */ public Ref getRef(String colName) throws SQLException { @@ -3885,16 +3893,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BLOB value + * column does not store an SQL {@code BLOB} value * @see #getBlob(int) */ public Blob getBlob(String colName) throws SQLException { @@ -3903,17 +3911,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Clob object representing an SQL - * CLOB value + * @return a {@code Clob} object representing an SQL + * {@code CLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CLOB value + * column does not store an SQL {@code CLOB} value * @see #getClob(int) */ public Clob getClob(String colName) throws SQLException { @@ -3922,17 +3930,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming langugage. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL ARRAY value + * column does not store an SQL {@code ARRAY} value * @see #getArray(int) */ public Array getArray(String colName) throws SQLException { @@ -3941,22 +3949,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3964,21 +3972,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3986,22 +3994,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4009,21 +4017,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4031,22 +4039,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Timestamp - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4054,22 +4062,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object, using the given - * Calendar object to construct an appropriate + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object, using the given + * {@code Calendar} object to construct an appropriate * millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE, - * TIME, or TIMESTAMP value + * column does not store an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4080,13 +4088,13 @@ */ /** - * Retrieves the Connection object passed to this - * CachedRowSetImpl object. This connection may be + * Retrieves the {@code Connection} object passed to this + * {@code CachedRowSetImpl} object. This connection may be * used to populate this rowset with data or to write data back * to its underlying data source. * - * @return the Connection object passed to this rowset; - * may be null if there is no connection + * @return the {@code Connection} object passed to this rowset; + * may be {@code null} if there is no connection * @throws SQLException if an error occurs */ public Connection getConnection() throws SQLException{ @@ -4094,10 +4102,10 @@ } /** - * Sets the metadata for this CachedRowSetImpl object - * with the given RowSetMetaData object. + * Sets the metadata for this {@code CachedRowSetImpl} object + * with the given {@code RowSetMetaData} object. * - * @param md a RowSetMetaData object instance containing + * @param md a {@code RowSetMetaData} object instance containing * metadata about the columsn in the rowset * @throws SQLException if invalid meta data is supplied to the * rowset @@ -4108,17 +4116,17 @@ /** * Returns a result set containing the original value of the rowset. The - * original value is the state of the CachedRowSetImpl after the + * original value is the state of the {@code CachedRowSetImpl} after the * last population or synchronization (whichever occurred most recently) with * the data source. * * The cursor is positioned before the first row in the result set. - * Only rows contained in the result set returned by getOriginal() + * Only rows contained in the result set returned by {@code getOriginal()} * are said to have an original value. * * @return the original result set of the rowset * @throws SQLException if an error occurs produce the - * ResultSet object + * {@code ResultSet} object */ public ResultSet getOriginal() throws SQLException { throw new UnsupportedOperationException(); @@ -4127,7 +4135,7 @@ /** * Returns a result set containing the original value of the current * row only. - * The original value is the state of the CachedRowSetImpl after + * The original value is the state of the {@code CachedRowSetImpl} after * the last population or synchronization (whichever occurred most recently) * with the data source. * @@ -4153,7 +4161,7 @@ /** * Marks all rows in this rowset as being original rows. Any updates * made to the rows become the original values for the rowset. - * Calls to the method setOriginal connot be reversed. + * Calls to the method {@code setOriginal} connot be reversed. * * @throws SQLException if an error occurs */ @@ -4165,8 +4173,8 @@ * Returns an identifier for the object (table) that was used to create this * rowset. * - * @return a String object that identifies the table from - * which this CachedRowSetImpl object was derived + * @return a {@code String} object that identifies the table from + * which this {@code CachedRowSetImpl} object was derived * @throws SQLException if an error occurs */ public String getTableName() throws SQLException { @@ -4177,8 +4185,8 @@ * Sets the identifier for the table from which this rowset was derived * to the given table name. * - * @param tabName a String object that identifies the - * table from which this CachedRowSetImpl object + * @param tabName a {@code String} object that identifies the + * table from which this {@code CachedRowSetImpl} object * was derived * @throws SQLException if an error occurs */ @@ -4188,7 +4196,7 @@ /** * Returns the columns that make a key to uniquely identify a - * row in this CachedRowSetImpl object. + * row in this {@code CachedRowSetImpl} object. * * @return an array of column numbers that constitutes a primary * key for this rowset. This array should be empty @@ -4203,16 +4211,16 @@ /** - * Sets this CachedRowSetImpl object's - * keyCols field with the given array of column + * Sets this {@code CachedRowSetImpl} object's + * {@code keyCols} field with the given array of column * numbers, which forms a key for uniquely identifying a row * in this rowset. * - * @param keys an array of int indicating the + * @param keys an array of {@code int} indicating the * columns that form a primary key for this - * CachedRowSetImpl object; every + * {@code CachedRowSetImpl} object; every * element in the array must be greater than - * 0 and less than or equal to the number + * {@code 0} and less than or equal to the number * of columns in this rowset * @throws SQLException if any of the numbers in the * given array is not valid for this rowset @@ -4224,8 +4232,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4236,14 +4244,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4251,8 +4259,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4263,13 +4271,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4277,8 +4285,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4289,14 +4297,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + * + * Absolute URIs * - * rmi://1234@hostname:2099/remoteobjectname - - * Specifies the Java Virtual Machine identified by lvmid - * 1234 on host hostname accessed - * using the rmi: protocol through the rmi remote - * object named remoteobjectname as registered with - * the rmiserver on port 2099 on host - * hostname. - * - * file:/path/file - Identifies a Java Virtual Machine - * through accessing a special file based protocol to use as - * the communications mechanism. - * + * rmi://1234@hostname:2099/remoteobjectname - + * Specifies the Java Virtual Machine identified by lvmid + * 1234 on host hostname accessed + * using the rmi: protocol through the rmi remote + * object named remoteobjectname as registered with + * the rmiserver on port 2099 on host + * hostname. + * + * file:/path/file - Identifies a Java Virtual Machine + * through accessing a special file based protocol to use as + * the communications mechanism. + * * + * * - *
BaseCalendar
CalendarDate
0
-1%4
-1
mod(n, d)
locale
getKeys
handleGetObject
TimeZoneNames
getContents
{@literal * Note: (XXX) is the action * APPLET_XXX is the state - * (applet code loaded) --> APPLET_LOAD -- (applet init called)--> APPLET_INIT -- ( - * applet start called) --> APPLET_START -- (applet stop called) -->APPLET_STOP --(applet - * destroyed called) --> APPLET_DESTROY -->(applet gets disposed) --> - * APPLET_DISPOSE -->.... + * (applet code loaded) --> APPLET_LOAD -- (applet init called)--> APPLET_INIT -- + * (applet start called) --> APPLET_START -- (applet stop called) --> APPLET_STOP -- + * (applet destroyed called) --> APPLET_DESTROY --> (applet gets disposed) --> + * APPLET_DISPOSE --> ... + * }
JdbcRowSet
Connection
PreparedStatement
execute
ResultSet
RowSetMetaDataImpl
ResultSetMetaData
- * The following is true of a default JdbcRowSet instance: + * The following is true of a default {@code JdbcRowSet} instance: *
null
Hashtable
jdbc:subprotocol:subname
RowSetMetaData
JdbcRowSetImpl
* Certain properties must have been set before this method is called * so that it can establish a connection to a database and execute the - * query that will create the result set. If a DataSource + * query that will create the result set. If a {@code DataSource} * object will be used to create the connection, properties for the * data source name, user name, and password must be set. If the - * DriverManager will be used, the properties for the + * {@code DriverManager} will be used, the properties for the * URL, user name, and password must be set. In either case, the * property for the command must be set. If the command has placeholder * parameters, those must also be set. This method throws * an exception if the required properties are not set. *
DataSource
DriverManager
* Other properties have default values that may optionally be set - * to new values. The execute method will use the value - * for the command property to create a PreparedStatement + * to new values. The {@code execute} method will use the value + * for the command property to create a {@code PreparedStatement} * object and set its properties (escape processing, maximum field * size, maximum number of rows, and query timeout limit) to be those * of this rowset. @@ -784,20 +784,20 @@ } /** - * Moves the cursor for this rowset's ResultSet + * Moves the cursor for this rowset's {@code ResultSet} * object down one row from its current position. - * A ResultSet cursor is initially positioned + * A {@code ResultSet} cursor is initially positioned * before the first row; the first call to the method - * next makes the first row the current row; the + * {@code next} makes the first row the current row; the * second call makes the second row the current row, and so on. * *
next
If an input stream is open for the current row, a call - * to the method next will - * implicitly close it. A ResultSet object's + * to the method {@code next} will + * implicitly close it. A {@code ResultSet} object's * warning chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -811,16 +811,16 @@ } /** - * Releases this rowset's ResultSet object's database and + * Releases this rowset's {@code ResultSet} object's database and * JDBC resources immediately instead of waiting for * this to happen when it is automatically closed. * - *
true
false
Note: A ResultSet object + *
Note: A {@code ResultSet} object * is automatically closed by the - * Statement object that generated it when - * that Statement object is closed, + * {@code Statement} object that generated it when + * that {@code Statement} object is closed, * re-executed, or is used to retrieve the next result from a - * sequence of multiple results. A ResultSet object + * sequence of multiple results. A {@code ResultSet} object * is also automatically closed when it is garbage collected. * * @throws SQLException if a database access error occurs @@ -836,14 +836,14 @@ /** * Reports whether the last column read from this rowset's - * ResultSet object had a value of SQL NULL. - * Note that you must first call one of the getXXX methods + * {@code ResultSet} object had a value of SQL {@code NULL}. + * Note that you must first call one of the {@code getXXX} methods * on a column to try to read its value and then call - * the method wasNull to see if the value read was - * SQL NULL. + * the method {@code wasNull} to see if the value read was + * SQL {@code NULL}. * - * @return true if the last column value read was SQL - * NULL and false otherwise + * @return {@code true} if the last column value read was SQL + * {@code NULL} and {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not have a currently valid connection, * prepared statement, and result set @@ -860,12 +860,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a String. + * of this rowset's {@code ResultSet} object as + * a {@code String}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -878,12 +878,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a boolean. + * of this rowset's {@code ResultSet} object as + * a {@code boolean}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is false + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code false} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -896,12 +896,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte. + * of this rowset's {@code ResultSet} object as + * a {@code byte}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -914,12 +914,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a short. + * of this rowset's {@code ResultSet} object as + * a {@code short}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -932,12 +932,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an int. + * of this rowset's {@code ResultSet} object as + * an {@code int}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -950,12 +950,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a long. + * of this rowset's {@code ResultSet} object as + * a {@code long}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -968,12 +968,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a float. + * of this rowset's {@code ResultSet} object as + * a {@code float}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -986,12 +986,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a double. + * of this rowset's {@code ResultSet} object as + * a {@code double}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1004,13 +1004,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.BigDecimal. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.BigDecimal}. * * @param columnIndex the first column is 1, the second is 2, and so on * @param scale the number of digits to the right of the decimal point - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1025,13 +1025,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte array in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code byte} array in the Java programming language. * The bytes represent the raw values returned by the driver. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1044,12 +1044,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Date object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Date} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1062,12 +1062,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Time object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Time} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1080,12 +1080,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Timestamp object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Timestamp} object in the Java programming language. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1098,25 +1098,25 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as + * of this rowset's {@code ResultSet} object as * a stream of ASCII characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into ASCII. * *
Statement
NULL
getXXX
wasNull
String
boolean
byte
short
int
long
float
double
java.sql.BigDecimal
java.sql.Date
java.sql.Time
java.sql.Timestamp
LONGVARCHAR
Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream of one-byte ASCII characters; - * if the value is SQL NULL, the - * value returned is null + * as a stream of one-byte ASCII characters; + * if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) database access error occurs * (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1129,31 +1129,31 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as + * of this rowset's {@code ResultSet} object as * as a stream of Unicode characters. * The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving largeLONGVARCHARvalues. The JDBC driver will + * suitable for retrieving large{@code LONGVARCHAR}values. The JDBC driver will * do any necessary conversion from the database format into Unicode. * The byte format of the Unicode stream must be Java UTF-8, * as specified in the Java virtual machine specification. * *
InputStream.available
Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream in Java UTF-8 byte format; - * if the value is SQL NULL, the value returned is null + * as a stream in Java UTF-8 byte format; + * if the value is SQL {@code NULL}, the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set - * @deprecated use getCharacterStream in place of - * getUnicodeStream + * @deprecated use {@code getCharacterStream} in place of + * {@code getUnicodeStream} */ @Deprecated public java.io.InputStream getUnicodeStream(int columnIndex) throws SQLException { @@ -1165,22 +1165,22 @@ /** * Gets the value of a column in the current row as a stream of * the value of the designated column in the current row - * of this rowset's ResultSet object as a binary stream of + * of this rowset's {@code ResultSet} object as a binary stream of * uninterpreted bytes. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * *
getCharacterStream
getUnicodeStream
LONGVARBINARY
Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method - * InputStream.available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method + * {@code InputStream.available} * is called whether there is data available or not. * * @param columnIndex the first column is 1, the second is 2, and so on * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes; - * if the value is SQL NULL, the value returned is null + * as a stream of uninterpreted bytes; + * if the value is SQL {@code NULL}, the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1198,12 +1198,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a String. + * of this rowset's {@code ResultSet} object as + * a {@code String}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1214,12 +1214,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a boolean. + * of this rowset's {@code ResultSet} object as + * a {@code boolean}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is false + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code false} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1230,12 +1230,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte. + * of this rowset's {@code ResultSet} object as + * a {@code byte}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1246,12 +1246,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a short. + * of this rowset's {@code ResultSet} object as + * a {@code short}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1262,12 +1262,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an int. + * of this rowset's {@code ResultSet} object as + * an {@code int}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1278,12 +1278,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a long. + * of this rowset's {@code ResultSet} object as + * a {@code long}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if a database access error occurs * or this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1294,12 +1294,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a float. + * of this rowset's {@code ResultSet} object as + * a {@code float}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1310,12 +1310,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a double. + * of this rowset's {@code ResultSet} object as + * a {@code double}. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code 0} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1326,13 +1326,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.math.BigDecimal. + * of this rowset's {@code ResultSet} object as + * a {@code java.math.BigDecimal}. * * @param columnName the SQL name of the column * @param scale the number of digits to the right of the decimal point - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) adatabase access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1345,13 +1345,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a byte array in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code byte} array in the Java programming language. * The bytes represent the raw values returned by the driver. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1362,12 +1362,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Date object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Date} object in the Java programming language. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1378,13 +1378,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Time object in the Java programming language. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Time} object in the Java programming language. * * @param columnName the SQL name of the column * @return the column value; - * if the value is SQL NULL, - * the value returned is null + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1395,12 +1395,12 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * a java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as + * a {@code java.sql.Timestamp} object. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1411,24 +1411,24 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of + * of this rowset's {@code ResultSet} object as a stream of * ASCII characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into ASCII. * *
java.math.BigDecimal
Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of one-byte ASCII characters. - * If the value is SQL NULL, - * the value returned is null. + * as a stream of one-byte ASCII characters. + * If the value is SQL {@code NULL}, + * the value returned is {@code null}. * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1439,10 +1439,10 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of + * of this rowset's {@code ResultSet} object as a stream of * Unicode characters. The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will * do any necessary conversion from the database format into Unicode. * The byte format of the Unicode stream must be Java UTF-8, @@ -1450,15 +1450,15 @@ * *
available
Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of two-byte Unicode characters. - * If the value is SQL NULL, - * the value returned is null. + * as a stream of two-byte Unicode characters. + * If the value is SQL {@code NULL}, + * the value returned is {@code null}. * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1471,23 +1471,23 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a stream of uninterpreted - * bytes. + * of this rowset's {@code ResultSet} object as a stream of uninterpreted + * {@code byte}s. * The value can then be read in chunks from the * stream. This method is particularly - * suitable for retrieving large LONGVARBINARY + * suitable for retrieving large {@code LONGVARBINARY} * values. * *
Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next - * call to a getXXX method implicitly closes the stream. Also, a - * stream may return 0 when the method available + * call to a {@code getXXX} method implicitly closes the stream. Also, a + * stream may return {@code 0} when the method {@code available} * is called whether there is data available or not. * * @param columnName the SQL name of the column * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes; - * if the value is SQL NULL, the result is null + * as a stream of uninterpreted bytes; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1503,21 +1503,21 @@ /** * Returns the first warning reported by calls on this rowset's - * ResultSet object. - * Subsequent warnings on this rowset's ResultSet object - * will be chained to the SQLWarning object that + * {@code ResultSet} object. + * Subsequent warnings on this rowset's {@code ResultSet} object + * will be chained to the {@code SQLWarning} object that * this method returns. * *
SQLWarning
The warning chain is automatically cleared each time a new * row is read. * *
Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by - * Statement methods + * by {@code ResultSet} methods. Any warning caused by + * {@code Statement} methods * (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * - * @return the first SQLWarning object reported or null + * @return the first {@code SQLWarning} object reported or {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, * prepared statement, and result set @@ -1529,10 +1529,10 @@ } /** - * Clears all warnings reported on this rowset's ResultSet object. - * After this method is called, the method getWarnings - * returns null until a new warning is - * reported for this rowset's ResultSet object. + * Clears all warnings reported on this rowset's {@code ResultSet} object. + * After this method is called, the method {@code getWarnings} + * returns {@code null} until a new warning is + * reported for this rowset's {@code ResultSet} object. * * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, @@ -1545,26 +1545,26 @@ } /** - * Gets the name of the SQL cursor used by this rowset's ResultSet + * Gets the name of the SQL cursor used by this rowset's {@code ResultSet} * object. * *
getWarnings
In SQL, a result table is retrieved through a cursor that is * named. The current row of a result set can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To insure that the cursor has the proper isolation - * level to support update, the cursor's select statement should be + * level to support update, the cursor's {@code select} statement should be * of the form 'select for update'. If the 'for update' clause is * omitted, the positioned updates may fail. * *
select
The JDBC API supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. - * The current row of a ResultSet object + * SQL cursor used by a {@code ResultSet} object. + * The current row of a {@code ResultSet} object * is also the current row of this SQL cursor. * *
Note: If positioned update is not supported, a - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL name for this rowset's ResultSet object's cursor + * @return the SQL name for this rowset's {@code ResultSet} object's cursor * @throws SQLException if (1) a database access error occurs * or (2) xthis rowset does not have a currently valid connection, * prepared statement, and result set @@ -1577,9 +1577,9 @@ /** * Retrieves the number, types and properties of - * this rowset's ResultSet object's columns. + * this rowset's {@code ResultSet} object's columns. * - * @return the description of this rowset's ResultSet + * @return the description of this rowset's {@code ResultSet} * object's columns * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not have a currently valid connection, @@ -1607,8 +1607,8 @@ /** *
SQLException
Gets the value of the designated column in the current row - * of this rowset's ResultSet object as - * an Object. + * of this rowset's {@code ResultSet} object as + * an {@code Object}. * *
Object
This method will return the value of the given column as a * Java object. The type of the Java object will be the default @@ -1620,14 +1620,14 @@ * abstract data types. * * In the JDBC 3.0 API, the behavior of method - * getObject is extended to materialize + * {@code getObject} is extended to materialize * data of SQL user-defined types. When a column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to: getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to: {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * * @param columnIndex the first column is 1, the second is 2, and so on - * @return a java.lang.Object holding the column value + * @return a {@code java.lang.Object} holding the column value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1640,8 +1640,8 @@ /** *
getObject
getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap())
java.lang.Object
This method will return the value of the given column as a * Java object. The type of the Java object will be the default @@ -1653,14 +1653,14 @@ * abstract data types. * * In the JDBC 3.0 API, the behavior of the method - * getObject is extended to materialize + * {@code getObject} is extended to materialize * data of SQL user-defined types. When a column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to: getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to: {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * * @param columnName the SQL name of the column - * @return a java.lang.Object holding the column value + * @return a {@code java.lang.Object} holding the column value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1672,9 +1672,9 @@ //---------------------------------------------------------------- /** - * Maps the given JdbcRowSetImpl column name to its - * JdbcRowSetImpl column index and reflects this on - * the internal ResultSet object. + * Maps the given {@code JdbcRowSetImpl} column name to its + * {@code JdbcRowSetImpl} column index and reflects this on + * the internal {@code ResultSet} object. * * @param columnName the name of the column * @return the column index of the given column name @@ -1697,11 +1697,11 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.io.Reader object. - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null. + * of this rowset's {@code ResultSet} object as a + * {@code java.io.Reader} object. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @param columnIndex the first column is 1, the second is 2, and so on * */ @@ -1713,14 +1713,14 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.io.Reader object. + * of this rowset's {@code ResultSet} object as a + * {@code java.io.Reader} object. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @param columnName the name of the column - * @return the value in the specified column as a java.io.Reader + * @return the value in the specified column as a {@code java.io.Reader} * */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { @@ -1729,13 +1729,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.math.BigDecimal with full precision. + * of this rowset's {@code ResultSet} object as a + * {@code java.math.BigDecimal} with full precision. * * @param columnIndex the first column is 1, the second is 2, and so on * @return the column value (full precision); - * if the value is SQL NULL, the value returned is - * null. + * if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1748,13 +1748,13 @@ /** * Gets the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.math.BigDecimal with full precision. + * of this rowset's {@code ResultSet} object as a + * {@code java.math.BigDecimal} with full precision. * * @param columnName the column name * @return the column value (full precision); - * if the value is SQL NULL, the value returned is - * null. + * if the value is SQL {@code NULL}, the value returned is + * {@code null}. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1769,11 +1769,11 @@ /** * Indicates whether the cursor is before the first row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is before the first row; - * false if the cursor is at any other position or the - * result set contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} if the cursor is at any other position or the + * result set contains no rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1786,11 +1786,11 @@ /** * Indicates whether the cursor is after the last row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is after the last row; - * false if the cursor is at any other position or the - * result set contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} if the cursor is at any other position or the + * result set contains no rows * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1803,10 +1803,10 @@ /** * Indicates whether the cursor is on the first row of - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on the first row; - * false otherwise + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1819,14 +1819,14 @@ /** * Indicates whether the cursor is on the last row of - * this rowset's ResultSet object. - * Note: Calling the method isLast may be expensive + * this rowset's {@code ResultSet} object. + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver * might need to fetch ahead one row in order to determine * whether the current row is the last row in the result set. * - * @return true if the cursor is on the last row; - * false otherwise + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid * connection, prepared statement, and result set @@ -1840,11 +1840,11 @@ /** * Moves the cursor to the front of - * this rowset's ResultSet object, just before the + * this rowset's {@code ResultSet} object, just before the * first row. This method has no effect if the result set contains no rows. * * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1857,10 +1857,10 @@ /** * Moves the cursor to the end of - * this rowset's ResultSet object, just after the + * this rowset's {@code ResultSet} object, just after the * last row. This method has no effect if the result set contains no rows. * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1873,12 +1873,12 @@ /** * Moves the cursor to the first row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on a valid row; - * false if there are no rows in the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if there are no rows in the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1893,12 +1893,12 @@ /** * Moves the cursor to the last row in - * this rowset's ResultSet object. + * this rowset's {@code ResultSet} object. * - * @return true if the cursor is on a valid row; - * false if there are no rows in the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if there are no rows in the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -1914,7 +1914,7 @@ * Retrieves the current row number. The first row is number 1, the * second is number 2, and so on. * - * @return the current row number; 0 if there is no current row + * @return the current row number; {@code 0} if there is no current row * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -1927,7 +1927,7 @@ /** * Moves the cursor to the given row number in - * this rowset's internal ResultSet object. + * this rowset's internal {@code ResultSet} object. * *
java.io.Reader
isLast
TYPE_FORWARD_ONLY
If the row number is positive, the cursor moves to * the given row number with respect to the @@ -1937,23 +1937,23 @@ *
If the given row number is negative, the cursor moves to * an absolute row position with respect to * the end of the result set. For example, calling the method - * absolute(-1) positions the - * cursor on the last row, calling the method absolute(-2) + * {@code absolute(-1)} positions the + * cursor on the last row, calling the method {@code absolute(-2)} * moves the cursor to the next-to-last row, and so on. * *
absolute(-1)
absolute(-2)
An attempt to position the cursor beyond the first/last row in * the result set leaves the cursor before the first row or after * the last row. * - *
Note: Calling absolute(1) is the same - * as calling first(). Calling absolute(-1) - * is the same as calling last(). + *
absolute(1)
first()
last()
Note: Calling {@code absolute(1)} is the same + * as calling {@code first()}. Calling {@code absolute(-1)} + * is the same as calling {@code last()}. * - * @return true if the cursor is on the result set; - * false otherwise + * @return {@code true} if the cursor is on the result set; + * {@code false} otherwise * @throws SQLException if (1) a database access error occurs, - * (2) the row is 0, (3) the result set - * type is TYPE_FORWARD_ONLY, or (4) this + * (2) the row is {@code 0}, (3) the result set + * type is {@code TYPE_FORWARD_ONLY}, or (4) this * rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -1969,21 +1969,21 @@ * Moves the cursor a relative number of rows, either positive or negative. * Attempting to move beyond the first/last row in the * result set positions the cursor before/after the - * the first/last row. Calling relative(0) is valid, but does + * the first/last row. Calling {@code relative(0)} is valid, but does * not change the cursor position. * - *
relative(0)
Note: Calling the method relative(1) - * is different from calling the method next() - * because is makes sense to call next() when there + *
relative(1)
next()
Note: Calling the method {@code relative(1)} + * is different from calling the method {@code next()} + * because is makes sense to call {@code next()} when there * is no current row, * for example, when the cursor is positioned before the first row * or after the last row of the result set. * - * @return true if the cursor is on a row; - * false otherwise + * @return {@code true} if the cursor is on a row; + * {@code false} otherwise * @throws SQLException if (1) a database access error occurs, * (2) there is no current row, (3) the result set - * type is TYPE_FORWARD_ONLY, or (4) this + * type is {@code TYPE_FORWARD_ONLY}, or (4) this * rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -1997,16 +1997,16 @@ /** * Moves the cursor to the previous row in this - * ResultSet object. + * {@code ResultSet} object. * - *
Note: Calling the method previous() is not the same as - * calling the method relative(-1) because it - * makes sense to call previous() when there is no current row. + *
previous()
relative(-1)
Note: Calling the method {@code previous()} is not the same as + * calling the method {@code relative(-1)} because it + * makes sense to call {@code previous()} when there is no current row. * - * @return true if the cursor is on a valid row; - * false if it is off the result set + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is off the result set * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY, + * (2) the result set type is {@code TYPE_FORWARD_ONLY}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set */ @@ -2020,15 +2020,15 @@ /** * Gives a hint as to the direction in which the rows in this - * ResultSet object will be processed. + * {@code ResultSet} object will be processed. * The initial value is determined by the - * Statement object - * that produced this rowset's ResultSet object. + * {@code Statement} object + * that produced this rowset's {@code ResultSet} object. * The fetch direction may be changed at any time. * * @throws SQLException if (1) a database access error occurs, - * (2) the result set type is TYPE_FORWARD_ONLY - * and the fetch direction is not FETCH_FORWARD, + * (2) the result set type is {@code TYPE_FORWARD_ONLY} + * and the fetch direction is not {@code FETCH_FORWARD}, * or (3) this rowset does not currently have a valid * connection, prepared statement, and result set * @see java.sql.Statement#setFetchDirection @@ -2041,10 +2041,10 @@ /** * Returns the fetch direction for this - * ResultSet object. + * {@code ResultSet} object. * * @return the current fetch direction for this rowset's - * ResultSet object + * {@code ResultSet} object * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2061,16 +2061,16 @@ /** * Gives the JDBC driver a hint as to the number of rows that should * be fetched from the database when more rows are needed for this - * ResultSet object. + * {@code ResultSet} object. * If the fetch size specified is zero, the JDBC driver * ignores the value and is free to make its own best guess as to what * the fetch size should be. The default value is set by the - * Statement object + * {@code Statement} object * that created the result set. The fetch size may be changed at any time. * * @param rows the number of rows to fetch * @throws SQLException if (1) a database access error occurs, (2) the - * condition 0 <= rows <= this.getMaxRows() is not + * condition {@code 0 <= rows <= this.getMaxRows()} is not * satisfied, or (3) this rowset does not currently have a valid * connection, prepared statement, and result set * @@ -2084,9 +2084,9 @@ /** * * Returns the fetch size for this - * ResultSet object. + * {@code ResultSet} object. * - * @return the current fetch size for this rowset's ResultSet object + * @return the current fetch size for this rowset's {@code ResultSet} object * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2111,12 +2111,12 @@ } /** - * Returns the concurrency mode of this rowset's ResultSet object. + * Returns the concurrency mode of this rowset's {@code ResultSet} object. * The concurrency used is determined by the - * Statement object that created the result set. + * {@code Statement} object that created the result set. * - * @return the concurrency type, either CONCUR_READ_ONLY - * or CONCUR_UPDATABLE + * @return the concurrency type, either {@code CONCUR_READ_ONLY} + * or {@code CONCUR_UPDATABLE} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2138,7 +2138,7 @@ * Indicates whether the current row has been updated. The value returned * depends on whether or not the result set can detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another, and updates are detected * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, @@ -2154,10 +2154,10 @@ /** * Indicates whether the current row has had an insertion. * The value returned depends on whether or not this - * ResultSet object can detect visible inserts. + * {@code ResultSet} object can detect visible inserts. * - * @return true if a row has had an insertion - * and insertions are detected; false otherwise + * @return {@code true} if a row has had an insertion + * and insertions are detected; {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2174,10 +2174,10 @@ * Indicates whether a row has been deleted. A deleted row may leave * a visible "hole" in a result set. This method can be used to * detect holes in a result set. The value returned depends on whether - * or not this rowset's ResultSet object can detect deletions. + * or not this rowset's {@code ResultSet} object can detect deletions. * - * @return true if a row was deleted and deletions are detected; - * false otherwise + * @return {@code true} if a row was deleted and deletions are detected; + * {@code false} otherwise * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2192,10 +2192,10 @@ /** * Gives a nullable column a null value. * - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow - * or insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} + * or {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @throws SQLException if a database access error occurs @@ -2213,11 +2213,11 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2237,11 +2237,11 @@ } /** - * Updates the designated column with a byte value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * * @param columnIndex the first column is 1, the second is 2, and so on @@ -2262,11 +2262,11 @@ } /** - * Updates the designated column with a short value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code short} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2286,11 +2286,11 @@ } /** - * Updates the designated column with an int value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code int} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2309,11 +2309,11 @@ } /** - * Updates the designated column with a long value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code long} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2333,11 +2333,11 @@ } /** - * Updates the designated column with a float value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code float} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2357,11 +2357,11 @@ } /** - * Updates the designated column with a double value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code double} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2381,12 +2381,12 @@ } /** - * Updates the designated column with a java.math.BigDecimal + * Updates the designated column with a {@code java.math.BigDecimal} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2406,11 +2406,11 @@ } /** - * Updates the designated column with a String value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code String} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2430,11 +2430,11 @@ } /** - * Updates the designated column with a byte array value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} array value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2454,11 +2454,11 @@ } /** - * Updates the designated column with a java.sql.Date value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Date} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2479,11 +2479,11 @@ /** - * Updates the designated column with a java.sql.Time value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Time} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2503,12 +2503,12 @@ } /** - * Updates the designated column with a java.sql.Timestamp + * Updates the designated column with a {@code java.sql.Timestamp} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2529,10 +2529,10 @@ /** * Updates the designated column with an ascii stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2554,10 +2554,10 @@ /** * Updates the designated column with a binary stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2579,10 +2579,10 @@ /** * Updates the designated column with a character stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2603,18 +2603,18 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value - * @param scale for java.sql.Types.DECIMAl - * or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types this value will be ignored. + * @param scale for {@code java.sql.Types.DECIMAl} + * or {@code java.sql.Types.NUMERIC} types, + * this is the number of digits after the decimal point. For all other + * types this value will be ignored. * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -2631,11 +2631,11 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, and so on * @param x the new column value @@ -2655,11 +2655,11 @@ } /** - * Updates the designated column with a null value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code null} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @throws SQLException if a database access error occurs @@ -2672,11 +2672,11 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2688,11 +2688,11 @@ } /** - * Updates the designated column with a byte value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code byte} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2704,11 +2704,11 @@ } /** - * Updates the designated column with a short value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code short} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2720,11 +2720,11 @@ } /** - * Updates the designated column with an int value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code int} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2736,11 +2736,11 @@ } /** - * Updates the designated column with a long value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code long} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2752,11 +2752,11 @@ } /** - * Updates the designated column with a float value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code float } value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2768,11 +2768,11 @@ } /** - * Updates the designated column with a double value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code double} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2784,12 +2784,12 @@ } /** - * Updates the designated column with a java.sql.BigDecimal + * Updates the designated column with a {@code java.sql.BigDecimal} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2801,11 +2801,11 @@ } /** - * Updates the designated column with a String value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code String} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2817,19 +2817,19 @@ } /** - * Updates the designated column with a boolean value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code boolean} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * JDBC 2.0 * * Updates a column with a byte array value. * - * The updateXXX methods are used to update column values in the - * current row, or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or insertRow + * The {@code updateXXX} methods are used to update column values in the + * current row, or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or {@code insertRow} * methods are called to update the database. * * @param columnName the name of the column @@ -2842,11 +2842,11 @@ } /** - * Updates the designated column with a java.sql.Date value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Date} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2858,11 +2858,11 @@ } /** - * Updates the designated column with a java.sql.Time value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with a {@code java.sql.Time} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2874,12 +2874,12 @@ } /** - * Updates the designated column with a java.sql.Timestamp + * Updates the designated column with a {@code java.sql.Timestamp} * value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2892,10 +2892,10 @@ /** * Updates the designated column with an ascii stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2909,10 +2909,10 @@ /** * Updates the designated column with a binary stream value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2926,14 +2926,14 @@ /** * Updates the designated column with a character stream value. - * The updateXXX methods are used to update column values - * in the current row or the insert row. The updateXXX + * The {@code updateXXX} methods are used to update column values + * in the current row or the insert row. The {@code updateXXX} * methods do not update the underlying database; instead the - * updateRow or insertRow methods are called + * {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column - * @param reader the new column Reader stream value + * @param reader the new column {@code Reader} stream value * @param length the length of the stream * @throws SQLException if a database access error occurs * @@ -2943,16 +2943,16 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value - * @param scale for java.sql.Types.DECIMAL - * or java.sql.Types.NUMERIC types, + * @param scale for {@code java.sql.Types.DECIMAL} + * or {@code java.sql.Types.NUMERIC} types, * this is the number of digits after the decimal point. For all other * types this value will be ignored. * @throws SQLException if a database access error occurs @@ -2963,11 +2963,11 @@ } /** - * Updates the designated column with an Object value. - * The updateXXX methods are used to update column values in the - * current row or the insert row. The updateXXX methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * Updates the designated column with an {@code Object} value. + * The {@code updateXXX} methods are used to update column values in the + * current row or the insert row. The {@code updateXXX} methods do not + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnName the name of the column * @param x the new column value @@ -2980,7 +2980,7 @@ /** * Inserts the contents of the insert row into this - * ResultSet object and into the database + * {@code ResultSet} object and into the database * and also notifies listeners that a row has changed. * The cursor must be on the insert row when this method is called. * @@ -3000,14 +3000,14 @@ /** * Updates the underlying database with the new contents of the - * current row of this rowset's ResultSet object + * current row of this rowset's {@code ResultSet} object * and notifies listeners that a row has changed. * This method cannot be called when the cursor is on the insert row. * * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is * on the insert row, (3) the concurrency of the result - * set is ResultSet.CONCUR_READ_ONLY, or + * set is {@code ResultSet.CONCUR_READ_ONLY}, or * (4) this rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -3019,18 +3019,18 @@ } /** - * Deletes the current row from this rowset's ResultSet object + * Deletes the current row from this rowset's {@code ResultSet} object * and from the underlying database and also notifies listeners that a row * has changed. This method cannot be called when the cursor is on the insert * row. * * @throws SQLException if a database access error occurs - * or if this method is called when the cursor is on the insert row + * or if this method is called when the cursor is on the insert row * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is before the * first row, after the last row, or on the insert row, * (3) the concurrency of this rowset's result - * set is ResultSet.CONCUR_READ_ONLY, or + * set is {@code ResultSet.CONCUR_READ_ONLY}, or * (4) this rowset does not currently have a valid connection, * prepared statement, and result set */ @@ -3042,24 +3042,24 @@ } /** - * Refreshes the current row of this rowset's ResultSet + * Refreshes the current row of this rowset's {@code ResultSet} * object with its most recent value in the database. This method * cannot be called when the cursor is on the insert row. * - *
FETCH_FORWARD
0 <= rows <= this.getMaxRows()
CONCUR_READ_ONLY
CONCUR_UPDATABLE
updateXXX
updateRow
insertRow
java.sql.Types.DECIMAl
java.sql.Types.NUMERIC
Reader
java.sql.Types.DECIMAL
ResultSet.CONCUR_READ_ONLY
The refreshRow method provides a way for an + *
refreshRow
The {@code refreshRow} method provides a way for an * application to explicitly tell the JDBC driver to refetch * a row(s) from the database. An application may want to call - * refreshRow when caching or prefetching is being + * {@code refreshRow} when caching or prefetching is being * done by the JDBC driver to fetch the latest value of a row * from the database. The JDBC driver may actually refresh multiple * rows at once if the fetch size is greater than one. * *
All values are refetched subject to the transaction isolation - * level and cursor sensitivity. If refreshRow is called after - * calling an updateXXX method, but before calling - * the method updateRow, then the + * level and cursor sensitivity. If {@code refreshRow} is called after + * calling an {@code updateXXX} method, but before calling + * the method {@code updateRow}, then the * updates made to the row are lost. Calling the method - * refreshRow frequently will likely slow performance. + * {@code refreshRow} frequently will likely slow performance. * * @throws SQLException if (1) a database access error occurs, * (2) this method is called when the cursor is @@ -3076,12 +3076,12 @@ /** * Cancels the updates made to the current row in this - * ResultSet object and notifies listeners that a row + * {@code ResultSet} object and notifies listeners that a row * has changed. This method may be called after calling an - * updateXXX method(s) and before calling - * the method updateRow to roll back + * {@code updateXXX} method(s) and before calling + * the method {@code updateRow} to roll back * the updates made to a row. If no updates have been made or - * updateRow has already been called, this method has no + * {@code updateRow} has already been called, this method has no * effect. * * @throws SQLException if (1) a database access error occurs, @@ -3104,19 +3104,19 @@ * * The insert row is a special row associated with an updatable * result set. It is essentially a buffer where a new row may - * be constructed by calling the updateXXX methods prior to + * be constructed by calling the {@code updateXXX} methods prior to * inserting the row into the result set. * - * Only the updateXXX, getXXX, - * and insertRow methods may be + * Only the {@code updateXXX}, {@code getXXX}, + * and {@code insertRow} methods may be * called when the cursor is on the insert row. All of the columns in * a result set must be given a value each time this method is - * called before calling insertRow. - * An updateXXX method must be called before a - * getXXX method can be called on a column value. + * called before calling {@code insertRow}. + * An {@code updateXXX} method must be called before a + * {@code getXXX} method can be called on a column value. * * @throws SQLException if (1) a database access error occurs, - * (2) this rowset's ResultSet object is + * (2) this rowset's {@code ResultSet} object is * not updatable, or (3) this rowset does not * currently have a valid connection, prepared statement, * and result set @@ -3134,7 +3134,7 @@ * the insert row. * * @throws SQLException if (1) a database access error occurs, - * (2) this rowset's ResultSet object is + * (2) this rowset's {@code ResultSet} object is * not updatable, or (3) this rowset does not * currently have a valid connection, prepared statement, * and result set @@ -3146,14 +3146,14 @@ } /** - * Returns the Statement object that produced this - * ResultSet object. + * Returns the {@code Statement} object that produced this + * {@code ResultSet} object. * If the result set was generated some other way, such as by a - * DatabaseMetaData method, this method returns - * null. + * {@code DatabaseMetaData} method, this method returns + * {@code null}. * - * @return the Statement object that produced - * this rowset's ResultSet object or null + * @return the {@code Statement} object that produced + * this rowset's {@code ResultSet} object or {@code null} * if the result set was produced some other way * @throws SQLException if a database access error occurs */ @@ -3169,16 +3169,16 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Object. - * This method uses the given Map object + * of this rowset's {@code ResultSet} object as an {@code Object}. + * This method uses the given {@code Map} object * for the custom mapping of the * SQL structured or distinct type that is being retrieved. * * @param i the first column is 1, the second is 2, and so on - * @param map a java.util.Map object that contains the mapping - * from SQL type names to classes in the Java programming language - * @return an Object in the Java programming language - * representing the SQL value + * @param map a {@code java.util.Map} object that contains the mapping + * from SQL type names to classes in the Java programming language + * @return an {@code Object} in the Java programming language + * representing the SQL value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3193,10 +3193,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Ref object. + * of this rowset's {@code ResultSet} object as a {@code Ref} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL {@code REF} value * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3210,10 +3210,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Blob object. + * of this rowset's {@code ResultSet} object as a {@code Blob} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Blob object representing the SQL BLOB + * @return a {@code Blob} object representing the SQL {@code BLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3227,10 +3227,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Clob object. + * of this rowset's {@code ResultSet} object as a {@code Clob} object. * * @param i the first column is 1, the second is 2, and so on - * @return a Clob object representing the SQL CLOB + * @return a {@code Clob} object representing the SQL {@code CLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3244,10 +3244,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Array object. + * of this rowset's {@code ResultSet} object as an {@code Array} object. * * @param i the first column is 1, the second is 2, and so on. - * @return an Array object representing the SQL ARRAY + * @return an {@code Array} object representing the SQL {@code ARRAY} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3261,14 +3261,14 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Object. - * This method uses the specified Map object for + * of this rowset's {@code ResultSet} object as an {@code Object}. + * This method uses the specified {@code Map} object for * custom mapping if appropriate. * * @param colName the name of the column from which to retrieve the value - * @param map a java.util.Map object that contains the mapping + * @param map a {@code java.util.Map} object that contains the mapping * from SQL type names to classes in the Java programming language - * @return an Object representing the SQL + * @return an {@code Object} representing the SQL * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3282,10 +3282,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Ref object. + * of this rowset's {@code ResultSet} object as a {@code Ref} object. * * @param colName the column name - * @return a Ref object representing the SQL REF value in + * @return a {@code Ref} object representing the SQL {@code REF} value in * the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3297,10 +3297,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Blob object. + * of this rowset's {@code ResultSet} object as a {@code Blob} object. * * @param colName the name of the column from which to retrieve the value - * @return a Blob object representing the SQL BLOB + * @return a {@code Blob} object representing the SQL {@code BLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3312,10 +3312,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a Clob object. + * of this rowset's {@code ResultSet} object as a {@code Clob} object. * * @param colName the name of the column from which to retrieve the value - * @return a Clob object representing the SQL CLOB + * @return a {@code Clob} object representing the SQL {@code CLOB} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3327,10 +3327,10 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as an Array object. + * of this rowset's {@code ResultSet} object as an {@code Array} object. * * @param colName the name of the column from which to retrieve the value - * @return an Array object representing the SQL ARRAY + * @return an {@code Array} object representing the SQL {@code ARRAY} * value in the specified column * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, @@ -3342,17 +3342,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Date + * of this rowset's {@code ResultSet} object as a {@code java.sql.Date} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the date - * @return the column value as a java.sql.Date object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Date} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if (1) a database access error occurs * or (2) this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3365,17 +3365,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Date + * of this rowset's {@code ResultSet} object as a {@code java.sql.Date} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column from which to retrieve the value - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the date - * @return the column value as a java.sql.Date object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Date} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3387,17 +3387,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Time + * of this rowset's {@code ResultSet} object as a {@code java.sql.Time} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the time - * @return the column value as a java.sql.Time object; - * if the value is SQL NULL, - * the value returned is null in the Java programming language + * @return the column value as a {@code java.sql.Time} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} in the Java programming language * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3410,17 +3410,17 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a java.sql.Time + * of this rowset's {@code ResultSet} object as a {@code java.sql.Time} * object. This method uses the given calendar to construct an appropriate * millisecond value for the date if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the time - * @return the column value as a java.sql.Time object; - * if the value is SQL NULL, - * the value returned is null in the Java programming language + * @return the column value as a {@code java.sql.Time} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} in the Java programming language * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3431,18 +3431,18 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as a + * {@code java.sql.Timestamp} object. * This method uses the given calendar to construct an appropriate millisecond * value for the timestamp if the underlying database does not store * timezone information. * * @param columnIndex the first column is 1, the second is 2, and so on - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the timestamp - * @return the column value as a java.sql.Timestamp object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Timestamp} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3455,18 +3455,18 @@ /** * Returns the value of the designated column in the current row - * of this rowset's ResultSet object as a - * java.sql.Timestamp object. + * of this rowset's {@code ResultSet} object as a + * {@code java.sql.Timestamp} object. * This method uses the given calendar to construct an appropriate millisecond * value for the timestamp if the underlying database does not store * timezone information. * * @param columnName the SQL name of the column - * @param cal the java.util.Calendar object + * @param cal the {@code java.util.Calendar} object * to use in constructing the timestamp - * @return the column value as a java.sql.Timestamp object; - * if the value is SQL NULL, - * the value returned is null + * @return the column value as a {@code java.sql.Timestamp} object; + * if the value is SQL {@code NULL}, + * the value returned is {@code null} * @throws SQLException if a database access error occurs * or this rowset does not currently have a valid connection, * prepared statement, and result set @@ -3478,8 +3478,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3490,14 +3490,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new Ref column value + * @param ref the new {@code Ref} column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { @@ -3507,8 +3507,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3519,13 +3519,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param ref the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { @@ -3534,8 +3534,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3546,14 +3546,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { checkState(); @@ -3563,8 +3563,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * double value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3575,13 +3575,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { updateClob(findColumn(columnName), c); @@ -3589,8 +3589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3601,14 +3601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { checkState(); @@ -3617,8 +3617,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3629,13 +3629,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { updateBlob(findColumn(columnName), b); @@ -3643,8 +3643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3655,14 +3655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { checkState(); @@ -3671,8 +3671,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this JdbcRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code JdbcRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3683,20 +3683,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { updateArray(findColumn(columnName), a); } /** - * Provide interface coverage for getURL(int) in ResultSet->RowSet + * Provide interface coverage for getURL(int) in {@code ResultSet->RowSet} */ public java.net.URL getURL(int columnIndex) throws SQLException { checkState(); @@ -3704,7 +3704,7 @@ } /** - * Provide interface coverage for getURL(String) in ResultSet->RowSet + * Provide interface coverage for getURL(String) in {@code ResultSet->RowSet} */ public java.net.URL getURL(String columnName) throws SQLException { return getURL(findColumn(columnName)); @@ -3712,14 +3712,14 @@ /** * Return the RowSetWarning object for the current row of a - * JdbcRowSetImpl + * {@code JdbcRowSetImpl} */ public RowSetWarning getRowSetWarnings() throws SQLException { return null; } /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. *
DatabaseMetaData
Map
java.util.Map
Ref
REF
Blob
BLOB
Clob
CLOB
Array
ARRAY
java.util.Calendar
1
2
java.sql.Blob
java.sql.Array
setMatchColumn
* The parameter value unset by this method should be same @@ -3728,8 +3728,8 @@ * @param columnIdxes the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * parameter index is out of bounds or if the columnIdx is + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { @@ -3748,7 +3748,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. *
setMatchColumn(int [])
* The parameter value unset by this method should be same @@ -3757,8 +3757,8 @@ * @param columnIdxes the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * parameter index is out of bounds or if the columnName is + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { @@ -3774,11 +3774,11 @@ } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -3796,10 +3796,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -3829,19 +3829,19 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. *
setMatchColumn(String [])
JoinRowSet
* The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(int[] columnIdxes) throws SQLException { @@ -3858,17 +3858,17 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. *
getMatchColumnIndexes
* The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(String[] columnNames) throws SQLException { @@ -3883,22 +3883,22 @@ } - /** - * Sets the designated parameter to the given int + /** + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. *
getMatchColumn
* The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(int columnIdx) throws SQLException { // validate, if col is ok to be set @@ -3912,19 +3912,19 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. *
* The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds + * parameter index is out of bounds */ public void setMatchColumn(String columnName) throws SQLException { // validate, if col is ok to be set @@ -3938,8 +3938,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. *
* The parameter value unset by this method should be same @@ -3948,8 +3948,8 @@ * @param columnIdx the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * parameter index is out of bounds or if the columnIdx is + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { // check if we are unsetting the SAME column @@ -3964,8 +3964,8 @@ } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. *
setMatchColumn(int)
* The parameter value unset by this method should be same @@ -3974,8 +3974,8 @@ * @param columnName the index into this rowset * object's internal representation of parameter values * @throws SQLException if an error occurs or the - * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * parameter index is out of bounds or if the columnName is + * not the same as set using {@code setMatchColumn(String)} * */ public void unsetMatchColumn(String columnName) throws SQLException { @@ -3992,12 +3992,12 @@ } /** - * Retrieves the DatabaseMetaData associated with + * Retrieves the {@code DatabaseMetaData} associated with * the connection handle associated with this - * JdbcRowSet object. + * {@code JdbcRowSet} object. * - * @return the DatabaseMetadata associated - * with the rowset's connection. + * @return the {@code DatabaseMetadata} associated + * with the rowset's connection. * @throws SQLException if a database access error occurs */ public DatabaseMetaData getDatabaseMetaData() throws SQLException { @@ -4006,12 +4006,12 @@ } /** - * Retrieves the ParameterMetaData associated with + * Retrieves the {@code ParameterMetaData} associated with * the connection handle associated with this - * JdbcRowSet object. + * {@code JdbcRowSet} object. * - * @return the ParameterMetadata associated - * with the rowset's connection. + * @return the {@code ParameterMetadata} associated + * with the rowset's connection. * @throws SQLException if a database access error occurs */ public ParameterMetaData getParameterMetaData() throws SQLException { @@ -4020,18 +4020,18 @@ } /** - * Commits all updates in this JdbcRowSet object by - * wrapping the internal Connection object and calling - * its commit method. - * This method sets this JdbcRowSet object's private field - * rs to null after saving its value to another - * object, but only if the ResultSet - * constant HOLD_CURSORS_OVER_COMMIT has not been set. - * (The field rs is this JdbcRowSet object's - * ResultSet object.) + * Commits all updates in this {@code JdbcRowSet} object by + * wrapping the internal {@code Connection} object and calling + * its {@code commit} method. + * This method sets this {@code JdbcRowSet} object's private field + * {@code rs} to {@code null} after saving its value to another + * object, but only if the {@code ResultSet} + * constant {@code HOLD_CURSORS_OVER_COMMIT} has not been set. + * (The field {@code rs} is this {@code JdbcRowSet} object's + * {@code ResultSet} object.) * * @throws SQLException if autoCommit is set to true or if a database - * access error occurs + * access error occurs */ public void commit() throws SQLException { conn.commit(); @@ -4045,8 +4045,8 @@ } /** - * Sets auto-commit on the internal Connection object with this - * JdbcRowSet + * Sets auto-commit on the internal {@code Connection} object with this + * {@code JdbcRowSet} * * @throws SQLException if a database access error occurs */ @@ -4074,7 +4074,7 @@ } /** - * Returns the auto-commit status with this JdbcRowSet. + * Returns the auto-commit status with this {@code JdbcRowSet}. * * @return true if auto commit is true; false otherwise * @throws SQLException if a database access error occurs @@ -4084,16 +4084,16 @@ } /** - * Rolls back all the updates in this JdbcRowSet object by - * wrapping the internal Connection object and calling its - * rollback method. - * This method sets this JdbcRowSet object's private field - * rs to null after saving its value to another object. - * (The field rs is this JdbcRowSet object's - * internal ResultSet object.) + * Rolls back all the updates in this {@code JdbcRowSet} object by + * wrapping the internal {@code Connection} object and calling its + * {@code rollback} method. + * This method sets this {@code JdbcRowSet} object's private field + * {@code rs} to {@code null} after saving its value to another object. + * (The field {@code rs} is this {@code JdbcRowSet} object's + * internal {@code ResultSet} object.) * * @throws SQLException if autoCommit is set to true or a database - * access error occurs + * access error occurs */ public void rollback() throws SQLException { conn.rollback(); @@ -4106,14 +4106,14 @@ /** - * Rollbacks all the updates in the JdbcRowSet back to the - * last Savepoint transaction marker. Wraps the internal - * Connection object and call it's rollback method + * Rollbacks all the updates in the {@code JdbcRowSet} back to the + * last {@code Savepoint} transaction marker. Wraps the internal + * {@code Connection} object and call it's rollback method * - * @param s the Savepoint transaction marker to roll the - * transaction to. + * @param s the {@code Savepoint} transaction marker to roll the + * transaction to. * @throws SQLException if autoCommit is set to true; or ia a database - * access error occurs + * access error occurs */ public void rollback(Savepoint s) throws SQLException { conn.rollback(s); @@ -4144,10 +4144,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's Connection property + * Gets this {@code JdbcRowSet} object's Connection property * * - * @return the Connection object associated with this rowset; + * @return the {@code Connection} object associated with this rowset; */ protected Connection getConnection() { @@ -4158,10 +4158,10 @@ // Added as per rave requirements /** - * Sets this JdbcRowSet object's connection property - * to the given Connection object. + * Sets this {@code JdbcRowSet} object's connection property + * to the given {@code Connection} object. * - * @param connection the Connection object. + * @param connection the {@code Connection} object. */ protected void setConnection(Connection connection) { @@ -4172,10 +4172,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's PreparedStatement property + * Gets this {@code JdbcRowSet} object's PreparedStatement property * * - * @return the PreparedStatement object associated with this rowset; + * @return the {@code PreparedStatement} object associated with this rowset; */ protected PreparedStatement getPreparedStatement() { @@ -4186,10 +4186,10 @@ // Added as per Rave requirements /** - * Sets this JdbcRowSet object's preparedtsatement property - * to the given PreparedStatemennt object. + * Sets this {@code JdbcRowSet} object's preparedtsatement property + * to the given {@code PreparedStatemennt} object. * - * @param preparedStatement the PreparedStatement object + * @param preparedStatement the {@code PreparedStatement} object * */ protected void setPreparedStatement(PreparedStatement preparedStatement) { @@ -4200,10 +4200,10 @@ // Added as per Rave requirements /** - * Gets this JdbcRowSet object's ResultSet property + * Gets this {@code JdbcRowSet} object's ResultSet property * * - * @return the ResultSet object associated with this rowset; + * @return the {@code ResultSet} object associated with this rowset; */ protected ResultSet getResultSet() throws SQLException { @@ -4217,10 +4217,10 @@ // Added as per Rave requirements /** - * Sets this JdbcRowSet object's resultset property - * to the given ResultSet object. + * Sets this {@code JdbcRowSet} object's resultset property + * to the given {@code ResultSet} object. * - * @param resultSet the ResultSet object + * @param resultSet the {@code ResultSet} object * */ protected void setResultSet(ResultSet resultSet) { @@ -4228,25 +4228,25 @@ } /** - * Sets this JdbcRowSet object's command property to - * the given String object and clears the parameters, if any, + * Sets this {@code JdbcRowSet} object's {@code command} property to + * the given {@code String} object and clears the parameters, if any, * that were set for the previous command. In addition, - * if the command property has previously been set to a + * if the {@code command} property has previously been set to a * non-null value and it is - * different from the String object supplied, - * this method sets this JdbcRowSet object's private fields - * ps and rs to null. - * (The field ps is its PreparedStatement object, and - * the field rs is its ResultSet object.) + * different from the {@code String} object supplied, + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps} and {@code rs} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, and + * the field {@code rs} is its {@code ResultSet} object.) *
setMatchColumn(String)
DatabaseMetadata
ParameterMetaData
ParameterMetadata
commit
rs
HOLD_CURSORS_OVER_COMMIT
rollback
Savepoint
PreparedStatemennt
command
ps
- * The command property may not be needed if the RowSet + * The {@code command} property may not be needed if the {@code RowSet} * object gets its data from a source that does not support commands, * such as a spreadsheet or other tabular file. - * Thus, this property is optional and may be null. + * Thus, this property is optional and may be {@code null}. * - * @param command a String object containing an SQL query - * that will be set as this RowSet object's command - * property; may be null but may not be an empty string + * @param command a {@code String} object containing an SQL query + * that will be set as this {@code RowSet} object's command + * property; may be {@code null} but may not be an empty string * @throws SQLException if an empty string is provided as the command value * @see #getCommand */ @@ -4265,32 +4265,32 @@ } /** - * Sets the dataSourceName property for this JdbcRowSet - * object to the given logical name and sets this JdbcRowSet object's - * Url property to null. In addition, if the dataSourceName + * Sets the {@code dataSourceName} property for this {@code JdbcRowSet} + * object to the given logical name and sets this {@code JdbcRowSet} object's + * Url property to {@code null}. In addition, if the {@code dataSourceName} * property has previously been set and is different from the one supplied, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * the field rs is its ResultSet object, and - * the field conn is its Connection object.) + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * the field {@code rs} is its {@code ResultSet} object, and + * the field {@code conn} is its {@code Connection} object.) *
RowSet
dataSourceName
conn
* The name supplied to this method must have been bound to a - * DataSource object in a JNDI naming service so that an + * {@code DataSource} object in a JNDI naming service so that an * application can do a lookup using that name to retrieve the - * DataSource object bound to it. The DataSource + * {@code DataSource} object bound to it. The {@code DataSource} * object can then be used to establish a connection to the data source it * represents. *
* Users should set either the Url property or the dataSourceName property. * If both properties are set, the driver will use the property set most recently. * - * @param dsName a String object with the name that can be supplied + * @param dsName a {@code String} object with the name that can be supplied * to a naming service based on JNDI technology to retrieve the - * DataSource object that can be used to get a connection; - * may be null + * {@code DataSource} object that can be used to get a connection; + * may be {@code null} * @throws SQLException if there is a problem setting the - * dataSourceName property + * {@code dataSourceName} property * @see #getDataSourceName */ public void setDataSourceName(String dsName) throws SQLException{ @@ -4310,42 +4310,42 @@ /** - * Sets the Url property for this JdbcRowSet object - * to the given String object and sets the dataSource name - * property to null. In addition, if the Url property has - * previously been set to a non null value and its value + * Sets the Url property for this {@code JdbcRowSet} object + * to the given {@code String} object and sets the dataSource name + * property to {@code null}. In addition, if the Url property has + * previously been set to a non {@code null} value and its value * is different from the value to be set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * the field rs is its ResultSet object, and - * the field conn is its Connection object.) + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * the field {@code rs} is its {@code ResultSet} object, and + * the field {@code conn} is its {@code Connection} object.) *
* The Url property is a JDBC URL that is used when * the connection is created using a JDBC technology-enabled driver - * ("JDBC driver") and the DriverManager. + * ("JDBC driver") and the {@code DriverManager}. * The correct JDBC URL for the specific driver to be used can be found * in the driver documentation. Although there are guidelines for how * a JDBC URL is formed, - * a driver vendor can specify any String object except - * one with a length of 0 (an empty string). + * a driver vendor can specify any {@code String} object except + * one with a length of {@code 0} (an empty string). *
* Setting the Url property is optional if connections are established using - * a DataSource object instead of the DriverManager. + * a {@code DataSource} object instead of the {@code DriverManager}. * The driver will use either the URL property or the * dataSourceName property to create a connection, whichever was * specified most recently. If an application uses a JDBC URL, it * must load a JDBC driver that accepts the JDBC URL before it uses the - * RowSet object to connect to a database. The RowSet + * {@code RowSet} object to connect to a database. The {@code RowSet} * object will use the URL internally to create a database connection in order * to read or write data. * - * @param url a String object that contains the JDBC URL + * @param url a {@code String} object that contains the JDBC URL * that will be used to establish the connection to a database for this - * RowSet object; may be null but must not + * {@code RowSet} object; may be {@code null} but must not * be an empty string * @throws SQLException if an error occurs setting the Url property or the - * parameter supplied is a string with a length of 0 (an + * parameter supplied is a string with a length of {@code 0} (an * empty string) * @see #getUrl */ @@ -4365,24 +4365,24 @@ } } - /** - * Sets the username property for this JdbcRowSet object + /** + * Sets the username property for this {@code JdbcRowSet} object * to the given user name. Because it * is not serialized, the username property is set at run time before - * calling the method execute. In addition, - * if the username property is already set with a - * non-null value and that value is different from the String + * calling the method {@code execute}. In addition, + * if the {@code username} property is already set with a + * non-null value and that value is different from the {@code String} * object to be set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * rs is its ResultSet object, and - * conn is its Connection object.) - * Setting these fields to null ensures that only current + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * {@code rs} is its {@code ResultSet} object, and + * {@code conn} is its {@code Connection} object.) + * Setting these fields to {@code null} ensures that only current * values will be used. * - * @param uname the String object containing the user name that - * is supplied to the data source to create a connection. It may be null. + * @param uname the {@code String} object containing the user name that + * is supplied to the data source to create a connection. It may be null. * @see #getUsername */ public void setUsername(String uname) { @@ -4401,23 +4401,23 @@ } /** - * Sets the password property for this JdbcRowSet object - * to the given String object. Because it + * Sets the password property for this {@code JdbcRowSet} object + * to the given {@code String} object. Because it * is not serialized, the password property is set at run time before - * calling the method execute. Its default valus is - * null. In addition, - * if the password property is already set with a + * calling the method {@code execute}. Its default valus is + * {@code null}. In addition, + * if the {@code password} property is already set with a * non-null value and that value is different from the one being set, - * this method sets this JdbcRowSet object's private fields - * ps, rs, and conn to null. - * (The field ps is its PreparedStatement object, - * rs is its ResultSet object, and - * conn is its Connection object.) - * Setting these fields to null ensures that only current + * this method sets this {@code JdbcRowSet} object's private fields + * {@code ps}, {@code rs}, and {@code conn} to {@code null}. + * (The field {@code ps} is its {@code PreparedStatement} object, + * {@code rs} is its {@code ResultSet} object, and + * {@code conn} is its {@code Connection} object.) + * Setting these fields to {@code null} ensures that only current * values will be used. * - * @param password the String object that represents the password - * that must be supplied to the database to create a connection + * @param password the {@code String} object that represents the password + * that must be supplied to the database to create a connection */ public void setPassword(String password) { @@ -4435,18 +4435,18 @@ } /** - * Sets the type for this RowSet object to the specified type. - * The default type is ResultSet.TYPE_SCROLL_INSENSITIVE. + * Sets the type for this {@code RowSet} object to the specified type. + * The default type is {@code ResultSet.TYPE_SCROLL_INSENSITIVE}. * * @param type one of the following constants: - * ResultSet.TYPE_FORWARD_ONLY, - * ResultSet.TYPE_SCROLL_INSENSITIVE, or - * ResultSet.TYPE_SCROLL_SENSITIVE + * {@code ResultSet.TYPE_FORWARD_ONLY}, + * {@code ResultSet.TYPE_SCROLL_INSENSITIVE}, or + * {@code ResultSet.TYPE_SCROLL_SENSITIVE} * @throws SQLException if the parameter supplied is not one of the * following constants: - * ResultSet.TYPE_FORWARD_ONLY or - * ResultSet.TYPE_SCROLL_INSENSITIVE - * ResultSet.TYPE_SCROLL_SENSITIVE + * {@code ResultSet.TYPE_FORWARD_ONLY} or + * {@code ResultSet.TYPE_SCROLL_INSENSITIVE} + * {@code ResultSet.TYPE_SCROLL_SENSITIVE} * @see #getConcurrency * @see #getType */ @@ -4468,18 +4468,18 @@ } /** - * Sets the concurrency for this RowSet object to - * the specified concurrency. The default concurrency for any RowSet - * object (connected or disconnected) is ResultSet.CONCUR_UPDATABLE, + * Sets the concurrency for this {@code RowSet} object to + * the specified concurrency. The default concurrency for any {@code RowSet} + * object (connected or disconnected) is {@code ResultSet.CONCUR_UPDATABLE}, * but this method may be called at any time to change the concurrency. * * @param concur one of the following constants: - * ResultSet.CONCUR_READ_ONLY or - * ResultSet.CONCUR_UPDATABLE + * {@code ResultSet.CONCUR_READ_ONLY} or + * {@code ResultSet.CONCUR_UPDATABLE} * @throws SQLException if the parameter supplied is not one of the * following constants: - * ResultSet.CONCUR_UPDATABLE or - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_UPDATABLE} or + * {@code ResultSet.CONCUR_READ_ONLY} * @see #getConcurrency * @see #isReadOnly */ @@ -4500,8 +4500,8 @@ } /** - * Retrieves the value of the designated SQL XML parameter as a - * SQLXML object in the Java programming language. + * Retrieves the value of the designated {@code SQL XML} parameter as a + * {@code SQLXML} object in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @return a SQLXML object that maps an SQL XML value * @throws SQLException if a database access error occurs @@ -4512,8 +4512,8 @@ } /** - * Retrieves the value of the designated SQL XML parameter as a - * SQLXML object in the Java programming language. + * Retrieves the value of the designated {@code SQL XML} parameter as a + * {@code SQLXML} object in the Java programming language. * @param colName the name of the column from which to retrieve the value * @return a SQLXML object that maps an SQL XML value * @throws SQLException if a database access error occurs @@ -4524,12 +4524,12 @@ /** * Retrieves the value of the designated column in the current row of this - * ResultSet object as a java.sql.RowId object in the Java + * {@code ResultSet} object as a java.sql.RowId object in the Java * programming language. * * @param columnIndex the first column is 1, the second 2, ... - * @return the column value if the value is a SQL NULL the - * value returned is null + * @return the column value if the value is a SQL {@code NULL} the + * value returned is {@code null} * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4539,12 +4539,12 @@ /** * Retrieves the value of the designated column in the current row of this - * ResultSet object as a java.sql.RowId object in the Java + * {@code ResultSet} object as a java.sql.RowId object in the Java * programming language. * * @param columnName the name of the column - * @return the column value if the value is a SQL NULL the - * value returned is null + * @return the column value if the value is a SQL {@code NULL} the + * value returned is {@code null} * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4553,10 +4553,10 @@ } /** - * Updates the designated column with a RowId value. The updater + * Updates the designated column with a {@code RowId} value. The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnIndex the first column is 1, the second 2, ... @@ -4569,10 +4569,10 @@ } /** - * Updates the designated column with a RowId value. The updater + * Updates the designated column with a {@code RowId} value. The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4631,8 +4631,8 @@ /*o - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnIndex the first column is 1, the second 2, ... * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4643,8 +4643,8 @@ } /** - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnName name of the column * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4656,12 +4656,12 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param i the first column is 1, the second is 2, ... - * @return a NClob object representing the SQL - * NCLOB value in the specified column + * @return a {@code NClob} object representing the SQL + * {@code NCLOB} value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4672,11 +4672,11 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param colName the name of the column from which to retrieve the value - * @return a NClob object representing the SQL NCLOB + * @return a {@code NClob} object representing the SQL {@code NCLOB} * value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 @@ -4694,10 +4694,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * SQL {@code XML} value when it sends it to the database. * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an SQL {@code XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4706,10 +4706,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * {@code SQL XML} value when it sends it to the database. * @param parameterName the name of the parameter - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an {@code SQL XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4718,8 +4718,8 @@ } /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID value when it sends it + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} value when it sends it * to the database * * @param parameterIndex the first parameter is 1, the second is 2, ... @@ -4732,9 +4732,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID when it sends it to the + /** + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} when it sends it to the * database. * * @param parameterName the name of the parameter @@ -4748,18 +4748,18 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR value + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on NVARCHAR values) + * size relative to the driver's limits on {@code NVARCHAR} values) * when it sends it to the database. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNString(int parameterIndex, String value) throws SQLException { @@ -4768,9 +4768,9 @@ /** - * Sets the designated parameter in this RowSet object's command - * to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter in this {@code RowSet} object's command + * to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -4779,14 +4779,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed PreparedStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -4795,14 +4795,14 @@ } /** - * Sets the designated parameter to a java.sql.NClob object. The object - * implements the java.sql.NClob interface. This NClob - * object maps to a SQL NCLOB. + * Sets the designated parameter to a {@code java.sql.NClob} object. The object + * implements the {@code java.sql.NClob} interface. This {@code NClob} + * object maps to a SQL {@code NCLOB}. * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(String parameterName, NClob value) throws SQLException { @@ -4810,17 +4810,17 @@ } - /** + /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @exception SQLException if a database access error occurs * @since 1.6 @@ -4832,16 +4832,16 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the name of the column - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4850,11 +4850,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * @param columnIndex the first column is 1, the second 2, ... * @param xmlObject the value for the column to be updated @@ -4866,11 +4866,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4884,15 +4884,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnIndex the first column is 1, the second is 2, ... - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4902,15 +4902,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4927,9 +4927,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnIndex - the first column is 1, the second is 2, ... - * @param x - the new column value - * @param length - the length of the stream + * @param columnIndex the first column is 1, the second is 2, ... + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4949,9 +4949,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnName - name of the Column - * @param x - the new column value - * @param length - the length of the stream + * @param columnName name of the Column + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4963,26 +4963,27 @@ } /** - * Updates the designated column with a character stream value. The + * Updates the designated column with a character stream value. The * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} or this + * method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -4997,26 +4998,27 @@ * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * the result set concurrency is {@code CONCUR_READ_ONLY} or + * this method is called on a closed result set + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method * @since 1.6 */ public void updateNCharacterStream(String columnLabel, @@ -5027,9 +5029,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5039,16 +5041,16 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5060,9 +5062,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5072,18 +5074,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, + * then the label is the name of the column. * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException { @@ -5092,9 +5096,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5102,23 +5106,23 @@ * Java stream object or your own subclass that implements the * standard interface. * - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException { @@ -5127,9 +5131,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5138,22 +5142,23 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException { @@ -5161,11 +5166,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5175,17 +5180,17 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5193,11 +5198,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5207,17 +5212,18 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5225,33 +5231,33 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader) throws SQLException { @@ -5259,34 +5265,35 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader) throws SQLException { @@ -5294,11 +5301,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5308,19 +5315,19 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5328,11 +5335,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5342,19 +5349,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5362,11 +5370,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5375,22 +5383,22 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader) throws SQLException { @@ -5398,11 +5406,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5411,23 +5419,24 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader) throws SQLException { @@ -5435,22 +5444,22 @@ } - /** + /** * Updates the designated column with an ascii stream value, which will have * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5464,17 +5473,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBinaryStream(int columnIndex, @@ -5488,17 +5497,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5512,17 +5521,19 @@ * the specified number of bytes.. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5535,20 +5546,20 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5560,21 +5571,22 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5588,15 +5600,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5611,18 +5625,18 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5637,19 +5651,20 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5665,18 +5680,20 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5689,20 +5706,20 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5714,22 +5731,23 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5738,97 +5756,98 @@ } - /** - * Sets the designated parameter to the given java.net.URL value. - * The driver converts this to an SQL DATALINK value - * when it sends it to the database. - * - * @param parameterIndex the first parameter is 1, the second is 2, ... - * @param x the java.net.URL object to be set - * @exception SQLException if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.4 - */ + /** + * Sets the designated parameter to the given {@code java.net.URL} value. + * The driver converts this to an SQL {@code DATALINK} value + * when it sends it to the database. + * + * @param parameterIndex the first parameter is 1, the second is 2, ... + * @param x the {@code java.net.URL} object to be set + * @exception SQLException if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * @since 1.4 + */ public void setURL(int parameterIndex, java.net.URL x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB - * Note: Consult your JDBC driver documentation to determine if - * it might be more efficient to use a version of - * setNClob which takes a length parameter. - * - * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param reader An object that contains the data to set the parameter value to. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * - * @since 1.6 - */ + /** + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * Note: Consult your JDBC driver documentation to determine if + * it might be more efficient to use a version of + * {@code setNClob} which takes a length parameter. + * + * @param parameterIndex index of the first parameter is 1, the second is 2, ... + * @param reader An object that contains the data to set the parameter value to. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * + * @since 1.6 + */ public void setNClob(int parameterIndex, Reader reader) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB - * - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national - * character sets; if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * @since 1.6 - */ - public void setNClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. + * The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national + * character sets; if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * @since 1.6 + */ + public void setNClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); - } + } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNClob which takes a length parameter. + * {@code setNClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5839,23 +5858,24 @@ } - /** - ** of characters specified by length otherwise a SQLException will becontain the number - * generated when the PreparedStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method + /** + * of characters specified by length otherwise a {@code SQLException} will becontain the number + * generated when the {@code PreparedStatement} is executed. + * This method differs from the {@code setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5867,14 +5887,14 @@ /** - * Sets the designated parameter to a java.sql.NClob object. The driver converts this to -a - * SQL NCLOB value when it sends it to the database. + * Sets the designated parameter to a {@code java.sql.NClob} object. + * The driver converts this to an + * SQL {@code NCLOB} value when it sends it to the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(int parameterIndex, NClob value) throws SQLException{ @@ -5883,14 +5903,14 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNString(String parameterName, String value) @@ -5899,8 +5919,8 @@ } /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... @@ -5908,7 +5928,7 @@ * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException{ @@ -5918,8 +5938,8 @@ /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterName the name of the column to be set @@ -5935,9 +5955,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + /** + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -5946,14 +5966,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed CallableStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -5962,23 +5982,23 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIMESTAMP value, + * Sets the designated parameter to the given {@code java.sql.Timestamp} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIMESTAMP} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the timestamp + * a {@code Calendar} object, the driver can calculate the timestamp * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use - * to construct the timestamp + * @param cal the {@code Calendar} object the driver will use + * to construct the timestamp * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -5987,28 +6007,29 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } @@ -6016,16 +6037,16 @@ /** - * Sets the designated parameter to the given java.sql.Clob object. - * The driver converts this to an SQL CLOB value when it + * Sets the designated parameter to the given {@code java.sql.Clob} object. + * The driver converts this to an SQL {@code CLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Clob object that maps an SQL CLOB value + * @param x a {@code Clob} object that maps an SQL {@code CLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setClob (String parameterName, Clob x) throws SQLException{ @@ -6033,21 +6054,21 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs or this method is called on - * a closed CallableStatement + * a closed {@code CallableStatement} * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6058,19 +6079,19 @@ } - /** - * Sets the designated parameter to the given java.sql.Date value + /** + * Sets the designated parameter to the given {@code java.sql.Date} value * using the default time zone of the virtual machine that is running * the application. * The driver converts this - * to an SQL DATE value when it sends it to the database. + * to an SQL {@code DATE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6080,23 +6101,23 @@ } /** - * Sets the designated parameter to the given java.sql.Date value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL DATE value, + * Sets the designated parameter to the given {@code java.sql.Date} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code DATE} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the date + * a {@code Calendar} object, the driver can calculate the date * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the date * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6107,16 +6128,16 @@ /** - * Sets the designated parameter to the given java.sql.Time value. + * Sets the designated parameter to the given {@code java.sql.Time} value. * The driver converts this - * to an SQL TIME value when it sends it to the database. + * to an SQL {@code TIME} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6126,23 +6147,23 @@ } /** - * Sets the designated parameter to the given java.sql.Time value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIME value, + * Sets the designated parameter to the given {@code java.sql.Time} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIME} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the time + * a {@code Calendar} object, the driver can calculate the time * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the time * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6152,22 +6173,22 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatementor if parameterIndex does not correspond to a parameter - * marker in the SQL statement + * a closed {@code PreparedStatement}or if parameterIndex does not correspond to a parameter + * marker in the SQL statement * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6179,19 +6200,19 @@ /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - *This method differs from the setCharacterStream (int, Reader, int) method + * Sets the designated parameter to a {@code Reader} object. The reader 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 setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatement, if parameterIndex does not correspond to a parameter + * a closed {@code PreparedStatement}, if parameterIndex does not correspond to a parameter * marker in the SQL statement, or if the length specified is less than zero. * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method @@ -6204,25 +6225,26 @@ /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) + * Sets the designated parameter to a {@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)} * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... + * the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement, - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, if the length specified - * is less than zero or if the number of bytes in the inputstream does not match - * the specified length. + * this method is called on a closed {@code PreparedStatement}, + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, if the length specified + * is less than zero or if the number of bytes in the inputstream does not match + * the specified length. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6233,28 +6255,27 @@ } /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) - * This method differs from the setBinaryStream (int, InputStream) + * Sets the designated parameter to a {@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 - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... - - + * the second is 2, ... + * * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement or - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, + * this method is called on a closed {@code PreparedStatement} or + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6264,72 +6285,72 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length, otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) - * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, - * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB - * - * @param parameterName the name of the parameter to be set - * the second is 2, ... - * - * @param inputStream An object that contains the data to set the parameter - * value to. - * @param length the number of bytes in the parameter data. - * @throws SQLException if parameterIndex does not correspond - * to a parameter marker in the SQL statement, or if the length specified - * is less than zero; if the number of bytes in the inputstream does not match - * the specified length; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setBlob(String parameterName, InputStream inputStream, long length) + /** + * Sets the designated parameter to a {@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)} + * 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, + * the driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * + * @param parameterName the name of the parameter to be set + * the second is 2, ... + * + * @param inputStream An object that contains the data to set the parameter + * value to. + * @param length the number of bytes in the parameter data. + * @throws SQLException if parameterIndex does not correspond + * to a parameter marker in the SQL statement, or if the length specified + * is less than zero; if the number of bytes in the inputstream does not match + * the specified length; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.Blob object. - * The driver converts this to an SQL BLOB value when it + /** + * Sets the designated parameter to the given {@code java.sql.Blob} object. + * The driver converts this to an SQL {@code BLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Blob object that maps an SQL BLOB value + * @param x a {@code Blob} object that maps an SQL {@code BLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setBlob (String parameterName, Blob x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) + /** + * Sets the designated parameter to a {@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 BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARBINARY or a BLOB + * data should be send to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterName the name of the parameter * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6339,22 +6360,22 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. The second * argument must be an object type; for integral values, the - * java.lang equivalent objects should be used. + * {@code java.lang} equivalent objects should be used. * * The given Java object will be converted to the given targetSqlType * before being sent to the database. * * If the object has a custom mapping (is of a class implementing the - * interface SQLData), - * the JDBC driver should call the method SQLData.writeSQL to write it + * interface {@code SQLData}), + * the JDBC driver should call the method {@code SQLData.writeSQL} to write it * to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * Note that this method may be used to pass datatabase- @@ -6365,17 +6386,17 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database. The scale argument may further qualify this type. * @param scale for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types, this value will be ignored. + * this is the number of digits after the decimal point. For all other + * types, this value will be ignored. * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see Types * @see #getObject * @since 1.4 @@ -6387,7 +6408,7 @@ /** * Sets the value of the designated parameter with the given object. - * This method is like the method setObject + * This method is like the method {@code setObject} * above, except that it assumes a scale of zero. * * @param parameterName the name of the parameter @@ -6395,14 +6416,14 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see #getObject * @since 1.4 */ @@ -6411,13 +6432,13 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. - * The second parameter must be of type Object; therefore, the - * java.lang equivalent objects should be used for built-in types. + * The second parameter must be of type {@code Object}; therefore, the + * {@code java.lang} equivalent objects should be used for built-in types. * * The JDBC specification specifies a standard mapping from - * Java Object types to SQL types. The given argument + * Java {@code Object} types to SQL types. The given argument * will be converted to the corresponding SQL type before being * sent to the database. * @@ -6425,13 +6446,13 @@ * specific abstract data types, by using a driver-specific Java * type. * - * If the object is of a class implementing the interface SQLData, - * the JDBC driver should call the method SQLData.writeSQL + * If the object is of a class implementing the interface {@code SQLData}, + * the JDBC driver should call the method {@code SQLData.writeSQL} * to write it to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * This method throws an exception if there is an ambiguity, for example, if the @@ -6440,10 +6461,10 @@ * @param parameterName the name of the parameter * @param x the object containing the input parameter value * @exception SQLException if a database access error occurs, - * this method is called on a closed CallableStatement or if the given - * Object parameter is ambiguous + * this method is called on a closed {@code CallableStatement} or if the given + * {@code Object} parameter is ambiguous * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getObject * @since 1.4 */ @@ -6454,9 +6475,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6468,9 +6489,9 @@ * @param x the Java input stream that contains the ASCII parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setAsciiStream(String parameterName, java.io.InputStream x, int length) @@ -6482,9 +6503,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the stream + * {@code java.io.InputStream} object. The data will be read from the stream * as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6495,9 +6516,9 @@ * @param x the java input stream which contains the binary parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBinaryStream(String parameterName, java.io.InputStream x, @@ -6506,11 +6527,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6519,13 +6540,13 @@ * standard interface. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that + * @param reader the {@code java.io.Reader} object that * contains the UNICODE data used as the designated parameter * @param length the number of characters in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setCharacterStream(String parameterName, @@ -6536,9 +6557,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6547,15 +6568,15 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setAsciiStream which takes a length parameter. + * {@code setAsciiStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the Java input stream that contains the ASCII parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.6 - */ + * @since 1.6 + */ public void setAsciiStream(String parameterName, java.io.InputStream x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); @@ -6564,9 +6585,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the + * {@code java.io.InputStream} object. The data will be read from the * stream as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6574,12 +6595,12 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBinaryStream which takes a length parameter. + * {@code setBinaryStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the java input stream which contains the binary parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6589,11 +6610,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6602,13 +6623,13 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setCharacterStream which takes a length parameter. + * {@code setCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that contains the + * @param reader the {@code java.io.Reader} object that contains the * Unicode data * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6619,16 +6640,16 @@ /** * Sets the designated parameter to the given - * java.math.BigDecimal value. - * The driver converts this to an SQL NUMERIC value when + * {@code java.math.BigDecimal} value. + * The driver converts this to an SQL {@code NUMERIC} value when * it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBigDecimal * @since 1.4 */ @@ -6636,20 +6657,20 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java String value. + /** + * Sets the designated parameter to the given Java {@code String} value. * The driver converts this - * to an SQL VARCHAR or LONGVARCHAR value + * to an SQL {@code VARCHAR} or {@code LONGVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on VARCHAR values) + * size relative to the driver's limits on {@code VARCHAR} values) * when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getString * @since 1.4 */ @@ -6659,19 +6680,19 @@ - /** + /** * Sets the designated parameter to the given Java array of bytes. - * The driver converts this to an SQL VARBINARY or - * LONGVARBINARY (depending on the argument's size relative - * to the driver's limits on VARBINARY values) when it sends + * The driver converts this to an SQL {@code VARBINARY} or + * {@code LONGVARBINARY} (depending on the argument's size relative + * to the driver's limits on {@code VARBINARY} values) when it sends * it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBytes * @since 1.4 */ @@ -6680,17 +6701,17 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value. + * Sets the designated parameter to the given {@code java.sql.Timestamp} value. * The driver - * converts this to an SQL TIMESTAMP value when it sends it to the + * converts this to an SQL {@code TIMESTAMP} value when it sends it to the * database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -6700,16 +6721,16 @@ } /** - * Sets the designated parameter to SQL NULL. + * Sets the designated parameter to SQL {@code NULL}. * * Note: You must specify the parameter's SQL type. * * @param parameterName the name of the parameter - * @param sqlType the SQL type code defined in java.sql.Types + * @param sqlType the SQL type code defined in {@code java.sql.Types} * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull(String parameterName, int sqlType) throws SQLException { @@ -6717,8 +6738,8 @@ } /** - * Sets the designated parameter to SQL NULL. - * This version of the method setNull should + * Sets the designated parameter to SQL {@code NULL}. + * This version of the method {@code setNull} should * be used for user-defined types and REF type parameters. Examples * of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and * named array types. @@ -6738,14 +6759,14 @@ * * * @param parameterName the name of the parameter - * @param sqlType a value from java.sql.Types + * @param sqlType a value from {@code java.sql.Types} * @param typeName the fully-qualified name of an SQL user-defined type; * ignored if the parameter is not a user-defined type or - * SQL REF value + * SQL {@code REF} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull (String parameterName, int sqlType, String typeName) @@ -6754,17 +6775,17 @@ } /** - * Sets the designated parameter to the given Java boolean value. + * Sets the designated parameter to the given Java {@code boolean} value. * The driver converts this - * to an SQL BIT or BOOLEAN value when it sends it to the database. + * to an SQL {@code BIT} or {@code BOOLEAN} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @see #getBoolean * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBoolean(String parameterName, boolean x) throws SQLException{ @@ -6774,16 +6795,16 @@ /** - * Sets the designated parameter to the given Java byte value. + * Sets the designated parameter to the given Java {@code byte} value. * The driver converts this - * to an SQL TINYINT value when it sends it to the database. + * to an SQL {@code TINYINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getByte * @since 1.4 */ @@ -6793,16 +6814,16 @@ /** - * Sets the designated parameter to the given Java short value. + * Sets the designated parameter to the given Java {@code short} value. * The driver converts this - * to an SQL SMALLINT value when it sends it to the database. + * to an SQL {@code SMALLINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getShort * @since 1.4 */ @@ -6812,16 +6833,16 @@ /** - * Sets the designated parameter to the given Java int value. + * Sets the designated parameter to the given Java {@code int} value. * The driver converts this - * to an SQL INTEGER value when it sends it to the database. + * to an SQL {@code INTEGER} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getInt * @since 1.4 */ @@ -6829,17 +6850,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java long value. + /** + * Sets the designated parameter to the given Java {@code long} value. * The driver converts this - * to an SQL BIGINT value when it sends it to the database. + * to an SQL {@code BIGINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getLong * @since 1.4 */ @@ -6848,17 +6869,17 @@ } - /** - * Sets the designated parameter to the given Java float value. + /** + * Sets the designated parameter to the given Java {@code float} value. * The driver converts this - * to an SQL FLOAT value when it sends it to the database. + * to an SQL {@code FLOAT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getFloat * @since 1.4 */ @@ -6866,17 +6887,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java double value. + /** + * Sets the designated parameter to the given Java {@code double} value. * The driver converts this - * to an SQL DOUBLE value when it sends it to the database. + * to an SQL {@code DOUBLE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDouble * @since 1.4 */ @@ -6887,7 +6908,6 @@ /** * This method re populates the resBundle * during the deserialization process - * */ private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException { // Default state initialization happens here --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.803466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.635466074 +0400 @@ -43,22 +43,22 @@ /** - * The facility called on internally by the RIOptimisticProvider implementation to + * The facility called on internally by the {@code RIOptimisticProvider} implementation to * propagate changes back to the data source from which the rowset got its data. * - * A CachedRowSetWriter object, called a writer, has the public - * method writeData for writing modified data to the underlying data source. + * A {@code CachedRowSetWriter} object, called a writer, has the public + * method {@code writeData} for writing modified data to the underlying data source. * This method is invoked by the rowset internally and is never invoked directly by an application. * A writer also has public methods for setting and getting - * the CachedRowSetReader object, called a reader, that is associated + * the {@code CachedRowSetReader} object, called a reader, that is associated * with the writer. The remainder of the methods in this class are private and * are invoked internally, either directly or indirectly, by the method - * writeData. + * {@code writeData}. * - * Typically the SyncFactory manages the RowSetReader and - * the RowSetWriter implementations using SyncProvider objects. + * Typically the {@code SyncFactory} manages the {@code RowSetReader} and + * the {@code RowSetWriter} implementations using {@code SyncProvider} objects. * Standard JDBC RowSet implementations provide an object instance of this - * writer by invoking the SyncProvider.getRowSetWriter() method. + * writer by invoking the {@code SyncProvider.getRowSetWriter()} method. * * @version 0.2 * @author Jonathan Bruce @@ -69,15 +69,15 @@ public class CachedRowSetWriter implements TransactionalWriter, Serializable { /** - * The Connection object that this writer will use to make a + * The {@code Connection} object that this writer will use to make a * connection to the data source to which it will write data. * */ private transient Connection con; /** - * The SQL SELECT command that this writer will call - * internally. The method initSQLStatements builds this + * The SQL {@code SELECT} command that this writer will call + * internally. The method {@code initSQLStatements} builds this * command by supplying the words "SELECT" and "FROM," and using * metadata to get the table name and column names . * @@ -86,9 +86,9 @@ private String selectCmd; /** - * The SQL UPDATE command that this writer will call + * The SQL {@code UPDATE} command that this writer will call * internally to write data to the rowset's underlying data source. - * The method initSQLStatements builds this String + * The method {@code initSQLStatements} builds this {@code String} * object. * * @serial @@ -96,8 +96,8 @@ private String updateCmd; /** - * The SQL WHERE clause the writer will use for update - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for update + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -105,7 +105,7 @@ private String updateWhere; /** - * The SQL DELETE command that this writer will call + * The SQL {@code DELETE} command that this writer will call * internally to delete a row in the rowset's underlying data source. * * @serial @@ -113,8 +113,8 @@ private String deleteCmd; /** - * The SQL WHERE clause the writer will use for delete - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for delete + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -122,9 +122,9 @@ private String deleteWhere; /** - * The SQL INSERT INTO command that this writer will internally use + * The SQL {@code INSERT INTO} command that this writer will internally use * to insert data into the rowset's underlying data source. The method - * initSQLStatements builds this command with a question + * {@code initSQLStatements} builds this command with a question * mark parameter placeholder for each column in the rowset. * * @serial @@ -133,8 +133,8 @@ /** * An array containing the column numbers of the columns that are - * needed to uniquely identify a row in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * needed to uniquely identify a row in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ @@ -142,7 +142,7 @@ /** * An array of the parameters that should be used to set the parameter - * placeholders in a PreparedStatement object that this + * placeholders in a {@code PreparedStatement} object that this * writer will execute. * * @serial @@ -150,33 +150,33 @@ private Object[] params; /** - * The CachedRowSetReader object that has been - * set as the reader for the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code CachedRowSetReader} object that has been + * set as the reader for the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private CachedRowSetReader reader; /** - * The ResultSetMetaData object that contains information - * about the columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code ResultSetMetaData} object that contains information + * about the columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private ResultSetMetaData callerMd; /** - * The number of columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The number of columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private int callerColumnCount; /** - * This CachedRowSet will hold the conflicting values + * This {@code CachedRowSet} will hold the conflicting values * retrieved from the db and hold it. */ private CachedRowSetImpl crsResolve; @@ -209,8 +209,8 @@ } /** - * Propagates changes in the given RowSet object - * back to its underlying data source and returns true + * Propagates changes in the given {@code RowSet} object + * back to its underlying data source and returns {@code true} * if successful. The writer will check to see if * the data in the pre-modified rowset (the original values) differ * from the data in the underlying data source. If data in the data @@ -221,15 +221,15 @@ * access for concurrent users. * * This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. * - * Creates a CachedRowSet object from the given - * RowSet object + * Creates a {@code CachedRowSet} object from the given + * {@code RowSet} object * Makes a connection with the data source * * Disables autocommit mode if it is not already disabled @@ -237,32 +237,32 @@ * * Checks to see if the reader has read new data since the writer * was last called and, if so, calls the method - * initSQLStatements to initialize new SQL statements + * {@code initSQLStatements} to initialize new SQL statements * - * Builds new SELECT, UPDATE, - * INSERT, and DELETE statements - * Uses the CachedRowSet object's metadata to + * Builds new {@code SELECT}, {@code UPDATE}, + * {@code INSERT}, and {@code DELETE} statements + * Uses the {@code CachedRowSet} object's metadata to * determine the table name, column names, and the columns * that make up the primary key * * When there is no conflict, propagates changes made to the - * CachedRowSet object back to its underlying data source + * {@code CachedRowSet} object back to its underlying data source * - * Iterates through each row of the CachedRowSet object + * Iterates through each row of the {@code CachedRowSet} object * to determine whether it has been updated, inserted, or deleted * If the corresponding row in the data source has not been changed * since the rowset last read its * values, the writer will use the appropriate command to update, * insert, or delete the row * If any data in the data source does not match the original values - * for the CachedRowSet object, the writer will roll + * for the {@code CachedRowSet} object, the writer will roll * back any changes it has made to the row in the data source. * * * - * @return true if changes to the rowset were successfully + * @return {@code true} if changes to the rowset were successfully * written to the rowset's underlying data source; - * false otherwise + * {@code false} otherwise */ public boolean writeData(RowSetInternal caller) throws SQLException { long conflicts = 0; @@ -434,25 +434,25 @@ } //end writeData -/** - * Updates the given CachedRowSet object's underlying data - * source so that updates to the rowset are reflected in the original - * data source, and returns false if the update was successful. - * A return value of true indicates that there is a conflict, - * meaning that a value updated in the rowset has already been changed by - * someone else in the underlying data source. A conflict can also exist - * if, for example, more than one row in the data source would be affected - * by the update or if no rows would be affected. In any case, if there is - * a conflict, this method does not update the underlying data source. - * - * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + * + * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - * - * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + * + * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. * - * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - * - * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + * + * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. * * If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. * * The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. * * NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. * * This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. * - * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. * - * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. * * Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. * - * undoUpdateRowSet object backed by the same data as - * that of this CachedRowSetImpl object and sharing a set of cursors + * Returns a new {@code RowSet} object backed by the same data as + * that of this {@code CachedRowSetImpl} object and sharing a set of cursors * with it. This allows cursors to interate over a shared set of rows, providing * multiple views of the underlying data. * - * @return a RowSet object that is a copy of this CachedRowSetImpl + * @return a {@code RowSet} object that is a copy of this {@code CachedRowSetImpl} * object and shares a set of cursors with it * @throws SQLException if an error occurs or cloning is * not supported @@ -750,19 +750,19 @@ } /** - * Returns a new RowSet object containing by the same data - * as this CachedRowSetImpl object. This method - * differs from the method createCopy in that it throws a - * CloneNotSupportedException object instead of an - * SQLException object, as the method createShared - * does. This clone - * method is called internally by the method createShared, - * which catches the CloneNotSupportedException object - * and in turn throws a new SQLException object. + * Returns a new {@code RowSet} object containing by the same data + * as this {@code CachedRowSetImpl} object. This method + * differs from the method {@code createCopy} in that it throws a + * {@code CloneNotSupportedException} object instead of an + * {@code SQLException} object, as the method {@code createShared} + * does. This {@code clone} + * method is called internally by the method {@code createShared}, + * which catches the {@code CloneNotSupportedException} object + * and in turn throws a new {@code SQLException} object. * - * @return a copy of this CachedRowSetImpl object + * @return a copy of this {@code CachedRowSetImpl} object * @throws CloneNotSupportedException if an error occurs when - * attempting to clone this CachedRowSetImpl object + * attempting to clone this {@code CachedRowSetImpl} object * @see #createShared */ protected Object clone() throws CloneNotSupportedException { @@ -770,8 +770,8 @@ } /** - * Creates a RowSet object that is a deep copy of - * this CachedRowSetImpl object's data, including + * Creates a {@code RowSet} object that is a deep copy of + * this {@code CachedRowSetImpl} object's data, including * constraints. Updates made * on a copy are not visible to the original rowset; * a copy of a rowset is completely independent from the original. @@ -780,12 +780,12 @@ * from first principles, which can be quite expensive. * For example, it can eliminate the need to query a * remote database server. - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSet object and is - * completely independent from this CachedRowSetImpl + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSet} object and is + * completely independent from this {@code CachedRowSetImpl} * object. * @throws SQLException if an error occurs in generating the copy of this - * of the CachedRowSetImpl + * of the {@code CachedRowSetImpl} * @see #createShared * @see javax.sql.RowSetEvent * @see javax.sql.RowSetListener @@ -795,21 +795,21 @@ } /** - * Creates a RowSet object that is a copy of - * this CachedRowSetImpl object's table structure + * Creates a {@code RowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's table structure * and the constraints only. * There will be no data in the object being returned. * Updates made on a copy are not visible to the original rowset. * * This helps in getting the underlying XML schema which can - * be used as the basis for populating a WebRowSet. + * be used as the basis for populating a {@code WebRowSet}. * - * @return a new CachedRowSet object that is a copy - * of this CachedRowSetImpl object's schema and + * @return a new {@code CachedRowSet} object that is a copy + * of this {@code CachedRowSetImpl} object's schema and * retains all the constraints on the original rowset but contains * no data * @throws SQLException if an error occurs in generating the copy - * of the CachedRowSet object + * of the {@code CachedRowSet} object * @see #createShared * @see #createCopy * @see #createCopyNoConstraints @@ -821,17 +821,17 @@ } /** - * Creates a CachedRowSet object that is a copy of - * this CachedRowSetImpl object's data only. + * Creates a {@code CachedRowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's data only. * All constraints set in this object will not be there * in the returning object. Updates made * on a copy are not visible to the original rowset. * - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSetImpl object and is - * completely independent from this CachedRowSetImpl object + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSetImpl} object and is + * completely independent from this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the copy of the - * of the CachedRowSet + * of the {@code CachedRowSet} * @see #createShared * @see #createCopy * @see #createCopySchema @@ -843,15 +843,15 @@ } /** - * Converts this CachedRowSetImpl object to a collection - * of tables. The sample implementation utilitizes the TreeMap + * Converts this {@code CachedRowSetImpl} object to a collection + * of tables. The sample implementation utilitizes the {@code TreeMap} * collection type. * This class guarantees that the map will be in ascending key order, * sorted according to the natural order for the key's class. * - * @return a Collection object consisting of tables, + * @return a {@code Collection} object consisting of tables, * each of which is a copy of a row in this - * CachedRowSetImpl object + * {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the collection * @see #toCollection(int) * @see #toCollection(String) @@ -863,16 +863,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -886,16 +886,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -914,25 +914,25 @@ /** - * Returns the SyncProvider implementation being used - * with this CachedRowSetImpl implementation rowset. + * Returns the {@code SyncProvider} implementation being used + * with this {@code CachedRowSetImpl} implementation rowset. * * @return the SyncProvider used by the rowset. If not provider was * set when the rowset was instantiated, the reference * implementation (default) provider is returned. * @throws SQLException if error occurs while return the - * SyncProvider instance. + * {@code SyncProvider} instance. */ public SyncProvider getSyncProvider() throws SQLException { throw new UnsupportedOperationException(); } /** - * Sets the active SyncProvider and attempts to load - * load the new provider using the SyncFactory SPI. + * Sets the active {@code SyncProvider} and attempts to load + * load the new provider using the {@code SyncFactory} SPI. * * @throws SQLException if an error occurs while resetting the - * SyncProvider. + * {@code SyncProvider}. */ public void setSyncProvider(String providerStr) throws SQLException { throw new UnsupportedOperationException(); @@ -953,23 +953,23 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data. + * Populates this {@code CachedRowSetImpl} object with data. * This form of the method uses the rowset's user, password, and url or * data source name properties to create a database * connection. If properties that are needed * have not been set, this method will throw an exception. * - * Another form of this method uses an existing JDBC Connection + * Another form of this method uses an existing JDBC {@code Connection} * object instead of creating a new one; therefore, it ignores the * properties used for establishing a new connection. * * The query specified by the command property is executed to create a - * ResultSet object from which to retrieve data. + * {@code ResultSet} object from which to retrieve data. * The current contents of the rowset are discarded, and the * rowset's metadata is also (re)set. If there are outstanding updates, * they are also ignored. * - * The method execute closes any database connections that it + * The method {@code execute} closes any database connections that it * creates. * * @throws SQLException if an error occurs or the @@ -987,20 +987,20 @@ /** * Moves the cursor down one row from its current position and - * returns true if the new cursor position is a + * returns {@code true} if the new cursor position is a * valid row. - * The cursor for a new ResultSet object is initially + * The cursor for a new {@code ResultSet} object is initially * positioned before the first row. The first call to the method - * next moves the cursor to the first row, making it + * {@code next} moves the cursor to the first row, making it * the current row; the second call makes the second row the * current row, and so on. * * If an input stream from the previous row is open, it is - * implicitly closed. The ResultSet object's warning + * implicitly closed. The {@code ResultSet} object's warning * chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if an error occurs or * the cursor is not positioned in the rowset, before * the first row, or after the last row @@ -1010,9 +1010,9 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the next - * row and returns true if the cursor is still in the rowset; - * returns false if the cursor has moved to the position after + * Moves this {@code CachedRowSetImpl} object's cursor to the next + * row and returns {@code true} if the cursor is still in the rowset; + * returns {@code false} if the cursor has moved to the position after * the last row. * * This method handles the cases where the cursor moves to a row that @@ -1021,15 +1021,15 @@ * that has been deleted, this method moves the cursor to the next * row until the cursor is on a row that has not been deleted. * - * The method internalNext is called by methods such as - * next, absolute, and relative, + * The method {@code internalNext} is called by methods such as + * {@code next}, {@code absolute}, and {@code relative}, * and, as its name implies, is only called internally. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a valid row in this - * rowset; false if it is after the last row + * @return {@code true} if the cursor is on a valid row in this + * rowset; {@code false} if it is after the last row * @throws SQLException if an error occurs */ protected boolean internalNext() throws SQLException { @@ -1037,25 +1037,25 @@ } /** - * Closes this CachedRowSetImpl objecy and releases any resources + * Closes this {@code CachedRowSetImpl} objecy and releases any resources * it was using. * * @throws SQLException if an error occurs when releasing any resources in use - * by this CachedRowSetImpl object + * by this {@code CachedRowSetImpl} object */ public void close() throws SQLException { throw new UnsupportedOperationException(); } /** - * Reports whether the last column read was SQL NULL. - * Note that you must first call the method getXXX + * Reports whether the last column read was SQL {@code NULL}. + * Note that you must first call the method {@code getXXX} * on a column to try to read its value and then call the method - * wasNull to determine whether the value was - * SQL NULL. + * {@code wasNull} to determine whether the value was + * SQL {@code NULL}. * - * @return true if the value in the last column read - * was SQL NULL; false otherwise + * @return {@code true} if the value in the last column read + * was SQL {@code NULL}; {@code false} otherwise * @throws SQLException if an error occurs */ public boolean wasNull() throws SQLException { @@ -1064,9 +1064,9 @@ /** * Returns the insert row or the current row of this - * CachedRowSetImplobject. + * {@code CachedRowSetImpl}object. * - * @return the Row object on which this CachedRowSetImpl + * @return the {@code Row} object on which this {@code CachedRowSetImpl} * objects's cursor is positioned */ protected BaseRow getCurrentRow() { @@ -1077,7 +1077,7 @@ * Removes the row on which the cursor is positioned. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * * @throws SQLException if the cursor is positioned on the insert * row @@ -1089,20 +1089,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * String object. + * of this {@code CachedRowSetImpl} object as a + * {@code String} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} {@code CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type designates the * recommended return type. */ public String getString(int columnIndex) throws SQLException { @@ -1111,18 +1111,18 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * boolean value. + * of this {@code CachedRowSetImpl} object as a + * {@code boolean} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a boolean in the Java progamming language; - * if the value is SQL NULL, the result is false + * @return the column value as a {@code boolean} in the Java progamming language; + * if the value is SQL {@code NULL}, the result is {@code false} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BOOLEAN value + * SQL {@code BOOLEAN} value * @see #getBoolean(String) */ public boolean getBoolean(int columnIndex) throws SQLException { @@ -1131,20 +1131,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type + * SQL {@code TINYINT}, {@code SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type * designates the recommended return type. * @see #getByte(String) */ @@ -1154,21 +1154,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * short value. + * of this {@code CachedRowSetImpl} object as a + * {@code short} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT}, {@code SMALLINT}, + * {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(String) */ public short getShort(int columnIndex) throws SQLException { @@ -1177,21 +1178,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * int value. + * of this {@code CachedRowSetImpl} object as an + * {@code int} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1199,21 +1201,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * long value. + * of this {@code CachedRowSetImpl} object as a + * {@code long} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getLong(String) */ public long getLong(int columnIndex) throws SQLException { @@ -1222,21 +1225,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * float value. + * of this {@code CachedRowSetImpl} object as a + * {@code float} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,} + * {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC, + * BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(int columnIndex) throws SQLException { @@ -1245,21 +1248,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * double value. + * of this {@code CachedRowSetImpl} object as a + * {@code double} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,} + * {@code FLOAT, DOUBLE}, + * {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getDouble(String) * */ @@ -1269,21 +1273,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * This method is deprecated; use the version of getBigDecimal + * This method is deprecated; use the version of {@code getBigDecimal} * that does not take a scale parameter and returns a value with full * precision. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @param scale the number of digits to the right of the decimal point in the * value returned * @return the column value with the specified number of digits to the right - * of the decimal point; if the value is SQL NULL, the - * result is null + * of the decimal point; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails * @deprecated @@ -1295,22 +1299,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte array value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} array value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the - * result is null + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the + * result is {@code null} * * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or + * {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getBytes(String) */ public byte[] getBytes(int columnIndex) throws SQLException { @@ -1319,17 +1323,17 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Date object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Date} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a java.sql.Data object; if - * the value is SQL NULL, the - * result is null + * @return the column value as a {@code java.sql.Data} object; if + * the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, - * the cursor is not on a valid row, or this method fails + * the cursor is not on a valid row, or this method fails */ public java.sql.Date getDate(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1337,14 +1341,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Time object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Time} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1354,14 +1358,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1371,33 +1375,33 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The JDBC + * suitable for retrieving large {@code LONGVARCHAR} values. The JDBC * driver will do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. . Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(String) */ public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException { @@ -1416,8 +1420,8 @@ * stream may return 0 for available() whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of two byte Unicode characters. If the value is SQL NULL @@ -1432,30 +1436,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for - * CachedRowSetImpl.available() whether there is data + * stream may return {@code 0} for + * {@code CachedRowSetImpl.available()} whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes. If the value is SQL NULL - * then the result is null. + * as a stream of uninterpreted bytes. If the value is SQL {@code NULL} + * then the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY}. * The bold type indicates the SQL type that this method is recommened * to retrieve. * @see #getBinaryStream(String) @@ -1472,19 +1476,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a String object. + * of the current row as a {@code String} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR< value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} + * {@code CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. */ public String getString(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1492,17 +1496,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a boolean value. + * of the current row as a {@code boolean} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a boolean in the Java programming - * language; if the value is SQL NULL, - * the result is false + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code boolean} in the Java programming + * language; if the value is SQL {@code NULL}, + * the result is {@code false} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BOOLEAN value + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BOOLEAN} value * @see #getBoolean(int) */ public boolean getBoolean(String columnName) throws SQLException { @@ -1511,19 +1515,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte value. + * of the current row as a {@code byte} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The - * bold type designates the recommended return type + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT}, + * {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} + * value. The bold type designates the recommended return type. */ public byte getByte(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1531,19 +1535,20 @@ /** * Retrieves the value stored in the designated column - * of the current row as a short value. + * of the current row as a {@code short} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT,} + * {@code SMALLINT}, {@code INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(int) */ public short getShort(String columnName) throws SQLException { @@ -1552,20 +1557,21 @@ /** * Retrieves the value stored in the designated column - * of the current row as an int value. + * of the current row as an {@code int} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name - * of a column in this rowset, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * of a column in this rowset, + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1573,19 +1579,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a long value. + * of the current row as a {@code long} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getLong(int) */ public long getLong(String columnName) throws SQLException { @@ -1594,19 +1600,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a float value. + * of the current row as a {@code float} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT,} {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(String columnName) throws SQLException { @@ -1615,20 +1621,20 @@ /** * Retrieves the value stored in the designated column - * of the current row of this CachedRowSetImpl object - * as a double value. + * of the current row of this {@code CachedRowSetImpl} object + * as a {@code double} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return types. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL,} {@code FLOAT, DOUBLE}, {@code DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return types. * @see #getDouble(int) */ public double getDouble(String columnName) throws SQLException { @@ -1637,22 +1643,22 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.math.BigDecimal object. + * of the current row as a {@code java.math.BigDecimal} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @param scale the number of digits to the right of the decimal point - * @return a java.math.BugDecimal object with scale - * number of digits to the right of the decimal point. + * @return a java.math.BugDecimal object with {@code scale} + * number of digits to the right of the decimal point. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve. - * @deprecated Use the getBigDecimal(String columnName) + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. + * @deprecated Use the {@code getBigDecimal(String columnName)} * method instead */ @Deprecated @@ -1662,19 +1668,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte array. + * of the current row as a {@code byte} array. * The bytes represent the raw values returned by the driver. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BINARY, VARBINARY - * or LONGVARBINARY values - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BINARY, VARBINARY} + * or {@code LONGVARBINARY} values. + * The bold SQL type designates the recommended return type. * @see #getBytes(int) */ public byte[] getBytes(String columnName) throws SQLException { @@ -1683,17 +1689,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Date object. + * of the current row as a {@code java.sql.Date} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1701,12 +1707,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Time object. + * of the current row as a {@code java.sql.Time} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1717,12 +1723,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Timestamp object. + * of the current row as a {@code java.sql.Timestamp} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1733,32 +1739,32 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The - * SyncProvider will rely on the JDBC driver to do any necessary + * suitable for retrieving large {@code LONGVARCHAR} values. The + * {@code SyncProvider} will rely on the JDBC driver to do any necessary * conversion from the database format into ASCII format. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * a column in this rowset + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(int) */ public java.io.InputStream getAsciiStream(String columnName) throws SQLException { @@ -1769,23 +1775,23 @@ /** * A column value can be retrieved as a stream of Unicode characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will do any necessary conversion from the database * format into Unicode. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row - * @deprecated use the method getCharacterStream instead + * @deprecated use the method {@code getCharacterStream} instead */ @Deprecated public java.io.InputStream getUnicodeStream(String columnName) throws SQLException { @@ -1794,30 +1800,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of uninterpreted bytes. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is unknown, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY - * The bold type indicates the SQL type that this method is recommened - * to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY} + * The bold type indicates the SQL type that this method is recommened + * to retrieve. * @see #getBinaryStream(int) * */ @@ -1831,17 +1837,17 @@ //===================================================================== /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by statement + * by {@code ResultSet} methods. Any warning caused by statement * methods (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * * @return the first SQLWarning or null */ @@ -1850,10 +1856,10 @@ } /** - * Clears all the warnings reporeted for the CachedRowSetImpl - * object. After a call to this method, the getWarnings method - * returns null until a new warning is reported for this - * CachedRowSetImpl object. + * Clears all the warnings reporeted for the {@code CachedRowSetImpl} + * object. After a call to this method, the {@code getWarnings} method + * returns {@code null} until a new warning is reported for this + * {@code CachedRowSetImpl} object. */ public void clearWarnings() { throw new UnsupportedOperationException(); @@ -1861,25 +1867,25 @@ /** * Retrieves the name of the SQL cursor used by this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * * In SQL, a result table is retrieved through a cursor that is - * named. The current row of a ResultSet can be updated or deleted + * named. The current row of a {@code ResultSet} can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To ensure that the cursor has the proper isolation - * level to support an update operation, the cursor's SELECT - * statement should be of the form select for update. - * If the for update clause + * level to support an update operation, the cursor's {@code SELECT} + * statement should be of the form {@code select for update}. + * If the {@code for update} clause * is omitted, positioned updates may fail. * * JDBC supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. The current row + * SQL cursor used by a {@code ResultSet} object. The current row * of a result set is also the current row of this SQL cursor. * * Note: If positioned updates are not supported, an - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL cursor name for this CachedRowSetImpl object's + * @return the SQL cursor name for this {@code CachedRowSetImpl} object's * cursor * @throws SQLException if an error occurs */ @@ -1888,12 +1894,12 @@ } /** - * Retrieves a ResultSetMetaData object instance that - * contains information about the CachedRowSet object. + * Retrieves a {@code ResultSetMetaData} object instance that + * contains information about the {@code CachedRowSet} object. * However, applications should cast the returned object to a - * RowSetMetaData interface implementation. In the + * {@code RowSetMetaData} interface implementation. In the * reference implementation, this cast can be done on the - * RowSetMetaDataImpl class. + * {@code RowSetMetaDataImpl} class. * * For example: * @@ -1907,10 +1913,10 @@ * crs.setMetaData(metaData); * * - * @return the ResultSetMetaData object that describes this - * CachedRowSetImpl object's columns + * @return the {@code ResultSetMetaData} object that describes this + * {@code CachedRowSetImpl} object's columns * @throws SQLException if an error occurs in generating the RowSet - * meta data; or if the CachedRowSetImpl is empty. + * meta data; or if the {@code CachedRowSetImpl} is empty. * @see javax.sql.RowSetMetaData */ public ResultSetMetaData getMetaData() throws SQLException { @@ -1920,10 +1926,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1931,23 +1937,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes in the Java programming language. * When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(String) */ public Object getObject(int columnIndex) throws SQLException { @@ -1956,10 +1962,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1967,23 +1973,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes * in the Java programming language. When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name does not match one of * this rowset's column names, (2) the cursor is not * on a valid row, or (3) there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(int) */ public Object getObject(String columnName) throws SQLException { @@ -1993,10 +1999,10 @@ //---------------------------------------------------------------- /** - * Maps the given column name for one of this CachedRowSetImpl + * Maps the given column name for one of this {@code CachedRowSetImpl} * object's columns to its column number. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @return the column index of the given column name * @throws SQLException if the given column name does not match one @@ -2014,25 +2020,25 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java character stream that delivers the database column value * as a stream of two-byte unicode characters in a - * java.io.Reader object. If the value is - * SQL NULL, the result is null. + * {@code java.io.Reader} object. If the value is + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR,} {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getCharacterStream(String) */ public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{ @@ -2041,23 +2047,24 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY or LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code CHAR, VARCHAR,} + * {@code LONGVARCHAR}, + * {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -2065,21 +2072,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return types that this method is used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return types that this method is used to retrieve. * @see #getBigDecimal(String) */ public BigDecimal getBigDecimal(int columnIndex) throws SQLException { @@ -2088,21 +2096,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. * @see #getBigDecimal(int) */ public BigDecimal getBigDecimal(String columnName) throws SQLException { @@ -2114,7 +2122,7 @@ //--------------------------------------------------------------------- /** - * Returns the number of rows in this CachedRowSetImpl object. + * Returns the number of rows in this {@code CachedRowSetImpl} object. * * @return number of rows in the rowset */ @@ -2124,10 +2132,10 @@ /** * Indicates whether the cursor is before the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is before the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isBeforeFirst() throws SQLException { @@ -2136,10 +2144,10 @@ /** * Indicates whether the cursor is after the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is after the last row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isAfterLast() throws SQLException { @@ -2148,10 +2156,10 @@ /** * Indicates whether the cursor is on the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is on the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isFirst() throws SQLException { @@ -2160,14 +2168,14 @@ /** * Indicates whether the cursor is on the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * Note: Calling the method isLast may be expensive + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver might need to fetch ahead one row in order * to determine whether the current row is the last row in this rowset. * - * @return true if the cursor is on the last row; - * false otherwise or if this rowset contains no rows + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise or if this rowset contains no rows * @throws SQLException if an error occurs */ public boolean isLast() throws SQLException { @@ -2175,19 +2183,19 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the front of + * Moves this {@code CachedRowSetImpl} object's cursor to the front of * the rowset, just before the first row. This method has no effect if * this rowset contains no rows. * * @throws SQLException if an error occurs or the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public void beforeFirst() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the end of + * Moves this {@code CachedRowSetImpl} object's cursor to the end of * the rowset, just after the last row. This method has no effect if * this rowset contains no rows. * @@ -2198,34 +2206,34 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the first row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the first row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean first() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the first - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the first + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the methods first, - * isFirst, and absolute. - * It in turn calls the method internalNext in order to + * This method is called internally by the methods {@code first}, + * {@code isFirst}, and {@code absolute}. + * It in turn calls the method {@code internalNext} in order to * handle the case where the first row is a deleted row that is not visible. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the first row; - * false otherwise + * @return {@code true} if the cursor moved to the first row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalFirst() throws SQLException { @@ -2233,35 +2241,35 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the last row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the last row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean last() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the last - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the last + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the method last + * This method is called internally by the method {@code last} * when rows have been deleted and the deletions are not visible. - * The method internalLast handles the case where the + * The method {@code internalLast} handles the case where the * last row is a deleted row that is not visible by in turn calling - * the method internalPrevious. + * the method {@code internalPrevious}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the last row; - * false otherwise + * @return {@code true} if the cursor moved to the last row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalLast() throws SQLException { @@ -2269,12 +2277,12 @@ } /** - * Returns the number of the current row in this CachedRowSetImpl + * Returns the number of the current row in this {@code CachedRowSetImpl} * object. The first row is number 1, the second number 2, and so on. * - * @return the number of the current row; 0 if there is no + * @return the number of the current row; {@code 0} if there is no * current row - * @throws SQLException if an error occurs; or if the CacheRowSetImpl + * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl} * is empty */ public int getRow() throws SQLException { @@ -2282,51 +2290,51 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the row number + * Moves this {@code CachedRowSetImpl} object's cursor to the row number * specified. * * If the number is positive, the cursor moves to an absolute row with * respect to the beginning of the rowset. The first row is row 1, the second * is row 2, and so on. For example, the following command, in which - * crs is a CachedRowSetImpl object, moves the cursor + * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor * to the fourth row, starting from the beginning of the rowset. - * + * {@code * * crs.absolute(4); * - * + * } * * If the number is negative, the cursor moves to an absolute row position * with respect to the end of the rowset. For example, calling - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row, counting * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. * * @param row a positive number to indicate the row, starting row numbering from - * the first row, which is 1; a negative number to indicate + * the first row, which is {@code 1}; a negative number to indicate * the row, starting row numbering from the last row, which is - * -1; it must not be 0 - * @return true if the cursor is on the rowset; false + * {@code -1}; it must not be {@code 0} + * @return {@code true} if the cursor is on the rowset; {@code false} * otherwise - * @throws SQLException if the given cursor position is 0 or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * @throws SQLException if the given cursor position is {@code 0} or the + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean absolute( int row ) throws SQLException { throw new UnsupportedOperationException(); @@ -2340,80 +2348,80 @@ * If the number is positive, the cursor moves the specified number of * rows toward the end of the rowset, starting at the current row. * For example, the following command, in which - * crs is a CachedRowSetImpl object with 100 rows, + * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows, * moves the cursor forward four rows from the current row. If the * current row is 50, the cursor would move to row 54. - * + * {@code * * crs.relative(4); * - * + * } * * If the number is negative, the cursor moves back toward the beginning * the specified number of rows, starting at the current row. * For example, calling the method - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. In both cases, this method - * throws an SQLException. + * throws an {@code SQLException}. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). Calling relative(0) + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. Calling {@code relative(0)} * is valid, but it does not change the cursor position. * - * @param rows an int indicating the number of rows to move + * @param rows an {@code int} indicating the number of rows to move * the cursor, starting at the current row; a positive number * moves the cursor forward; a negative number moves the cursor * backward; must not move the cursor past the valid * rows - * @return true if the cursor is on a row in this - * CachedRowSetImpl object; false + * @return {@code true} if the cursor is on a row in this + * {@code CachedRowSetImpl} object; {@code false} * otherwise * @throws SQLException if there are no rows in this rowset, the cursor is * positioned either before the first row or after the last row, or - * the rowset is type ResultSet.TYPE_FORWARD_ONLY + * the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean relative(int rows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the - * previous row and returns true if the cursor is on - * a valid row or false if it is not. + * Moves this {@code CachedRowSetImpl} object's cursor to the + * previous row and returns {@code true} if the cursor is on + * a valid row or {@code false} if it is not. * This method also notifies all listeners registered with this - * CachedRowSetImpl object that its cursor has moved. + * {@code CachedRowSetImpl} object that its cursor has moved. * - * Note: calling the method previous() is not the same - * as calling the method relative(-1). This is true - * because it is possible to call previous() from the insert + * Note: calling the method {@code previous()} is not the same + * as calling the method {@code relative(-1)}. This is true + * because it is possible to call {@code previous()} from the insert * row, from after the last row, or from the current row, whereas - * relative may only be called from the current row. + * {@code relative} may only be called from the current row. * - * The method previous may used in a while + * The method {@code previous} may used in a {@code while} * loop to iterate through a rowset starting after the last row - * and moving toward the beginning. The loop ends when previous - * returns false, meaning that there are no more rows. + * and moving toward the beginning. The loop ends when {@code previous} + * returns {@code false}, meaning that there are no more rows. * For example, the following code fragment retrieves all the data in - * the CachedRowSetImpl object crs, which has + * the {@code CachedRowSetImpl} object {@code crs}, which has * three columns. Note that the cursor must initially be positioned * after the last row so that the first call to the method - * previous places the cursor on the last line. - * + * {@code previous} places the cursor on the last line. + * {@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - * - * This method throws an SQLException if the cursor is not + * } + * This method throws an {@code SQLException} if the cursor is not * on a row in the rowset, before the first row, or after the last row. * - * @return true if the cursor is on a valid row; - * false if it is before the first row or after the + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is before the first row or after the * last row * @throws SQLException if the cursor is not on a valid position or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean previous() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor to the previous row in this CachedRowSetImpl + * Moves the cursor to the previous row in this {@code CachedRowSetImpl} * object, skipping past deleted rows that are not visible; returns - * true if the cursor is on a row in this rowset and - * false when the cursor goes before the first row. + * {@code true} if the cursor is on a row in this rowset and + * {@code false} when the cursor goes before the first row. * - * This method is called internally by the method previous. + * This method is called internally by the method {@code previous}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a row in this rowset; - * false when the cursor reaches the position before + * @return {@code true} if the cursor is on a row in this rowset; + * {@code false} when the cursor reaches the position before * the first row * @throws SQLException if an error occurs */ @@ -2463,14 +2471,14 @@ //--------------------------------------------------------------------- /** - * Indicates whether the current row of this CachedRowSetImpl + * Indicates whether the current row of this {@code CachedRowSetImpl} * object has been updated. The value returned - * depends on whether this rowset can detect updates: false + * depends on whether this rowset can detect updates: {@code false} * will always be returned if it does not detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another and updates are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2482,13 +2490,13 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * * @param idx the index identifier of the column that may be have been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2500,14 +2508,14 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * - * @param columnName the String column name column that may be have + * @param columnName the {@code String} column name column that may be have * been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2521,8 +2529,8 @@ * Indicates whether the current row has been inserted. The value returned * depends on whether or not the rowset can detect visible inserts. * - * @return true if a row has been inserted and inserts are detected; - * false otherwise + * @return {@code true} if a row has been inserted and inserts are detected; + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2536,12 +2544,12 @@ * Indicates whether the current row has been deleted. A deleted row * may leave a visible "hole" in a rowset. This method can be used to * detect such holes if the rowset can detect deletions. This method - * will always return false if this rowset cannot detect + * will always return {@code false} if this rowset cannot detect * deletions. * - * @return true if (1)the current row is blank, indicating that + * @return {@code true} if (1)the current row is blank, indicating that * the row has been deleted, and (2)deletions are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on a valid row in this rowset * @see DatabaseMetaData#deletesAreDetected */ @@ -2551,8 +2559,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset; however, another method must be called to complete @@ -2565,15 +2573,15 @@ * * In order to propagate updates in this rowset to the underlying * data source, an application must call the method {@link #acceptChanges} - * after it calls either updateRow or insertRow. + * after it calls either {@code updateRow} or {@code insertRow}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -2581,8 +2589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2593,14 +2601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(int columnIndex, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -2608,8 +2616,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2620,14 +2628,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(int columnIndex, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -2635,8 +2643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2647,14 +2655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(int columnIndex, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -2662,8 +2670,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2674,14 +2682,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(int columnIndex, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -2689,8 +2697,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2701,14 +2709,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(int columnIndex, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -2717,8 +2725,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2729,14 +2737,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(int columnIndex, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -2744,8 +2752,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2756,14 +2764,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(int columnIndex, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -2771,8 +2779,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2783,14 +2791,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -2798,8 +2806,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2810,17 +2818,17 @@ * as inserted. Both of these methods must be called before the * cursor moves to another row. * - * The method acceptChanges must be called if the + * The method {@code acceptChanges} must be called if the * updated values are to be written back to the underlying database. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(int columnIndex, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -2828,8 +2836,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2840,14 +2848,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(int columnIndex, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -2855,8 +2863,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2867,15 +2875,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(int columnIndex, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -2883,8 +2891,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2895,15 +2903,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL TIME or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code TIME} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(int columnIndex, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -2911,8 +2919,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2923,16 +2931,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE, TIME, or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE}, {@code TIME}, or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -2940,7 +2948,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -2952,8 +2960,8 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -2965,8 +2973,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2977,17 +2985,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not binary, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException { throw new UnsupportedOperationException(); @@ -2995,8 +3003,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3007,19 +3015,19 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.Reader - * containing BINARY, VARBINARY, - * LONGVARBINARY, CHAR, VARCHAR, - * or LONGVARCHAR data + * @param x the new column value; must be a {@code java.io.Reader} + * containing {@code BINARY}, {@code VARBINARY}, + * {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR}, + * or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not a binary or * character type, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3027,11 +3035,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter indicates + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter indicates * the number of digits to the right of the decimal point and is ignored * if the new column value is not a type that will be mapped to an SQL - * DECIMAL or NUMERIC value. + * {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3042,16 +3050,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3059,8 +3067,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3071,14 +3079,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x) throws SQLException { throw new UnsupportedOperationException(); @@ -3087,8 +3095,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3098,12 +3106,12 @@ * must be called, which will insert the new row into both this rowset * and the database. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -3111,8 +3119,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3123,13 +3131,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(String columnName, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -3137,8 +3145,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3149,13 +3157,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(String columnName, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -3163,8 +3171,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3175,13 +3183,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(String columnName, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -3189,8 +3197,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3201,13 +3209,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(String columnName, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -3215,8 +3223,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3227,13 +3235,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(String columnName, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -3241,8 +3249,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3253,13 +3261,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(String columnName, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -3267,8 +3275,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3279,13 +3287,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(String columnName, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -3293,8 +3301,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3305,13 +3313,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -3319,8 +3327,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3331,13 +3339,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(String columnName, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -3345,8 +3353,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3357,13 +3365,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(String columnName, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -3371,8 +3379,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3383,15 +3391,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(String columnName, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -3399,8 +3407,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3411,15 +3419,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL TIME or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code TIME} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(String columnName, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -3427,8 +3435,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3439,7 +3447,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if the given column index is out of bounds or @@ -3448,9 +3456,9 @@ * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE, - * TIME, or TIMESTAMP, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP}, or (4) this + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -3458,7 +3466,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -3470,7 +3478,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -3483,8 +3491,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3495,17 +3503,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not binary, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3513,8 +3521,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3525,18 +3533,18 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param reader the new column value; must be a - * java.io.Reader containing BINARY, - * VARBINARY, LONGVARBINARY, CHAR, - * VARCHAR, or LONGVARCHAR data + * {@code java.io.Reader} containing {@code BINARY}, + * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR}, + * {@code VARCHAR}, or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not a binary or character type, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(String columnName, java.io.Reader reader, @@ -3546,11 +3554,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter * indicates the number of digits to the right of the decimal point * and is ignored if the new column value is not a type that will be - * mapped to an SQL DECIMAL or NUMERIC value. + * mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3561,15 +3569,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3577,8 +3585,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3589,20 +3597,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x) throws SQLException { throw new UnsupportedOperationException(); } /** - * Inserts the contents of this CachedRowSetImpl object's insert + * Inserts the contents of this {@code CachedRowSetImpl} object's insert * row into this rowset immediately following the current row. * If the current row is the * position after the last row or before the first row, the new row will @@ -3614,14 +3622,14 @@ * @throws SQLException if (1) the cursor is not on the insert row, * (2) one or more of the non-nullable columns in the insert * row has not been given a value, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void insertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Marks the current row of this CachedRowSetImpl object as + * Marks the current row of this {@code CachedRowSetImpl} object as * updated and notifies listeners registered with this rowset that the * row has changed. * @@ -3631,26 +3639,26 @@ * and the updates made before the cursor moved will be lost. * * @throws SQLException if the cursor is on the insert row or this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Deletes the current row from this CachedRowSetImpl object and + * Deletes the current row from this {@code CachedRowSetImpl} object and * notifies listeners registered with this rowset that a row has changed. * This method cannot be called when the cursor is on the insert row. * * This method marks the current row as deleted, but it does not delete * the row from the underlying data source. The method - * acceptChanges must be called to delete the row in + * {@code acceptChanges} must be called to delete the row in * the data source. * * @throws SQLException if (1) this method is called when the cursor * is on the insert row, before the first row, or after the * last row or (2) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void deleteRow() throws SQLException { throw new UnsupportedOperationException(); @@ -3659,7 +3667,7 @@ /** * Sets the current row with its original value and marks the row as * not updated, thus undoing any changes made to the row since the - * last call to the methods updateRow or deleteRow. + * last call to the methods {@code updateRow} or {@code deleteRow}. * This method should be called only when the cursor is on a row in * this rowset. * @@ -3672,11 +3680,11 @@ /** * Rolls back any updates made to the current row of this - * CachedRowSetImpl object and notifies listeners that + * {@code CachedRowSetImpl} object and notifies listeners that * a row has changed. To have an effect, this method - * must be called after an updateXXX method has been - * called and before the method updateRow has been called. - * If no updates have been made or the method updateRow + * must be called after an {@code updateXXX} method has been + * called and before the method {@code updateRow} has been called. + * If no updates have been made or the method {@code updateRow} * has already been called, this method has no effect. * * @throws SQLException if the cursor is on the insert row, before the @@ -3687,39 +3695,39 @@ } /** - * Moves the cursor for this CachedRowSetImpl object + * Moves the cursor for this {@code CachedRowSetImpl} object * to the insert row. The current row in the rowset is remembered * while the cursor is on the insert row. * * The insert row is a special row associated with an updatable * rowset. It is essentially a buffer where a new row may - * be constructed by calling the appropriate updateXXX + * be constructed by calling the appropriate {@code updateXXX} * methods to assign a value to each column in the row. A complete * row must be constructed; that is, every column that is not nullable * must be assigned a value. In order for the new row to become part - * of this rowset, the method insertRow must be called + * of this rowset, the method {@code insertRow} must be called * before the cursor is moved back to the rowset. * * Only certain methods may be invoked while the cursor is on the insert * row; many methods throw an exception if they are called while the - * cursor is there. In addition to the updateXXX - * and insertRow methods, only the getXXX methods - * may be called when the cursor is on the insert row. A getXXX - * method should be called on a column only after an updateXXX + * cursor is there. In addition to the {@code updateXXX} + * and {@code insertRow} methods, only the {@code getXXX} methods + * may be called when the cursor is on the insert row. A {@code getXXX} + * method should be called on a column only after an {@code updateXXX} * method has been called on that column; otherwise, the value returned is * undetermined. * - * @throws SQLException if this CachedRowSetImpl object is - * ResultSet.CONCUR_READ_ONLY + * @throws SQLException if this {@code CachedRowSetImpl} object is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void moveToInsertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor for this CachedRowSetImpl object to + * Moves the cursor for this {@code CachedRowSetImpl} object to * the current row. The current row is the row the cursor was on - * when the method moveToInsertRow was called. + * when the method {@code moveToInsertRow} was called. * * Calling this method has no effect unless it is called while the * cursor is on the insert row. @@ -3731,9 +3739,9 @@ } /** - * Returns null. + * Returns {@code null}. * - * @return null + * @return {@code null} * @throws SQLException if an error occurs */ public Statement getStatement() throws SQLException { @@ -3742,18 +3750,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column index is out of bounds or * the cursor is not on one of this rowset's rows or its * insert row @@ -3767,17 +3775,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL REF value + * SQL {@code REF} value * @see #getRef(String) */ public Ref getRef(int columnIndex) throws SQLException { @@ -3786,17 +3794,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BLOB value + * SQL {@code BLOB} value * @see #getBlob(String) */ public Blob getBlob(int columnIndex) throws SQLException { @@ -3805,17 +3813,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Clob object representing an SQL CLOB value + * @return a {@code Clob} object representing an SQL {@code CLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL CLOB value + * SQL {@code CLOB} value * @see #getClob(String) */ public Clob getClob(int columnIndex) throws SQLException { @@ -3824,18 +3832,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL ARRAY value + * SQL {@code ARRAY} value * @see #getArray(String) */ public Array getArray(int columnIndex) throws SQLException { @@ -3844,17 +3852,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column name is not the name of * a column in this rowset or the cursor is not on one of * this rowset's rows or its insert row @@ -3867,16 +3875,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the column value - * is not an SQL REF value + * is not an SQL {@code REF} value * @see #getRef(int) */ public Ref getRef(String colName) throws SQLException { @@ -3885,16 +3893,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BLOB value + * column does not store an SQL {@code BLOB} value * @see #getBlob(int) */ public Blob getBlob(String colName) throws SQLException { @@ -3903,17 +3911,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Clob object representing an SQL - * CLOB value + * @return a {@code Clob} object representing an SQL + * {@code CLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CLOB value + * column does not store an SQL {@code CLOB} value * @see #getClob(int) */ public Clob getClob(String colName) throws SQLException { @@ -3922,17 +3930,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming langugage. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL ARRAY value + * column does not store an SQL {@code ARRAY} value * @see #getArray(int) */ public Array getArray(String colName) throws SQLException { @@ -3941,22 +3949,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3964,21 +3972,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3986,22 +3994,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4009,21 +4017,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4031,22 +4039,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Timestamp - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4054,22 +4062,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object, using the given - * Calendar object to construct an appropriate + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object, using the given + * {@code Calendar} object to construct an appropriate * millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE, - * TIME, or TIMESTAMP value + * column does not store an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4080,13 +4088,13 @@ */ /** - * Retrieves the Connection object passed to this - * CachedRowSetImpl object. This connection may be + * Retrieves the {@code Connection} object passed to this + * {@code CachedRowSetImpl} object. This connection may be * used to populate this rowset with data or to write data back * to its underlying data source. * - * @return the Connection object passed to this rowset; - * may be null if there is no connection + * @return the {@code Connection} object passed to this rowset; + * may be {@code null} if there is no connection * @throws SQLException if an error occurs */ public Connection getConnection() throws SQLException{ @@ -4094,10 +4102,10 @@ } /** - * Sets the metadata for this CachedRowSetImpl object - * with the given RowSetMetaData object. + * Sets the metadata for this {@code CachedRowSetImpl} object + * with the given {@code RowSetMetaData} object. * - * @param md a RowSetMetaData object instance containing + * @param md a {@code RowSetMetaData} object instance containing * metadata about the columsn in the rowset * @throws SQLException if invalid meta data is supplied to the * rowset @@ -4108,17 +4116,17 @@ /** * Returns a result set containing the original value of the rowset. The - * original value is the state of the CachedRowSetImpl after the + * original value is the state of the {@code CachedRowSetImpl} after the * last population or synchronization (whichever occurred most recently) with * the data source. * * The cursor is positioned before the first row in the result set. - * Only rows contained in the result set returned by getOriginal() + * Only rows contained in the result set returned by {@code getOriginal()} * are said to have an original value. * * @return the original result set of the rowset * @throws SQLException if an error occurs produce the - * ResultSet object + * {@code ResultSet} object */ public ResultSet getOriginal() throws SQLException { throw new UnsupportedOperationException(); @@ -4127,7 +4135,7 @@ /** * Returns a result set containing the original value of the current * row only. - * The original value is the state of the CachedRowSetImpl after + * The original value is the state of the {@code CachedRowSetImpl} after * the last population or synchronization (whichever occurred most recently) * with the data source. * @@ -4153,7 +4161,7 @@ /** * Marks all rows in this rowset as being original rows. Any updates * made to the rows become the original values for the rowset. - * Calls to the method setOriginal connot be reversed. + * Calls to the method {@code setOriginal} connot be reversed. * * @throws SQLException if an error occurs */ @@ -4165,8 +4173,8 @@ * Returns an identifier for the object (table) that was used to create this * rowset. * - * @return a String object that identifies the table from - * which this CachedRowSetImpl object was derived + * @return a {@code String} object that identifies the table from + * which this {@code CachedRowSetImpl} object was derived * @throws SQLException if an error occurs */ public String getTableName() throws SQLException { @@ -4177,8 +4185,8 @@ * Sets the identifier for the table from which this rowset was derived * to the given table name. * - * @param tabName a String object that identifies the - * table from which this CachedRowSetImpl object + * @param tabName a {@code String} object that identifies the + * table from which this {@code CachedRowSetImpl} object * was derived * @throws SQLException if an error occurs */ @@ -4188,7 +4196,7 @@ /** * Returns the columns that make a key to uniquely identify a - * row in this CachedRowSetImpl object. + * row in this {@code CachedRowSetImpl} object. * * @return an array of column numbers that constitutes a primary * key for this rowset. This array should be empty @@ -4203,16 +4211,16 @@ /** - * Sets this CachedRowSetImpl object's - * keyCols field with the given array of column + * Sets this {@code CachedRowSetImpl} object's + * {@code keyCols} field with the given array of column * numbers, which forms a key for uniquely identifying a row * in this rowset. * - * @param keys an array of int indicating the + * @param keys an array of {@code int} indicating the * columns that form a primary key for this - * CachedRowSetImpl object; every + * {@code CachedRowSetImpl} object; every * element in the array must be greater than - * 0 and less than or equal to the number + * {@code 0} and less than or equal to the number * of columns in this rowset * @throws SQLException if any of the numbers in the * given array is not valid for this rowset @@ -4224,8 +4232,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4236,14 +4244,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4251,8 +4259,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4263,13 +4271,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4277,8 +4285,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4289,14 +4297,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + *
username
password
ResultSet.TYPE_SCROLL_INSENSITIVE
ResultSet.TYPE_FORWARD_ONLY
ResultSet.TYPE_SCROLL_SENSITIVE
ResultSet.CONCUR_UPDATABLE
SQL XML
SQLXML
RowId
updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnIndex the first column is 1, the second 2, ... @@ -4569,10 +4569,10 @@ } /** - * Updates the designated column with a RowId value. The updater + * Updates the designated column with a {@code RowId} value. The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4631,8 +4631,8 @@ /*o - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnIndex the first column is 1, the second 2, ... * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4643,8 +4643,8 @@ } /** - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnName name of the column * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4656,12 +4656,12 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param i the first column is 1, the second is 2, ... - * @return a NClob object representing the SQL - * NCLOB value in the specified column + * @return a {@code NClob} object representing the SQL + * {@code NCLOB} value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4672,11 +4672,11 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param colName the name of the column from which to retrieve the value - * @return a NClob object representing the SQL NCLOB + * @return a {@code NClob} object representing the SQL {@code NCLOB} * value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 @@ -4694,10 +4694,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * SQL {@code XML} value when it sends it to the database. * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an SQL {@code XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4706,10 +4706,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * {@code SQL XML} value when it sends it to the database. * @param parameterName the name of the parameter - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an {@code SQL XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4718,8 +4718,8 @@ } /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID value when it sends it + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} value when it sends it * to the database * * @param parameterIndex the first parameter is 1, the second is 2, ... @@ -4732,9 +4732,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID when it sends it to the + /** + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} when it sends it to the * database. * * @param parameterName the name of the parameter @@ -4748,18 +4748,18 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR value + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on NVARCHAR values) + * size relative to the driver's limits on {@code NVARCHAR} values) * when it sends it to the database. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNString(int parameterIndex, String value) throws SQLException { @@ -4768,9 +4768,9 @@ /** - * Sets the designated parameter in this RowSet object's command - * to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter in this {@code RowSet} object's command + * to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -4779,14 +4779,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed PreparedStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -4795,14 +4795,14 @@ } /** - * Sets the designated parameter to a java.sql.NClob object. The object - * implements the java.sql.NClob interface. This NClob - * object maps to a SQL NCLOB. + * Sets the designated parameter to a {@code java.sql.NClob} object. The object + * implements the {@code java.sql.NClob} interface. This {@code NClob} + * object maps to a SQL {@code NCLOB}. * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(String parameterName, NClob value) throws SQLException { @@ -4810,17 +4810,17 @@ } - /** + /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @exception SQLException if a database access error occurs * @since 1.6 @@ -4832,16 +4832,16 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the name of the column - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4850,11 +4850,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * @param columnIndex the first column is 1, the second 2, ... * @param xmlObject the value for the column to be updated @@ -4866,11 +4866,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4884,15 +4884,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnIndex the first column is 1, the second is 2, ... - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4902,15 +4902,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4927,9 +4927,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnIndex - the first column is 1, the second is 2, ... - * @param x - the new column value - * @param length - the length of the stream + * @param columnIndex the first column is 1, the second is 2, ... + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4949,9 +4949,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnName - name of the Column - * @param x - the new column value - * @param length - the length of the stream + * @param columnName name of the Column + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4963,26 +4963,27 @@ } /** - * Updates the designated column with a character stream value. The + * Updates the designated column with a character stream value. The * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} or this + * method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -4997,26 +4998,27 @@ * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * the result set concurrency is {@code CONCUR_READ_ONLY} or + * this method is called on a closed result set + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method * @since 1.6 */ public void updateNCharacterStream(String columnLabel, @@ -5027,9 +5029,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5039,16 +5041,16 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5060,9 +5062,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5072,18 +5074,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, + * then the label is the name of the column. * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException { @@ -5092,9 +5096,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5102,23 +5106,23 @@ * Java stream object or your own subclass that implements the * standard interface. * - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException { @@ -5127,9 +5131,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5138,22 +5142,23 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException { @@ -5161,11 +5166,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5175,17 +5180,17 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5193,11 +5198,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5207,17 +5212,18 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5225,33 +5231,33 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader) throws SQLException { @@ -5259,34 +5265,35 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader) throws SQLException { @@ -5294,11 +5301,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5308,19 +5315,19 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5328,11 +5335,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5342,19 +5349,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5362,11 +5370,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5375,22 +5383,22 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader) throws SQLException { @@ -5398,11 +5406,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5411,23 +5419,24 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader) throws SQLException { @@ -5435,22 +5444,22 @@ } - /** + /** * Updates the designated column with an ascii stream value, which will have * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5464,17 +5473,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBinaryStream(int columnIndex, @@ -5488,17 +5497,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5512,17 +5521,19 @@ * the specified number of bytes.. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5535,20 +5546,20 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5560,21 +5571,22 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5588,15 +5600,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5611,18 +5625,18 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5637,19 +5651,20 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5665,18 +5680,20 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5689,20 +5706,20 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5714,22 +5731,23 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5738,97 +5756,98 @@ } - /** - * Sets the designated parameter to the given java.net.URL value. - * The driver converts this to an SQL DATALINK value - * when it sends it to the database. - * - * @param parameterIndex the first parameter is 1, the second is 2, ... - * @param x the java.net.URL object to be set - * @exception SQLException if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.4 - */ + /** + * Sets the designated parameter to the given {@code java.net.URL} value. + * The driver converts this to an SQL {@code DATALINK} value + * when it sends it to the database. + * + * @param parameterIndex the first parameter is 1, the second is 2, ... + * @param x the {@code java.net.URL} object to be set + * @exception SQLException if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * @since 1.4 + */ public void setURL(int parameterIndex, java.net.URL x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB - * Note: Consult your JDBC driver documentation to determine if - * it might be more efficient to use a version of - * setNClob which takes a length parameter. - * - * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param reader An object that contains the data to set the parameter value to. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * - * @since 1.6 - */ + /** + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * Note: Consult your JDBC driver documentation to determine if + * it might be more efficient to use a version of + * {@code setNClob} which takes a length parameter. + * + * @param parameterIndex index of the first parameter is 1, the second is 2, ... + * @param reader An object that contains the data to set the parameter value to. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * + * @since 1.6 + */ public void setNClob(int parameterIndex, Reader reader) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB - * - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national - * character sets; if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * @since 1.6 - */ - public void setNClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. + * The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national + * character sets; if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * @since 1.6 + */ + public void setNClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); - } + } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNClob which takes a length parameter. + * {@code setNClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5839,23 +5858,24 @@ } - /** - ** of characters specified by length otherwise a SQLException will becontain the number - * generated when the PreparedStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method + /** + * of characters specified by length otherwise a {@code SQLException} will becontain the number + * generated when the {@code PreparedStatement} is executed. + * This method differs from the {@code setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5867,14 +5887,14 @@ /** - * Sets the designated parameter to a java.sql.NClob object. The driver converts this to -a - * SQL NCLOB value when it sends it to the database. + * Sets the designated parameter to a {@code java.sql.NClob} object. + * The driver converts this to an + * SQL {@code NCLOB} value when it sends it to the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(int parameterIndex, NClob value) throws SQLException{ @@ -5883,14 +5903,14 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNString(String parameterName, String value) @@ -5899,8 +5919,8 @@ } /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... @@ -5908,7 +5928,7 @@ * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException{ @@ -5918,8 +5938,8 @@ /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterName the name of the column to be set @@ -5935,9 +5955,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + /** + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -5946,14 +5966,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed CallableStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -5962,23 +5982,23 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIMESTAMP value, + * Sets the designated parameter to the given {@code java.sql.Timestamp} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIMESTAMP} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the timestamp + * a {@code Calendar} object, the driver can calculate the timestamp * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use - * to construct the timestamp + * @param cal the {@code Calendar} object the driver will use + * to construct the timestamp * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -5987,28 +6007,29 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } @@ -6016,16 +6037,16 @@ /** - * Sets the designated parameter to the given java.sql.Clob object. - * The driver converts this to an SQL CLOB value when it + * Sets the designated parameter to the given {@code java.sql.Clob} object. + * The driver converts this to an SQL {@code CLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Clob object that maps an SQL CLOB value + * @param x a {@code Clob} object that maps an SQL {@code CLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setClob (String parameterName, Clob x) throws SQLException{ @@ -6033,21 +6054,21 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs or this method is called on - * a closed CallableStatement + * a closed {@code CallableStatement} * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6058,19 +6079,19 @@ } - /** - * Sets the designated parameter to the given java.sql.Date value + /** + * Sets the designated parameter to the given {@code java.sql.Date} value * using the default time zone of the virtual machine that is running * the application. * The driver converts this - * to an SQL DATE value when it sends it to the database. + * to an SQL {@code DATE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6080,23 +6101,23 @@ } /** - * Sets the designated parameter to the given java.sql.Date value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL DATE value, + * Sets the designated parameter to the given {@code java.sql.Date} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code DATE} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the date + * a {@code Calendar} object, the driver can calculate the date * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the date * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6107,16 +6128,16 @@ /** - * Sets the designated parameter to the given java.sql.Time value. + * Sets the designated parameter to the given {@code java.sql.Time} value. * The driver converts this - * to an SQL TIME value when it sends it to the database. + * to an SQL {@code TIME} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6126,23 +6147,23 @@ } /** - * Sets the designated parameter to the given java.sql.Time value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIME value, + * Sets the designated parameter to the given {@code java.sql.Time} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIME} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the time + * a {@code Calendar} object, the driver can calculate the time * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the time * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6152,22 +6173,22 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatementor if parameterIndex does not correspond to a parameter - * marker in the SQL statement + * a closed {@code PreparedStatement}or if parameterIndex does not correspond to a parameter + * marker in the SQL statement * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6179,19 +6200,19 @@ /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - *This method differs from the setCharacterStream (int, Reader, int) method + * Sets the designated parameter to a {@code Reader} object. The reader 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 setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatement, if parameterIndex does not correspond to a parameter + * a closed {@code PreparedStatement}, if parameterIndex does not correspond to a parameter * marker in the SQL statement, or if the length specified is less than zero. * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method @@ -6204,25 +6225,26 @@ /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) + * Sets the designated parameter to a {@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)} * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... + * the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement, - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, if the length specified - * is less than zero or if the number of bytes in the inputstream does not match - * the specified length. + * this method is called on a closed {@code PreparedStatement}, + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, if the length specified + * is less than zero or if the number of bytes in the inputstream does not match + * the specified length. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6233,28 +6255,27 @@ } /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) - * This method differs from the setBinaryStream (int, InputStream) + * Sets the designated parameter to a {@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 - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... - - + * the second is 2, ... + * * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement or - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, + * this method is called on a closed {@code PreparedStatement} or + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6264,72 +6285,72 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length, otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) - * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, - * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB - * - * @param parameterName the name of the parameter to be set - * the second is 2, ... - * - * @param inputStream An object that contains the data to set the parameter - * value to. - * @param length the number of bytes in the parameter data. - * @throws SQLException if parameterIndex does not correspond - * to a parameter marker in the SQL statement, or if the length specified - * is less than zero; if the number of bytes in the inputstream does not match - * the specified length; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setBlob(String parameterName, InputStream inputStream, long length) + /** + * Sets the designated parameter to a {@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)} + * 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, + * the driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * + * @param parameterName the name of the parameter to be set + * the second is 2, ... + * + * @param inputStream An object that contains the data to set the parameter + * value to. + * @param length the number of bytes in the parameter data. + * @throws SQLException if parameterIndex does not correspond + * to a parameter marker in the SQL statement, or if the length specified + * is less than zero; if the number of bytes in the inputstream does not match + * the specified length; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.Blob object. - * The driver converts this to an SQL BLOB value when it + /** + * Sets the designated parameter to the given {@code java.sql.Blob} object. + * The driver converts this to an SQL {@code BLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Blob object that maps an SQL BLOB value + * @param x a {@code Blob} object that maps an SQL {@code BLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setBlob (String parameterName, Blob x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) + /** + * Sets the designated parameter to a {@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 BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARBINARY or a BLOB + * data should be send to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterName the name of the parameter * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6339,22 +6360,22 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. The second * argument must be an object type; for integral values, the - * java.lang equivalent objects should be used. + * {@code java.lang} equivalent objects should be used. * * The given Java object will be converted to the given targetSqlType * before being sent to the database. * * If the object has a custom mapping (is of a class implementing the - * interface SQLData), - * the JDBC driver should call the method SQLData.writeSQL to write it + * interface {@code SQLData}), + * the JDBC driver should call the method {@code SQLData.writeSQL} to write it * to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * Note that this method may be used to pass datatabase- @@ -6365,17 +6386,17 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database. The scale argument may further qualify this type. * @param scale for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types, this value will be ignored. + * this is the number of digits after the decimal point. For all other + * types, this value will be ignored. * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see Types * @see #getObject * @since 1.4 @@ -6387,7 +6408,7 @@ /** * Sets the value of the designated parameter with the given object. - * This method is like the method setObject + * This method is like the method {@code setObject} * above, except that it assumes a scale of zero. * * @param parameterName the name of the parameter @@ -6395,14 +6416,14 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see #getObject * @since 1.4 */ @@ -6411,13 +6432,13 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. - * The second parameter must be of type Object; therefore, the - * java.lang equivalent objects should be used for built-in types. + * The second parameter must be of type {@code Object}; therefore, the + * {@code java.lang} equivalent objects should be used for built-in types. * * The JDBC specification specifies a standard mapping from - * Java Object types to SQL types. The given argument + * Java {@code Object} types to SQL types. The given argument * will be converted to the corresponding SQL type before being * sent to the database. * @@ -6425,13 +6446,13 @@ * specific abstract data types, by using a driver-specific Java * type. * - * If the object is of a class implementing the interface SQLData, - * the JDBC driver should call the method SQLData.writeSQL + * If the object is of a class implementing the interface {@code SQLData}, + * the JDBC driver should call the method {@code SQLData.writeSQL} * to write it to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * This method throws an exception if there is an ambiguity, for example, if the @@ -6440,10 +6461,10 @@ * @param parameterName the name of the parameter * @param x the object containing the input parameter value * @exception SQLException if a database access error occurs, - * this method is called on a closed CallableStatement or if the given - * Object parameter is ambiguous + * this method is called on a closed {@code CallableStatement} or if the given + * {@code Object} parameter is ambiguous * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getObject * @since 1.4 */ @@ -6454,9 +6475,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6468,9 +6489,9 @@ * @param x the Java input stream that contains the ASCII parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setAsciiStream(String parameterName, java.io.InputStream x, int length) @@ -6482,9 +6503,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the stream + * {@code java.io.InputStream} object. The data will be read from the stream * as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6495,9 +6516,9 @@ * @param x the java input stream which contains the binary parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBinaryStream(String parameterName, java.io.InputStream x, @@ -6506,11 +6527,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6519,13 +6540,13 @@ * standard interface. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that + * @param reader the {@code java.io.Reader} object that * contains the UNICODE data used as the designated parameter * @param length the number of characters in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setCharacterStream(String parameterName, @@ -6536,9 +6557,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6547,15 +6568,15 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setAsciiStream which takes a length parameter. + * {@code setAsciiStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the Java input stream that contains the ASCII parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.6 - */ + * @since 1.6 + */ public void setAsciiStream(String parameterName, java.io.InputStream x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); @@ -6564,9 +6585,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the + * {@code java.io.InputStream} object. The data will be read from the * stream as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6574,12 +6595,12 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBinaryStream which takes a length parameter. + * {@code setBinaryStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the java input stream which contains the binary parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6589,11 +6610,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6602,13 +6623,13 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setCharacterStream which takes a length parameter. + * {@code setCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that contains the + * @param reader the {@code java.io.Reader} object that contains the * Unicode data * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6619,16 +6640,16 @@ /** * Sets the designated parameter to the given - * java.math.BigDecimal value. - * The driver converts this to an SQL NUMERIC value when + * {@code java.math.BigDecimal} value. + * The driver converts this to an SQL {@code NUMERIC} value when * it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBigDecimal * @since 1.4 */ @@ -6636,20 +6657,20 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java String value. + /** + * Sets the designated parameter to the given Java {@code String} value. * The driver converts this - * to an SQL VARCHAR or LONGVARCHAR value + * to an SQL {@code VARCHAR} or {@code LONGVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on VARCHAR values) + * size relative to the driver's limits on {@code VARCHAR} values) * when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getString * @since 1.4 */ @@ -6659,19 +6680,19 @@ - /** + /** * Sets the designated parameter to the given Java array of bytes. - * The driver converts this to an SQL VARBINARY or - * LONGVARBINARY (depending on the argument's size relative - * to the driver's limits on VARBINARY values) when it sends + * The driver converts this to an SQL {@code VARBINARY} or + * {@code LONGVARBINARY} (depending on the argument's size relative + * to the driver's limits on {@code VARBINARY} values) when it sends * it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBytes * @since 1.4 */ @@ -6680,17 +6701,17 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value. + * Sets the designated parameter to the given {@code java.sql.Timestamp} value. * The driver - * converts this to an SQL TIMESTAMP value when it sends it to the + * converts this to an SQL {@code TIMESTAMP} value when it sends it to the * database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -6700,16 +6721,16 @@ } /** - * Sets the designated parameter to SQL NULL. + * Sets the designated parameter to SQL {@code NULL}. * * Note: You must specify the parameter's SQL type. * * @param parameterName the name of the parameter - * @param sqlType the SQL type code defined in java.sql.Types + * @param sqlType the SQL type code defined in {@code java.sql.Types} * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull(String parameterName, int sqlType) throws SQLException { @@ -6717,8 +6738,8 @@ } /** - * Sets the designated parameter to SQL NULL. - * This version of the method setNull should + * Sets the designated parameter to SQL {@code NULL}. + * This version of the method {@code setNull} should * be used for user-defined types and REF type parameters. Examples * of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and * named array types. @@ -6738,14 +6759,14 @@ * * * @param parameterName the name of the parameter - * @param sqlType a value from java.sql.Types + * @param sqlType a value from {@code java.sql.Types} * @param typeName the fully-qualified name of an SQL user-defined type; * ignored if the parameter is not a user-defined type or - * SQL REF value + * SQL {@code REF} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull (String parameterName, int sqlType, String typeName) @@ -6754,17 +6775,17 @@ } /** - * Sets the designated parameter to the given Java boolean value. + * Sets the designated parameter to the given Java {@code boolean} value. * The driver converts this - * to an SQL BIT or BOOLEAN value when it sends it to the database. + * to an SQL {@code BIT} or {@code BOOLEAN} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @see #getBoolean * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBoolean(String parameterName, boolean x) throws SQLException{ @@ -6774,16 +6795,16 @@ /** - * Sets the designated parameter to the given Java byte value. + * Sets the designated parameter to the given Java {@code byte} value. * The driver converts this - * to an SQL TINYINT value when it sends it to the database. + * to an SQL {@code TINYINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getByte * @since 1.4 */ @@ -6793,16 +6814,16 @@ /** - * Sets the designated parameter to the given Java short value. + * Sets the designated parameter to the given Java {@code short} value. * The driver converts this - * to an SQL SMALLINT value when it sends it to the database. + * to an SQL {@code SMALLINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getShort * @since 1.4 */ @@ -6812,16 +6833,16 @@ /** - * Sets the designated parameter to the given Java int value. + * Sets the designated parameter to the given Java {@code int} value. * The driver converts this - * to an SQL INTEGER value when it sends it to the database. + * to an SQL {@code INTEGER} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getInt * @since 1.4 */ @@ -6829,17 +6850,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java long value. + /** + * Sets the designated parameter to the given Java {@code long} value. * The driver converts this - * to an SQL BIGINT value when it sends it to the database. + * to an SQL {@code BIGINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getLong * @since 1.4 */ @@ -6848,17 +6869,17 @@ } - /** - * Sets the designated parameter to the given Java float value. + /** + * Sets the designated parameter to the given Java {@code float} value. * The driver converts this - * to an SQL FLOAT value when it sends it to the database. + * to an SQL {@code FLOAT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getFloat * @since 1.4 */ @@ -6866,17 +6887,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java double value. + /** + * Sets the designated parameter to the given Java {@code double} value. * The driver converts this - * to an SQL DOUBLE value when it sends it to the database. + * to an SQL {@code DOUBLE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDouble * @since 1.4 */ @@ -6887,7 +6908,6 @@ /** * This method re populates the resBundle * during the deserialization process - * */ private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException { // Default state initialization happens here --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.803466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.635466074 +0400 @@ -43,22 +43,22 @@ /** - * The facility called on internally by the RIOptimisticProvider implementation to + * The facility called on internally by the {@code RIOptimisticProvider} implementation to * propagate changes back to the data source from which the rowset got its data. * - * A CachedRowSetWriter object, called a writer, has the public - * method writeData for writing modified data to the underlying data source. + * A {@code CachedRowSetWriter} object, called a writer, has the public + * method {@code writeData} for writing modified data to the underlying data source. * This method is invoked by the rowset internally and is never invoked directly by an application. * A writer also has public methods for setting and getting - * the CachedRowSetReader object, called a reader, that is associated + * the {@code CachedRowSetReader} object, called a reader, that is associated * with the writer. The remainder of the methods in this class are private and * are invoked internally, either directly or indirectly, by the method - * writeData. + * {@code writeData}. * - * Typically the SyncFactory manages the RowSetReader and - * the RowSetWriter implementations using SyncProvider objects. + * Typically the {@code SyncFactory} manages the {@code RowSetReader} and + * the {@code RowSetWriter} implementations using {@code SyncProvider} objects. * Standard JDBC RowSet implementations provide an object instance of this - * writer by invoking the SyncProvider.getRowSetWriter() method. + * writer by invoking the {@code SyncProvider.getRowSetWriter()} method. * * @version 0.2 * @author Jonathan Bruce @@ -69,15 +69,15 @@ public class CachedRowSetWriter implements TransactionalWriter, Serializable { /** - * The Connection object that this writer will use to make a + * The {@code Connection} object that this writer will use to make a * connection to the data source to which it will write data. * */ private transient Connection con; /** - * The SQL SELECT command that this writer will call - * internally. The method initSQLStatements builds this + * The SQL {@code SELECT} command that this writer will call + * internally. The method {@code initSQLStatements} builds this * command by supplying the words "SELECT" and "FROM," and using * metadata to get the table name and column names . * @@ -86,9 +86,9 @@ private String selectCmd; /** - * The SQL UPDATE command that this writer will call + * The SQL {@code UPDATE} command that this writer will call * internally to write data to the rowset's underlying data source. - * The method initSQLStatements builds this String + * The method {@code initSQLStatements} builds this {@code String} * object. * * @serial @@ -96,8 +96,8 @@ private String updateCmd; /** - * The SQL WHERE clause the writer will use for update - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for update + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -105,7 +105,7 @@ private String updateWhere; /** - * The SQL DELETE command that this writer will call + * The SQL {@code DELETE} command that this writer will call * internally to delete a row in the rowset's underlying data source. * * @serial @@ -113,8 +113,8 @@ private String deleteCmd; /** - * The SQL WHERE clause the writer will use for delete - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for delete + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -122,9 +122,9 @@ private String deleteWhere; /** - * The SQL INSERT INTO command that this writer will internally use + * The SQL {@code INSERT INTO} command that this writer will internally use * to insert data into the rowset's underlying data source. The method - * initSQLStatements builds this command with a question + * {@code initSQLStatements} builds this command with a question * mark parameter placeholder for each column in the rowset. * * @serial @@ -133,8 +133,8 @@ /** * An array containing the column numbers of the columns that are - * needed to uniquely identify a row in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * needed to uniquely identify a row in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ @@ -142,7 +142,7 @@ /** * An array of the parameters that should be used to set the parameter - * placeholders in a PreparedStatement object that this + * placeholders in a {@code PreparedStatement} object that this * writer will execute. * * @serial @@ -150,33 +150,33 @@ private Object[] params; /** - * The CachedRowSetReader object that has been - * set as the reader for the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code CachedRowSetReader} object that has been + * set as the reader for the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private CachedRowSetReader reader; /** - * The ResultSetMetaData object that contains information - * about the columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code ResultSetMetaData} object that contains information + * about the columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private ResultSetMetaData callerMd; /** - * The number of columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The number of columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private int callerColumnCount; /** - * This CachedRowSet will hold the conflicting values + * This {@code CachedRowSet} will hold the conflicting values * retrieved from the db and hold it. */ private CachedRowSetImpl crsResolve; @@ -209,8 +209,8 @@ } /** - * Propagates changes in the given RowSet object - * back to its underlying data source and returns true + * Propagates changes in the given {@code RowSet} object + * back to its underlying data source and returns {@code true} * if successful. The writer will check to see if * the data in the pre-modified rowset (the original values) differ * from the data in the underlying data source. If data in the data @@ -221,15 +221,15 @@ * access for concurrent users. * * This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. * - * Creates a CachedRowSet object from the given - * RowSet object + * Creates a {@code CachedRowSet} object from the given + * {@code RowSet} object * Makes a connection with the data source * * Disables autocommit mode if it is not already disabled @@ -237,32 +237,32 @@ * * Checks to see if the reader has read new data since the writer * was last called and, if so, calls the method - * initSQLStatements to initialize new SQL statements + * {@code initSQLStatements} to initialize new SQL statements * - * Builds new SELECT, UPDATE, - * INSERT, and DELETE statements - * Uses the CachedRowSet object's metadata to + * Builds new {@code SELECT}, {@code UPDATE}, + * {@code INSERT}, and {@code DELETE} statements + * Uses the {@code CachedRowSet} object's metadata to * determine the table name, column names, and the columns * that make up the primary key * * When there is no conflict, propagates changes made to the - * CachedRowSet object back to its underlying data source + * {@code CachedRowSet} object back to its underlying data source * - * Iterates through each row of the CachedRowSet object + * Iterates through each row of the {@code CachedRowSet} object * to determine whether it has been updated, inserted, or deleted * If the corresponding row in the data source has not been changed * since the rowset last read its * values, the writer will use the appropriate command to update, * insert, or delete the row * If any data in the data source does not match the original values - * for the CachedRowSet object, the writer will roll + * for the {@code CachedRowSet} object, the writer will roll * back any changes it has made to the row in the data source. * * * - * @return true if changes to the rowset were successfully + * @return {@code true} if changes to the rowset were successfully * written to the rowset's underlying data source; - * false otherwise + * {@code false} otherwise */ public boolean writeData(RowSetInternal caller) throws SQLException { long conflicts = 0; @@ -434,25 +434,25 @@ } //end writeData -/** - * Updates the given CachedRowSet object's underlying data - * source so that updates to the rowset are reflected in the original - * data source, and returns false if the update was successful. - * A return value of true indicates that there is a conflict, - * meaning that a value updated in the rowset has already been changed by - * someone else in the underlying data source. A conflict can also exist - * if, for example, more than one row in the data source would be affected - * by the update or if no rows would be affected. In any case, if there is - * a conflict, this method does not update the underlying data source. - * - * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + * + * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - * - * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + * + * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. * - * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - * - * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + * + * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. * * If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. * * The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. * * NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. * * This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. * - * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. * - * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. * * Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. * - * undoUpdateRowSet object backed by the same data as - * that of this CachedRowSetImpl object and sharing a set of cursors + * Returns a new {@code RowSet} object backed by the same data as + * that of this {@code CachedRowSetImpl} object and sharing a set of cursors * with it. This allows cursors to interate over a shared set of rows, providing * multiple views of the underlying data. * - * @return a RowSet object that is a copy of this CachedRowSetImpl + * @return a {@code RowSet} object that is a copy of this {@code CachedRowSetImpl} * object and shares a set of cursors with it * @throws SQLException if an error occurs or cloning is * not supported @@ -750,19 +750,19 @@ } /** - * Returns a new RowSet object containing by the same data - * as this CachedRowSetImpl object. This method - * differs from the method createCopy in that it throws a - * CloneNotSupportedException object instead of an - * SQLException object, as the method createShared - * does. This clone - * method is called internally by the method createShared, - * which catches the CloneNotSupportedException object - * and in turn throws a new SQLException object. + * Returns a new {@code RowSet} object containing by the same data + * as this {@code CachedRowSetImpl} object. This method + * differs from the method {@code createCopy} in that it throws a + * {@code CloneNotSupportedException} object instead of an + * {@code SQLException} object, as the method {@code createShared} + * does. This {@code clone} + * method is called internally by the method {@code createShared}, + * which catches the {@code CloneNotSupportedException} object + * and in turn throws a new {@code SQLException} object. * - * @return a copy of this CachedRowSetImpl object + * @return a copy of this {@code CachedRowSetImpl} object * @throws CloneNotSupportedException if an error occurs when - * attempting to clone this CachedRowSetImpl object + * attempting to clone this {@code CachedRowSetImpl} object * @see #createShared */ protected Object clone() throws CloneNotSupportedException { @@ -770,8 +770,8 @@ } /** - * Creates a RowSet object that is a deep copy of - * this CachedRowSetImpl object's data, including + * Creates a {@code RowSet} object that is a deep copy of + * this {@code CachedRowSetImpl} object's data, including * constraints. Updates made * on a copy are not visible to the original rowset; * a copy of a rowset is completely independent from the original. @@ -780,12 +780,12 @@ * from first principles, which can be quite expensive. * For example, it can eliminate the need to query a * remote database server. - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSet object and is - * completely independent from this CachedRowSetImpl + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSet} object and is + * completely independent from this {@code CachedRowSetImpl} * object. * @throws SQLException if an error occurs in generating the copy of this - * of the CachedRowSetImpl + * of the {@code CachedRowSetImpl} * @see #createShared * @see javax.sql.RowSetEvent * @see javax.sql.RowSetListener @@ -795,21 +795,21 @@ } /** - * Creates a RowSet object that is a copy of - * this CachedRowSetImpl object's table structure + * Creates a {@code RowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's table structure * and the constraints only. * There will be no data in the object being returned. * Updates made on a copy are not visible to the original rowset. * * This helps in getting the underlying XML schema which can - * be used as the basis for populating a WebRowSet. + * be used as the basis for populating a {@code WebRowSet}. * - * @return a new CachedRowSet object that is a copy - * of this CachedRowSetImpl object's schema and + * @return a new {@code CachedRowSet} object that is a copy + * of this {@code CachedRowSetImpl} object's schema and * retains all the constraints on the original rowset but contains * no data * @throws SQLException if an error occurs in generating the copy - * of the CachedRowSet object + * of the {@code CachedRowSet} object * @see #createShared * @see #createCopy * @see #createCopyNoConstraints @@ -821,17 +821,17 @@ } /** - * Creates a CachedRowSet object that is a copy of - * this CachedRowSetImpl object's data only. + * Creates a {@code CachedRowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's data only. * All constraints set in this object will not be there * in the returning object. Updates made * on a copy are not visible to the original rowset. * - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSetImpl object and is - * completely independent from this CachedRowSetImpl object + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSetImpl} object and is + * completely independent from this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the copy of the - * of the CachedRowSet + * of the {@code CachedRowSet} * @see #createShared * @see #createCopy * @see #createCopySchema @@ -843,15 +843,15 @@ } /** - * Converts this CachedRowSetImpl object to a collection - * of tables. The sample implementation utilitizes the TreeMap + * Converts this {@code CachedRowSetImpl} object to a collection + * of tables. The sample implementation utilitizes the {@code TreeMap} * collection type. * This class guarantees that the map will be in ascending key order, * sorted according to the natural order for the key's class. * - * @return a Collection object consisting of tables, + * @return a {@code Collection} object consisting of tables, * each of which is a copy of a row in this - * CachedRowSetImpl object + * {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the collection * @see #toCollection(int) * @see #toCollection(String) @@ -863,16 +863,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -886,16 +886,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -914,25 +914,25 @@ /** - * Returns the SyncProvider implementation being used - * with this CachedRowSetImpl implementation rowset. + * Returns the {@code SyncProvider} implementation being used + * with this {@code CachedRowSetImpl} implementation rowset. * * @return the SyncProvider used by the rowset. If not provider was * set when the rowset was instantiated, the reference * implementation (default) provider is returned. * @throws SQLException if error occurs while return the - * SyncProvider instance. + * {@code SyncProvider} instance. */ public SyncProvider getSyncProvider() throws SQLException { throw new UnsupportedOperationException(); } /** - * Sets the active SyncProvider and attempts to load - * load the new provider using the SyncFactory SPI. + * Sets the active {@code SyncProvider} and attempts to load + * load the new provider using the {@code SyncFactory} SPI. * * @throws SQLException if an error occurs while resetting the - * SyncProvider. + * {@code SyncProvider}. */ public void setSyncProvider(String providerStr) throws SQLException { throw new UnsupportedOperationException(); @@ -953,23 +953,23 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data. + * Populates this {@code CachedRowSetImpl} object with data. * This form of the method uses the rowset's user, password, and url or * data source name properties to create a database * connection. If properties that are needed * have not been set, this method will throw an exception. * - * Another form of this method uses an existing JDBC Connection + * Another form of this method uses an existing JDBC {@code Connection} * object instead of creating a new one; therefore, it ignores the * properties used for establishing a new connection. * * The query specified by the command property is executed to create a - * ResultSet object from which to retrieve data. + * {@code ResultSet} object from which to retrieve data. * The current contents of the rowset are discarded, and the * rowset's metadata is also (re)set. If there are outstanding updates, * they are also ignored. * - * The method execute closes any database connections that it + * The method {@code execute} closes any database connections that it * creates. * * @throws SQLException if an error occurs or the @@ -987,20 +987,20 @@ /** * Moves the cursor down one row from its current position and - * returns true if the new cursor position is a + * returns {@code true} if the new cursor position is a * valid row. - * The cursor for a new ResultSet object is initially + * The cursor for a new {@code ResultSet} object is initially * positioned before the first row. The first call to the method - * next moves the cursor to the first row, making it + * {@code next} moves the cursor to the first row, making it * the current row; the second call makes the second row the * current row, and so on. * * If an input stream from the previous row is open, it is - * implicitly closed. The ResultSet object's warning + * implicitly closed. The {@code ResultSet} object's warning * chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if an error occurs or * the cursor is not positioned in the rowset, before * the first row, or after the last row @@ -1010,9 +1010,9 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the next - * row and returns true if the cursor is still in the rowset; - * returns false if the cursor has moved to the position after + * Moves this {@code CachedRowSetImpl} object's cursor to the next + * row and returns {@code true} if the cursor is still in the rowset; + * returns {@code false} if the cursor has moved to the position after * the last row. * * This method handles the cases where the cursor moves to a row that @@ -1021,15 +1021,15 @@ * that has been deleted, this method moves the cursor to the next * row until the cursor is on a row that has not been deleted. * - * The method internalNext is called by methods such as - * next, absolute, and relative, + * The method {@code internalNext} is called by methods such as + * {@code next}, {@code absolute}, and {@code relative}, * and, as its name implies, is only called internally. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a valid row in this - * rowset; false if it is after the last row + * @return {@code true} if the cursor is on a valid row in this + * rowset; {@code false} if it is after the last row * @throws SQLException if an error occurs */ protected boolean internalNext() throws SQLException { @@ -1037,25 +1037,25 @@ } /** - * Closes this CachedRowSetImpl objecy and releases any resources + * Closes this {@code CachedRowSetImpl} objecy and releases any resources * it was using. * * @throws SQLException if an error occurs when releasing any resources in use - * by this CachedRowSetImpl object + * by this {@code CachedRowSetImpl} object */ public void close() throws SQLException { throw new UnsupportedOperationException(); } /** - * Reports whether the last column read was SQL NULL. - * Note that you must first call the method getXXX + * Reports whether the last column read was SQL {@code NULL}. + * Note that you must first call the method {@code getXXX} * on a column to try to read its value and then call the method - * wasNull to determine whether the value was - * SQL NULL. + * {@code wasNull} to determine whether the value was + * SQL {@code NULL}. * - * @return true if the value in the last column read - * was SQL NULL; false otherwise + * @return {@code true} if the value in the last column read + * was SQL {@code NULL}; {@code false} otherwise * @throws SQLException if an error occurs */ public boolean wasNull() throws SQLException { @@ -1064,9 +1064,9 @@ /** * Returns the insert row or the current row of this - * CachedRowSetImplobject. + * {@code CachedRowSetImpl}object. * - * @return the Row object on which this CachedRowSetImpl + * @return the {@code Row} object on which this {@code CachedRowSetImpl} * objects's cursor is positioned */ protected BaseRow getCurrentRow() { @@ -1077,7 +1077,7 @@ * Removes the row on which the cursor is positioned. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * * @throws SQLException if the cursor is positioned on the insert * row @@ -1089,20 +1089,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * String object. + * of this {@code CachedRowSetImpl} object as a + * {@code String} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} {@code CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type designates the * recommended return type. */ public String getString(int columnIndex) throws SQLException { @@ -1111,18 +1111,18 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * boolean value. + * of this {@code CachedRowSetImpl} object as a + * {@code boolean} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a boolean in the Java progamming language; - * if the value is SQL NULL, the result is false + * @return the column value as a {@code boolean} in the Java progamming language; + * if the value is SQL {@code NULL}, the result is {@code false} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BOOLEAN value + * SQL {@code BOOLEAN} value * @see #getBoolean(String) */ public boolean getBoolean(int columnIndex) throws SQLException { @@ -1131,20 +1131,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type + * SQL {@code TINYINT}, {@code SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type * designates the recommended return type. * @see #getByte(String) */ @@ -1154,21 +1154,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * short value. + * of this {@code CachedRowSetImpl} object as a + * {@code short} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT}, {@code SMALLINT}, + * {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(String) */ public short getShort(int columnIndex) throws SQLException { @@ -1177,21 +1178,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * int value. + * of this {@code CachedRowSetImpl} object as an + * {@code int} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1199,21 +1201,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * long value. + * of this {@code CachedRowSetImpl} object as a + * {@code long} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getLong(String) */ public long getLong(int columnIndex) throws SQLException { @@ -1222,21 +1225,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * float value. + * of this {@code CachedRowSetImpl} object as a + * {@code float} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,} + * {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC, + * BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(int columnIndex) throws SQLException { @@ -1245,21 +1248,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * double value. + * of this {@code CachedRowSetImpl} object as a + * {@code double} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,} + * {@code FLOAT, DOUBLE}, + * {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getDouble(String) * */ @@ -1269,21 +1273,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * This method is deprecated; use the version of getBigDecimal + * This method is deprecated; use the version of {@code getBigDecimal} * that does not take a scale parameter and returns a value with full * precision. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @param scale the number of digits to the right of the decimal point in the * value returned * @return the column value with the specified number of digits to the right - * of the decimal point; if the value is SQL NULL, the - * result is null + * of the decimal point; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails * @deprecated @@ -1295,22 +1299,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte array value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} array value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the - * result is null + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the + * result is {@code null} * * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or + * {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getBytes(String) */ public byte[] getBytes(int columnIndex) throws SQLException { @@ -1319,17 +1323,17 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Date object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Date} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a java.sql.Data object; if - * the value is SQL NULL, the - * result is null + * @return the column value as a {@code java.sql.Data} object; if + * the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, - * the cursor is not on a valid row, or this method fails + * the cursor is not on a valid row, or this method fails */ public java.sql.Date getDate(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1337,14 +1341,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Time object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Time} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1354,14 +1358,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1371,33 +1375,33 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The JDBC + * suitable for retrieving large {@code LONGVARCHAR} values. The JDBC * driver will do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. . Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(String) */ public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException { @@ -1416,8 +1420,8 @@ * stream may return 0 for available() whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of two byte Unicode characters. If the value is SQL NULL @@ -1432,30 +1436,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for - * CachedRowSetImpl.available() whether there is data + * stream may return {@code 0} for + * {@code CachedRowSetImpl.available()} whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes. If the value is SQL NULL - * then the result is null. + * as a stream of uninterpreted bytes. If the value is SQL {@code NULL} + * then the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY}. * The bold type indicates the SQL type that this method is recommened * to retrieve. * @see #getBinaryStream(String) @@ -1472,19 +1476,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a String object. + * of the current row as a {@code String} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR< value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} + * {@code CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. */ public String getString(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1492,17 +1496,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a boolean value. + * of the current row as a {@code boolean} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a boolean in the Java programming - * language; if the value is SQL NULL, - * the result is false + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code boolean} in the Java programming + * language; if the value is SQL {@code NULL}, + * the result is {@code false} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BOOLEAN value + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BOOLEAN} value * @see #getBoolean(int) */ public boolean getBoolean(String columnName) throws SQLException { @@ -1511,19 +1515,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte value. + * of the current row as a {@code byte} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The - * bold type designates the recommended return type + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT}, + * {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} + * value. The bold type designates the recommended return type. */ public byte getByte(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1531,19 +1535,20 @@ /** * Retrieves the value stored in the designated column - * of the current row as a short value. + * of the current row as a {@code short} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT,} + * {@code SMALLINT}, {@code INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(int) */ public short getShort(String columnName) throws SQLException { @@ -1552,20 +1557,21 @@ /** * Retrieves the value stored in the designated column - * of the current row as an int value. + * of the current row as an {@code int} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name - * of a column in this rowset, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * of a column in this rowset, + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1573,19 +1579,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a long value. + * of the current row as a {@code long} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getLong(int) */ public long getLong(String columnName) throws SQLException { @@ -1594,19 +1600,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a float value. + * of the current row as a {@code float} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT,} {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(String columnName) throws SQLException { @@ -1615,20 +1621,20 @@ /** * Retrieves the value stored in the designated column - * of the current row of this CachedRowSetImpl object - * as a double value. + * of the current row of this {@code CachedRowSetImpl} object + * as a {@code double} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return types. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL,} {@code FLOAT, DOUBLE}, {@code DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return types. * @see #getDouble(int) */ public double getDouble(String columnName) throws SQLException { @@ -1637,22 +1643,22 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.math.BigDecimal object. + * of the current row as a {@code java.math.BigDecimal} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @param scale the number of digits to the right of the decimal point - * @return a java.math.BugDecimal object with scale - * number of digits to the right of the decimal point. + * @return a java.math.BugDecimal object with {@code scale} + * number of digits to the right of the decimal point. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve. - * @deprecated Use the getBigDecimal(String columnName) + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. + * @deprecated Use the {@code getBigDecimal(String columnName)} * method instead */ @Deprecated @@ -1662,19 +1668,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte array. + * of the current row as a {@code byte} array. * The bytes represent the raw values returned by the driver. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BINARY, VARBINARY - * or LONGVARBINARY values - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BINARY, VARBINARY} + * or {@code LONGVARBINARY} values. + * The bold SQL type designates the recommended return type. * @see #getBytes(int) */ public byte[] getBytes(String columnName) throws SQLException { @@ -1683,17 +1689,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Date object. + * of the current row as a {@code java.sql.Date} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1701,12 +1707,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Time object. + * of the current row as a {@code java.sql.Time} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1717,12 +1723,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Timestamp object. + * of the current row as a {@code java.sql.Timestamp} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1733,32 +1739,32 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The - * SyncProvider will rely on the JDBC driver to do any necessary + * suitable for retrieving large {@code LONGVARCHAR} values. The + * {@code SyncProvider} will rely on the JDBC driver to do any necessary * conversion from the database format into ASCII format. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * a column in this rowset + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(int) */ public java.io.InputStream getAsciiStream(String columnName) throws SQLException { @@ -1769,23 +1775,23 @@ /** * A column value can be retrieved as a stream of Unicode characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will do any necessary conversion from the database * format into Unicode. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row - * @deprecated use the method getCharacterStream instead + * @deprecated use the method {@code getCharacterStream} instead */ @Deprecated public java.io.InputStream getUnicodeStream(String columnName) throws SQLException { @@ -1794,30 +1800,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of uninterpreted bytes. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is unknown, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY - * The bold type indicates the SQL type that this method is recommened - * to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY} + * The bold type indicates the SQL type that this method is recommened + * to retrieve. * @see #getBinaryStream(int) * */ @@ -1831,17 +1837,17 @@ //===================================================================== /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by statement + * by {@code ResultSet} methods. Any warning caused by statement * methods (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * * @return the first SQLWarning or null */ @@ -1850,10 +1856,10 @@ } /** - * Clears all the warnings reporeted for the CachedRowSetImpl - * object. After a call to this method, the getWarnings method - * returns null until a new warning is reported for this - * CachedRowSetImpl object. + * Clears all the warnings reporeted for the {@code CachedRowSetImpl} + * object. After a call to this method, the {@code getWarnings} method + * returns {@code null} until a new warning is reported for this + * {@code CachedRowSetImpl} object. */ public void clearWarnings() { throw new UnsupportedOperationException(); @@ -1861,25 +1867,25 @@ /** * Retrieves the name of the SQL cursor used by this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * * In SQL, a result table is retrieved through a cursor that is - * named. The current row of a ResultSet can be updated or deleted + * named. The current row of a {@code ResultSet} can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To ensure that the cursor has the proper isolation - * level to support an update operation, the cursor's SELECT - * statement should be of the form select for update. - * If the for update clause + * level to support an update operation, the cursor's {@code SELECT} + * statement should be of the form {@code select for update}. + * If the {@code for update} clause * is omitted, positioned updates may fail. * * JDBC supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. The current row + * SQL cursor used by a {@code ResultSet} object. The current row * of a result set is also the current row of this SQL cursor. * * Note: If positioned updates are not supported, an - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL cursor name for this CachedRowSetImpl object's + * @return the SQL cursor name for this {@code CachedRowSetImpl} object's * cursor * @throws SQLException if an error occurs */ @@ -1888,12 +1894,12 @@ } /** - * Retrieves a ResultSetMetaData object instance that - * contains information about the CachedRowSet object. + * Retrieves a {@code ResultSetMetaData} object instance that + * contains information about the {@code CachedRowSet} object. * However, applications should cast the returned object to a - * RowSetMetaData interface implementation. In the + * {@code RowSetMetaData} interface implementation. In the * reference implementation, this cast can be done on the - * RowSetMetaDataImpl class. + * {@code RowSetMetaDataImpl} class. * * For example: * @@ -1907,10 +1913,10 @@ * crs.setMetaData(metaData); * * - * @return the ResultSetMetaData object that describes this - * CachedRowSetImpl object's columns + * @return the {@code ResultSetMetaData} object that describes this + * {@code CachedRowSetImpl} object's columns * @throws SQLException if an error occurs in generating the RowSet - * meta data; or if the CachedRowSetImpl is empty. + * meta data; or if the {@code CachedRowSetImpl} is empty. * @see javax.sql.RowSetMetaData */ public ResultSetMetaData getMetaData() throws SQLException { @@ -1920,10 +1926,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1931,23 +1937,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes in the Java programming language. * When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(String) */ public Object getObject(int columnIndex) throws SQLException { @@ -1956,10 +1962,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1967,23 +1973,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes * in the Java programming language. When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name does not match one of * this rowset's column names, (2) the cursor is not * on a valid row, or (3) there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(int) */ public Object getObject(String columnName) throws SQLException { @@ -1993,10 +1999,10 @@ //---------------------------------------------------------------- /** - * Maps the given column name for one of this CachedRowSetImpl + * Maps the given column name for one of this {@code CachedRowSetImpl} * object's columns to its column number. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @return the column index of the given column name * @throws SQLException if the given column name does not match one @@ -2014,25 +2020,25 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java character stream that delivers the database column value * as a stream of two-byte unicode characters in a - * java.io.Reader object. If the value is - * SQL NULL, the result is null. + * {@code java.io.Reader} object. If the value is + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR,} {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getCharacterStream(String) */ public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{ @@ -2041,23 +2047,24 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY or LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code CHAR, VARCHAR,} + * {@code LONGVARCHAR}, + * {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -2065,21 +2072,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return types that this method is used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return types that this method is used to retrieve. * @see #getBigDecimal(String) */ public BigDecimal getBigDecimal(int columnIndex) throws SQLException { @@ -2088,21 +2096,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. * @see #getBigDecimal(int) */ public BigDecimal getBigDecimal(String columnName) throws SQLException { @@ -2114,7 +2122,7 @@ //--------------------------------------------------------------------- /** - * Returns the number of rows in this CachedRowSetImpl object. + * Returns the number of rows in this {@code CachedRowSetImpl} object. * * @return number of rows in the rowset */ @@ -2124,10 +2132,10 @@ /** * Indicates whether the cursor is before the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is before the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isBeforeFirst() throws SQLException { @@ -2136,10 +2144,10 @@ /** * Indicates whether the cursor is after the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is after the last row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isAfterLast() throws SQLException { @@ -2148,10 +2156,10 @@ /** * Indicates whether the cursor is on the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is on the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isFirst() throws SQLException { @@ -2160,14 +2168,14 @@ /** * Indicates whether the cursor is on the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * Note: Calling the method isLast may be expensive + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver might need to fetch ahead one row in order * to determine whether the current row is the last row in this rowset. * - * @return true if the cursor is on the last row; - * false otherwise or if this rowset contains no rows + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise or if this rowset contains no rows * @throws SQLException if an error occurs */ public boolean isLast() throws SQLException { @@ -2175,19 +2183,19 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the front of + * Moves this {@code CachedRowSetImpl} object's cursor to the front of * the rowset, just before the first row. This method has no effect if * this rowset contains no rows. * * @throws SQLException if an error occurs or the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public void beforeFirst() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the end of + * Moves this {@code CachedRowSetImpl} object's cursor to the end of * the rowset, just after the last row. This method has no effect if * this rowset contains no rows. * @@ -2198,34 +2206,34 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the first row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the first row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean first() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the first - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the first + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the methods first, - * isFirst, and absolute. - * It in turn calls the method internalNext in order to + * This method is called internally by the methods {@code first}, + * {@code isFirst}, and {@code absolute}. + * It in turn calls the method {@code internalNext} in order to * handle the case where the first row is a deleted row that is not visible. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the first row; - * false otherwise + * @return {@code true} if the cursor moved to the first row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalFirst() throws SQLException { @@ -2233,35 +2241,35 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the last row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the last row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean last() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the last - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the last + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the method last + * This method is called internally by the method {@code last} * when rows have been deleted and the deletions are not visible. - * The method internalLast handles the case where the + * The method {@code internalLast} handles the case where the * last row is a deleted row that is not visible by in turn calling - * the method internalPrevious. + * the method {@code internalPrevious}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the last row; - * false otherwise + * @return {@code true} if the cursor moved to the last row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalLast() throws SQLException { @@ -2269,12 +2277,12 @@ } /** - * Returns the number of the current row in this CachedRowSetImpl + * Returns the number of the current row in this {@code CachedRowSetImpl} * object. The first row is number 1, the second number 2, and so on. * - * @return the number of the current row; 0 if there is no + * @return the number of the current row; {@code 0} if there is no * current row - * @throws SQLException if an error occurs; or if the CacheRowSetImpl + * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl} * is empty */ public int getRow() throws SQLException { @@ -2282,51 +2290,51 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the row number + * Moves this {@code CachedRowSetImpl} object's cursor to the row number * specified. * * If the number is positive, the cursor moves to an absolute row with * respect to the beginning of the rowset. The first row is row 1, the second * is row 2, and so on. For example, the following command, in which - * crs is a CachedRowSetImpl object, moves the cursor + * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor * to the fourth row, starting from the beginning of the rowset. - * + * {@code * * crs.absolute(4); * - * + * } * * If the number is negative, the cursor moves to an absolute row position * with respect to the end of the rowset. For example, calling - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row, counting * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. * * @param row a positive number to indicate the row, starting row numbering from - * the first row, which is 1; a negative number to indicate + * the first row, which is {@code 1}; a negative number to indicate * the row, starting row numbering from the last row, which is - * -1; it must not be 0 - * @return true if the cursor is on the rowset; false + * {@code -1}; it must not be {@code 0} + * @return {@code true} if the cursor is on the rowset; {@code false} * otherwise - * @throws SQLException if the given cursor position is 0 or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * @throws SQLException if the given cursor position is {@code 0} or the + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean absolute( int row ) throws SQLException { throw new UnsupportedOperationException(); @@ -2340,80 +2348,80 @@ * If the number is positive, the cursor moves the specified number of * rows toward the end of the rowset, starting at the current row. * For example, the following command, in which - * crs is a CachedRowSetImpl object with 100 rows, + * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows, * moves the cursor forward four rows from the current row. If the * current row is 50, the cursor would move to row 54. - * + * {@code * * crs.relative(4); * - * + * } * * If the number is negative, the cursor moves back toward the beginning * the specified number of rows, starting at the current row. * For example, calling the method - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. In both cases, this method - * throws an SQLException. + * throws an {@code SQLException}. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). Calling relative(0) + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. Calling {@code relative(0)} * is valid, but it does not change the cursor position. * - * @param rows an int indicating the number of rows to move + * @param rows an {@code int} indicating the number of rows to move * the cursor, starting at the current row; a positive number * moves the cursor forward; a negative number moves the cursor * backward; must not move the cursor past the valid * rows - * @return true if the cursor is on a row in this - * CachedRowSetImpl object; false + * @return {@code true} if the cursor is on a row in this + * {@code CachedRowSetImpl} object; {@code false} * otherwise * @throws SQLException if there are no rows in this rowset, the cursor is * positioned either before the first row or after the last row, or - * the rowset is type ResultSet.TYPE_FORWARD_ONLY + * the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean relative(int rows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the - * previous row and returns true if the cursor is on - * a valid row or false if it is not. + * Moves this {@code CachedRowSetImpl} object's cursor to the + * previous row and returns {@code true} if the cursor is on + * a valid row or {@code false} if it is not. * This method also notifies all listeners registered with this - * CachedRowSetImpl object that its cursor has moved. + * {@code CachedRowSetImpl} object that its cursor has moved. * - * Note: calling the method previous() is not the same - * as calling the method relative(-1). This is true - * because it is possible to call previous() from the insert + * Note: calling the method {@code previous()} is not the same + * as calling the method {@code relative(-1)}. This is true + * because it is possible to call {@code previous()} from the insert * row, from after the last row, or from the current row, whereas - * relative may only be called from the current row. + * {@code relative} may only be called from the current row. * - * The method previous may used in a while + * The method {@code previous} may used in a {@code while} * loop to iterate through a rowset starting after the last row - * and moving toward the beginning. The loop ends when previous - * returns false, meaning that there are no more rows. + * and moving toward the beginning. The loop ends when {@code previous} + * returns {@code false}, meaning that there are no more rows. * For example, the following code fragment retrieves all the data in - * the CachedRowSetImpl object crs, which has + * the {@code CachedRowSetImpl} object {@code crs}, which has * three columns. Note that the cursor must initially be positioned * after the last row so that the first call to the method - * previous places the cursor on the last line. - * + * {@code previous} places the cursor on the last line. + * {@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - * - * This method throws an SQLException if the cursor is not + * } + * This method throws an {@code SQLException} if the cursor is not * on a row in the rowset, before the first row, or after the last row. * - * @return true if the cursor is on a valid row; - * false if it is before the first row or after the + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is before the first row or after the * last row * @throws SQLException if the cursor is not on a valid position or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean previous() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor to the previous row in this CachedRowSetImpl + * Moves the cursor to the previous row in this {@code CachedRowSetImpl} * object, skipping past deleted rows that are not visible; returns - * true if the cursor is on a row in this rowset and - * false when the cursor goes before the first row. + * {@code true} if the cursor is on a row in this rowset and + * {@code false} when the cursor goes before the first row. * - * This method is called internally by the method previous. + * This method is called internally by the method {@code previous}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a row in this rowset; - * false when the cursor reaches the position before + * @return {@code true} if the cursor is on a row in this rowset; + * {@code false} when the cursor reaches the position before * the first row * @throws SQLException if an error occurs */ @@ -2463,14 +2471,14 @@ //--------------------------------------------------------------------- /** - * Indicates whether the current row of this CachedRowSetImpl + * Indicates whether the current row of this {@code CachedRowSetImpl} * object has been updated. The value returned - * depends on whether this rowset can detect updates: false + * depends on whether this rowset can detect updates: {@code false} * will always be returned if it does not detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another and updates are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2482,13 +2490,13 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * * @param idx the index identifier of the column that may be have been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2500,14 +2508,14 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * - * @param columnName the String column name column that may be have + * @param columnName the {@code String} column name column that may be have * been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2521,8 +2529,8 @@ * Indicates whether the current row has been inserted. The value returned * depends on whether or not the rowset can detect visible inserts. * - * @return true if a row has been inserted and inserts are detected; - * false otherwise + * @return {@code true} if a row has been inserted and inserts are detected; + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2536,12 +2544,12 @@ * Indicates whether the current row has been deleted. A deleted row * may leave a visible "hole" in a rowset. This method can be used to * detect such holes if the rowset can detect deletions. This method - * will always return false if this rowset cannot detect + * will always return {@code false} if this rowset cannot detect * deletions. * - * @return true if (1)the current row is blank, indicating that + * @return {@code true} if (1)the current row is blank, indicating that * the row has been deleted, and (2)deletions are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on a valid row in this rowset * @see DatabaseMetaData#deletesAreDetected */ @@ -2551,8 +2559,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset; however, another method must be called to complete @@ -2565,15 +2573,15 @@ * * In order to propagate updates in this rowset to the underlying * data source, an application must call the method {@link #acceptChanges} - * after it calls either updateRow or insertRow. + * after it calls either {@code updateRow} or {@code insertRow}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -2581,8 +2589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2593,14 +2601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(int columnIndex, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -2608,8 +2616,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2620,14 +2628,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(int columnIndex, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -2635,8 +2643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2647,14 +2655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(int columnIndex, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -2662,8 +2670,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2674,14 +2682,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(int columnIndex, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -2689,8 +2697,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2701,14 +2709,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(int columnIndex, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -2717,8 +2725,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2729,14 +2737,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(int columnIndex, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -2744,8 +2752,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2756,14 +2764,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(int columnIndex, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -2771,8 +2779,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2783,14 +2791,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -2798,8 +2806,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2810,17 +2818,17 @@ * as inserted. Both of these methods must be called before the * cursor moves to another row. * - * The method acceptChanges must be called if the + * The method {@code acceptChanges} must be called if the * updated values are to be written back to the underlying database. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(int columnIndex, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -2828,8 +2836,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2840,14 +2848,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(int columnIndex, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -2855,8 +2863,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2867,15 +2875,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(int columnIndex, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -2883,8 +2891,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2895,15 +2903,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL TIME or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code TIME} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(int columnIndex, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -2911,8 +2919,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2923,16 +2931,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE, TIME, or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE}, {@code TIME}, or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -2940,7 +2948,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -2952,8 +2960,8 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -2965,8 +2973,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2977,17 +2985,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not binary, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException { throw new UnsupportedOperationException(); @@ -2995,8 +3003,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3007,19 +3015,19 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.Reader - * containing BINARY, VARBINARY, - * LONGVARBINARY, CHAR, VARCHAR, - * or LONGVARCHAR data + * @param x the new column value; must be a {@code java.io.Reader} + * containing {@code BINARY}, {@code VARBINARY}, + * {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR}, + * or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not a binary or * character type, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3027,11 +3035,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter indicates + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter indicates * the number of digits to the right of the decimal point and is ignored * if the new column value is not a type that will be mapped to an SQL - * DECIMAL or NUMERIC value. + * {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3042,16 +3050,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3059,8 +3067,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3071,14 +3079,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x) throws SQLException { throw new UnsupportedOperationException(); @@ -3087,8 +3095,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3098,12 +3106,12 @@ * must be called, which will insert the new row into both this rowset * and the database. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -3111,8 +3119,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3123,13 +3131,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(String columnName, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -3137,8 +3145,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3149,13 +3157,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(String columnName, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -3163,8 +3171,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3175,13 +3183,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(String columnName, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -3189,8 +3197,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3201,13 +3209,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(String columnName, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -3215,8 +3223,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3227,13 +3235,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(String columnName, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -3241,8 +3249,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3253,13 +3261,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(String columnName, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -3267,8 +3275,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3279,13 +3287,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(String columnName, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -3293,8 +3301,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3305,13 +3313,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -3319,8 +3327,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3331,13 +3339,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(String columnName, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -3345,8 +3353,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3357,13 +3365,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(String columnName, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -3371,8 +3379,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3383,15 +3391,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(String columnName, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -3399,8 +3407,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3411,15 +3419,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL TIME or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code TIME} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(String columnName, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -3427,8 +3435,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3439,7 +3447,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if the given column index is out of bounds or @@ -3448,9 +3456,9 @@ * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE, - * TIME, or TIMESTAMP, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP}, or (4) this + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -3458,7 +3466,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -3470,7 +3478,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -3483,8 +3491,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3495,17 +3503,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not binary, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3513,8 +3521,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3525,18 +3533,18 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param reader the new column value; must be a - * java.io.Reader containing BINARY, - * VARBINARY, LONGVARBINARY, CHAR, - * VARCHAR, or LONGVARCHAR data + * {@code java.io.Reader} containing {@code BINARY}, + * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR}, + * {@code VARCHAR}, or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not a binary or character type, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(String columnName, java.io.Reader reader, @@ -3546,11 +3554,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter * indicates the number of digits to the right of the decimal point * and is ignored if the new column value is not a type that will be - * mapped to an SQL DECIMAL or NUMERIC value. + * mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3561,15 +3569,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3577,8 +3585,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3589,20 +3597,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x) throws SQLException { throw new UnsupportedOperationException(); } /** - * Inserts the contents of this CachedRowSetImpl object's insert + * Inserts the contents of this {@code CachedRowSetImpl} object's insert * row into this rowset immediately following the current row. * If the current row is the * position after the last row or before the first row, the new row will @@ -3614,14 +3622,14 @@ * @throws SQLException if (1) the cursor is not on the insert row, * (2) one or more of the non-nullable columns in the insert * row has not been given a value, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void insertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Marks the current row of this CachedRowSetImpl object as + * Marks the current row of this {@code CachedRowSetImpl} object as * updated and notifies listeners registered with this rowset that the * row has changed. * @@ -3631,26 +3639,26 @@ * and the updates made before the cursor moved will be lost. * * @throws SQLException if the cursor is on the insert row or this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Deletes the current row from this CachedRowSetImpl object and + * Deletes the current row from this {@code CachedRowSetImpl} object and * notifies listeners registered with this rowset that a row has changed. * This method cannot be called when the cursor is on the insert row. * * This method marks the current row as deleted, but it does not delete * the row from the underlying data source. The method - * acceptChanges must be called to delete the row in + * {@code acceptChanges} must be called to delete the row in * the data source. * * @throws SQLException if (1) this method is called when the cursor * is on the insert row, before the first row, or after the * last row or (2) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void deleteRow() throws SQLException { throw new UnsupportedOperationException(); @@ -3659,7 +3667,7 @@ /** * Sets the current row with its original value and marks the row as * not updated, thus undoing any changes made to the row since the - * last call to the methods updateRow or deleteRow. + * last call to the methods {@code updateRow} or {@code deleteRow}. * This method should be called only when the cursor is on a row in * this rowset. * @@ -3672,11 +3680,11 @@ /** * Rolls back any updates made to the current row of this - * CachedRowSetImpl object and notifies listeners that + * {@code CachedRowSetImpl} object and notifies listeners that * a row has changed. To have an effect, this method - * must be called after an updateXXX method has been - * called and before the method updateRow has been called. - * If no updates have been made or the method updateRow + * must be called after an {@code updateXXX} method has been + * called and before the method {@code updateRow} has been called. + * If no updates have been made or the method {@code updateRow} * has already been called, this method has no effect. * * @throws SQLException if the cursor is on the insert row, before the @@ -3687,39 +3695,39 @@ } /** - * Moves the cursor for this CachedRowSetImpl object + * Moves the cursor for this {@code CachedRowSetImpl} object * to the insert row. The current row in the rowset is remembered * while the cursor is on the insert row. * * The insert row is a special row associated with an updatable * rowset. It is essentially a buffer where a new row may - * be constructed by calling the appropriate updateXXX + * be constructed by calling the appropriate {@code updateXXX} * methods to assign a value to each column in the row. A complete * row must be constructed; that is, every column that is not nullable * must be assigned a value. In order for the new row to become part - * of this rowset, the method insertRow must be called + * of this rowset, the method {@code insertRow} must be called * before the cursor is moved back to the rowset. * * Only certain methods may be invoked while the cursor is on the insert * row; many methods throw an exception if they are called while the - * cursor is there. In addition to the updateXXX - * and insertRow methods, only the getXXX methods - * may be called when the cursor is on the insert row. A getXXX - * method should be called on a column only after an updateXXX + * cursor is there. In addition to the {@code updateXXX} + * and {@code insertRow} methods, only the {@code getXXX} methods + * may be called when the cursor is on the insert row. A {@code getXXX} + * method should be called on a column only after an {@code updateXXX} * method has been called on that column; otherwise, the value returned is * undetermined. * - * @throws SQLException if this CachedRowSetImpl object is - * ResultSet.CONCUR_READ_ONLY + * @throws SQLException if this {@code CachedRowSetImpl} object is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void moveToInsertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor for this CachedRowSetImpl object to + * Moves the cursor for this {@code CachedRowSetImpl} object to * the current row. The current row is the row the cursor was on - * when the method moveToInsertRow was called. + * when the method {@code moveToInsertRow} was called. * * Calling this method has no effect unless it is called while the * cursor is on the insert row. @@ -3731,9 +3739,9 @@ } /** - * Returns null. + * Returns {@code null}. * - * @return null + * @return {@code null} * @throws SQLException if an error occurs */ public Statement getStatement() throws SQLException { @@ -3742,18 +3750,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column index is out of bounds or * the cursor is not on one of this rowset's rows or its * insert row @@ -3767,17 +3775,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL REF value + * SQL {@code REF} value * @see #getRef(String) */ public Ref getRef(int columnIndex) throws SQLException { @@ -3786,17 +3794,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BLOB value + * SQL {@code BLOB} value * @see #getBlob(String) */ public Blob getBlob(int columnIndex) throws SQLException { @@ -3805,17 +3813,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Clob object representing an SQL CLOB value + * @return a {@code Clob} object representing an SQL {@code CLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL CLOB value + * SQL {@code CLOB} value * @see #getClob(String) */ public Clob getClob(int columnIndex) throws SQLException { @@ -3824,18 +3832,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL ARRAY value + * SQL {@code ARRAY} value * @see #getArray(String) */ public Array getArray(int columnIndex) throws SQLException { @@ -3844,17 +3852,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column name is not the name of * a column in this rowset or the cursor is not on one of * this rowset's rows or its insert row @@ -3867,16 +3875,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the column value - * is not an SQL REF value + * is not an SQL {@code REF} value * @see #getRef(int) */ public Ref getRef(String colName) throws SQLException { @@ -3885,16 +3893,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BLOB value + * column does not store an SQL {@code BLOB} value * @see #getBlob(int) */ public Blob getBlob(String colName) throws SQLException { @@ -3903,17 +3911,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Clob object representing an SQL - * CLOB value + * @return a {@code Clob} object representing an SQL + * {@code CLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CLOB value + * column does not store an SQL {@code CLOB} value * @see #getClob(int) */ public Clob getClob(String colName) throws SQLException { @@ -3922,17 +3930,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming langugage. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL ARRAY value + * column does not store an SQL {@code ARRAY} value * @see #getArray(int) */ public Array getArray(String colName) throws SQLException { @@ -3941,22 +3949,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3964,21 +3972,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3986,22 +3994,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4009,21 +4017,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4031,22 +4039,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Timestamp - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4054,22 +4062,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object, using the given - * Calendar object to construct an appropriate + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object, using the given + * {@code Calendar} object to construct an appropriate * millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE, - * TIME, or TIMESTAMP value + * column does not store an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4080,13 +4088,13 @@ */ /** - * Retrieves the Connection object passed to this - * CachedRowSetImpl object. This connection may be + * Retrieves the {@code Connection} object passed to this + * {@code CachedRowSetImpl} object. This connection may be * used to populate this rowset with data or to write data back * to its underlying data source. * - * @return the Connection object passed to this rowset; - * may be null if there is no connection + * @return the {@code Connection} object passed to this rowset; + * may be {@code null} if there is no connection * @throws SQLException if an error occurs */ public Connection getConnection() throws SQLException{ @@ -4094,10 +4102,10 @@ } /** - * Sets the metadata for this CachedRowSetImpl object - * with the given RowSetMetaData object. + * Sets the metadata for this {@code CachedRowSetImpl} object + * with the given {@code RowSetMetaData} object. * - * @param md a RowSetMetaData object instance containing + * @param md a {@code RowSetMetaData} object instance containing * metadata about the columsn in the rowset * @throws SQLException if invalid meta data is supplied to the * rowset @@ -4108,17 +4116,17 @@ /** * Returns a result set containing the original value of the rowset. The - * original value is the state of the CachedRowSetImpl after the + * original value is the state of the {@code CachedRowSetImpl} after the * last population or synchronization (whichever occurred most recently) with * the data source. * * The cursor is positioned before the first row in the result set. - * Only rows contained in the result set returned by getOriginal() + * Only rows contained in the result set returned by {@code getOriginal()} * are said to have an original value. * * @return the original result set of the rowset * @throws SQLException if an error occurs produce the - * ResultSet object + * {@code ResultSet} object */ public ResultSet getOriginal() throws SQLException { throw new UnsupportedOperationException(); @@ -4127,7 +4135,7 @@ /** * Returns a result set containing the original value of the current * row only. - * The original value is the state of the CachedRowSetImpl after + * The original value is the state of the {@code CachedRowSetImpl} after * the last population or synchronization (whichever occurred most recently) * with the data source. * @@ -4153,7 +4161,7 @@ /** * Marks all rows in this rowset as being original rows. Any updates * made to the rows become the original values for the rowset. - * Calls to the method setOriginal connot be reversed. + * Calls to the method {@code setOriginal} connot be reversed. * * @throws SQLException if an error occurs */ @@ -4165,8 +4173,8 @@ * Returns an identifier for the object (table) that was used to create this * rowset. * - * @return a String object that identifies the table from - * which this CachedRowSetImpl object was derived + * @return a {@code String} object that identifies the table from + * which this {@code CachedRowSetImpl} object was derived * @throws SQLException if an error occurs */ public String getTableName() throws SQLException { @@ -4177,8 +4185,8 @@ * Sets the identifier for the table from which this rowset was derived * to the given table name. * - * @param tabName a String object that identifies the - * table from which this CachedRowSetImpl object + * @param tabName a {@code String} object that identifies the + * table from which this {@code CachedRowSetImpl} object * was derived * @throws SQLException if an error occurs */ @@ -4188,7 +4196,7 @@ /** * Returns the columns that make a key to uniquely identify a - * row in this CachedRowSetImpl object. + * row in this {@code CachedRowSetImpl} object. * * @return an array of column numbers that constitutes a primary * key for this rowset. This array should be empty @@ -4203,16 +4211,16 @@ /** - * Sets this CachedRowSetImpl object's - * keyCols field with the given array of column + * Sets this {@code CachedRowSetImpl} object's + * {@code keyCols} field with the given array of column * numbers, which forms a key for uniquely identifying a row * in this rowset. * - * @param keys an array of int indicating the + * @param keys an array of {@code int} indicating the * columns that form a primary key for this - * CachedRowSetImpl object; every + * {@code CachedRowSetImpl} object; every * element in the array must be greater than - * 0 and less than or equal to the number + * {@code 0} and less than or equal to the number * of columns in this rowset * @throws SQLException if any of the numbers in the * given array is not valid for this rowset @@ -4224,8 +4232,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4236,14 +4244,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4251,8 +4259,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4263,13 +4271,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4277,8 +4285,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4289,14 +4297,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + *
or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnIndex the first column is 1, the second 2, ... @@ -4569,10 +4569,10 @@ } /** - * Updates the designated column with a RowId value. The updater + * Updates the designated column with a {@code RowId} value. The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4631,8 +4631,8 @@ /*o - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnIndex the first column is 1, the second 2, ... * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4643,8 +4643,8 @@ } /** - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnName name of the column * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4656,12 +4656,12 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param i the first column is 1, the second is 2, ... - * @return a NClob object representing the SQL - * NCLOB value in the specified column + * @return a {@code NClob} object representing the SQL + * {@code NCLOB} value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4672,11 +4672,11 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param colName the name of the column from which to retrieve the value - * @return a NClob object representing the SQL NCLOB + * @return a {@code NClob} object representing the SQL {@code NCLOB} * value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 @@ -4694,10 +4694,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * SQL {@code XML} value when it sends it to the database. * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an SQL {@code XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4706,10 +4706,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * {@code SQL XML} value when it sends it to the database. * @param parameterName the name of the parameter - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an {@code SQL XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4718,8 +4718,8 @@ } /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID value when it sends it + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} value when it sends it * to the database * * @param parameterIndex the first parameter is 1, the second is 2, ... @@ -4732,9 +4732,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID when it sends it to the + /** + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} when it sends it to the * database. * * @param parameterName the name of the parameter @@ -4748,18 +4748,18 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR value + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on NVARCHAR values) + * size relative to the driver's limits on {@code NVARCHAR} values) * when it sends it to the database. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNString(int parameterIndex, String value) throws SQLException { @@ -4768,9 +4768,9 @@ /** - * Sets the designated parameter in this RowSet object's command - * to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter in this {@code RowSet} object's command + * to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -4779,14 +4779,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed PreparedStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -4795,14 +4795,14 @@ } /** - * Sets the designated parameter to a java.sql.NClob object. The object - * implements the java.sql.NClob interface. This NClob - * object maps to a SQL NCLOB. + * Sets the designated parameter to a {@code java.sql.NClob} object. The object + * implements the {@code java.sql.NClob} interface. This {@code NClob} + * object maps to a SQL {@code NCLOB}. * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(String parameterName, NClob value) throws SQLException { @@ -4810,17 +4810,17 @@ } - /** + /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @exception SQLException if a database access error occurs * @since 1.6 @@ -4832,16 +4832,16 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the name of the column - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4850,11 +4850,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * @param columnIndex the first column is 1, the second 2, ... * @param xmlObject the value for the column to be updated @@ -4866,11 +4866,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4884,15 +4884,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnIndex the first column is 1, the second is 2, ... - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4902,15 +4902,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4927,9 +4927,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnIndex - the first column is 1, the second is 2, ... - * @param x - the new column value - * @param length - the length of the stream + * @param columnIndex the first column is 1, the second is 2, ... + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4949,9 +4949,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnName - name of the Column - * @param x - the new column value - * @param length - the length of the stream + * @param columnName name of the Column + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4963,26 +4963,27 @@ } /** - * Updates the designated column with a character stream value. The + * Updates the designated column with a character stream value. The * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} or this + * method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -4997,26 +4998,27 @@ * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * the result set concurrency is {@code CONCUR_READ_ONLY} or + * this method is called on a closed result set + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method * @since 1.6 */ public void updateNCharacterStream(String columnLabel, @@ -5027,9 +5029,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5039,16 +5041,16 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5060,9 +5062,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5072,18 +5074,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, + * then the label is the name of the column. * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException { @@ -5092,9 +5096,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5102,23 +5106,23 @@ * Java stream object or your own subclass that implements the * standard interface. * - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException { @@ -5127,9 +5131,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5138,22 +5142,23 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException { @@ -5161,11 +5166,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5175,17 +5180,17 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5193,11 +5198,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5207,17 +5212,18 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5225,33 +5231,33 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader) throws SQLException { @@ -5259,34 +5265,35 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader) throws SQLException { @@ -5294,11 +5301,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5308,19 +5315,19 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5328,11 +5335,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5342,19 +5349,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5362,11 +5370,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5375,22 +5383,22 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader) throws SQLException { @@ -5398,11 +5406,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5411,23 +5419,24 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader) throws SQLException { @@ -5435,22 +5444,22 @@ } - /** + /** * Updates the designated column with an ascii stream value, which will have * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5464,17 +5473,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBinaryStream(int columnIndex, @@ -5488,17 +5497,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5512,17 +5521,19 @@ * the specified number of bytes.. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5535,20 +5546,20 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5560,21 +5571,22 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5588,15 +5600,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5611,18 +5625,18 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5637,19 +5651,20 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5665,18 +5680,20 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5689,20 +5706,20 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5714,22 +5731,23 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5738,97 +5756,98 @@ } - /** - * Sets the designated parameter to the given java.net.URL value. - * The driver converts this to an SQL DATALINK value - * when it sends it to the database. - * - * @param parameterIndex the first parameter is 1, the second is 2, ... - * @param x the java.net.URL object to be set - * @exception SQLException if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.4 - */ + /** + * Sets the designated parameter to the given {@code java.net.URL} value. + * The driver converts this to an SQL {@code DATALINK} value + * when it sends it to the database. + * + * @param parameterIndex the first parameter is 1, the second is 2, ... + * @param x the {@code java.net.URL} object to be set + * @exception SQLException if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * @since 1.4 + */ public void setURL(int parameterIndex, java.net.URL x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB - * Note: Consult your JDBC driver documentation to determine if - * it might be more efficient to use a version of - * setNClob which takes a length parameter. - * - * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param reader An object that contains the data to set the parameter value to. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * - * @since 1.6 - */ + /** + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * Note: Consult your JDBC driver documentation to determine if + * it might be more efficient to use a version of + * {@code setNClob} which takes a length parameter. + * + * @param parameterIndex index of the first parameter is 1, the second is 2, ... + * @param reader An object that contains the data to set the parameter value to. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * + * @since 1.6 + */ public void setNClob(int parameterIndex, Reader reader) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB - * - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national - * character sets; if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * @since 1.6 - */ - public void setNClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. + * The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national + * character sets; if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * @since 1.6 + */ + public void setNClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); - } + } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNClob which takes a length parameter. + * {@code setNClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5839,23 +5858,24 @@ } - /** - ** of characters specified by length otherwise a SQLException will becontain the number - * generated when the PreparedStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method + /** + * of characters specified by length otherwise a {@code SQLException} will becontain the number + * generated when the {@code PreparedStatement} is executed. + * This method differs from the {@code setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5867,14 +5887,14 @@ /** - * Sets the designated parameter to a java.sql.NClob object. The driver converts this to -a - * SQL NCLOB value when it sends it to the database. + * Sets the designated parameter to a {@code java.sql.NClob} object. + * The driver converts this to an + * SQL {@code NCLOB} value when it sends it to the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(int parameterIndex, NClob value) throws SQLException{ @@ -5883,14 +5903,14 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNString(String parameterName, String value) @@ -5899,8 +5919,8 @@ } /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... @@ -5908,7 +5928,7 @@ * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException{ @@ -5918,8 +5938,8 @@ /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterName the name of the column to be set @@ -5935,9 +5955,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + /** + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -5946,14 +5966,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed CallableStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -5962,23 +5982,23 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIMESTAMP value, + * Sets the designated parameter to the given {@code java.sql.Timestamp} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIMESTAMP} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the timestamp + * a {@code Calendar} object, the driver can calculate the timestamp * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use - * to construct the timestamp + * @param cal the {@code Calendar} object the driver will use + * to construct the timestamp * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -5987,28 +6007,29 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } @@ -6016,16 +6037,16 @@ /** - * Sets the designated parameter to the given java.sql.Clob object. - * The driver converts this to an SQL CLOB value when it + * Sets the designated parameter to the given {@code java.sql.Clob} object. + * The driver converts this to an SQL {@code CLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Clob object that maps an SQL CLOB value + * @param x a {@code Clob} object that maps an SQL {@code CLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setClob (String parameterName, Clob x) throws SQLException{ @@ -6033,21 +6054,21 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs or this method is called on - * a closed CallableStatement + * a closed {@code CallableStatement} * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6058,19 +6079,19 @@ } - /** - * Sets the designated parameter to the given java.sql.Date value + /** + * Sets the designated parameter to the given {@code java.sql.Date} value * using the default time zone of the virtual machine that is running * the application. * The driver converts this - * to an SQL DATE value when it sends it to the database. + * to an SQL {@code DATE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6080,23 +6101,23 @@ } /** - * Sets the designated parameter to the given java.sql.Date value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL DATE value, + * Sets the designated parameter to the given {@code java.sql.Date} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code DATE} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the date + * a {@code Calendar} object, the driver can calculate the date * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the date * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6107,16 +6128,16 @@ /** - * Sets the designated parameter to the given java.sql.Time value. + * Sets the designated parameter to the given {@code java.sql.Time} value. * The driver converts this - * to an SQL TIME value when it sends it to the database. + * to an SQL {@code TIME} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6126,23 +6147,23 @@ } /** - * Sets the designated parameter to the given java.sql.Time value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIME value, + * Sets the designated parameter to the given {@code java.sql.Time} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIME} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the time + * a {@code Calendar} object, the driver can calculate the time * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the time * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6152,22 +6173,22 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatementor if parameterIndex does not correspond to a parameter - * marker in the SQL statement + * a closed {@code PreparedStatement}or if parameterIndex does not correspond to a parameter + * marker in the SQL statement * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6179,19 +6200,19 @@ /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - *This method differs from the setCharacterStream (int, Reader, int) method + * Sets the designated parameter to a {@code Reader} object. The reader 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 setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatement, if parameterIndex does not correspond to a parameter + * a closed {@code PreparedStatement}, if parameterIndex does not correspond to a parameter * marker in the SQL statement, or if the length specified is less than zero. * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method @@ -6204,25 +6225,26 @@ /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) + * Sets the designated parameter to a {@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)} * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... + * the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement, - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, if the length specified - * is less than zero or if the number of bytes in the inputstream does not match - * the specified length. + * this method is called on a closed {@code PreparedStatement}, + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, if the length specified + * is less than zero or if the number of bytes in the inputstream does not match + * the specified length. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6233,28 +6255,27 @@ } /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) - * This method differs from the setBinaryStream (int, InputStream) + * Sets the designated parameter to a {@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 - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... - - + * the second is 2, ... + * * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement or - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, + * this method is called on a closed {@code PreparedStatement} or + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6264,72 +6285,72 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length, otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) - * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, - * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB - * - * @param parameterName the name of the parameter to be set - * the second is 2, ... - * - * @param inputStream An object that contains the data to set the parameter - * value to. - * @param length the number of bytes in the parameter data. - * @throws SQLException if parameterIndex does not correspond - * to a parameter marker in the SQL statement, or if the length specified - * is less than zero; if the number of bytes in the inputstream does not match - * the specified length; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setBlob(String parameterName, InputStream inputStream, long length) + /** + * Sets the designated parameter to a {@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)} + * 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, + * the driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * + * @param parameterName the name of the parameter to be set + * the second is 2, ... + * + * @param inputStream An object that contains the data to set the parameter + * value to. + * @param length the number of bytes in the parameter data. + * @throws SQLException if parameterIndex does not correspond + * to a parameter marker in the SQL statement, or if the length specified + * is less than zero; if the number of bytes in the inputstream does not match + * the specified length; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.Blob object. - * The driver converts this to an SQL BLOB value when it + /** + * Sets the designated parameter to the given {@code java.sql.Blob} object. + * The driver converts this to an SQL {@code BLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Blob object that maps an SQL BLOB value + * @param x a {@code Blob} object that maps an SQL {@code BLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setBlob (String parameterName, Blob x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) + /** + * Sets the designated parameter to a {@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 BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARBINARY or a BLOB + * data should be send to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterName the name of the parameter * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6339,22 +6360,22 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. The second * argument must be an object type; for integral values, the - * java.lang equivalent objects should be used. + * {@code java.lang} equivalent objects should be used. * * The given Java object will be converted to the given targetSqlType * before being sent to the database. * * If the object has a custom mapping (is of a class implementing the - * interface SQLData), - * the JDBC driver should call the method SQLData.writeSQL to write it + * interface {@code SQLData}), + * the JDBC driver should call the method {@code SQLData.writeSQL} to write it * to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * Note that this method may be used to pass datatabase- @@ -6365,17 +6386,17 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database. The scale argument may further qualify this type. * @param scale for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types, this value will be ignored. + * this is the number of digits after the decimal point. For all other + * types, this value will be ignored. * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see Types * @see #getObject * @since 1.4 @@ -6387,7 +6408,7 @@ /** * Sets the value of the designated parameter with the given object. - * This method is like the method setObject + * This method is like the method {@code setObject} * above, except that it assumes a scale of zero. * * @param parameterName the name of the parameter @@ -6395,14 +6416,14 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see #getObject * @since 1.4 */ @@ -6411,13 +6432,13 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. - * The second parameter must be of type Object; therefore, the - * java.lang equivalent objects should be used for built-in types. + * The second parameter must be of type {@code Object}; therefore, the + * {@code java.lang} equivalent objects should be used for built-in types. * * The JDBC specification specifies a standard mapping from - * Java Object types to SQL types. The given argument + * Java {@code Object} types to SQL types. The given argument * will be converted to the corresponding SQL type before being * sent to the database. * @@ -6425,13 +6446,13 @@ * specific abstract data types, by using a driver-specific Java * type. * - * If the object is of a class implementing the interface SQLData, - * the JDBC driver should call the method SQLData.writeSQL + * If the object is of a class implementing the interface {@code SQLData}, + * the JDBC driver should call the method {@code SQLData.writeSQL} * to write it to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * This method throws an exception if there is an ambiguity, for example, if the @@ -6440,10 +6461,10 @@ * @param parameterName the name of the parameter * @param x the object containing the input parameter value * @exception SQLException if a database access error occurs, - * this method is called on a closed CallableStatement or if the given - * Object parameter is ambiguous + * this method is called on a closed {@code CallableStatement} or if the given + * {@code Object} parameter is ambiguous * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getObject * @since 1.4 */ @@ -6454,9 +6475,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6468,9 +6489,9 @@ * @param x the Java input stream that contains the ASCII parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setAsciiStream(String parameterName, java.io.InputStream x, int length) @@ -6482,9 +6503,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the stream + * {@code java.io.InputStream} object. The data will be read from the stream * as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6495,9 +6516,9 @@ * @param x the java input stream which contains the binary parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBinaryStream(String parameterName, java.io.InputStream x, @@ -6506,11 +6527,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6519,13 +6540,13 @@ * standard interface. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that + * @param reader the {@code java.io.Reader} object that * contains the UNICODE data used as the designated parameter * @param length the number of characters in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setCharacterStream(String parameterName, @@ -6536,9 +6557,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6547,15 +6568,15 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setAsciiStream which takes a length parameter. + * {@code setAsciiStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the Java input stream that contains the ASCII parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.6 - */ + * @since 1.6 + */ public void setAsciiStream(String parameterName, java.io.InputStream x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); @@ -6564,9 +6585,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the + * {@code java.io.InputStream} object. The data will be read from the * stream as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6574,12 +6595,12 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBinaryStream which takes a length parameter. + * {@code setBinaryStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the java input stream which contains the binary parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6589,11 +6610,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6602,13 +6623,13 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setCharacterStream which takes a length parameter. + * {@code setCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that contains the + * @param reader the {@code java.io.Reader} object that contains the * Unicode data * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6619,16 +6640,16 @@ /** * Sets the designated parameter to the given - * java.math.BigDecimal value. - * The driver converts this to an SQL NUMERIC value when + * {@code java.math.BigDecimal} value. + * The driver converts this to an SQL {@code NUMERIC} value when * it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBigDecimal * @since 1.4 */ @@ -6636,20 +6657,20 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java String value. + /** + * Sets the designated parameter to the given Java {@code String} value. * The driver converts this - * to an SQL VARCHAR or LONGVARCHAR value + * to an SQL {@code VARCHAR} or {@code LONGVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on VARCHAR values) + * size relative to the driver's limits on {@code VARCHAR} values) * when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getString * @since 1.4 */ @@ -6659,19 +6680,19 @@ - /** + /** * Sets the designated parameter to the given Java array of bytes. - * The driver converts this to an SQL VARBINARY or - * LONGVARBINARY (depending on the argument's size relative - * to the driver's limits on VARBINARY values) when it sends + * The driver converts this to an SQL {@code VARBINARY} or + * {@code LONGVARBINARY} (depending on the argument's size relative + * to the driver's limits on {@code VARBINARY} values) when it sends * it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBytes * @since 1.4 */ @@ -6680,17 +6701,17 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value. + * Sets the designated parameter to the given {@code java.sql.Timestamp} value. * The driver - * converts this to an SQL TIMESTAMP value when it sends it to the + * converts this to an SQL {@code TIMESTAMP} value when it sends it to the * database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -6700,16 +6721,16 @@ } /** - * Sets the designated parameter to SQL NULL. + * Sets the designated parameter to SQL {@code NULL}. * * Note: You must specify the parameter's SQL type. * * @param parameterName the name of the parameter - * @param sqlType the SQL type code defined in java.sql.Types + * @param sqlType the SQL type code defined in {@code java.sql.Types} * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull(String parameterName, int sqlType) throws SQLException { @@ -6717,8 +6738,8 @@ } /** - * Sets the designated parameter to SQL NULL. - * This version of the method setNull should + * Sets the designated parameter to SQL {@code NULL}. + * This version of the method {@code setNull} should * be used for user-defined types and REF type parameters. Examples * of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and * named array types. @@ -6738,14 +6759,14 @@ * * * @param parameterName the name of the parameter - * @param sqlType a value from java.sql.Types + * @param sqlType a value from {@code java.sql.Types} * @param typeName the fully-qualified name of an SQL user-defined type; * ignored if the parameter is not a user-defined type or - * SQL REF value + * SQL {@code REF} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull (String parameterName, int sqlType, String typeName) @@ -6754,17 +6775,17 @@ } /** - * Sets the designated parameter to the given Java boolean value. + * Sets the designated parameter to the given Java {@code boolean} value. * The driver converts this - * to an SQL BIT or BOOLEAN value when it sends it to the database. + * to an SQL {@code BIT} or {@code BOOLEAN} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @see #getBoolean * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBoolean(String parameterName, boolean x) throws SQLException{ @@ -6774,16 +6795,16 @@ /** - * Sets the designated parameter to the given Java byte value. + * Sets the designated parameter to the given Java {@code byte} value. * The driver converts this - * to an SQL TINYINT value when it sends it to the database. + * to an SQL {@code TINYINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getByte * @since 1.4 */ @@ -6793,16 +6814,16 @@ /** - * Sets the designated parameter to the given Java short value. + * Sets the designated parameter to the given Java {@code short} value. * The driver converts this - * to an SQL SMALLINT value when it sends it to the database. + * to an SQL {@code SMALLINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getShort * @since 1.4 */ @@ -6812,16 +6833,16 @@ /** - * Sets the designated parameter to the given Java int value. + * Sets the designated parameter to the given Java {@code int} value. * The driver converts this - * to an SQL INTEGER value when it sends it to the database. + * to an SQL {@code INTEGER} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getInt * @since 1.4 */ @@ -6829,17 +6850,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java long value. + /** + * Sets the designated parameter to the given Java {@code long} value. * The driver converts this - * to an SQL BIGINT value when it sends it to the database. + * to an SQL {@code BIGINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getLong * @since 1.4 */ @@ -6848,17 +6869,17 @@ } - /** - * Sets the designated parameter to the given Java float value. + /** + * Sets the designated parameter to the given Java {@code float} value. * The driver converts this - * to an SQL FLOAT value when it sends it to the database. + * to an SQL {@code FLOAT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getFloat * @since 1.4 */ @@ -6866,17 +6887,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java double value. + /** + * Sets the designated parameter to the given Java {@code double} value. * The driver converts this - * to an SQL DOUBLE value when it sends it to the database. + * to an SQL {@code DOUBLE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDouble * @since 1.4 */ @@ -6887,7 +6908,6 @@ /** * This method re populates the resBundle * during the deserialization process - * */ private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException { // Default state initialization happens here --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.803466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.635466074 +0400 @@ -43,22 +43,22 @@ /** - * The facility called on internally by the RIOptimisticProvider implementation to + * The facility called on internally by the {@code RIOptimisticProvider} implementation to * propagate changes back to the data source from which the rowset got its data. * - * A CachedRowSetWriter object, called a writer, has the public - * method writeData for writing modified data to the underlying data source. + * A {@code CachedRowSetWriter} object, called a writer, has the public + * method {@code writeData} for writing modified data to the underlying data source. * This method is invoked by the rowset internally and is never invoked directly by an application. * A writer also has public methods for setting and getting - * the CachedRowSetReader object, called a reader, that is associated + * the {@code CachedRowSetReader} object, called a reader, that is associated * with the writer. The remainder of the methods in this class are private and * are invoked internally, either directly or indirectly, by the method - * writeData. + * {@code writeData}. * - * Typically the SyncFactory manages the RowSetReader and - * the RowSetWriter implementations using SyncProvider objects. + * Typically the {@code SyncFactory} manages the {@code RowSetReader} and + * the {@code RowSetWriter} implementations using {@code SyncProvider} objects. * Standard JDBC RowSet implementations provide an object instance of this - * writer by invoking the SyncProvider.getRowSetWriter() method. + * writer by invoking the {@code SyncProvider.getRowSetWriter()} method. * * @version 0.2 * @author Jonathan Bruce @@ -69,15 +69,15 @@ public class CachedRowSetWriter implements TransactionalWriter, Serializable { /** - * The Connection object that this writer will use to make a + * The {@code Connection} object that this writer will use to make a * connection to the data source to which it will write data. * */ private transient Connection con; /** - * The SQL SELECT command that this writer will call - * internally. The method initSQLStatements builds this + * The SQL {@code SELECT} command that this writer will call + * internally. The method {@code initSQLStatements} builds this * command by supplying the words "SELECT" and "FROM," and using * metadata to get the table name and column names . * @@ -86,9 +86,9 @@ private String selectCmd; /** - * The SQL UPDATE command that this writer will call + * The SQL {@code UPDATE} command that this writer will call * internally to write data to the rowset's underlying data source. - * The method initSQLStatements builds this String + * The method {@code initSQLStatements} builds this {@code String} * object. * * @serial @@ -96,8 +96,8 @@ private String updateCmd; /** - * The SQL WHERE clause the writer will use for update - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for update + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -105,7 +105,7 @@ private String updateWhere; /** - * The SQL DELETE command that this writer will call + * The SQL {@code DELETE} command that this writer will call * internally to delete a row in the rowset's underlying data source. * * @serial @@ -113,8 +113,8 @@ private String deleteCmd; /** - * The SQL WHERE clause the writer will use for delete - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for delete + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -122,9 +122,9 @@ private String deleteWhere; /** - * The SQL INSERT INTO command that this writer will internally use + * The SQL {@code INSERT INTO} command that this writer will internally use * to insert data into the rowset's underlying data source. The method - * initSQLStatements builds this command with a question + * {@code initSQLStatements} builds this command with a question * mark parameter placeholder for each column in the rowset. * * @serial @@ -133,8 +133,8 @@ /** * An array containing the column numbers of the columns that are - * needed to uniquely identify a row in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * needed to uniquely identify a row in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ @@ -142,7 +142,7 @@ /** * An array of the parameters that should be used to set the parameter - * placeholders in a PreparedStatement object that this + * placeholders in a {@code PreparedStatement} object that this * writer will execute. * * @serial @@ -150,33 +150,33 @@ private Object[] params; /** - * The CachedRowSetReader object that has been - * set as the reader for the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code CachedRowSetReader} object that has been + * set as the reader for the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private CachedRowSetReader reader; /** - * The ResultSetMetaData object that contains information - * about the columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code ResultSetMetaData} object that contains information + * about the columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private ResultSetMetaData callerMd; /** - * The number of columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The number of columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private int callerColumnCount; /** - * This CachedRowSet will hold the conflicting values + * This {@code CachedRowSet} will hold the conflicting values * retrieved from the db and hold it. */ private CachedRowSetImpl crsResolve; @@ -209,8 +209,8 @@ } /** - * Propagates changes in the given RowSet object - * back to its underlying data source and returns true + * Propagates changes in the given {@code RowSet} object + * back to its underlying data source and returns {@code true} * if successful. The writer will check to see if * the data in the pre-modified rowset (the original values) differ * from the data in the underlying data source. If data in the data @@ -221,15 +221,15 @@ * access for concurrent users. * * This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. * - * Creates a CachedRowSet object from the given - * RowSet object + * Creates a {@code CachedRowSet} object from the given + * {@code RowSet} object * Makes a connection with the data source * * Disables autocommit mode if it is not already disabled @@ -237,32 +237,32 @@ * * Checks to see if the reader has read new data since the writer * was last called and, if so, calls the method - * initSQLStatements to initialize new SQL statements + * {@code initSQLStatements} to initialize new SQL statements * - * Builds new SELECT, UPDATE, - * INSERT, and DELETE statements - * Uses the CachedRowSet object's metadata to + * Builds new {@code SELECT}, {@code UPDATE}, + * {@code INSERT}, and {@code DELETE} statements + * Uses the {@code CachedRowSet} object's metadata to * determine the table name, column names, and the columns * that make up the primary key * * When there is no conflict, propagates changes made to the - * CachedRowSet object back to its underlying data source + * {@code CachedRowSet} object back to its underlying data source * - * Iterates through each row of the CachedRowSet object + * Iterates through each row of the {@code CachedRowSet} object * to determine whether it has been updated, inserted, or deleted * If the corresponding row in the data source has not been changed * since the rowset last read its * values, the writer will use the appropriate command to update, * insert, or delete the row * If any data in the data source does not match the original values - * for the CachedRowSet object, the writer will roll + * for the {@code CachedRowSet} object, the writer will roll * back any changes it has made to the row in the data source. * * * - * @return true if changes to the rowset were successfully + * @return {@code true} if changes to the rowset were successfully * written to the rowset's underlying data source; - * false otherwise + * {@code false} otherwise */ public boolean writeData(RowSetInternal caller) throws SQLException { long conflicts = 0; @@ -434,25 +434,25 @@ } //end writeData -/** - * Updates the given CachedRowSet object's underlying data - * source so that updates to the rowset are reflected in the original - * data source, and returns false if the update was successful. - * A return value of true indicates that there is a conflict, - * meaning that a value updated in the rowset has already been changed by - * someone else in the underlying data source. A conflict can also exist - * if, for example, more than one row in the data source would be affected - * by the update or if no rows would be affected. In any case, if there is - * a conflict, this method does not update the underlying data source. - * - * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + * + * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - * - * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + * + * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. * - * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - * - * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + * + * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. * * If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. * * The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. * * NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. * * This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. * - * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. * - * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. * * Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. * - * undoUpdateRowSet object backed by the same data as - * that of this CachedRowSetImpl object and sharing a set of cursors + * Returns a new {@code RowSet} object backed by the same data as + * that of this {@code CachedRowSetImpl} object and sharing a set of cursors * with it. This allows cursors to interate over a shared set of rows, providing * multiple views of the underlying data. * - * @return a RowSet object that is a copy of this CachedRowSetImpl + * @return a {@code RowSet} object that is a copy of this {@code CachedRowSetImpl} * object and shares a set of cursors with it * @throws SQLException if an error occurs or cloning is * not supported @@ -750,19 +750,19 @@ } /** - * Returns a new RowSet object containing by the same data - * as this CachedRowSetImpl object. This method - * differs from the method createCopy in that it throws a - * CloneNotSupportedException object instead of an - * SQLException object, as the method createShared - * does. This clone - * method is called internally by the method createShared, - * which catches the CloneNotSupportedException object - * and in turn throws a new SQLException object. + * Returns a new {@code RowSet} object containing by the same data + * as this {@code CachedRowSetImpl} object. This method + * differs from the method {@code createCopy} in that it throws a + * {@code CloneNotSupportedException} object instead of an + * {@code SQLException} object, as the method {@code createShared} + * does. This {@code clone} + * method is called internally by the method {@code createShared}, + * which catches the {@code CloneNotSupportedException} object + * and in turn throws a new {@code SQLException} object. * - * @return a copy of this CachedRowSetImpl object + * @return a copy of this {@code CachedRowSetImpl} object * @throws CloneNotSupportedException if an error occurs when - * attempting to clone this CachedRowSetImpl object + * attempting to clone this {@code CachedRowSetImpl} object * @see #createShared */ protected Object clone() throws CloneNotSupportedException { @@ -770,8 +770,8 @@ } /** - * Creates a RowSet object that is a deep copy of - * this CachedRowSetImpl object's data, including + * Creates a {@code RowSet} object that is a deep copy of + * this {@code CachedRowSetImpl} object's data, including * constraints. Updates made * on a copy are not visible to the original rowset; * a copy of a rowset is completely independent from the original. @@ -780,12 +780,12 @@ * from first principles, which can be quite expensive. * For example, it can eliminate the need to query a * remote database server. - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSet object and is - * completely independent from this CachedRowSetImpl + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSet} object and is + * completely independent from this {@code CachedRowSetImpl} * object. * @throws SQLException if an error occurs in generating the copy of this - * of the CachedRowSetImpl + * of the {@code CachedRowSetImpl} * @see #createShared * @see javax.sql.RowSetEvent * @see javax.sql.RowSetListener @@ -795,21 +795,21 @@ } /** - * Creates a RowSet object that is a copy of - * this CachedRowSetImpl object's table structure + * Creates a {@code RowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's table structure * and the constraints only. * There will be no data in the object being returned. * Updates made on a copy are not visible to the original rowset. * * This helps in getting the underlying XML schema which can - * be used as the basis for populating a WebRowSet. + * be used as the basis for populating a {@code WebRowSet}. * - * @return a new CachedRowSet object that is a copy - * of this CachedRowSetImpl object's schema and + * @return a new {@code CachedRowSet} object that is a copy + * of this {@code CachedRowSetImpl} object's schema and * retains all the constraints on the original rowset but contains * no data * @throws SQLException if an error occurs in generating the copy - * of the CachedRowSet object + * of the {@code CachedRowSet} object * @see #createShared * @see #createCopy * @see #createCopyNoConstraints @@ -821,17 +821,17 @@ } /** - * Creates a CachedRowSet object that is a copy of - * this CachedRowSetImpl object's data only. + * Creates a {@code CachedRowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's data only. * All constraints set in this object will not be there * in the returning object. Updates made * on a copy are not visible to the original rowset. * - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSetImpl object and is - * completely independent from this CachedRowSetImpl object + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSetImpl} object and is + * completely independent from this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the copy of the - * of the CachedRowSet + * of the {@code CachedRowSet} * @see #createShared * @see #createCopy * @see #createCopySchema @@ -843,15 +843,15 @@ } /** - * Converts this CachedRowSetImpl object to a collection - * of tables. The sample implementation utilitizes the TreeMap + * Converts this {@code CachedRowSetImpl} object to a collection + * of tables. The sample implementation utilitizes the {@code TreeMap} * collection type. * This class guarantees that the map will be in ascending key order, * sorted according to the natural order for the key's class. * - * @return a Collection object consisting of tables, + * @return a {@code Collection} object consisting of tables, * each of which is a copy of a row in this - * CachedRowSetImpl object + * {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the collection * @see #toCollection(int) * @see #toCollection(String) @@ -863,16 +863,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -886,16 +886,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -914,25 +914,25 @@ /** - * Returns the SyncProvider implementation being used - * with this CachedRowSetImpl implementation rowset. + * Returns the {@code SyncProvider} implementation being used + * with this {@code CachedRowSetImpl} implementation rowset. * * @return the SyncProvider used by the rowset. If not provider was * set when the rowset was instantiated, the reference * implementation (default) provider is returned. * @throws SQLException if error occurs while return the - * SyncProvider instance. + * {@code SyncProvider} instance. */ public SyncProvider getSyncProvider() throws SQLException { throw new UnsupportedOperationException(); } /** - * Sets the active SyncProvider and attempts to load - * load the new provider using the SyncFactory SPI. + * Sets the active {@code SyncProvider} and attempts to load + * load the new provider using the {@code SyncFactory} SPI. * * @throws SQLException if an error occurs while resetting the - * SyncProvider. + * {@code SyncProvider}. */ public void setSyncProvider(String providerStr) throws SQLException { throw new UnsupportedOperationException(); @@ -953,23 +953,23 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data. + * Populates this {@code CachedRowSetImpl} object with data. * This form of the method uses the rowset's user, password, and url or * data source name properties to create a database * connection. If properties that are needed * have not been set, this method will throw an exception. * - * Another form of this method uses an existing JDBC Connection + * Another form of this method uses an existing JDBC {@code Connection} * object instead of creating a new one; therefore, it ignores the * properties used for establishing a new connection. * * The query specified by the command property is executed to create a - * ResultSet object from which to retrieve data. + * {@code ResultSet} object from which to retrieve data. * The current contents of the rowset are discarded, and the * rowset's metadata is also (re)set. If there are outstanding updates, * they are also ignored. * - * The method execute closes any database connections that it + * The method {@code execute} closes any database connections that it * creates. * * @throws SQLException if an error occurs or the @@ -987,20 +987,20 @@ /** * Moves the cursor down one row from its current position and - * returns true if the new cursor position is a + * returns {@code true} if the new cursor position is a * valid row. - * The cursor for a new ResultSet object is initially + * The cursor for a new {@code ResultSet} object is initially * positioned before the first row. The first call to the method - * next moves the cursor to the first row, making it + * {@code next} moves the cursor to the first row, making it * the current row; the second call makes the second row the * current row, and so on. * * If an input stream from the previous row is open, it is - * implicitly closed. The ResultSet object's warning + * implicitly closed. The {@code ResultSet} object's warning * chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if an error occurs or * the cursor is not positioned in the rowset, before * the first row, or after the last row @@ -1010,9 +1010,9 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the next - * row and returns true if the cursor is still in the rowset; - * returns false if the cursor has moved to the position after + * Moves this {@code CachedRowSetImpl} object's cursor to the next + * row and returns {@code true} if the cursor is still in the rowset; + * returns {@code false} if the cursor has moved to the position after * the last row. * * This method handles the cases where the cursor moves to a row that @@ -1021,15 +1021,15 @@ * that has been deleted, this method moves the cursor to the next * row until the cursor is on a row that has not been deleted. * - * The method internalNext is called by methods such as - * next, absolute, and relative, + * The method {@code internalNext} is called by methods such as + * {@code next}, {@code absolute}, and {@code relative}, * and, as its name implies, is only called internally. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a valid row in this - * rowset; false if it is after the last row + * @return {@code true} if the cursor is on a valid row in this + * rowset; {@code false} if it is after the last row * @throws SQLException if an error occurs */ protected boolean internalNext() throws SQLException { @@ -1037,25 +1037,25 @@ } /** - * Closes this CachedRowSetImpl objecy and releases any resources + * Closes this {@code CachedRowSetImpl} objecy and releases any resources * it was using. * * @throws SQLException if an error occurs when releasing any resources in use - * by this CachedRowSetImpl object + * by this {@code CachedRowSetImpl} object */ public void close() throws SQLException { throw new UnsupportedOperationException(); } /** - * Reports whether the last column read was SQL NULL. - * Note that you must first call the method getXXX + * Reports whether the last column read was SQL {@code NULL}. + * Note that you must first call the method {@code getXXX} * on a column to try to read its value and then call the method - * wasNull to determine whether the value was - * SQL NULL. + * {@code wasNull} to determine whether the value was + * SQL {@code NULL}. * - * @return true if the value in the last column read - * was SQL NULL; false otherwise + * @return {@code true} if the value in the last column read + * was SQL {@code NULL}; {@code false} otherwise * @throws SQLException if an error occurs */ public boolean wasNull() throws SQLException { @@ -1064,9 +1064,9 @@ /** * Returns the insert row or the current row of this - * CachedRowSetImplobject. + * {@code CachedRowSetImpl}object. * - * @return the Row object on which this CachedRowSetImpl + * @return the {@code Row} object on which this {@code CachedRowSetImpl} * objects's cursor is positioned */ protected BaseRow getCurrentRow() { @@ -1077,7 +1077,7 @@ * Removes the row on which the cursor is positioned. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * * @throws SQLException if the cursor is positioned on the insert * row @@ -1089,20 +1089,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * String object. + * of this {@code CachedRowSetImpl} object as a + * {@code String} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} {@code CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type designates the * recommended return type. */ public String getString(int columnIndex) throws SQLException { @@ -1111,18 +1111,18 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * boolean value. + * of this {@code CachedRowSetImpl} object as a + * {@code boolean} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a boolean in the Java progamming language; - * if the value is SQL NULL, the result is false + * @return the column value as a {@code boolean} in the Java progamming language; + * if the value is SQL {@code NULL}, the result is {@code false} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BOOLEAN value + * SQL {@code BOOLEAN} value * @see #getBoolean(String) */ public boolean getBoolean(int columnIndex) throws SQLException { @@ -1131,20 +1131,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type + * SQL {@code TINYINT}, {@code SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type * designates the recommended return type. * @see #getByte(String) */ @@ -1154,21 +1154,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * short value. + * of this {@code CachedRowSetImpl} object as a + * {@code short} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT}, {@code SMALLINT}, + * {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(String) */ public short getShort(int columnIndex) throws SQLException { @@ -1177,21 +1178,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * int value. + * of this {@code CachedRowSetImpl} object as an + * {@code int} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1199,21 +1201,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * long value. + * of this {@code CachedRowSetImpl} object as a + * {@code long} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getLong(String) */ public long getLong(int columnIndex) throws SQLException { @@ -1222,21 +1225,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * float value. + * of this {@code CachedRowSetImpl} object as a + * {@code float} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,} + * {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC, + * BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(int columnIndex) throws SQLException { @@ -1245,21 +1248,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * double value. + * of this {@code CachedRowSetImpl} object as a + * {@code double} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,} + * {@code FLOAT, DOUBLE}, + * {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getDouble(String) * */ @@ -1269,21 +1273,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * This method is deprecated; use the version of getBigDecimal + * This method is deprecated; use the version of {@code getBigDecimal} * that does not take a scale parameter and returns a value with full * precision. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @param scale the number of digits to the right of the decimal point in the * value returned * @return the column value with the specified number of digits to the right - * of the decimal point; if the value is SQL NULL, the - * result is null + * of the decimal point; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails * @deprecated @@ -1295,22 +1299,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte array value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} array value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the - * result is null + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the + * result is {@code null} * * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or + * {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getBytes(String) */ public byte[] getBytes(int columnIndex) throws SQLException { @@ -1319,17 +1323,17 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Date object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Date} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a java.sql.Data object; if - * the value is SQL NULL, the - * result is null + * @return the column value as a {@code java.sql.Data} object; if + * the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, - * the cursor is not on a valid row, or this method fails + * the cursor is not on a valid row, or this method fails */ public java.sql.Date getDate(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1337,14 +1341,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Time object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Time} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1354,14 +1358,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1371,33 +1375,33 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The JDBC + * suitable for retrieving large {@code LONGVARCHAR} values. The JDBC * driver will do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. . Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(String) */ public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException { @@ -1416,8 +1420,8 @@ * stream may return 0 for available() whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of two byte Unicode characters. If the value is SQL NULL @@ -1432,30 +1436,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for - * CachedRowSetImpl.available() whether there is data + * stream may return {@code 0} for + * {@code CachedRowSetImpl.available()} whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes. If the value is SQL NULL - * then the result is null. + * as a stream of uninterpreted bytes. If the value is SQL {@code NULL} + * then the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY}. * The bold type indicates the SQL type that this method is recommened * to retrieve. * @see #getBinaryStream(String) @@ -1472,19 +1476,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a String object. + * of the current row as a {@code String} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR< value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} + * {@code CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. */ public String getString(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1492,17 +1496,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a boolean value. + * of the current row as a {@code boolean} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a boolean in the Java programming - * language; if the value is SQL NULL, - * the result is false + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code boolean} in the Java programming + * language; if the value is SQL {@code NULL}, + * the result is {@code false} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BOOLEAN value + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BOOLEAN} value * @see #getBoolean(int) */ public boolean getBoolean(String columnName) throws SQLException { @@ -1511,19 +1515,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte value. + * of the current row as a {@code byte} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The - * bold type designates the recommended return type + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT}, + * {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} + * value. The bold type designates the recommended return type. */ public byte getByte(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1531,19 +1535,20 @@ /** * Retrieves the value stored in the designated column - * of the current row as a short value. + * of the current row as a {@code short} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT,} + * {@code SMALLINT}, {@code INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(int) */ public short getShort(String columnName) throws SQLException { @@ -1552,20 +1557,21 @@ /** * Retrieves the value stored in the designated column - * of the current row as an int value. + * of the current row as an {@code int} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name - * of a column in this rowset, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * of a column in this rowset, + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1573,19 +1579,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a long value. + * of the current row as a {@code long} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getLong(int) */ public long getLong(String columnName) throws SQLException { @@ -1594,19 +1600,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a float value. + * of the current row as a {@code float} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT,} {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(String columnName) throws SQLException { @@ -1615,20 +1621,20 @@ /** * Retrieves the value stored in the designated column - * of the current row of this CachedRowSetImpl object - * as a double value. + * of the current row of this {@code CachedRowSetImpl} object + * as a {@code double} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return types. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL,} {@code FLOAT, DOUBLE}, {@code DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return types. * @see #getDouble(int) */ public double getDouble(String columnName) throws SQLException { @@ -1637,22 +1643,22 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.math.BigDecimal object. + * of the current row as a {@code java.math.BigDecimal} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @param scale the number of digits to the right of the decimal point - * @return a java.math.BugDecimal object with scale - * number of digits to the right of the decimal point. + * @return a java.math.BugDecimal object with {@code scale} + * number of digits to the right of the decimal point. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve. - * @deprecated Use the getBigDecimal(String columnName) + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. + * @deprecated Use the {@code getBigDecimal(String columnName)} * method instead */ @Deprecated @@ -1662,19 +1668,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte array. + * of the current row as a {@code byte} array. * The bytes represent the raw values returned by the driver. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BINARY, VARBINARY - * or LONGVARBINARY values - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BINARY, VARBINARY} + * or {@code LONGVARBINARY} values. + * The bold SQL type designates the recommended return type. * @see #getBytes(int) */ public byte[] getBytes(String columnName) throws SQLException { @@ -1683,17 +1689,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Date object. + * of the current row as a {@code java.sql.Date} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1701,12 +1707,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Time object. + * of the current row as a {@code java.sql.Time} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1717,12 +1723,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Timestamp object. + * of the current row as a {@code java.sql.Timestamp} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1733,32 +1739,32 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The - * SyncProvider will rely on the JDBC driver to do any necessary + * suitable for retrieving large {@code LONGVARCHAR} values. The + * {@code SyncProvider} will rely on the JDBC driver to do any necessary * conversion from the database format into ASCII format. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * a column in this rowset + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(int) */ public java.io.InputStream getAsciiStream(String columnName) throws SQLException { @@ -1769,23 +1775,23 @@ /** * A column value can be retrieved as a stream of Unicode characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will do any necessary conversion from the database * format into Unicode. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row - * @deprecated use the method getCharacterStream instead + * @deprecated use the method {@code getCharacterStream} instead */ @Deprecated public java.io.InputStream getUnicodeStream(String columnName) throws SQLException { @@ -1794,30 +1800,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of uninterpreted bytes. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is unknown, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY - * The bold type indicates the SQL type that this method is recommened - * to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY} + * The bold type indicates the SQL type that this method is recommened + * to retrieve. * @see #getBinaryStream(int) * */ @@ -1831,17 +1837,17 @@ //===================================================================== /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by statement + * by {@code ResultSet} methods. Any warning caused by statement * methods (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * * @return the first SQLWarning or null */ @@ -1850,10 +1856,10 @@ } /** - * Clears all the warnings reporeted for the CachedRowSetImpl - * object. After a call to this method, the getWarnings method - * returns null until a new warning is reported for this - * CachedRowSetImpl object. + * Clears all the warnings reporeted for the {@code CachedRowSetImpl} + * object. After a call to this method, the {@code getWarnings} method + * returns {@code null} until a new warning is reported for this + * {@code CachedRowSetImpl} object. */ public void clearWarnings() { throw new UnsupportedOperationException(); @@ -1861,25 +1867,25 @@ /** * Retrieves the name of the SQL cursor used by this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * * In SQL, a result table is retrieved through a cursor that is - * named. The current row of a ResultSet can be updated or deleted + * named. The current row of a {@code ResultSet} can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To ensure that the cursor has the proper isolation - * level to support an update operation, the cursor's SELECT - * statement should be of the form select for update. - * If the for update clause + * level to support an update operation, the cursor's {@code SELECT} + * statement should be of the form {@code select for update}. + * If the {@code for update} clause * is omitted, positioned updates may fail. * * JDBC supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. The current row + * SQL cursor used by a {@code ResultSet} object. The current row * of a result set is also the current row of this SQL cursor. * * Note: If positioned updates are not supported, an - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL cursor name for this CachedRowSetImpl object's + * @return the SQL cursor name for this {@code CachedRowSetImpl} object's * cursor * @throws SQLException if an error occurs */ @@ -1888,12 +1894,12 @@ } /** - * Retrieves a ResultSetMetaData object instance that - * contains information about the CachedRowSet object. + * Retrieves a {@code ResultSetMetaData} object instance that + * contains information about the {@code CachedRowSet} object. * However, applications should cast the returned object to a - * RowSetMetaData interface implementation. In the + * {@code RowSetMetaData} interface implementation. In the * reference implementation, this cast can be done on the - * RowSetMetaDataImpl class. + * {@code RowSetMetaDataImpl} class. * * For example: * @@ -1907,10 +1913,10 @@ * crs.setMetaData(metaData); * * - * @return the ResultSetMetaData object that describes this - * CachedRowSetImpl object's columns + * @return the {@code ResultSetMetaData} object that describes this + * {@code CachedRowSetImpl} object's columns * @throws SQLException if an error occurs in generating the RowSet - * meta data; or if the CachedRowSetImpl is empty. + * meta data; or if the {@code CachedRowSetImpl} is empty. * @see javax.sql.RowSetMetaData */ public ResultSetMetaData getMetaData() throws SQLException { @@ -1920,10 +1926,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1931,23 +1937,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes in the Java programming language. * When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(String) */ public Object getObject(int columnIndex) throws SQLException { @@ -1956,10 +1962,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1967,23 +1973,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes * in the Java programming language. When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name does not match one of * this rowset's column names, (2) the cursor is not * on a valid row, or (3) there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(int) */ public Object getObject(String columnName) throws SQLException { @@ -1993,10 +1999,10 @@ //---------------------------------------------------------------- /** - * Maps the given column name for one of this CachedRowSetImpl + * Maps the given column name for one of this {@code CachedRowSetImpl} * object's columns to its column number. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @return the column index of the given column name * @throws SQLException if the given column name does not match one @@ -2014,25 +2020,25 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java character stream that delivers the database column value * as a stream of two-byte unicode characters in a - * java.io.Reader object. If the value is - * SQL NULL, the result is null. + * {@code java.io.Reader} object. If the value is + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR,} {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getCharacterStream(String) */ public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{ @@ -2041,23 +2047,24 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY or LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code CHAR, VARCHAR,} + * {@code LONGVARCHAR}, + * {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -2065,21 +2072,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return types that this method is used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return types that this method is used to retrieve. * @see #getBigDecimal(String) */ public BigDecimal getBigDecimal(int columnIndex) throws SQLException { @@ -2088,21 +2096,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. * @see #getBigDecimal(int) */ public BigDecimal getBigDecimal(String columnName) throws SQLException { @@ -2114,7 +2122,7 @@ //--------------------------------------------------------------------- /** - * Returns the number of rows in this CachedRowSetImpl object. + * Returns the number of rows in this {@code CachedRowSetImpl} object. * * @return number of rows in the rowset */ @@ -2124,10 +2132,10 @@ /** * Indicates whether the cursor is before the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is before the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isBeforeFirst() throws SQLException { @@ -2136,10 +2144,10 @@ /** * Indicates whether the cursor is after the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is after the last row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isAfterLast() throws SQLException { @@ -2148,10 +2156,10 @@ /** * Indicates whether the cursor is on the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is on the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isFirst() throws SQLException { @@ -2160,14 +2168,14 @@ /** * Indicates whether the cursor is on the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * Note: Calling the method isLast may be expensive + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver might need to fetch ahead one row in order * to determine whether the current row is the last row in this rowset. * - * @return true if the cursor is on the last row; - * false otherwise or if this rowset contains no rows + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise or if this rowset contains no rows * @throws SQLException if an error occurs */ public boolean isLast() throws SQLException { @@ -2175,19 +2183,19 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the front of + * Moves this {@code CachedRowSetImpl} object's cursor to the front of * the rowset, just before the first row. This method has no effect if * this rowset contains no rows. * * @throws SQLException if an error occurs or the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public void beforeFirst() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the end of + * Moves this {@code CachedRowSetImpl} object's cursor to the end of * the rowset, just after the last row. This method has no effect if * this rowset contains no rows. * @@ -2198,34 +2206,34 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the first row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the first row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean first() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the first - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the first + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the methods first, - * isFirst, and absolute. - * It in turn calls the method internalNext in order to + * This method is called internally by the methods {@code first}, + * {@code isFirst}, and {@code absolute}. + * It in turn calls the method {@code internalNext} in order to * handle the case where the first row is a deleted row that is not visible. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the first row; - * false otherwise + * @return {@code true} if the cursor moved to the first row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalFirst() throws SQLException { @@ -2233,35 +2241,35 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the last row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the last row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean last() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the last - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the last + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the method last + * This method is called internally by the method {@code last} * when rows have been deleted and the deletions are not visible. - * The method internalLast handles the case where the + * The method {@code internalLast} handles the case where the * last row is a deleted row that is not visible by in turn calling - * the method internalPrevious. + * the method {@code internalPrevious}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the last row; - * false otherwise + * @return {@code true} if the cursor moved to the last row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalLast() throws SQLException { @@ -2269,12 +2277,12 @@ } /** - * Returns the number of the current row in this CachedRowSetImpl + * Returns the number of the current row in this {@code CachedRowSetImpl} * object. The first row is number 1, the second number 2, and so on. * - * @return the number of the current row; 0 if there is no + * @return the number of the current row; {@code 0} if there is no * current row - * @throws SQLException if an error occurs; or if the CacheRowSetImpl + * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl} * is empty */ public int getRow() throws SQLException { @@ -2282,51 +2290,51 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the row number + * Moves this {@code CachedRowSetImpl} object's cursor to the row number * specified. * * If the number is positive, the cursor moves to an absolute row with * respect to the beginning of the rowset. The first row is row 1, the second * is row 2, and so on. For example, the following command, in which - * crs is a CachedRowSetImpl object, moves the cursor + * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor * to the fourth row, starting from the beginning of the rowset. - * + * {@code * * crs.absolute(4); * - * + * } * * If the number is negative, the cursor moves to an absolute row position * with respect to the end of the rowset. For example, calling - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row, counting * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. * * @param row a positive number to indicate the row, starting row numbering from - * the first row, which is 1; a negative number to indicate + * the first row, which is {@code 1}; a negative number to indicate * the row, starting row numbering from the last row, which is - * -1; it must not be 0 - * @return true if the cursor is on the rowset; false + * {@code -1}; it must not be {@code 0} + * @return {@code true} if the cursor is on the rowset; {@code false} * otherwise - * @throws SQLException if the given cursor position is 0 or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * @throws SQLException if the given cursor position is {@code 0} or the + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean absolute( int row ) throws SQLException { throw new UnsupportedOperationException(); @@ -2340,80 +2348,80 @@ * If the number is positive, the cursor moves the specified number of * rows toward the end of the rowset, starting at the current row. * For example, the following command, in which - * crs is a CachedRowSetImpl object with 100 rows, + * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows, * moves the cursor forward four rows from the current row. If the * current row is 50, the cursor would move to row 54. - * + * {@code * * crs.relative(4); * - * + * } * * If the number is negative, the cursor moves back toward the beginning * the specified number of rows, starting at the current row. * For example, calling the method - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. In both cases, this method - * throws an SQLException. + * throws an {@code SQLException}. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). Calling relative(0) + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. Calling {@code relative(0)} * is valid, but it does not change the cursor position. * - * @param rows an int indicating the number of rows to move + * @param rows an {@code int} indicating the number of rows to move * the cursor, starting at the current row; a positive number * moves the cursor forward; a negative number moves the cursor * backward; must not move the cursor past the valid * rows - * @return true if the cursor is on a row in this - * CachedRowSetImpl object; false + * @return {@code true} if the cursor is on a row in this + * {@code CachedRowSetImpl} object; {@code false} * otherwise * @throws SQLException if there are no rows in this rowset, the cursor is * positioned either before the first row or after the last row, or - * the rowset is type ResultSet.TYPE_FORWARD_ONLY + * the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean relative(int rows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the - * previous row and returns true if the cursor is on - * a valid row or false if it is not. + * Moves this {@code CachedRowSetImpl} object's cursor to the + * previous row and returns {@code true} if the cursor is on + * a valid row or {@code false} if it is not. * This method also notifies all listeners registered with this - * CachedRowSetImpl object that its cursor has moved. + * {@code CachedRowSetImpl} object that its cursor has moved. * - * Note: calling the method previous() is not the same - * as calling the method relative(-1). This is true - * because it is possible to call previous() from the insert + * Note: calling the method {@code previous()} is not the same + * as calling the method {@code relative(-1)}. This is true + * because it is possible to call {@code previous()} from the insert * row, from after the last row, or from the current row, whereas - * relative may only be called from the current row. + * {@code relative} may only be called from the current row. * - * The method previous may used in a while + * The method {@code previous} may used in a {@code while} * loop to iterate through a rowset starting after the last row - * and moving toward the beginning. The loop ends when previous - * returns false, meaning that there are no more rows. + * and moving toward the beginning. The loop ends when {@code previous} + * returns {@code false}, meaning that there are no more rows. * For example, the following code fragment retrieves all the data in - * the CachedRowSetImpl object crs, which has + * the {@code CachedRowSetImpl} object {@code crs}, which has * three columns. Note that the cursor must initially be positioned * after the last row so that the first call to the method - * previous places the cursor on the last line. - * + * {@code previous} places the cursor on the last line. + * {@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - * - * This method throws an SQLException if the cursor is not + * } + * This method throws an {@code SQLException} if the cursor is not * on a row in the rowset, before the first row, or after the last row. * - * @return true if the cursor is on a valid row; - * false if it is before the first row or after the + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is before the first row or after the * last row * @throws SQLException if the cursor is not on a valid position or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean previous() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor to the previous row in this CachedRowSetImpl + * Moves the cursor to the previous row in this {@code CachedRowSetImpl} * object, skipping past deleted rows that are not visible; returns - * true if the cursor is on a row in this rowset and - * false when the cursor goes before the first row. + * {@code true} if the cursor is on a row in this rowset and + * {@code false} when the cursor goes before the first row. * - * This method is called internally by the method previous. + * This method is called internally by the method {@code previous}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a row in this rowset; - * false when the cursor reaches the position before + * @return {@code true} if the cursor is on a row in this rowset; + * {@code false} when the cursor reaches the position before * the first row * @throws SQLException if an error occurs */ @@ -2463,14 +2471,14 @@ //--------------------------------------------------------------------- /** - * Indicates whether the current row of this CachedRowSetImpl + * Indicates whether the current row of this {@code CachedRowSetImpl} * object has been updated. The value returned - * depends on whether this rowset can detect updates: false + * depends on whether this rowset can detect updates: {@code false} * will always be returned if it does not detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another and updates are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2482,13 +2490,13 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * * @param idx the index identifier of the column that may be have been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2500,14 +2508,14 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * - * @param columnName the String column name column that may be have + * @param columnName the {@code String} column name column that may be have * been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2521,8 +2529,8 @@ * Indicates whether the current row has been inserted. The value returned * depends on whether or not the rowset can detect visible inserts. * - * @return true if a row has been inserted and inserts are detected; - * false otherwise + * @return {@code true} if a row has been inserted and inserts are detected; + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2536,12 +2544,12 @@ * Indicates whether the current row has been deleted. A deleted row * may leave a visible "hole" in a rowset. This method can be used to * detect such holes if the rowset can detect deletions. This method - * will always return false if this rowset cannot detect + * will always return {@code false} if this rowset cannot detect * deletions. * - * @return true if (1)the current row is blank, indicating that + * @return {@code true} if (1)the current row is blank, indicating that * the row has been deleted, and (2)deletions are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on a valid row in this rowset * @see DatabaseMetaData#deletesAreDetected */ @@ -2551,8 +2559,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset; however, another method must be called to complete @@ -2565,15 +2573,15 @@ * * In order to propagate updates in this rowset to the underlying * data source, an application must call the method {@link #acceptChanges} - * after it calls either updateRow or insertRow. + * after it calls either {@code updateRow} or {@code insertRow}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -2581,8 +2589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2593,14 +2601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(int columnIndex, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -2608,8 +2616,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2620,14 +2628,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(int columnIndex, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -2635,8 +2643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2647,14 +2655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(int columnIndex, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -2662,8 +2670,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2674,14 +2682,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(int columnIndex, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -2689,8 +2697,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2701,14 +2709,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(int columnIndex, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -2717,8 +2725,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2729,14 +2737,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(int columnIndex, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -2744,8 +2752,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2756,14 +2764,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(int columnIndex, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -2771,8 +2779,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2783,14 +2791,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -2798,8 +2806,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2810,17 +2818,17 @@ * as inserted. Both of these methods must be called before the * cursor moves to another row. * - * The method acceptChanges must be called if the + * The method {@code acceptChanges} must be called if the * updated values are to be written back to the underlying database. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(int columnIndex, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -2828,8 +2836,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2840,14 +2848,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(int columnIndex, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -2855,8 +2863,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2867,15 +2875,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(int columnIndex, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -2883,8 +2891,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2895,15 +2903,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL TIME or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code TIME} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(int columnIndex, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -2911,8 +2919,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2923,16 +2931,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE, TIME, or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE}, {@code TIME}, or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -2940,7 +2948,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -2952,8 +2960,8 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -2965,8 +2973,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2977,17 +2985,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not binary, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException { throw new UnsupportedOperationException(); @@ -2995,8 +3003,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3007,19 +3015,19 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.Reader - * containing BINARY, VARBINARY, - * LONGVARBINARY, CHAR, VARCHAR, - * or LONGVARCHAR data + * @param x the new column value; must be a {@code java.io.Reader} + * containing {@code BINARY}, {@code VARBINARY}, + * {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR}, + * or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not a binary or * character type, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3027,11 +3035,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter indicates + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter indicates * the number of digits to the right of the decimal point and is ignored * if the new column value is not a type that will be mapped to an SQL - * DECIMAL or NUMERIC value. + * {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3042,16 +3050,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3059,8 +3067,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3071,14 +3079,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x) throws SQLException { throw new UnsupportedOperationException(); @@ -3087,8 +3095,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3098,12 +3106,12 @@ * must be called, which will insert the new row into both this rowset * and the database. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -3111,8 +3119,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3123,13 +3131,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(String columnName, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -3137,8 +3145,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3149,13 +3157,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(String columnName, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -3163,8 +3171,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3175,13 +3183,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(String columnName, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -3189,8 +3197,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3201,13 +3209,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(String columnName, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -3215,8 +3223,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3227,13 +3235,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(String columnName, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -3241,8 +3249,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3253,13 +3261,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(String columnName, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -3267,8 +3275,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3279,13 +3287,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(String columnName, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -3293,8 +3301,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3305,13 +3313,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -3319,8 +3327,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3331,13 +3339,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(String columnName, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -3345,8 +3353,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3357,13 +3365,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(String columnName, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -3371,8 +3379,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3383,15 +3391,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(String columnName, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -3399,8 +3407,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3411,15 +3419,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL TIME or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code TIME} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(String columnName, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -3427,8 +3435,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3439,7 +3447,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if the given column index is out of bounds or @@ -3448,9 +3456,9 @@ * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE, - * TIME, or TIMESTAMP, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP}, or (4) this + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -3458,7 +3466,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -3470,7 +3478,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -3483,8 +3491,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3495,17 +3503,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not binary, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3513,8 +3521,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3525,18 +3533,18 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param reader the new column value; must be a - * java.io.Reader containing BINARY, - * VARBINARY, LONGVARBINARY, CHAR, - * VARCHAR, or LONGVARCHAR data + * {@code java.io.Reader} containing {@code BINARY}, + * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR}, + * {@code VARCHAR}, or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not a binary or character type, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(String columnName, java.io.Reader reader, @@ -3546,11 +3554,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter * indicates the number of digits to the right of the decimal point * and is ignored if the new column value is not a type that will be - * mapped to an SQL DECIMAL or NUMERIC value. + * mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3561,15 +3569,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3577,8 +3585,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3589,20 +3597,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x) throws SQLException { throw new UnsupportedOperationException(); } /** - * Inserts the contents of this CachedRowSetImpl object's insert + * Inserts the contents of this {@code CachedRowSetImpl} object's insert * row into this rowset immediately following the current row. * If the current row is the * position after the last row or before the first row, the new row will @@ -3614,14 +3622,14 @@ * @throws SQLException if (1) the cursor is not on the insert row, * (2) one or more of the non-nullable columns in the insert * row has not been given a value, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void insertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Marks the current row of this CachedRowSetImpl object as + * Marks the current row of this {@code CachedRowSetImpl} object as * updated and notifies listeners registered with this rowset that the * row has changed. * @@ -3631,26 +3639,26 @@ * and the updates made before the cursor moved will be lost. * * @throws SQLException if the cursor is on the insert row or this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Deletes the current row from this CachedRowSetImpl object and + * Deletes the current row from this {@code CachedRowSetImpl} object and * notifies listeners registered with this rowset that a row has changed. * This method cannot be called when the cursor is on the insert row. * * This method marks the current row as deleted, but it does not delete * the row from the underlying data source. The method - * acceptChanges must be called to delete the row in + * {@code acceptChanges} must be called to delete the row in * the data source. * * @throws SQLException if (1) this method is called when the cursor * is on the insert row, before the first row, or after the * last row or (2) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void deleteRow() throws SQLException { throw new UnsupportedOperationException(); @@ -3659,7 +3667,7 @@ /** * Sets the current row with its original value and marks the row as * not updated, thus undoing any changes made to the row since the - * last call to the methods updateRow or deleteRow. + * last call to the methods {@code updateRow} or {@code deleteRow}. * This method should be called only when the cursor is on a row in * this rowset. * @@ -3672,11 +3680,11 @@ /** * Rolls back any updates made to the current row of this - * CachedRowSetImpl object and notifies listeners that + * {@code CachedRowSetImpl} object and notifies listeners that * a row has changed. To have an effect, this method - * must be called after an updateXXX method has been - * called and before the method updateRow has been called. - * If no updates have been made or the method updateRow + * must be called after an {@code updateXXX} method has been + * called and before the method {@code updateRow} has been called. + * If no updates have been made or the method {@code updateRow} * has already been called, this method has no effect. * * @throws SQLException if the cursor is on the insert row, before the @@ -3687,39 +3695,39 @@ } /** - * Moves the cursor for this CachedRowSetImpl object + * Moves the cursor for this {@code CachedRowSetImpl} object * to the insert row. The current row in the rowset is remembered * while the cursor is on the insert row. * * The insert row is a special row associated with an updatable * rowset. It is essentially a buffer where a new row may - * be constructed by calling the appropriate updateXXX + * be constructed by calling the appropriate {@code updateXXX} * methods to assign a value to each column in the row. A complete * row must be constructed; that is, every column that is not nullable * must be assigned a value. In order for the new row to become part - * of this rowset, the method insertRow must be called + * of this rowset, the method {@code insertRow} must be called * before the cursor is moved back to the rowset. * * Only certain methods may be invoked while the cursor is on the insert * row; many methods throw an exception if they are called while the - * cursor is there. In addition to the updateXXX - * and insertRow methods, only the getXXX methods - * may be called when the cursor is on the insert row. A getXXX - * method should be called on a column only after an updateXXX + * cursor is there. In addition to the {@code updateXXX} + * and {@code insertRow} methods, only the {@code getXXX} methods + * may be called when the cursor is on the insert row. A {@code getXXX} + * method should be called on a column only after an {@code updateXXX} * method has been called on that column; otherwise, the value returned is * undetermined. * - * @throws SQLException if this CachedRowSetImpl object is - * ResultSet.CONCUR_READ_ONLY + * @throws SQLException if this {@code CachedRowSetImpl} object is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void moveToInsertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor for this CachedRowSetImpl object to + * Moves the cursor for this {@code CachedRowSetImpl} object to * the current row. The current row is the row the cursor was on - * when the method moveToInsertRow was called. + * when the method {@code moveToInsertRow} was called. * * Calling this method has no effect unless it is called while the * cursor is on the insert row. @@ -3731,9 +3739,9 @@ } /** - * Returns null. + * Returns {@code null}. * - * @return null + * @return {@code null} * @throws SQLException if an error occurs */ public Statement getStatement() throws SQLException { @@ -3742,18 +3750,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column index is out of bounds or * the cursor is not on one of this rowset's rows or its * insert row @@ -3767,17 +3775,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL REF value + * SQL {@code REF} value * @see #getRef(String) */ public Ref getRef(int columnIndex) throws SQLException { @@ -3786,17 +3794,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BLOB value + * SQL {@code BLOB} value * @see #getBlob(String) */ public Blob getBlob(int columnIndex) throws SQLException { @@ -3805,17 +3813,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Clob object representing an SQL CLOB value + * @return a {@code Clob} object representing an SQL {@code CLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL CLOB value + * SQL {@code CLOB} value * @see #getClob(String) */ public Clob getClob(int columnIndex) throws SQLException { @@ -3824,18 +3832,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL ARRAY value + * SQL {@code ARRAY} value * @see #getArray(String) */ public Array getArray(int columnIndex) throws SQLException { @@ -3844,17 +3852,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column name is not the name of * a column in this rowset or the cursor is not on one of * this rowset's rows or its insert row @@ -3867,16 +3875,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the column value - * is not an SQL REF value + * is not an SQL {@code REF} value * @see #getRef(int) */ public Ref getRef(String colName) throws SQLException { @@ -3885,16 +3893,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BLOB value + * column does not store an SQL {@code BLOB} value * @see #getBlob(int) */ public Blob getBlob(String colName) throws SQLException { @@ -3903,17 +3911,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Clob object representing an SQL - * CLOB value + * @return a {@code Clob} object representing an SQL + * {@code CLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CLOB value + * column does not store an SQL {@code CLOB} value * @see #getClob(int) */ public Clob getClob(String colName) throws SQLException { @@ -3922,17 +3930,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming langugage. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL ARRAY value + * column does not store an SQL {@code ARRAY} value * @see #getArray(int) */ public Array getArray(String colName) throws SQLException { @@ -3941,22 +3949,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3964,21 +3972,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3986,22 +3994,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4009,21 +4017,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4031,22 +4039,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Timestamp - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4054,22 +4062,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object, using the given - * Calendar object to construct an appropriate + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object, using the given + * {@code Calendar} object to construct an appropriate * millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE, - * TIME, or TIMESTAMP value + * column does not store an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4080,13 +4088,13 @@ */ /** - * Retrieves the Connection object passed to this - * CachedRowSetImpl object. This connection may be + * Retrieves the {@code Connection} object passed to this + * {@code CachedRowSetImpl} object. This connection may be * used to populate this rowset with data or to write data back * to its underlying data source. * - * @return the Connection object passed to this rowset; - * may be null if there is no connection + * @return the {@code Connection} object passed to this rowset; + * may be {@code null} if there is no connection * @throws SQLException if an error occurs */ public Connection getConnection() throws SQLException{ @@ -4094,10 +4102,10 @@ } /** - * Sets the metadata for this CachedRowSetImpl object - * with the given RowSetMetaData object. + * Sets the metadata for this {@code CachedRowSetImpl} object + * with the given {@code RowSetMetaData} object. * - * @param md a RowSetMetaData object instance containing + * @param md a {@code RowSetMetaData} object instance containing * metadata about the columsn in the rowset * @throws SQLException if invalid meta data is supplied to the * rowset @@ -4108,17 +4116,17 @@ /** * Returns a result set containing the original value of the rowset. The - * original value is the state of the CachedRowSetImpl after the + * original value is the state of the {@code CachedRowSetImpl} after the * last population or synchronization (whichever occurred most recently) with * the data source. * * The cursor is positioned before the first row in the result set. - * Only rows contained in the result set returned by getOriginal() + * Only rows contained in the result set returned by {@code getOriginal()} * are said to have an original value. * * @return the original result set of the rowset * @throws SQLException if an error occurs produce the - * ResultSet object + * {@code ResultSet} object */ public ResultSet getOriginal() throws SQLException { throw new UnsupportedOperationException(); @@ -4127,7 +4135,7 @@ /** * Returns a result set containing the original value of the current * row only. - * The original value is the state of the CachedRowSetImpl after + * The original value is the state of the {@code CachedRowSetImpl} after * the last population or synchronization (whichever occurred most recently) * with the data source. * @@ -4153,7 +4161,7 @@ /** * Marks all rows in this rowset as being original rows. Any updates * made to the rows become the original values for the rowset. - * Calls to the method setOriginal connot be reversed. + * Calls to the method {@code setOriginal} connot be reversed. * * @throws SQLException if an error occurs */ @@ -4165,8 +4173,8 @@ * Returns an identifier for the object (table) that was used to create this * rowset. * - * @return a String object that identifies the table from - * which this CachedRowSetImpl object was derived + * @return a {@code String} object that identifies the table from + * which this {@code CachedRowSetImpl} object was derived * @throws SQLException if an error occurs */ public String getTableName() throws SQLException { @@ -4177,8 +4185,8 @@ * Sets the identifier for the table from which this rowset was derived * to the given table name. * - * @param tabName a String object that identifies the - * table from which this CachedRowSetImpl object + * @param tabName a {@code String} object that identifies the + * table from which this {@code CachedRowSetImpl} object * was derived * @throws SQLException if an error occurs */ @@ -4188,7 +4196,7 @@ /** * Returns the columns that make a key to uniquely identify a - * row in this CachedRowSetImpl object. + * row in this {@code CachedRowSetImpl} object. * * @return an array of column numbers that constitutes a primary * key for this rowset. This array should be empty @@ -4203,16 +4211,16 @@ /** - * Sets this CachedRowSetImpl object's - * keyCols field with the given array of column + * Sets this {@code CachedRowSetImpl} object's + * {@code keyCols} field with the given array of column * numbers, which forms a key for uniquely identifying a row * in this rowset. * - * @param keys an array of int indicating the + * @param keys an array of {@code int} indicating the * columns that form a primary key for this - * CachedRowSetImpl object; every + * {@code CachedRowSetImpl} object; every * element in the array must be greater than - * 0 and less than or equal to the number + * {@code 0} and less than or equal to the number * of columns in this rowset * @throws SQLException if any of the numbers in the * given array is not valid for this rowset @@ -4224,8 +4232,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4236,14 +4244,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4251,8 +4259,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4263,13 +4271,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4277,8 +4285,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4289,14 +4297,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + *
updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4631,8 +4631,8 @@ /*o - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnIndex the first column is 1, the second 2, ... * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4643,8 +4643,8 @@ } /** - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnName name of the column * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4656,12 +4656,12 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param i the first column is 1, the second is 2, ... - * @return a NClob object representing the SQL - * NCLOB value in the specified column + * @return a {@code NClob} object representing the SQL + * {@code NCLOB} value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4672,11 +4672,11 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param colName the name of the column from which to retrieve the value - * @return a NClob object representing the SQL NCLOB + * @return a {@code NClob} object representing the SQL {@code NCLOB} * value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 @@ -4694,10 +4694,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * SQL {@code XML} value when it sends it to the database. * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an SQL {@code XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4706,10 +4706,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * {@code SQL XML} value when it sends it to the database. * @param parameterName the name of the parameter - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an {@code SQL XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4718,8 +4718,8 @@ } /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID value when it sends it + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} value when it sends it * to the database * * @param parameterIndex the first parameter is 1, the second is 2, ... @@ -4732,9 +4732,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID when it sends it to the + /** + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} when it sends it to the * database. * * @param parameterName the name of the parameter @@ -4748,18 +4748,18 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR value + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on NVARCHAR values) + * size relative to the driver's limits on {@code NVARCHAR} values) * when it sends it to the database. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNString(int parameterIndex, String value) throws SQLException { @@ -4768,9 +4768,9 @@ /** - * Sets the designated parameter in this RowSet object's command - * to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter in this {@code RowSet} object's command + * to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -4779,14 +4779,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed PreparedStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -4795,14 +4795,14 @@ } /** - * Sets the designated parameter to a java.sql.NClob object. The object - * implements the java.sql.NClob interface. This NClob - * object maps to a SQL NCLOB. + * Sets the designated parameter to a {@code java.sql.NClob} object. The object + * implements the {@code java.sql.NClob} interface. This {@code NClob} + * object maps to a SQL {@code NCLOB}. * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(String parameterName, NClob value) throws SQLException { @@ -4810,17 +4810,17 @@ } - /** + /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @exception SQLException if a database access error occurs * @since 1.6 @@ -4832,16 +4832,16 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the name of the column - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4850,11 +4850,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * @param columnIndex the first column is 1, the second 2, ... * @param xmlObject the value for the column to be updated @@ -4866,11 +4866,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4884,15 +4884,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnIndex the first column is 1, the second is 2, ... - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4902,15 +4902,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4927,9 +4927,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnIndex - the first column is 1, the second is 2, ... - * @param x - the new column value - * @param length - the length of the stream + * @param columnIndex the first column is 1, the second is 2, ... + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4949,9 +4949,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnName - name of the Column - * @param x - the new column value - * @param length - the length of the stream + * @param columnName name of the Column + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4963,26 +4963,27 @@ } /** - * Updates the designated column with a character stream value. The + * Updates the designated column with a character stream value. The * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} or this + * method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -4997,26 +4998,27 @@ * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * the result set concurrency is {@code CONCUR_READ_ONLY} or + * this method is called on a closed result set + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method * @since 1.6 */ public void updateNCharacterStream(String columnLabel, @@ -5027,9 +5029,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5039,16 +5041,16 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5060,9 +5062,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5072,18 +5074,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, + * then the label is the name of the column. * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException { @@ -5092,9 +5096,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5102,23 +5106,23 @@ * Java stream object or your own subclass that implements the * standard interface. * - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException { @@ -5127,9 +5131,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5138,22 +5142,23 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException { @@ -5161,11 +5166,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5175,17 +5180,17 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5193,11 +5198,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5207,17 +5212,18 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5225,33 +5231,33 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader) throws SQLException { @@ -5259,34 +5265,35 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader) throws SQLException { @@ -5294,11 +5301,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5308,19 +5315,19 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5328,11 +5335,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5342,19 +5349,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5362,11 +5370,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5375,22 +5383,22 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader) throws SQLException { @@ -5398,11 +5406,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5411,23 +5419,24 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader) throws SQLException { @@ -5435,22 +5444,22 @@ } - /** + /** * Updates the designated column with an ascii stream value, which will have * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5464,17 +5473,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBinaryStream(int columnIndex, @@ -5488,17 +5497,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5512,17 +5521,19 @@ * the specified number of bytes.. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5535,20 +5546,20 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5560,21 +5571,22 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5588,15 +5600,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5611,18 +5625,18 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5637,19 +5651,20 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5665,18 +5680,20 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5689,20 +5706,20 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5714,22 +5731,23 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5738,97 +5756,98 @@ } - /** - * Sets the designated parameter to the given java.net.URL value. - * The driver converts this to an SQL DATALINK value - * when it sends it to the database. - * - * @param parameterIndex the first parameter is 1, the second is 2, ... - * @param x the java.net.URL object to be set - * @exception SQLException if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.4 - */ + /** + * Sets the designated parameter to the given {@code java.net.URL} value. + * The driver converts this to an SQL {@code DATALINK} value + * when it sends it to the database. + * + * @param parameterIndex the first parameter is 1, the second is 2, ... + * @param x the {@code java.net.URL} object to be set + * @exception SQLException if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * @since 1.4 + */ public void setURL(int parameterIndex, java.net.URL x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB - * Note: Consult your JDBC driver documentation to determine if - * it might be more efficient to use a version of - * setNClob which takes a length parameter. - * - * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param reader An object that contains the data to set the parameter value to. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * - * @since 1.6 - */ + /** + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * Note: Consult your JDBC driver documentation to determine if + * it might be more efficient to use a version of + * {@code setNClob} which takes a length parameter. + * + * @param parameterIndex index of the first parameter is 1, the second is 2, ... + * @param reader An object that contains the data to set the parameter value to. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * + * @since 1.6 + */ public void setNClob(int parameterIndex, Reader reader) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB - * - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national - * character sets; if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * @since 1.6 - */ - public void setNClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. + * The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national + * character sets; if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * @since 1.6 + */ + public void setNClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); - } + } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNClob which takes a length parameter. + * {@code setNClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5839,23 +5858,24 @@ } - /** - ** of characters specified by length otherwise a SQLException will becontain the number - * generated when the PreparedStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method + /** + * of characters specified by length otherwise a {@code SQLException} will becontain the number + * generated when the {@code PreparedStatement} is executed. + * This method differs from the {@code setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5867,14 +5887,14 @@ /** - * Sets the designated parameter to a java.sql.NClob object. The driver converts this to -a - * SQL NCLOB value when it sends it to the database. + * Sets the designated parameter to a {@code java.sql.NClob} object. + * The driver converts this to an + * SQL {@code NCLOB} value when it sends it to the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(int parameterIndex, NClob value) throws SQLException{ @@ -5883,14 +5903,14 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNString(String parameterName, String value) @@ -5899,8 +5919,8 @@ } /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... @@ -5908,7 +5928,7 @@ * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException{ @@ -5918,8 +5938,8 @@ /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterName the name of the column to be set @@ -5935,9 +5955,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + /** + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -5946,14 +5966,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed CallableStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -5962,23 +5982,23 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIMESTAMP value, + * Sets the designated parameter to the given {@code java.sql.Timestamp} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIMESTAMP} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the timestamp + * a {@code Calendar} object, the driver can calculate the timestamp * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use - * to construct the timestamp + * @param cal the {@code Calendar} object the driver will use + * to construct the timestamp * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -5987,28 +6007,29 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } @@ -6016,16 +6037,16 @@ /** - * Sets the designated parameter to the given java.sql.Clob object. - * The driver converts this to an SQL CLOB value when it + * Sets the designated parameter to the given {@code java.sql.Clob} object. + * The driver converts this to an SQL {@code CLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Clob object that maps an SQL CLOB value + * @param x a {@code Clob} object that maps an SQL {@code CLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setClob (String parameterName, Clob x) throws SQLException{ @@ -6033,21 +6054,21 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs or this method is called on - * a closed CallableStatement + * a closed {@code CallableStatement} * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6058,19 +6079,19 @@ } - /** - * Sets the designated parameter to the given java.sql.Date value + /** + * Sets the designated parameter to the given {@code java.sql.Date} value * using the default time zone of the virtual machine that is running * the application. * The driver converts this - * to an SQL DATE value when it sends it to the database. + * to an SQL {@code DATE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6080,23 +6101,23 @@ } /** - * Sets the designated parameter to the given java.sql.Date value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL DATE value, + * Sets the designated parameter to the given {@code java.sql.Date} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code DATE} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the date + * a {@code Calendar} object, the driver can calculate the date * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the date * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6107,16 +6128,16 @@ /** - * Sets the designated parameter to the given java.sql.Time value. + * Sets the designated parameter to the given {@code java.sql.Time} value. * The driver converts this - * to an SQL TIME value when it sends it to the database. + * to an SQL {@code TIME} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6126,23 +6147,23 @@ } /** - * Sets the designated parameter to the given java.sql.Time value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIME value, + * Sets the designated parameter to the given {@code java.sql.Time} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIME} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the time + * a {@code Calendar} object, the driver can calculate the time * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the time * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6152,22 +6173,22 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatementor if parameterIndex does not correspond to a parameter - * marker in the SQL statement + * a closed {@code PreparedStatement}or if parameterIndex does not correspond to a parameter + * marker in the SQL statement * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6179,19 +6200,19 @@ /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - *This method differs from the setCharacterStream (int, Reader, int) method + * Sets the designated parameter to a {@code Reader} object. The reader 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 setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatement, if parameterIndex does not correspond to a parameter + * a closed {@code PreparedStatement}, if parameterIndex does not correspond to a parameter * marker in the SQL statement, or if the length specified is less than zero. * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method @@ -6204,25 +6225,26 @@ /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) + * Sets the designated parameter to a {@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)} * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... + * the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement, - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, if the length specified - * is less than zero or if the number of bytes in the inputstream does not match - * the specified length. + * this method is called on a closed {@code PreparedStatement}, + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, if the length specified + * is less than zero or if the number of bytes in the inputstream does not match + * the specified length. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6233,28 +6255,27 @@ } /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) - * This method differs from the setBinaryStream (int, InputStream) + * Sets the designated parameter to a {@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 - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... - - + * the second is 2, ... + * * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement or - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, + * this method is called on a closed {@code PreparedStatement} or + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6264,72 +6285,72 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length, otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) - * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, - * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB - * - * @param parameterName the name of the parameter to be set - * the second is 2, ... - * - * @param inputStream An object that contains the data to set the parameter - * value to. - * @param length the number of bytes in the parameter data. - * @throws SQLException if parameterIndex does not correspond - * to a parameter marker in the SQL statement, or if the length specified - * is less than zero; if the number of bytes in the inputstream does not match - * the specified length; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setBlob(String parameterName, InputStream inputStream, long length) + /** + * Sets the designated parameter to a {@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)} + * 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, + * the driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * + * @param parameterName the name of the parameter to be set + * the second is 2, ... + * + * @param inputStream An object that contains the data to set the parameter + * value to. + * @param length the number of bytes in the parameter data. + * @throws SQLException if parameterIndex does not correspond + * to a parameter marker in the SQL statement, or if the length specified + * is less than zero; if the number of bytes in the inputstream does not match + * the specified length; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.Blob object. - * The driver converts this to an SQL BLOB value when it + /** + * Sets the designated parameter to the given {@code java.sql.Blob} object. + * The driver converts this to an SQL {@code BLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Blob object that maps an SQL BLOB value + * @param x a {@code Blob} object that maps an SQL {@code BLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setBlob (String parameterName, Blob x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) + /** + * Sets the designated parameter to a {@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 BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARBINARY or a BLOB + * data should be send to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterName the name of the parameter * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6339,22 +6360,22 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. The second * argument must be an object type; for integral values, the - * java.lang equivalent objects should be used. + * {@code java.lang} equivalent objects should be used. * * The given Java object will be converted to the given targetSqlType * before being sent to the database. * * If the object has a custom mapping (is of a class implementing the - * interface SQLData), - * the JDBC driver should call the method SQLData.writeSQL to write it + * interface {@code SQLData}), + * the JDBC driver should call the method {@code SQLData.writeSQL} to write it * to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * Note that this method may be used to pass datatabase- @@ -6365,17 +6386,17 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database. The scale argument may further qualify this type. * @param scale for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types, this value will be ignored. + * this is the number of digits after the decimal point. For all other + * types, this value will be ignored. * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see Types * @see #getObject * @since 1.4 @@ -6387,7 +6408,7 @@ /** * Sets the value of the designated parameter with the given object. - * This method is like the method setObject + * This method is like the method {@code setObject} * above, except that it assumes a scale of zero. * * @param parameterName the name of the parameter @@ -6395,14 +6416,14 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see #getObject * @since 1.4 */ @@ -6411,13 +6432,13 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. - * The second parameter must be of type Object; therefore, the - * java.lang equivalent objects should be used for built-in types. + * The second parameter must be of type {@code Object}; therefore, the + * {@code java.lang} equivalent objects should be used for built-in types. * * The JDBC specification specifies a standard mapping from - * Java Object types to SQL types. The given argument + * Java {@code Object} types to SQL types. The given argument * will be converted to the corresponding SQL type before being * sent to the database. * @@ -6425,13 +6446,13 @@ * specific abstract data types, by using a driver-specific Java * type. * - * If the object is of a class implementing the interface SQLData, - * the JDBC driver should call the method SQLData.writeSQL + * If the object is of a class implementing the interface {@code SQLData}, + * the JDBC driver should call the method {@code SQLData.writeSQL} * to write it to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * This method throws an exception if there is an ambiguity, for example, if the @@ -6440,10 +6461,10 @@ * @param parameterName the name of the parameter * @param x the object containing the input parameter value * @exception SQLException if a database access error occurs, - * this method is called on a closed CallableStatement or if the given - * Object parameter is ambiguous + * this method is called on a closed {@code CallableStatement} or if the given + * {@code Object} parameter is ambiguous * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getObject * @since 1.4 */ @@ -6454,9 +6475,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6468,9 +6489,9 @@ * @param x the Java input stream that contains the ASCII parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setAsciiStream(String parameterName, java.io.InputStream x, int length) @@ -6482,9 +6503,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the stream + * {@code java.io.InputStream} object. The data will be read from the stream * as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6495,9 +6516,9 @@ * @param x the java input stream which contains the binary parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBinaryStream(String parameterName, java.io.InputStream x, @@ -6506,11 +6527,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6519,13 +6540,13 @@ * standard interface. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that + * @param reader the {@code java.io.Reader} object that * contains the UNICODE data used as the designated parameter * @param length the number of characters in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setCharacterStream(String parameterName, @@ -6536,9 +6557,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6547,15 +6568,15 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setAsciiStream which takes a length parameter. + * {@code setAsciiStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the Java input stream that contains the ASCII parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.6 - */ + * @since 1.6 + */ public void setAsciiStream(String parameterName, java.io.InputStream x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); @@ -6564,9 +6585,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the + * {@code java.io.InputStream} object. The data will be read from the * stream as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6574,12 +6595,12 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBinaryStream which takes a length parameter. + * {@code setBinaryStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the java input stream which contains the binary parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6589,11 +6610,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6602,13 +6623,13 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setCharacterStream which takes a length parameter. + * {@code setCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that contains the + * @param reader the {@code java.io.Reader} object that contains the * Unicode data * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6619,16 +6640,16 @@ /** * Sets the designated parameter to the given - * java.math.BigDecimal value. - * The driver converts this to an SQL NUMERIC value when + * {@code java.math.BigDecimal} value. + * The driver converts this to an SQL {@code NUMERIC} value when * it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBigDecimal * @since 1.4 */ @@ -6636,20 +6657,20 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java String value. + /** + * Sets the designated parameter to the given Java {@code String} value. * The driver converts this - * to an SQL VARCHAR or LONGVARCHAR value + * to an SQL {@code VARCHAR} or {@code LONGVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on VARCHAR values) + * size relative to the driver's limits on {@code VARCHAR} values) * when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getString * @since 1.4 */ @@ -6659,19 +6680,19 @@ - /** + /** * Sets the designated parameter to the given Java array of bytes. - * The driver converts this to an SQL VARBINARY or - * LONGVARBINARY (depending on the argument's size relative - * to the driver's limits on VARBINARY values) when it sends + * The driver converts this to an SQL {@code VARBINARY} or + * {@code LONGVARBINARY} (depending on the argument's size relative + * to the driver's limits on {@code VARBINARY} values) when it sends * it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBytes * @since 1.4 */ @@ -6680,17 +6701,17 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value. + * Sets the designated parameter to the given {@code java.sql.Timestamp} value. * The driver - * converts this to an SQL TIMESTAMP value when it sends it to the + * converts this to an SQL {@code TIMESTAMP} value when it sends it to the * database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -6700,16 +6721,16 @@ } /** - * Sets the designated parameter to SQL NULL. + * Sets the designated parameter to SQL {@code NULL}. * * Note: You must specify the parameter's SQL type. * * @param parameterName the name of the parameter - * @param sqlType the SQL type code defined in java.sql.Types + * @param sqlType the SQL type code defined in {@code java.sql.Types} * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull(String parameterName, int sqlType) throws SQLException { @@ -6717,8 +6738,8 @@ } /** - * Sets the designated parameter to SQL NULL. - * This version of the method setNull should + * Sets the designated parameter to SQL {@code NULL}. + * This version of the method {@code setNull} should * be used for user-defined types and REF type parameters. Examples * of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and * named array types. @@ -6738,14 +6759,14 @@ * * * @param parameterName the name of the parameter - * @param sqlType a value from java.sql.Types + * @param sqlType a value from {@code java.sql.Types} * @param typeName the fully-qualified name of an SQL user-defined type; * ignored if the parameter is not a user-defined type or - * SQL REF value + * SQL {@code REF} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull (String parameterName, int sqlType, String typeName) @@ -6754,17 +6775,17 @@ } /** - * Sets the designated parameter to the given Java boolean value. + * Sets the designated parameter to the given Java {@code boolean} value. * The driver converts this - * to an SQL BIT or BOOLEAN value when it sends it to the database. + * to an SQL {@code BIT} or {@code BOOLEAN} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @see #getBoolean * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBoolean(String parameterName, boolean x) throws SQLException{ @@ -6774,16 +6795,16 @@ /** - * Sets the designated parameter to the given Java byte value. + * Sets the designated parameter to the given Java {@code byte} value. * The driver converts this - * to an SQL TINYINT value when it sends it to the database. + * to an SQL {@code TINYINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getByte * @since 1.4 */ @@ -6793,16 +6814,16 @@ /** - * Sets the designated parameter to the given Java short value. + * Sets the designated parameter to the given Java {@code short} value. * The driver converts this - * to an SQL SMALLINT value when it sends it to the database. + * to an SQL {@code SMALLINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getShort * @since 1.4 */ @@ -6812,16 +6833,16 @@ /** - * Sets the designated parameter to the given Java int value. + * Sets the designated parameter to the given Java {@code int} value. * The driver converts this - * to an SQL INTEGER value when it sends it to the database. + * to an SQL {@code INTEGER} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getInt * @since 1.4 */ @@ -6829,17 +6850,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java long value. + /** + * Sets the designated parameter to the given Java {@code long} value. * The driver converts this - * to an SQL BIGINT value when it sends it to the database. + * to an SQL {@code BIGINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getLong * @since 1.4 */ @@ -6848,17 +6869,17 @@ } - /** - * Sets the designated parameter to the given Java float value. + /** + * Sets the designated parameter to the given Java {@code float} value. * The driver converts this - * to an SQL FLOAT value when it sends it to the database. + * to an SQL {@code FLOAT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getFloat * @since 1.4 */ @@ -6866,17 +6887,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java double value. + /** + * Sets the designated parameter to the given Java {@code double} value. * The driver converts this - * to an SQL DOUBLE value when it sends it to the database. + * to an SQL {@code DOUBLE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDouble * @since 1.4 */ @@ -6887,7 +6908,6 @@ /** * This method re populates the resBundle * during the deserialization process - * */ private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException { // Default state initialization happens here --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.803466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.635466074 +0400 @@ -43,22 +43,22 @@ /** - * The facility called on internally by the RIOptimisticProvider implementation to + * The facility called on internally by the {@code RIOptimisticProvider} implementation to * propagate changes back to the data source from which the rowset got its data. * - * A CachedRowSetWriter object, called a writer, has the public - * method writeData for writing modified data to the underlying data source. + * A {@code CachedRowSetWriter} object, called a writer, has the public + * method {@code writeData} for writing modified data to the underlying data source. * This method is invoked by the rowset internally and is never invoked directly by an application. * A writer also has public methods for setting and getting - * the CachedRowSetReader object, called a reader, that is associated + * the {@code CachedRowSetReader} object, called a reader, that is associated * with the writer. The remainder of the methods in this class are private and * are invoked internally, either directly or indirectly, by the method - * writeData. + * {@code writeData}. * - * Typically the SyncFactory manages the RowSetReader and - * the RowSetWriter implementations using SyncProvider objects. + * Typically the {@code SyncFactory} manages the {@code RowSetReader} and + * the {@code RowSetWriter} implementations using {@code SyncProvider} objects. * Standard JDBC RowSet implementations provide an object instance of this - * writer by invoking the SyncProvider.getRowSetWriter() method. + * writer by invoking the {@code SyncProvider.getRowSetWriter()} method. * * @version 0.2 * @author Jonathan Bruce @@ -69,15 +69,15 @@ public class CachedRowSetWriter implements TransactionalWriter, Serializable { /** - * The Connection object that this writer will use to make a + * The {@code Connection} object that this writer will use to make a * connection to the data source to which it will write data. * */ private transient Connection con; /** - * The SQL SELECT command that this writer will call - * internally. The method initSQLStatements builds this + * The SQL {@code SELECT} command that this writer will call + * internally. The method {@code initSQLStatements} builds this * command by supplying the words "SELECT" and "FROM," and using * metadata to get the table name and column names . * @@ -86,9 +86,9 @@ private String selectCmd; /** - * The SQL UPDATE command that this writer will call + * The SQL {@code UPDATE} command that this writer will call * internally to write data to the rowset's underlying data source. - * The method initSQLStatements builds this String + * The method {@code initSQLStatements} builds this {@code String} * object. * * @serial @@ -96,8 +96,8 @@ private String updateCmd; /** - * The SQL WHERE clause the writer will use for update - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for update + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -105,7 +105,7 @@ private String updateWhere; /** - * The SQL DELETE command that this writer will call + * The SQL {@code DELETE} command that this writer will call * internally to delete a row in the rowset's underlying data source. * * @serial @@ -113,8 +113,8 @@ private String deleteCmd; /** - * The SQL WHERE clause the writer will use for delete - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for delete + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -122,9 +122,9 @@ private String deleteWhere; /** - * The SQL INSERT INTO command that this writer will internally use + * The SQL {@code INSERT INTO} command that this writer will internally use * to insert data into the rowset's underlying data source. The method - * initSQLStatements builds this command with a question + * {@code initSQLStatements} builds this command with a question * mark parameter placeholder for each column in the rowset. * * @serial @@ -133,8 +133,8 @@ /** * An array containing the column numbers of the columns that are - * needed to uniquely identify a row in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * needed to uniquely identify a row in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ @@ -142,7 +142,7 @@ /** * An array of the parameters that should be used to set the parameter - * placeholders in a PreparedStatement object that this + * placeholders in a {@code PreparedStatement} object that this * writer will execute. * * @serial @@ -150,33 +150,33 @@ private Object[] params; /** - * The CachedRowSetReader object that has been - * set as the reader for the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code CachedRowSetReader} object that has been + * set as the reader for the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private CachedRowSetReader reader; /** - * The ResultSetMetaData object that contains information - * about the columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code ResultSetMetaData} object that contains information + * about the columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private ResultSetMetaData callerMd; /** - * The number of columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The number of columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private int callerColumnCount; /** - * This CachedRowSet will hold the conflicting values + * This {@code CachedRowSet} will hold the conflicting values * retrieved from the db and hold it. */ private CachedRowSetImpl crsResolve; @@ -209,8 +209,8 @@ } /** - * Propagates changes in the given RowSet object - * back to its underlying data source and returns true + * Propagates changes in the given {@code RowSet} object + * back to its underlying data source and returns {@code true} * if successful. The writer will check to see if * the data in the pre-modified rowset (the original values) differ * from the data in the underlying data source. If data in the data @@ -221,15 +221,15 @@ * access for concurrent users. * * This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. * - * Creates a CachedRowSet object from the given - * RowSet object + * Creates a {@code CachedRowSet} object from the given + * {@code RowSet} object * Makes a connection with the data source * * Disables autocommit mode if it is not already disabled @@ -237,32 +237,32 @@ * * Checks to see if the reader has read new data since the writer * was last called and, if so, calls the method - * initSQLStatements to initialize new SQL statements + * {@code initSQLStatements} to initialize new SQL statements * - * Builds new SELECT, UPDATE, - * INSERT, and DELETE statements - * Uses the CachedRowSet object's metadata to + * Builds new {@code SELECT}, {@code UPDATE}, + * {@code INSERT}, and {@code DELETE} statements + * Uses the {@code CachedRowSet} object's metadata to * determine the table name, column names, and the columns * that make up the primary key * * When there is no conflict, propagates changes made to the - * CachedRowSet object back to its underlying data source + * {@code CachedRowSet} object back to its underlying data source * - * Iterates through each row of the CachedRowSet object + * Iterates through each row of the {@code CachedRowSet} object * to determine whether it has been updated, inserted, or deleted * If the corresponding row in the data source has not been changed * since the rowset last read its * values, the writer will use the appropriate command to update, * insert, or delete the row * If any data in the data source does not match the original values - * for the CachedRowSet object, the writer will roll + * for the {@code CachedRowSet} object, the writer will roll * back any changes it has made to the row in the data source. * * * - * @return true if changes to the rowset were successfully + * @return {@code true} if changes to the rowset were successfully * written to the rowset's underlying data source; - * false otherwise + * {@code false} otherwise */ public boolean writeData(RowSetInternal caller) throws SQLException { long conflicts = 0; @@ -434,25 +434,25 @@ } //end writeData -/** - * Updates the given CachedRowSet object's underlying data - * source so that updates to the rowset are reflected in the original - * data source, and returns false if the update was successful. - * A return value of true indicates that there is a conflict, - * meaning that a value updated in the rowset has already been changed by - * someone else in the underlying data source. A conflict can also exist - * if, for example, more than one row in the data source would be affected - * by the update or if no rows would be affected. In any case, if there is - * a conflict, this method does not update the underlying data source. - * - * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + * + * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - * - * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + * + * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. * - * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - * - * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + * + * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. * * If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. * * The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. * * NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. * * This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. * - * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. * - * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. * * Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. * - * undoUpdateRowSet object backed by the same data as - * that of this CachedRowSetImpl object and sharing a set of cursors + * Returns a new {@code RowSet} object backed by the same data as + * that of this {@code CachedRowSetImpl} object and sharing a set of cursors * with it. This allows cursors to interate over a shared set of rows, providing * multiple views of the underlying data. * - * @return a RowSet object that is a copy of this CachedRowSetImpl + * @return a {@code RowSet} object that is a copy of this {@code CachedRowSetImpl} * object and shares a set of cursors with it * @throws SQLException if an error occurs or cloning is * not supported @@ -750,19 +750,19 @@ } /** - * Returns a new RowSet object containing by the same data - * as this CachedRowSetImpl object. This method - * differs from the method createCopy in that it throws a - * CloneNotSupportedException object instead of an - * SQLException object, as the method createShared - * does. This clone - * method is called internally by the method createShared, - * which catches the CloneNotSupportedException object - * and in turn throws a new SQLException object. + * Returns a new {@code RowSet} object containing by the same data + * as this {@code CachedRowSetImpl} object. This method + * differs from the method {@code createCopy} in that it throws a + * {@code CloneNotSupportedException} object instead of an + * {@code SQLException} object, as the method {@code createShared} + * does. This {@code clone} + * method is called internally by the method {@code createShared}, + * which catches the {@code CloneNotSupportedException} object + * and in turn throws a new {@code SQLException} object. * - * @return a copy of this CachedRowSetImpl object + * @return a copy of this {@code CachedRowSetImpl} object * @throws CloneNotSupportedException if an error occurs when - * attempting to clone this CachedRowSetImpl object + * attempting to clone this {@code CachedRowSetImpl} object * @see #createShared */ protected Object clone() throws CloneNotSupportedException { @@ -770,8 +770,8 @@ } /** - * Creates a RowSet object that is a deep copy of - * this CachedRowSetImpl object's data, including + * Creates a {@code RowSet} object that is a deep copy of + * this {@code CachedRowSetImpl} object's data, including * constraints. Updates made * on a copy are not visible to the original rowset; * a copy of a rowset is completely independent from the original. @@ -780,12 +780,12 @@ * from first principles, which can be quite expensive. * For example, it can eliminate the need to query a * remote database server. - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSet object and is - * completely independent from this CachedRowSetImpl + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSet} object and is + * completely independent from this {@code CachedRowSetImpl} * object. * @throws SQLException if an error occurs in generating the copy of this - * of the CachedRowSetImpl + * of the {@code CachedRowSetImpl} * @see #createShared * @see javax.sql.RowSetEvent * @see javax.sql.RowSetListener @@ -795,21 +795,21 @@ } /** - * Creates a RowSet object that is a copy of - * this CachedRowSetImpl object's table structure + * Creates a {@code RowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's table structure * and the constraints only. * There will be no data in the object being returned. * Updates made on a copy are not visible to the original rowset. * * This helps in getting the underlying XML schema which can - * be used as the basis for populating a WebRowSet. + * be used as the basis for populating a {@code WebRowSet}. * - * @return a new CachedRowSet object that is a copy - * of this CachedRowSetImpl object's schema and + * @return a new {@code CachedRowSet} object that is a copy + * of this {@code CachedRowSetImpl} object's schema and * retains all the constraints on the original rowset but contains * no data * @throws SQLException if an error occurs in generating the copy - * of the CachedRowSet object + * of the {@code CachedRowSet} object * @see #createShared * @see #createCopy * @see #createCopyNoConstraints @@ -821,17 +821,17 @@ } /** - * Creates a CachedRowSet object that is a copy of - * this CachedRowSetImpl object's data only. + * Creates a {@code CachedRowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's data only. * All constraints set in this object will not be there * in the returning object. Updates made * on a copy are not visible to the original rowset. * - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSetImpl object and is - * completely independent from this CachedRowSetImpl object + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSetImpl} object and is + * completely independent from this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the copy of the - * of the CachedRowSet + * of the {@code CachedRowSet} * @see #createShared * @see #createCopy * @see #createCopySchema @@ -843,15 +843,15 @@ } /** - * Converts this CachedRowSetImpl object to a collection - * of tables. The sample implementation utilitizes the TreeMap + * Converts this {@code CachedRowSetImpl} object to a collection + * of tables. The sample implementation utilitizes the {@code TreeMap} * collection type. * This class guarantees that the map will be in ascending key order, * sorted according to the natural order for the key's class. * - * @return a Collection object consisting of tables, + * @return a {@code Collection} object consisting of tables, * each of which is a copy of a row in this - * CachedRowSetImpl object + * {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the collection * @see #toCollection(int) * @see #toCollection(String) @@ -863,16 +863,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -886,16 +886,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -914,25 +914,25 @@ /** - * Returns the SyncProvider implementation being used - * with this CachedRowSetImpl implementation rowset. + * Returns the {@code SyncProvider} implementation being used + * with this {@code CachedRowSetImpl} implementation rowset. * * @return the SyncProvider used by the rowset. If not provider was * set when the rowset was instantiated, the reference * implementation (default) provider is returned. * @throws SQLException if error occurs while return the - * SyncProvider instance. + * {@code SyncProvider} instance. */ public SyncProvider getSyncProvider() throws SQLException { throw new UnsupportedOperationException(); } /** - * Sets the active SyncProvider and attempts to load - * load the new provider using the SyncFactory SPI. + * Sets the active {@code SyncProvider} and attempts to load + * load the new provider using the {@code SyncFactory} SPI. * * @throws SQLException if an error occurs while resetting the - * SyncProvider. + * {@code SyncProvider}. */ public void setSyncProvider(String providerStr) throws SQLException { throw new UnsupportedOperationException(); @@ -953,23 +953,23 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data. + * Populates this {@code CachedRowSetImpl} object with data. * This form of the method uses the rowset's user, password, and url or * data source name properties to create a database * connection. If properties that are needed * have not been set, this method will throw an exception. * - * Another form of this method uses an existing JDBC Connection + * Another form of this method uses an existing JDBC {@code Connection} * object instead of creating a new one; therefore, it ignores the * properties used for establishing a new connection. * * The query specified by the command property is executed to create a - * ResultSet object from which to retrieve data. + * {@code ResultSet} object from which to retrieve data. * The current contents of the rowset are discarded, and the * rowset's metadata is also (re)set. If there are outstanding updates, * they are also ignored. * - * The method execute closes any database connections that it + * The method {@code execute} closes any database connections that it * creates. * * @throws SQLException if an error occurs or the @@ -987,20 +987,20 @@ /** * Moves the cursor down one row from its current position and - * returns true if the new cursor position is a + * returns {@code true} if the new cursor position is a * valid row. - * The cursor for a new ResultSet object is initially + * The cursor for a new {@code ResultSet} object is initially * positioned before the first row. The first call to the method - * next moves the cursor to the first row, making it + * {@code next} moves the cursor to the first row, making it * the current row; the second call makes the second row the * current row, and so on. * * If an input stream from the previous row is open, it is - * implicitly closed. The ResultSet object's warning + * implicitly closed. The {@code ResultSet} object's warning * chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if an error occurs or * the cursor is not positioned in the rowset, before * the first row, or after the last row @@ -1010,9 +1010,9 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the next - * row and returns true if the cursor is still in the rowset; - * returns false if the cursor has moved to the position after + * Moves this {@code CachedRowSetImpl} object's cursor to the next + * row and returns {@code true} if the cursor is still in the rowset; + * returns {@code false} if the cursor has moved to the position after * the last row. * * This method handles the cases where the cursor moves to a row that @@ -1021,15 +1021,15 @@ * that has been deleted, this method moves the cursor to the next * row until the cursor is on a row that has not been deleted. * - * The method internalNext is called by methods such as - * next, absolute, and relative, + * The method {@code internalNext} is called by methods such as + * {@code next}, {@code absolute}, and {@code relative}, * and, as its name implies, is only called internally. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a valid row in this - * rowset; false if it is after the last row + * @return {@code true} if the cursor is on a valid row in this + * rowset; {@code false} if it is after the last row * @throws SQLException if an error occurs */ protected boolean internalNext() throws SQLException { @@ -1037,25 +1037,25 @@ } /** - * Closes this CachedRowSetImpl objecy and releases any resources + * Closes this {@code CachedRowSetImpl} objecy and releases any resources * it was using. * * @throws SQLException if an error occurs when releasing any resources in use - * by this CachedRowSetImpl object + * by this {@code CachedRowSetImpl} object */ public void close() throws SQLException { throw new UnsupportedOperationException(); } /** - * Reports whether the last column read was SQL NULL. - * Note that you must first call the method getXXX + * Reports whether the last column read was SQL {@code NULL}. + * Note that you must first call the method {@code getXXX} * on a column to try to read its value and then call the method - * wasNull to determine whether the value was - * SQL NULL. + * {@code wasNull} to determine whether the value was + * SQL {@code NULL}. * - * @return true if the value in the last column read - * was SQL NULL; false otherwise + * @return {@code true} if the value in the last column read + * was SQL {@code NULL}; {@code false} otherwise * @throws SQLException if an error occurs */ public boolean wasNull() throws SQLException { @@ -1064,9 +1064,9 @@ /** * Returns the insert row or the current row of this - * CachedRowSetImplobject. + * {@code CachedRowSetImpl}object. * - * @return the Row object on which this CachedRowSetImpl + * @return the {@code Row} object on which this {@code CachedRowSetImpl} * objects's cursor is positioned */ protected BaseRow getCurrentRow() { @@ -1077,7 +1077,7 @@ * Removes the row on which the cursor is positioned. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * * @throws SQLException if the cursor is positioned on the insert * row @@ -1089,20 +1089,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * String object. + * of this {@code CachedRowSetImpl} object as a + * {@code String} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} {@code CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type designates the * recommended return type. */ public String getString(int columnIndex) throws SQLException { @@ -1111,18 +1111,18 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * boolean value. + * of this {@code CachedRowSetImpl} object as a + * {@code boolean} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a boolean in the Java progamming language; - * if the value is SQL NULL, the result is false + * @return the column value as a {@code boolean} in the Java progamming language; + * if the value is SQL {@code NULL}, the result is {@code false} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BOOLEAN value + * SQL {@code BOOLEAN} value * @see #getBoolean(String) */ public boolean getBoolean(int columnIndex) throws SQLException { @@ -1131,20 +1131,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type + * SQL {@code TINYINT}, {@code SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type * designates the recommended return type. * @see #getByte(String) */ @@ -1154,21 +1154,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * short value. + * of this {@code CachedRowSetImpl} object as a + * {@code short} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT}, {@code SMALLINT}, + * {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(String) */ public short getShort(int columnIndex) throws SQLException { @@ -1177,21 +1178,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * int value. + * of this {@code CachedRowSetImpl} object as an + * {@code int} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1199,21 +1201,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * long value. + * of this {@code CachedRowSetImpl} object as a + * {@code long} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getLong(String) */ public long getLong(int columnIndex) throws SQLException { @@ -1222,21 +1225,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * float value. + * of this {@code CachedRowSetImpl} object as a + * {@code float} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,} + * {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC, + * BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(int columnIndex) throws SQLException { @@ -1245,21 +1248,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * double value. + * of this {@code CachedRowSetImpl} object as a + * {@code double} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,} + * {@code FLOAT, DOUBLE}, + * {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getDouble(String) * */ @@ -1269,21 +1273,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * This method is deprecated; use the version of getBigDecimal + * This method is deprecated; use the version of {@code getBigDecimal} * that does not take a scale parameter and returns a value with full * precision. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @param scale the number of digits to the right of the decimal point in the * value returned * @return the column value with the specified number of digits to the right - * of the decimal point; if the value is SQL NULL, the - * result is null + * of the decimal point; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails * @deprecated @@ -1295,22 +1299,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte array value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} array value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the - * result is null + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the + * result is {@code null} * * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or + * {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getBytes(String) */ public byte[] getBytes(int columnIndex) throws SQLException { @@ -1319,17 +1323,17 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Date object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Date} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a java.sql.Data object; if - * the value is SQL NULL, the - * result is null + * @return the column value as a {@code java.sql.Data} object; if + * the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, - * the cursor is not on a valid row, or this method fails + * the cursor is not on a valid row, or this method fails */ public java.sql.Date getDate(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1337,14 +1341,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Time object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Time} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1354,14 +1358,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1371,33 +1375,33 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The JDBC + * suitable for retrieving large {@code LONGVARCHAR} values. The JDBC * driver will do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. . Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(String) */ public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException { @@ -1416,8 +1420,8 @@ * stream may return 0 for available() whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of two byte Unicode characters. If the value is SQL NULL @@ -1432,30 +1436,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for - * CachedRowSetImpl.available() whether there is data + * stream may return {@code 0} for + * {@code CachedRowSetImpl.available()} whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes. If the value is SQL NULL - * then the result is null. + * as a stream of uninterpreted bytes. If the value is SQL {@code NULL} + * then the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY}. * The bold type indicates the SQL type that this method is recommened * to retrieve. * @see #getBinaryStream(String) @@ -1472,19 +1476,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a String object. + * of the current row as a {@code String} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR< value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} + * {@code CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. */ public String getString(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1492,17 +1496,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a boolean value. + * of the current row as a {@code boolean} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a boolean in the Java programming - * language; if the value is SQL NULL, - * the result is false + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code boolean} in the Java programming + * language; if the value is SQL {@code NULL}, + * the result is {@code false} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BOOLEAN value + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BOOLEAN} value * @see #getBoolean(int) */ public boolean getBoolean(String columnName) throws SQLException { @@ -1511,19 +1515,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte value. + * of the current row as a {@code byte} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The - * bold type designates the recommended return type + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT}, + * {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} + * value. The bold type designates the recommended return type. */ public byte getByte(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1531,19 +1535,20 @@ /** * Retrieves the value stored in the designated column - * of the current row as a short value. + * of the current row as a {@code short} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT,} + * {@code SMALLINT}, {@code INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(int) */ public short getShort(String columnName) throws SQLException { @@ -1552,20 +1557,21 @@ /** * Retrieves the value stored in the designated column - * of the current row as an int value. + * of the current row as an {@code int} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name - * of a column in this rowset, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * of a column in this rowset, + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1573,19 +1579,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a long value. + * of the current row as a {@code long} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getLong(int) */ public long getLong(String columnName) throws SQLException { @@ -1594,19 +1600,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a float value. + * of the current row as a {@code float} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT,} {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(String columnName) throws SQLException { @@ -1615,20 +1621,20 @@ /** * Retrieves the value stored in the designated column - * of the current row of this CachedRowSetImpl object - * as a double value. + * of the current row of this {@code CachedRowSetImpl} object + * as a {@code double} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return types. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL,} {@code FLOAT, DOUBLE}, {@code DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return types. * @see #getDouble(int) */ public double getDouble(String columnName) throws SQLException { @@ -1637,22 +1643,22 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.math.BigDecimal object. + * of the current row as a {@code java.math.BigDecimal} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @param scale the number of digits to the right of the decimal point - * @return a java.math.BugDecimal object with scale - * number of digits to the right of the decimal point. + * @return a java.math.BugDecimal object with {@code scale} + * number of digits to the right of the decimal point. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve. - * @deprecated Use the getBigDecimal(String columnName) + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. + * @deprecated Use the {@code getBigDecimal(String columnName)} * method instead */ @Deprecated @@ -1662,19 +1668,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte array. + * of the current row as a {@code byte} array. * The bytes represent the raw values returned by the driver. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BINARY, VARBINARY - * or LONGVARBINARY values - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BINARY, VARBINARY} + * or {@code LONGVARBINARY} values. + * The bold SQL type designates the recommended return type. * @see #getBytes(int) */ public byte[] getBytes(String columnName) throws SQLException { @@ -1683,17 +1689,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Date object. + * of the current row as a {@code java.sql.Date} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1701,12 +1707,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Time object. + * of the current row as a {@code java.sql.Time} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1717,12 +1723,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Timestamp object. + * of the current row as a {@code java.sql.Timestamp} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1733,32 +1739,32 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The - * SyncProvider will rely on the JDBC driver to do any necessary + * suitable for retrieving large {@code LONGVARCHAR} values. The + * {@code SyncProvider} will rely on the JDBC driver to do any necessary * conversion from the database format into ASCII format. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * a column in this rowset + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(int) */ public java.io.InputStream getAsciiStream(String columnName) throws SQLException { @@ -1769,23 +1775,23 @@ /** * A column value can be retrieved as a stream of Unicode characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will do any necessary conversion from the database * format into Unicode. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row - * @deprecated use the method getCharacterStream instead + * @deprecated use the method {@code getCharacterStream} instead */ @Deprecated public java.io.InputStream getUnicodeStream(String columnName) throws SQLException { @@ -1794,30 +1800,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of uninterpreted bytes. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is unknown, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY - * The bold type indicates the SQL type that this method is recommened - * to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY} + * The bold type indicates the SQL type that this method is recommened + * to retrieve. * @see #getBinaryStream(int) * */ @@ -1831,17 +1837,17 @@ //===================================================================== /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by statement + * by {@code ResultSet} methods. Any warning caused by statement * methods (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * * @return the first SQLWarning or null */ @@ -1850,10 +1856,10 @@ } /** - * Clears all the warnings reporeted for the CachedRowSetImpl - * object. After a call to this method, the getWarnings method - * returns null until a new warning is reported for this - * CachedRowSetImpl object. + * Clears all the warnings reporeted for the {@code CachedRowSetImpl} + * object. After a call to this method, the {@code getWarnings} method + * returns {@code null} until a new warning is reported for this + * {@code CachedRowSetImpl} object. */ public void clearWarnings() { throw new UnsupportedOperationException(); @@ -1861,25 +1867,25 @@ /** * Retrieves the name of the SQL cursor used by this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * * In SQL, a result table is retrieved through a cursor that is - * named. The current row of a ResultSet can be updated or deleted + * named. The current row of a {@code ResultSet} can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To ensure that the cursor has the proper isolation - * level to support an update operation, the cursor's SELECT - * statement should be of the form select for update. - * If the for update clause + * level to support an update operation, the cursor's {@code SELECT} + * statement should be of the form {@code select for update}. + * If the {@code for update} clause * is omitted, positioned updates may fail. * * JDBC supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. The current row + * SQL cursor used by a {@code ResultSet} object. The current row * of a result set is also the current row of this SQL cursor. * * Note: If positioned updates are not supported, an - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL cursor name for this CachedRowSetImpl object's + * @return the SQL cursor name for this {@code CachedRowSetImpl} object's * cursor * @throws SQLException if an error occurs */ @@ -1888,12 +1894,12 @@ } /** - * Retrieves a ResultSetMetaData object instance that - * contains information about the CachedRowSet object. + * Retrieves a {@code ResultSetMetaData} object instance that + * contains information about the {@code CachedRowSet} object. * However, applications should cast the returned object to a - * RowSetMetaData interface implementation. In the + * {@code RowSetMetaData} interface implementation. In the * reference implementation, this cast can be done on the - * RowSetMetaDataImpl class. + * {@code RowSetMetaDataImpl} class. * * For example: * @@ -1907,10 +1913,10 @@ * crs.setMetaData(metaData); * * - * @return the ResultSetMetaData object that describes this - * CachedRowSetImpl object's columns + * @return the {@code ResultSetMetaData} object that describes this + * {@code CachedRowSetImpl} object's columns * @throws SQLException if an error occurs in generating the RowSet - * meta data; or if the CachedRowSetImpl is empty. + * meta data; or if the {@code CachedRowSetImpl} is empty. * @see javax.sql.RowSetMetaData */ public ResultSetMetaData getMetaData() throws SQLException { @@ -1920,10 +1926,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1931,23 +1937,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes in the Java programming language. * When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(String) */ public Object getObject(int columnIndex) throws SQLException { @@ -1956,10 +1962,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1967,23 +1973,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes * in the Java programming language. When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name does not match one of * this rowset's column names, (2) the cursor is not * on a valid row, or (3) there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(int) */ public Object getObject(String columnName) throws SQLException { @@ -1993,10 +1999,10 @@ //---------------------------------------------------------------- /** - * Maps the given column name for one of this CachedRowSetImpl + * Maps the given column name for one of this {@code CachedRowSetImpl} * object's columns to its column number. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @return the column index of the given column name * @throws SQLException if the given column name does not match one @@ -2014,25 +2020,25 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java character stream that delivers the database column value * as a stream of two-byte unicode characters in a - * java.io.Reader object. If the value is - * SQL NULL, the result is null. + * {@code java.io.Reader} object. If the value is + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR,} {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getCharacterStream(String) */ public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{ @@ -2041,23 +2047,24 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY or LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code CHAR, VARCHAR,} + * {@code LONGVARCHAR}, + * {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -2065,21 +2072,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return types that this method is used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return types that this method is used to retrieve. * @see #getBigDecimal(String) */ public BigDecimal getBigDecimal(int columnIndex) throws SQLException { @@ -2088,21 +2096,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. * @see #getBigDecimal(int) */ public BigDecimal getBigDecimal(String columnName) throws SQLException { @@ -2114,7 +2122,7 @@ //--------------------------------------------------------------------- /** - * Returns the number of rows in this CachedRowSetImpl object. + * Returns the number of rows in this {@code CachedRowSetImpl} object. * * @return number of rows in the rowset */ @@ -2124,10 +2132,10 @@ /** * Indicates whether the cursor is before the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is before the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isBeforeFirst() throws SQLException { @@ -2136,10 +2144,10 @@ /** * Indicates whether the cursor is after the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is after the last row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isAfterLast() throws SQLException { @@ -2148,10 +2156,10 @@ /** * Indicates whether the cursor is on the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is on the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isFirst() throws SQLException { @@ -2160,14 +2168,14 @@ /** * Indicates whether the cursor is on the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * Note: Calling the method isLast may be expensive + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver might need to fetch ahead one row in order * to determine whether the current row is the last row in this rowset. * - * @return true if the cursor is on the last row; - * false otherwise or if this rowset contains no rows + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise or if this rowset contains no rows * @throws SQLException if an error occurs */ public boolean isLast() throws SQLException { @@ -2175,19 +2183,19 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the front of + * Moves this {@code CachedRowSetImpl} object's cursor to the front of * the rowset, just before the first row. This method has no effect if * this rowset contains no rows. * * @throws SQLException if an error occurs or the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public void beforeFirst() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the end of + * Moves this {@code CachedRowSetImpl} object's cursor to the end of * the rowset, just after the last row. This method has no effect if * this rowset contains no rows. * @@ -2198,34 +2206,34 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the first row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the first row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean first() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the first - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the first + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the methods first, - * isFirst, and absolute. - * It in turn calls the method internalNext in order to + * This method is called internally by the methods {@code first}, + * {@code isFirst}, and {@code absolute}. + * It in turn calls the method {@code internalNext} in order to * handle the case where the first row is a deleted row that is not visible. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the first row; - * false otherwise + * @return {@code true} if the cursor moved to the first row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalFirst() throws SQLException { @@ -2233,35 +2241,35 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the last row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the last row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean last() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the last - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the last + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the method last + * This method is called internally by the method {@code last} * when rows have been deleted and the deletions are not visible. - * The method internalLast handles the case where the + * The method {@code internalLast} handles the case where the * last row is a deleted row that is not visible by in turn calling - * the method internalPrevious. + * the method {@code internalPrevious}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the last row; - * false otherwise + * @return {@code true} if the cursor moved to the last row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalLast() throws SQLException { @@ -2269,12 +2277,12 @@ } /** - * Returns the number of the current row in this CachedRowSetImpl + * Returns the number of the current row in this {@code CachedRowSetImpl} * object. The first row is number 1, the second number 2, and so on. * - * @return the number of the current row; 0 if there is no + * @return the number of the current row; {@code 0} if there is no * current row - * @throws SQLException if an error occurs; or if the CacheRowSetImpl + * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl} * is empty */ public int getRow() throws SQLException { @@ -2282,51 +2290,51 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the row number + * Moves this {@code CachedRowSetImpl} object's cursor to the row number * specified. * * If the number is positive, the cursor moves to an absolute row with * respect to the beginning of the rowset. The first row is row 1, the second * is row 2, and so on. For example, the following command, in which - * crs is a CachedRowSetImpl object, moves the cursor + * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor * to the fourth row, starting from the beginning of the rowset. - * + * {@code * * crs.absolute(4); * - * + * } * * If the number is negative, the cursor moves to an absolute row position * with respect to the end of the rowset. For example, calling - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row, counting * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. * * @param row a positive number to indicate the row, starting row numbering from - * the first row, which is 1; a negative number to indicate + * the first row, which is {@code 1}; a negative number to indicate * the row, starting row numbering from the last row, which is - * -1; it must not be 0 - * @return true if the cursor is on the rowset; false + * {@code -1}; it must not be {@code 0} + * @return {@code true} if the cursor is on the rowset; {@code false} * otherwise - * @throws SQLException if the given cursor position is 0 or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * @throws SQLException if the given cursor position is {@code 0} or the + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean absolute( int row ) throws SQLException { throw new UnsupportedOperationException(); @@ -2340,80 +2348,80 @@ * If the number is positive, the cursor moves the specified number of * rows toward the end of the rowset, starting at the current row. * For example, the following command, in which - * crs is a CachedRowSetImpl object with 100 rows, + * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows, * moves the cursor forward four rows from the current row. If the * current row is 50, the cursor would move to row 54. - * + * {@code * * crs.relative(4); * - * + * } * * If the number is negative, the cursor moves back toward the beginning * the specified number of rows, starting at the current row. * For example, calling the method - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. In both cases, this method - * throws an SQLException. + * throws an {@code SQLException}. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). Calling relative(0) + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. Calling {@code relative(0)} * is valid, but it does not change the cursor position. * - * @param rows an int indicating the number of rows to move + * @param rows an {@code int} indicating the number of rows to move * the cursor, starting at the current row; a positive number * moves the cursor forward; a negative number moves the cursor * backward; must not move the cursor past the valid * rows - * @return true if the cursor is on a row in this - * CachedRowSetImpl object; false + * @return {@code true} if the cursor is on a row in this + * {@code CachedRowSetImpl} object; {@code false} * otherwise * @throws SQLException if there are no rows in this rowset, the cursor is * positioned either before the first row or after the last row, or - * the rowset is type ResultSet.TYPE_FORWARD_ONLY + * the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean relative(int rows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the - * previous row and returns true if the cursor is on - * a valid row or false if it is not. + * Moves this {@code CachedRowSetImpl} object's cursor to the + * previous row and returns {@code true} if the cursor is on + * a valid row or {@code false} if it is not. * This method also notifies all listeners registered with this - * CachedRowSetImpl object that its cursor has moved. + * {@code CachedRowSetImpl} object that its cursor has moved. * - * Note: calling the method previous() is not the same - * as calling the method relative(-1). This is true - * because it is possible to call previous() from the insert + * Note: calling the method {@code previous()} is not the same + * as calling the method {@code relative(-1)}. This is true + * because it is possible to call {@code previous()} from the insert * row, from after the last row, or from the current row, whereas - * relative may only be called from the current row. + * {@code relative} may only be called from the current row. * - * The method previous may used in a while + * The method {@code previous} may used in a {@code while} * loop to iterate through a rowset starting after the last row - * and moving toward the beginning. The loop ends when previous - * returns false, meaning that there are no more rows. + * and moving toward the beginning. The loop ends when {@code previous} + * returns {@code false}, meaning that there are no more rows. * For example, the following code fragment retrieves all the data in - * the CachedRowSetImpl object crs, which has + * the {@code CachedRowSetImpl} object {@code crs}, which has * three columns. Note that the cursor must initially be positioned * after the last row so that the first call to the method - * previous places the cursor on the last line. - * + * {@code previous} places the cursor on the last line. + * {@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - * - * This method throws an SQLException if the cursor is not + * } + * This method throws an {@code SQLException} if the cursor is not * on a row in the rowset, before the first row, or after the last row. * - * @return true if the cursor is on a valid row; - * false if it is before the first row or after the + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is before the first row or after the * last row * @throws SQLException if the cursor is not on a valid position or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean previous() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor to the previous row in this CachedRowSetImpl + * Moves the cursor to the previous row in this {@code CachedRowSetImpl} * object, skipping past deleted rows that are not visible; returns - * true if the cursor is on a row in this rowset and - * false when the cursor goes before the first row. + * {@code true} if the cursor is on a row in this rowset and + * {@code false} when the cursor goes before the first row. * - * This method is called internally by the method previous. + * This method is called internally by the method {@code previous}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a row in this rowset; - * false when the cursor reaches the position before + * @return {@code true} if the cursor is on a row in this rowset; + * {@code false} when the cursor reaches the position before * the first row * @throws SQLException if an error occurs */ @@ -2463,14 +2471,14 @@ //--------------------------------------------------------------------- /** - * Indicates whether the current row of this CachedRowSetImpl + * Indicates whether the current row of this {@code CachedRowSetImpl} * object has been updated. The value returned - * depends on whether this rowset can detect updates: false + * depends on whether this rowset can detect updates: {@code false} * will always be returned if it does not detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another and updates are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2482,13 +2490,13 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * * @param idx the index identifier of the column that may be have been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2500,14 +2508,14 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * - * @param columnName the String column name column that may be have + * @param columnName the {@code String} column name column that may be have * been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2521,8 +2529,8 @@ * Indicates whether the current row has been inserted. The value returned * depends on whether or not the rowset can detect visible inserts. * - * @return true if a row has been inserted and inserts are detected; - * false otherwise + * @return {@code true} if a row has been inserted and inserts are detected; + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2536,12 +2544,12 @@ * Indicates whether the current row has been deleted. A deleted row * may leave a visible "hole" in a rowset. This method can be used to * detect such holes if the rowset can detect deletions. This method - * will always return false if this rowset cannot detect + * will always return {@code false} if this rowset cannot detect * deletions. * - * @return true if (1)the current row is blank, indicating that + * @return {@code true} if (1)the current row is blank, indicating that * the row has been deleted, and (2)deletions are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on a valid row in this rowset * @see DatabaseMetaData#deletesAreDetected */ @@ -2551,8 +2559,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset; however, another method must be called to complete @@ -2565,15 +2573,15 @@ * * In order to propagate updates in this rowset to the underlying * data source, an application must call the method {@link #acceptChanges} - * after it calls either updateRow or insertRow. + * after it calls either {@code updateRow} or {@code insertRow}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -2581,8 +2589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2593,14 +2601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(int columnIndex, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -2608,8 +2616,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2620,14 +2628,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(int columnIndex, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -2635,8 +2643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2647,14 +2655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(int columnIndex, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -2662,8 +2670,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2674,14 +2682,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(int columnIndex, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -2689,8 +2697,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2701,14 +2709,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(int columnIndex, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -2717,8 +2725,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2729,14 +2737,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(int columnIndex, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -2744,8 +2752,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2756,14 +2764,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(int columnIndex, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -2771,8 +2779,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2783,14 +2791,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -2798,8 +2806,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2810,17 +2818,17 @@ * as inserted. Both of these methods must be called before the * cursor moves to another row. * - * The method acceptChanges must be called if the + * The method {@code acceptChanges} must be called if the * updated values are to be written back to the underlying database. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(int columnIndex, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -2828,8 +2836,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2840,14 +2848,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(int columnIndex, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -2855,8 +2863,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2867,15 +2875,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(int columnIndex, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -2883,8 +2891,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2895,15 +2903,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL TIME or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code TIME} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(int columnIndex, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -2911,8 +2919,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2923,16 +2931,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE, TIME, or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE}, {@code TIME}, or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -2940,7 +2948,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -2952,8 +2960,8 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -2965,8 +2973,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2977,17 +2985,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not binary, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException { throw new UnsupportedOperationException(); @@ -2995,8 +3003,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3007,19 +3015,19 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.Reader - * containing BINARY, VARBINARY, - * LONGVARBINARY, CHAR, VARCHAR, - * or LONGVARCHAR data + * @param x the new column value; must be a {@code java.io.Reader} + * containing {@code BINARY}, {@code VARBINARY}, + * {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR}, + * or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not a binary or * character type, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3027,11 +3035,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter indicates + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter indicates * the number of digits to the right of the decimal point and is ignored * if the new column value is not a type that will be mapped to an SQL - * DECIMAL or NUMERIC value. + * {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3042,16 +3050,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3059,8 +3067,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3071,14 +3079,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x) throws SQLException { throw new UnsupportedOperationException(); @@ -3087,8 +3095,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3098,12 +3106,12 @@ * must be called, which will insert the new row into both this rowset * and the database. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -3111,8 +3119,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3123,13 +3131,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(String columnName, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -3137,8 +3145,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3149,13 +3157,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(String columnName, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -3163,8 +3171,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3175,13 +3183,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(String columnName, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -3189,8 +3197,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3201,13 +3209,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(String columnName, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -3215,8 +3223,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3227,13 +3235,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(String columnName, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -3241,8 +3249,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3253,13 +3261,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(String columnName, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -3267,8 +3275,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3279,13 +3287,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(String columnName, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -3293,8 +3301,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3305,13 +3313,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -3319,8 +3327,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3331,13 +3339,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(String columnName, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -3345,8 +3353,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3357,13 +3365,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(String columnName, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -3371,8 +3379,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3383,15 +3391,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(String columnName, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -3399,8 +3407,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3411,15 +3419,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL TIME or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code TIME} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(String columnName, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -3427,8 +3435,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3439,7 +3447,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if the given column index is out of bounds or @@ -3448,9 +3456,9 @@ * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE, - * TIME, or TIMESTAMP, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP}, or (4) this + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -3458,7 +3466,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -3470,7 +3478,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -3483,8 +3491,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3495,17 +3503,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not binary, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3513,8 +3521,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3525,18 +3533,18 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param reader the new column value; must be a - * java.io.Reader containing BINARY, - * VARBINARY, LONGVARBINARY, CHAR, - * VARCHAR, or LONGVARCHAR data + * {@code java.io.Reader} containing {@code BINARY}, + * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR}, + * {@code VARCHAR}, or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not a binary or character type, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(String columnName, java.io.Reader reader, @@ -3546,11 +3554,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter * indicates the number of digits to the right of the decimal point * and is ignored if the new column value is not a type that will be - * mapped to an SQL DECIMAL or NUMERIC value. + * mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3561,15 +3569,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3577,8 +3585,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3589,20 +3597,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x) throws SQLException { throw new UnsupportedOperationException(); } /** - * Inserts the contents of this CachedRowSetImpl object's insert + * Inserts the contents of this {@code CachedRowSetImpl} object's insert * row into this rowset immediately following the current row. * If the current row is the * position after the last row or before the first row, the new row will @@ -3614,14 +3622,14 @@ * @throws SQLException if (1) the cursor is not on the insert row, * (2) one or more of the non-nullable columns in the insert * row has not been given a value, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void insertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Marks the current row of this CachedRowSetImpl object as + * Marks the current row of this {@code CachedRowSetImpl} object as * updated and notifies listeners registered with this rowset that the * row has changed. * @@ -3631,26 +3639,26 @@ * and the updates made before the cursor moved will be lost. * * @throws SQLException if the cursor is on the insert row or this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Deletes the current row from this CachedRowSetImpl object and + * Deletes the current row from this {@code CachedRowSetImpl} object and * notifies listeners registered with this rowset that a row has changed. * This method cannot be called when the cursor is on the insert row. * * This method marks the current row as deleted, but it does not delete * the row from the underlying data source. The method - * acceptChanges must be called to delete the row in + * {@code acceptChanges} must be called to delete the row in * the data source. * * @throws SQLException if (1) this method is called when the cursor * is on the insert row, before the first row, or after the * last row or (2) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void deleteRow() throws SQLException { throw new UnsupportedOperationException(); @@ -3659,7 +3667,7 @@ /** * Sets the current row with its original value and marks the row as * not updated, thus undoing any changes made to the row since the - * last call to the methods updateRow or deleteRow. + * last call to the methods {@code updateRow} or {@code deleteRow}. * This method should be called only when the cursor is on a row in * this rowset. * @@ -3672,11 +3680,11 @@ /** * Rolls back any updates made to the current row of this - * CachedRowSetImpl object and notifies listeners that + * {@code CachedRowSetImpl} object and notifies listeners that * a row has changed. To have an effect, this method - * must be called after an updateXXX method has been - * called and before the method updateRow has been called. - * If no updates have been made or the method updateRow + * must be called after an {@code updateXXX} method has been + * called and before the method {@code updateRow} has been called. + * If no updates have been made or the method {@code updateRow} * has already been called, this method has no effect. * * @throws SQLException if the cursor is on the insert row, before the @@ -3687,39 +3695,39 @@ } /** - * Moves the cursor for this CachedRowSetImpl object + * Moves the cursor for this {@code CachedRowSetImpl} object * to the insert row. The current row in the rowset is remembered * while the cursor is on the insert row. * * The insert row is a special row associated with an updatable * rowset. It is essentially a buffer where a new row may - * be constructed by calling the appropriate updateXXX + * be constructed by calling the appropriate {@code updateXXX} * methods to assign a value to each column in the row. A complete * row must be constructed; that is, every column that is not nullable * must be assigned a value. In order for the new row to become part - * of this rowset, the method insertRow must be called + * of this rowset, the method {@code insertRow} must be called * before the cursor is moved back to the rowset. * * Only certain methods may be invoked while the cursor is on the insert * row; many methods throw an exception if they are called while the - * cursor is there. In addition to the updateXXX - * and insertRow methods, only the getXXX methods - * may be called when the cursor is on the insert row. A getXXX - * method should be called on a column only after an updateXXX + * cursor is there. In addition to the {@code updateXXX} + * and {@code insertRow} methods, only the {@code getXXX} methods + * may be called when the cursor is on the insert row. A {@code getXXX} + * method should be called on a column only after an {@code updateXXX} * method has been called on that column; otherwise, the value returned is * undetermined. * - * @throws SQLException if this CachedRowSetImpl object is - * ResultSet.CONCUR_READ_ONLY + * @throws SQLException if this {@code CachedRowSetImpl} object is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void moveToInsertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor for this CachedRowSetImpl object to + * Moves the cursor for this {@code CachedRowSetImpl} object to * the current row. The current row is the row the cursor was on - * when the method moveToInsertRow was called. + * when the method {@code moveToInsertRow} was called. * * Calling this method has no effect unless it is called while the * cursor is on the insert row. @@ -3731,9 +3739,9 @@ } /** - * Returns null. + * Returns {@code null}. * - * @return null + * @return {@code null} * @throws SQLException if an error occurs */ public Statement getStatement() throws SQLException { @@ -3742,18 +3750,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column index is out of bounds or * the cursor is not on one of this rowset's rows or its * insert row @@ -3767,17 +3775,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL REF value + * SQL {@code REF} value * @see #getRef(String) */ public Ref getRef(int columnIndex) throws SQLException { @@ -3786,17 +3794,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BLOB value + * SQL {@code BLOB} value * @see #getBlob(String) */ public Blob getBlob(int columnIndex) throws SQLException { @@ -3805,17 +3813,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Clob object representing an SQL CLOB value + * @return a {@code Clob} object representing an SQL {@code CLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL CLOB value + * SQL {@code CLOB} value * @see #getClob(String) */ public Clob getClob(int columnIndex) throws SQLException { @@ -3824,18 +3832,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL ARRAY value + * SQL {@code ARRAY} value * @see #getArray(String) */ public Array getArray(int columnIndex) throws SQLException { @@ -3844,17 +3852,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column name is not the name of * a column in this rowset or the cursor is not on one of * this rowset's rows or its insert row @@ -3867,16 +3875,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the column value - * is not an SQL REF value + * is not an SQL {@code REF} value * @see #getRef(int) */ public Ref getRef(String colName) throws SQLException { @@ -3885,16 +3893,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BLOB value + * column does not store an SQL {@code BLOB} value * @see #getBlob(int) */ public Blob getBlob(String colName) throws SQLException { @@ -3903,17 +3911,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Clob object representing an SQL - * CLOB value + * @return a {@code Clob} object representing an SQL + * {@code CLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CLOB value + * column does not store an SQL {@code CLOB} value * @see #getClob(int) */ public Clob getClob(String colName) throws SQLException { @@ -3922,17 +3930,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming langugage. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL ARRAY value + * column does not store an SQL {@code ARRAY} value * @see #getArray(int) */ public Array getArray(String colName) throws SQLException { @@ -3941,22 +3949,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3964,21 +3972,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3986,22 +3994,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4009,21 +4017,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4031,22 +4039,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Timestamp - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4054,22 +4062,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object, using the given - * Calendar object to construct an appropriate + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object, using the given + * {@code Calendar} object to construct an appropriate * millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE, - * TIME, or TIMESTAMP value + * column does not store an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4080,13 +4088,13 @@ */ /** - * Retrieves the Connection object passed to this - * CachedRowSetImpl object. This connection may be + * Retrieves the {@code Connection} object passed to this + * {@code CachedRowSetImpl} object. This connection may be * used to populate this rowset with data or to write data back * to its underlying data source. * - * @return the Connection object passed to this rowset; - * may be null if there is no connection + * @return the {@code Connection} object passed to this rowset; + * may be {@code null} if there is no connection * @throws SQLException if an error occurs */ public Connection getConnection() throws SQLException{ @@ -4094,10 +4102,10 @@ } /** - * Sets the metadata for this CachedRowSetImpl object - * with the given RowSetMetaData object. + * Sets the metadata for this {@code CachedRowSetImpl} object + * with the given {@code RowSetMetaData} object. * - * @param md a RowSetMetaData object instance containing + * @param md a {@code RowSetMetaData} object instance containing * metadata about the columsn in the rowset * @throws SQLException if invalid meta data is supplied to the * rowset @@ -4108,17 +4116,17 @@ /** * Returns a result set containing the original value of the rowset. The - * original value is the state of the CachedRowSetImpl after the + * original value is the state of the {@code CachedRowSetImpl} after the * last population or synchronization (whichever occurred most recently) with * the data source. * * The cursor is positioned before the first row in the result set. - * Only rows contained in the result set returned by getOriginal() + * Only rows contained in the result set returned by {@code getOriginal()} * are said to have an original value. * * @return the original result set of the rowset * @throws SQLException if an error occurs produce the - * ResultSet object + * {@code ResultSet} object */ public ResultSet getOriginal() throws SQLException { throw new UnsupportedOperationException(); @@ -4127,7 +4135,7 @@ /** * Returns a result set containing the original value of the current * row only. - * The original value is the state of the CachedRowSetImpl after + * The original value is the state of the {@code CachedRowSetImpl} after * the last population or synchronization (whichever occurred most recently) * with the data source. * @@ -4153,7 +4161,7 @@ /** * Marks all rows in this rowset as being original rows. Any updates * made to the rows become the original values for the rowset. - * Calls to the method setOriginal connot be reversed. + * Calls to the method {@code setOriginal} connot be reversed. * * @throws SQLException if an error occurs */ @@ -4165,8 +4173,8 @@ * Returns an identifier for the object (table) that was used to create this * rowset. * - * @return a String object that identifies the table from - * which this CachedRowSetImpl object was derived + * @return a {@code String} object that identifies the table from + * which this {@code CachedRowSetImpl} object was derived * @throws SQLException if an error occurs */ public String getTableName() throws SQLException { @@ -4177,8 +4185,8 @@ * Sets the identifier for the table from which this rowset was derived * to the given table name. * - * @param tabName a String object that identifies the - * table from which this CachedRowSetImpl object + * @param tabName a {@code String} object that identifies the + * table from which this {@code CachedRowSetImpl} object * was derived * @throws SQLException if an error occurs */ @@ -4188,7 +4196,7 @@ /** * Returns the columns that make a key to uniquely identify a - * row in this CachedRowSetImpl object. + * row in this {@code CachedRowSetImpl} object. * * @return an array of column numbers that constitutes a primary * key for this rowset. This array should be empty @@ -4203,16 +4211,16 @@ /** - * Sets this CachedRowSetImpl object's - * keyCols field with the given array of column + * Sets this {@code CachedRowSetImpl} object's + * {@code keyCols} field with the given array of column * numbers, which forms a key for uniquely identifying a row * in this rowset. * - * @param keys an array of int indicating the + * @param keys an array of {@code int} indicating the * columns that form a primary key for this - * CachedRowSetImpl object; every + * {@code CachedRowSetImpl} object; every * element in the array must be greater than - * 0 and less than or equal to the number + * {@code 0} and less than or equal to the number * of columns in this rowset * @throws SQLException if any of the numbers in the * given array is not valid for this rowset @@ -4224,8 +4232,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4236,14 +4244,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4251,8 +4259,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4263,13 +4271,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4277,8 +4285,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4289,14 +4297,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + *
or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4631,8 +4631,8 @@ /*o - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnIndex the first column is 1, the second 2, ... * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4643,8 +4643,8 @@ } /** - * This method is used for updating SQL NCLOB type that maps - * to java.sql.Types.NCLOB + * This method is used for updating SQL {@code NCLOB} type that maps + * to {@code java.sql.Types.NCLOB} * @param columnName name of the column * @param nClob the value for the column to be updated * @throws SQLException if a database access error occurs @@ -4656,12 +4656,12 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param i the first column is 1, the second is 2, ... - * @return a NClob object representing the SQL - * NCLOB value in the specified column + * @return a {@code NClob} object representing the SQL + * {@code NCLOB} value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4672,11 +4672,11 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a NClob object + * of this {@code ResultSet} object as a {@code NClob} object * in the Java programming language. * * @param colName the name of the column from which to retrieve the value - * @return a NClob object representing the SQL NCLOB + * @return a {@code NClob} object representing the SQL {@code NCLOB} * value in the specified column * @exception SQLException if a database access error occurs * @since 1.6 @@ -4694,10 +4694,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * SQL {@code XML} value when it sends it to the database. * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an SQL {@code XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4706,10 +4706,10 @@ } /** - * Sets the designated parameter to the given java.sql.SQLXML object. The driver converts this to an - * SQL XML value when it sends it to the database. + * Sets the designated parameter to the given {@code java.sql.SQLXML} object. The driver converts this to an + * {@code SQL XML} value when it sends it to the database. * @param parameterName the name of the parameter - * @param xmlObject a SQLXML object that maps an SQL XML value + * @param xmlObject a {@code SQLXML} object that maps an {@code SQL XML} value * @throws SQLException if a database access error occurs * @since 1.6 */ @@ -4718,8 +4718,8 @@ } /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID value when it sends it + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} value when it sends it * to the database * * @param parameterIndex the first parameter is 1, the second is 2, ... @@ -4732,9 +4732,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.RowId object. The - * driver converts this to a SQL ROWID when it sends it to the + /** + * Sets the designated parameter to the given {@code java.sql.RowId} object. The + * driver converts this to a SQL {@code ROWID} when it sends it to the * database. * * @param parameterName the name of the parameter @@ -4748,18 +4748,18 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR value + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on NVARCHAR values) + * size relative to the driver's limits on {@code NVARCHAR} values) * when it sends it to the database. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNString(int parameterIndex, String value) throws SQLException { @@ -4768,9 +4768,9 @@ /** - * Sets the designated parameter in this RowSet object's command - * to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter in this {@code RowSet} object's command + * to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -4779,14 +4779,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed PreparedStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -4795,14 +4795,14 @@ } /** - * Sets the designated parameter to a java.sql.NClob object. The object - * implements the java.sql.NClob interface. This NClob - * object maps to a SQL NCLOB. + * Sets the designated parameter to a {@code java.sql.NClob} object. The object + * implements the {@code java.sql.NClob} interface. This {@code NClob} + * object maps to a SQL {@code NCLOB}. * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(String parameterName, NClob value) throws SQLException { @@ -4810,17 +4810,17 @@ } - /** + /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @exception SQLException if a database access error occurs * @since 1.6 @@ -4832,16 +4832,16 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the name of the column - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4850,11 +4850,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * @param columnIndex the first column is 1, the second 2, ... * @param xmlObject the value for the column to be updated @@ -4866,11 +4866,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4884,15 +4884,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnIndex the first column is 1, the second is 2, ... - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4902,15 +4902,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4927,9 +4927,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnIndex - the first column is 1, the second is 2, ... - * @param x - the new column value - * @param length - the length of the stream + * @param columnIndex the first column is 1, the second is 2, ... + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4949,9 +4949,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnName - name of the Column - * @param x - the new column value - * @param length - the length of the stream + * @param columnName name of the Column + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4963,26 +4963,27 @@ } /** - * Updates the designated column with a character stream value. The + * Updates the designated column with a character stream value. The * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} or this + * method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -4997,26 +4998,27 @@ * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * the result set concurrency is {@code CONCUR_READ_ONLY} or + * this method is called on a closed result set + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method * @since 1.6 */ public void updateNCharacterStream(String columnLabel, @@ -5027,9 +5029,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5039,16 +5041,16 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5060,9 +5062,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5072,18 +5074,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, + * then the label is the name of the column. * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException { @@ -5092,9 +5096,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5102,23 +5106,23 @@ * Java stream object or your own subclass that implements the * standard interface. * - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException { @@ -5127,9 +5131,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5138,22 +5142,23 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException { @@ -5161,11 +5166,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5175,17 +5180,17 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5193,11 +5198,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5207,17 +5212,18 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5225,33 +5231,33 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader) throws SQLException { @@ -5259,34 +5265,35 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * * Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - * Note: Consult your JDBC driver documentation to determine if + * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader) throws SQLException { @@ -5294,11 +5301,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5308,19 +5315,19 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5328,11 +5335,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5342,19 +5349,20 @@ * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5362,11 +5370,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5375,22 +5383,22 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader) throws SQLException { @@ -5398,11 +5406,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5411,23 +5419,24 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader) throws SQLException { @@ -5435,22 +5444,22 @@ } - /** + /** * Updates the designated column with an ascii stream value, which will have * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5464,17 +5473,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBinaryStream(int columnIndex, @@ -5488,17 +5497,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5512,17 +5521,19 @@ * the specified number of bytes.. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5535,20 +5546,20 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5560,21 +5571,22 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5588,15 +5600,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5611,18 +5625,18 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5637,19 +5651,20 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5665,18 +5680,20 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5689,20 +5706,20 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5714,22 +5731,23 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5738,97 +5756,98 @@ } - /** - * Sets the designated parameter to the given java.net.URL value. - * The driver converts this to an SQL DATALINK value - * when it sends it to the database. - * - * @param parameterIndex the first parameter is 1, the second is 2, ... - * @param x the java.net.URL object to be set - * @exception SQLException if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.4 - */ + /** + * Sets the designated parameter to the given {@code java.net.URL} value. + * The driver converts this to an SQL {@code DATALINK} value + * when it sends it to the database. + * + * @param parameterIndex the first parameter is 1, the second is 2, ... + * @param x the {@code java.net.URL} object to be set + * @exception SQLException if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * @since 1.4 + */ public void setURL(int parameterIndex, java.net.URL x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB - * Note: Consult your JDBC driver documentation to determine if - * it might be more efficient to use a version of - * setNClob which takes a length parameter. - * - * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param reader An object that contains the data to set the parameter value to. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * - * @since 1.6 - */ + /** + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * Note: Consult your JDBC driver documentation to determine if + * it might be more efficient to use a version of + * {@code setNClob} which takes a length parameter. + * + * @param parameterIndex index of the first parameter is 1, the second is 2, ... + * @param reader An object that contains the data to set the parameter value to. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * + * @since 1.6 + */ public void setNClob(int parameterIndex, Reader reader) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB - * - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national - * character sets; if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * @since 1.6 - */ - public void setNClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. + * The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national + * character sets; if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * @since 1.6 + */ + public void setNClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); - } + } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNClob which takes a length parameter. + * {@code setNClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5839,23 +5858,24 @@ } - /** - ** of characters specified by length otherwise a SQLException will becontain the number - * generated when the PreparedStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method + /** + * of characters specified by length otherwise a {@code SQLException} will becontain the number + * generated when the {@code PreparedStatement} is executed. + * This method differs from the {@code setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5867,14 +5887,14 @@ /** - * Sets the designated parameter to a java.sql.NClob object. The driver converts this to -a - * SQL NCLOB value when it sends it to the database. + * Sets the designated parameter to a {@code java.sql.NClob} object. + * The driver converts this to an + * SQL {@code NCLOB} value when it sends it to the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(int parameterIndex, NClob value) throws SQLException{ @@ -5883,14 +5903,14 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNString(String parameterName, String value) @@ -5899,8 +5919,8 @@ } /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... @@ -5908,7 +5928,7 @@ * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException{ @@ -5918,8 +5938,8 @@ /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterName the name of the column to be set @@ -5935,9 +5955,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + /** + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -5946,14 +5966,14 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed CallableStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -5962,23 +5982,23 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIMESTAMP value, + * Sets the designated parameter to the given {@code java.sql.Timestamp} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIMESTAMP} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the timestamp + * a {@code Calendar} object, the driver can calculate the timestamp * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use - * to construct the timestamp + * @param cal the {@code Calendar} object the driver will use + * to construct the timestamp * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -5987,28 +6007,29 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } @@ -6016,16 +6037,16 @@ /** - * Sets the designated parameter to the given java.sql.Clob object. - * The driver converts this to an SQL CLOB value when it + * Sets the designated parameter to the given {@code java.sql.Clob} object. + * The driver converts this to an SQL {@code CLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Clob object that maps an SQL CLOB value + * @param x a {@code Clob} object that maps an SQL {@code CLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setClob (String parameterName, Clob x) throws SQLException{ @@ -6033,21 +6054,21 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs or this method is called on - * a closed CallableStatement + * a closed {@code CallableStatement} * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6058,19 +6079,19 @@ } - /** - * Sets the designated parameter to the given java.sql.Date value + /** + * Sets the designated parameter to the given {@code java.sql.Date} value * using the default time zone of the virtual machine that is running * the application. * The driver converts this - * to an SQL DATE value when it sends it to the database. + * to an SQL {@code DATE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6080,23 +6101,23 @@ } /** - * Sets the designated parameter to the given java.sql.Date value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL DATE value, + * Sets the designated parameter to the given {@code java.sql.Date} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code DATE} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the date + * a {@code Calendar} object, the driver can calculate the date * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the date * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6107,16 +6128,16 @@ /** - * Sets the designated parameter to the given java.sql.Time value. + * Sets the designated parameter to the given {@code java.sql.Time} value. * The driver converts this - * to an SQL TIME value when it sends it to the database. + * to an SQL {@code TIME} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6126,23 +6147,23 @@ } /** - * Sets the designated parameter to the given java.sql.Time value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIME value, + * Sets the designated parameter to the given {@code java.sql.Time} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIME} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the time + * a {@code Calendar} object, the driver can calculate the time * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the time * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6152,22 +6173,22 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatementor if parameterIndex does not correspond to a parameter - * marker in the SQL statement + * a closed {@code PreparedStatement}or if parameterIndex does not correspond to a parameter + * marker in the SQL statement * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6179,19 +6200,19 @@ /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - *This method differs from the setCharacterStream (int, Reader, int) method + * Sets the designated parameter to a {@code Reader} object. The reader 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 setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatement, if parameterIndex does not correspond to a parameter + * a closed {@code PreparedStatement}, if parameterIndex does not correspond to a parameter * marker in the SQL statement, or if the length specified is less than zero. * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method @@ -6204,25 +6225,26 @@ /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) + * Sets the designated parameter to a {@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)} * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... + * the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement, - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, if the length specified - * is less than zero or if the number of bytes in the inputstream does not match - * the specified length. + * this method is called on a closed {@code PreparedStatement}, + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, if the length specified + * is less than zero or if the number of bytes in the inputstream does not match + * the specified length. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6233,28 +6255,27 @@ } /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) - * This method differs from the setBinaryStream (int, InputStream) + * Sets the designated parameter to a {@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 - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... - - + * the second is 2, ... + * * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement or - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, + * this method is called on a closed {@code PreparedStatement} or + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6264,72 +6285,72 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length, otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) - * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, - * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB - * - * @param parameterName the name of the parameter to be set - * the second is 2, ... - * - * @param inputStream An object that contains the data to set the parameter - * value to. - * @param length the number of bytes in the parameter data. - * @throws SQLException if parameterIndex does not correspond - * to a parameter marker in the SQL statement, or if the length specified - * is less than zero; if the number of bytes in the inputstream does not match - * the specified length; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setBlob(String parameterName, InputStream inputStream, long length) + /** + * Sets the designated parameter to a {@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)} + * 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, + * the driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * + * @param parameterName the name of the parameter to be set + * the second is 2, ... + * + * @param inputStream An object that contains the data to set the parameter + * value to. + * @param length the number of bytes in the parameter data. + * @throws SQLException if parameterIndex does not correspond + * to a parameter marker in the SQL statement, or if the length specified + * is less than zero; if the number of bytes in the inputstream does not match + * the specified length; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.Blob object. - * The driver converts this to an SQL BLOB value when it + /** + * Sets the designated parameter to the given {@code java.sql.Blob} object. + * The driver converts this to an SQL {@code BLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Blob object that maps an SQL BLOB value + * @param x a {@code Blob} object that maps an SQL {@code BLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setBlob (String parameterName, Blob x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) + /** + * Sets the designated parameter to a {@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 BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARBINARY or a BLOB + * data should be send to the server as a {@code LONGVARBINARY} or a {@code BLOB} * * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterName the name of the parameter * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6339,22 +6360,22 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. The second * argument must be an object type; for integral values, the - * java.lang equivalent objects should be used. + * {@code java.lang} equivalent objects should be used. * * The given Java object will be converted to the given targetSqlType * before being sent to the database. * * If the object has a custom mapping (is of a class implementing the - * interface SQLData), - * the JDBC driver should call the method SQLData.writeSQL to write it + * interface {@code SQLData}), + * the JDBC driver should call the method {@code SQLData.writeSQL} to write it * to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * Note that this method may be used to pass datatabase- @@ -6365,17 +6386,17 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database. The scale argument may further qualify this type. * @param scale for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types, this value will be ignored. + * this is the number of digits after the decimal point. For all other + * types, this value will be ignored. * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see Types * @see #getObject * @since 1.4 @@ -6387,7 +6408,7 @@ /** * Sets the value of the designated parameter with the given object. - * This method is like the method setObject + * This method is like the method {@code setObject} * above, except that it assumes a scale of zero. * * @param parameterName the name of the parameter @@ -6395,14 +6416,14 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see #getObject * @since 1.4 */ @@ -6411,13 +6432,13 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. - * The second parameter must be of type Object; therefore, the - * java.lang equivalent objects should be used for built-in types. + * The second parameter must be of type {@code Object}; therefore, the + * {@code java.lang} equivalent objects should be used for built-in types. * * The JDBC specification specifies a standard mapping from - * Java Object types to SQL types. The given argument + * Java {@code Object} types to SQL types. The given argument * will be converted to the corresponding SQL type before being * sent to the database. * @@ -6425,13 +6446,13 @@ * specific abstract data types, by using a driver-specific Java * type. * - * If the object is of a class implementing the interface SQLData, - * the JDBC driver should call the method SQLData.writeSQL + * If the object is of a class implementing the interface {@code SQLData}, + * the JDBC driver should call the method {@code SQLData.writeSQL} * to write it to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. * * This method throws an exception if there is an ambiguity, for example, if the @@ -6440,10 +6461,10 @@ * @param parameterName the name of the parameter * @param x the object containing the input parameter value * @exception SQLException if a database access error occurs, - * this method is called on a closed CallableStatement or if the given - * Object parameter is ambiguous + * this method is called on a closed {@code CallableStatement} or if the given + * {@code Object} parameter is ambiguous * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getObject * @since 1.4 */ @@ -6454,9 +6475,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6468,9 +6489,9 @@ * @param x the Java input stream that contains the ASCII parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setAsciiStream(String parameterName, java.io.InputStream x, int length) @@ -6482,9 +6503,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the stream + * {@code java.io.InputStream} object. The data will be read from the stream * as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6495,9 +6516,9 @@ * @param x the java input stream which contains the binary parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBinaryStream(String parameterName, java.io.InputStream x, @@ -6506,11 +6527,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6519,13 +6540,13 @@ * standard interface. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that + * @param reader the {@code java.io.Reader} object that * contains the UNICODE data used as the designated parameter * @param length the number of characters in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setCharacterStream(String parameterName, @@ -6536,9 +6557,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6547,15 +6568,15 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setAsciiStream which takes a length parameter. + * {@code setAsciiStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the Java input stream that contains the ASCII parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.6 - */ + * @since 1.6 + */ public void setAsciiStream(String parameterName, java.io.InputStream x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); @@ -6564,9 +6585,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the + * {@code java.io.InputStream} object. The data will be read from the * stream as needed until end-of-file is reached. * * Note: This stream object can either be a standard @@ -6574,12 +6595,12 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBinaryStream which takes a length parameter. + * {@code setBinaryStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the java input stream which contains the binary parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6589,11 +6610,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6602,13 +6623,13 @@ * standard interface. * Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setCharacterStream which takes a length parameter. + * {@code setCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that contains the + * @param reader the {@code java.io.Reader} object that contains the * Unicode data * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6619,16 +6640,16 @@ /** * Sets the designated parameter to the given - * java.math.BigDecimal value. - * The driver converts this to an SQL NUMERIC value when + * {@code java.math.BigDecimal} value. + * The driver converts this to an SQL {@code NUMERIC} value when * it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBigDecimal * @since 1.4 */ @@ -6636,20 +6657,20 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java String value. + /** + * Sets the designated parameter to the given Java {@code String} value. * The driver converts this - * to an SQL VARCHAR or LONGVARCHAR value + * to an SQL {@code VARCHAR} or {@code LONGVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on VARCHAR values) + * size relative to the driver's limits on {@code VARCHAR} values) * when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getString * @since 1.4 */ @@ -6659,19 +6680,19 @@ - /** + /** * Sets the designated parameter to the given Java array of bytes. - * The driver converts this to an SQL VARBINARY or - * LONGVARBINARY (depending on the argument's size relative - * to the driver's limits on VARBINARY values) when it sends + * The driver converts this to an SQL {@code VARBINARY} or + * {@code LONGVARBINARY} (depending on the argument's size relative + * to the driver's limits on {@code VARBINARY} values) when it sends * it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBytes * @since 1.4 */ @@ -6680,17 +6701,17 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value. + * Sets the designated parameter to the given {@code java.sql.Timestamp} value. * The driver - * converts this to an SQL TIMESTAMP value when it sends it to the + * converts this to an SQL {@code TIMESTAMP} value when it sends it to the * database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -6700,16 +6721,16 @@ } /** - * Sets the designated parameter to SQL NULL. + * Sets the designated parameter to SQL {@code NULL}. * * Note: You must specify the parameter's SQL type. * * @param parameterName the name of the parameter - * @param sqlType the SQL type code defined in java.sql.Types + * @param sqlType the SQL type code defined in {@code java.sql.Types} * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull(String parameterName, int sqlType) throws SQLException { @@ -6717,8 +6738,8 @@ } /** - * Sets the designated parameter to SQL NULL. - * This version of the method setNull should + * Sets the designated parameter to SQL {@code NULL}. + * This version of the method {@code setNull} should * be used for user-defined types and REF type parameters. Examples * of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and * named array types. @@ -6738,14 +6759,14 @@ * * * @param parameterName the name of the parameter - * @param sqlType a value from java.sql.Types + * @param sqlType a value from {@code java.sql.Types} * @param typeName the fully-qualified name of an SQL user-defined type; * ignored if the parameter is not a user-defined type or - * SQL REF value + * SQL {@code REF} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull (String parameterName, int sqlType, String typeName) @@ -6754,17 +6775,17 @@ } /** - * Sets the designated parameter to the given Java boolean value. + * Sets the designated parameter to the given Java {@code boolean} value. * The driver converts this - * to an SQL BIT or BOOLEAN value when it sends it to the database. + * to an SQL {@code BIT} or {@code BOOLEAN} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @see #getBoolean * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBoolean(String parameterName, boolean x) throws SQLException{ @@ -6774,16 +6795,16 @@ /** - * Sets the designated parameter to the given Java byte value. + * Sets the designated parameter to the given Java {@code byte} value. * The driver converts this - * to an SQL TINYINT value when it sends it to the database. + * to an SQL {@code TINYINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getByte * @since 1.4 */ @@ -6793,16 +6814,16 @@ /** - * Sets the designated parameter to the given Java short value. + * Sets the designated parameter to the given Java {@code short} value. * The driver converts this - * to an SQL SMALLINT value when it sends it to the database. + * to an SQL {@code SMALLINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getShort * @since 1.4 */ @@ -6812,16 +6833,16 @@ /** - * Sets the designated parameter to the given Java int value. + * Sets the designated parameter to the given Java {@code int} value. * The driver converts this - * to an SQL INTEGER value when it sends it to the database. + * to an SQL {@code INTEGER} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getInt * @since 1.4 */ @@ -6829,17 +6850,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java long value. + /** + * Sets the designated parameter to the given Java {@code long} value. * The driver converts this - * to an SQL BIGINT value when it sends it to the database. + * to an SQL {@code BIGINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getLong * @since 1.4 */ @@ -6848,17 +6869,17 @@ } - /** - * Sets the designated parameter to the given Java float value. + /** + * Sets the designated parameter to the given Java {@code float} value. * The driver converts this - * to an SQL FLOAT value when it sends it to the database. + * to an SQL {@code FLOAT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getFloat * @since 1.4 */ @@ -6866,17 +6887,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java double value. + /** + * Sets the designated parameter to the given Java {@code double} value. * The driver converts this - * to an SQL DOUBLE value when it sends it to the database. + * to an SQL {@code DOUBLE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDouble * @since 1.4 */ @@ -6887,7 +6908,6 @@ /** * This method re populates the resBundle * during the deserialization process - * */ private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException { // Default state initialization happens here --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.803466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.635466074 +0400 @@ -43,22 +43,22 @@ /** - * The facility called on internally by the RIOptimisticProvider implementation to + * The facility called on internally by the {@code RIOptimisticProvider} implementation to * propagate changes back to the data source from which the rowset got its data. * - * A CachedRowSetWriter object, called a writer, has the public - * method writeData for writing modified data to the underlying data source. + * A {@code CachedRowSetWriter} object, called a writer, has the public + * method {@code writeData} for writing modified data to the underlying data source. * This method is invoked by the rowset internally and is never invoked directly by an application. * A writer also has public methods for setting and getting - * the CachedRowSetReader object, called a reader, that is associated + * the {@code CachedRowSetReader} object, called a reader, that is associated * with the writer. The remainder of the methods in this class are private and * are invoked internally, either directly or indirectly, by the method - * writeData. + * {@code writeData}. * - * Typically the SyncFactory manages the RowSetReader and - * the RowSetWriter implementations using SyncProvider objects. + * Typically the {@code SyncFactory} manages the {@code RowSetReader} and + * the {@code RowSetWriter} implementations using {@code SyncProvider} objects. * Standard JDBC RowSet implementations provide an object instance of this - * writer by invoking the SyncProvider.getRowSetWriter() method. + * writer by invoking the {@code SyncProvider.getRowSetWriter()} method. * * @version 0.2 * @author Jonathan Bruce @@ -69,15 +69,15 @@ public class CachedRowSetWriter implements TransactionalWriter, Serializable { /** - * The Connection object that this writer will use to make a + * The {@code Connection} object that this writer will use to make a * connection to the data source to which it will write data. * */ private transient Connection con; /** - * The SQL SELECT command that this writer will call - * internally. The method initSQLStatements builds this + * The SQL {@code SELECT} command that this writer will call + * internally. The method {@code initSQLStatements} builds this * command by supplying the words "SELECT" and "FROM," and using * metadata to get the table name and column names . * @@ -86,9 +86,9 @@ private String selectCmd; /** - * The SQL UPDATE command that this writer will call + * The SQL {@code UPDATE} command that this writer will call * internally to write data to the rowset's underlying data source. - * The method initSQLStatements builds this String + * The method {@code initSQLStatements} builds this {@code String} * object. * * @serial @@ -96,8 +96,8 @@ private String updateCmd; /** - * The SQL WHERE clause the writer will use for update - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for update + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -105,7 +105,7 @@ private String updateWhere; /** - * The SQL DELETE command that this writer will call + * The SQL {@code DELETE} command that this writer will call * internally to delete a row in the rowset's underlying data source. * * @serial @@ -113,8 +113,8 @@ private String deleteCmd; /** - * The SQL WHERE clause the writer will use for delete - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for delete + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -122,9 +122,9 @@ private String deleteWhere; /** - * The SQL INSERT INTO command that this writer will internally use + * The SQL {@code INSERT INTO} command that this writer will internally use * to insert data into the rowset's underlying data source. The method - * initSQLStatements builds this command with a question + * {@code initSQLStatements} builds this command with a question * mark parameter placeholder for each column in the rowset. * * @serial @@ -133,8 +133,8 @@ /** * An array containing the column numbers of the columns that are - * needed to uniquely identify a row in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * needed to uniquely identify a row in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ @@ -142,7 +142,7 @@ /** * An array of the parameters that should be used to set the parameter - * placeholders in a PreparedStatement object that this + * placeholders in a {@code PreparedStatement} object that this * writer will execute. * * @serial @@ -150,33 +150,33 @@ private Object[] params; /** - * The CachedRowSetReader object that has been - * set as the reader for the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code CachedRowSetReader} object that has been + * set as the reader for the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private CachedRowSetReader reader; /** - * The ResultSetMetaData object that contains information - * about the columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code ResultSetMetaData} object that contains information + * about the columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private ResultSetMetaData callerMd; /** - * The number of columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The number of columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private int callerColumnCount; /** - * This CachedRowSet will hold the conflicting values + * This {@code CachedRowSet} will hold the conflicting values * retrieved from the db and hold it. */ private CachedRowSetImpl crsResolve; @@ -209,8 +209,8 @@ } /** - * Propagates changes in the given RowSet object - * back to its underlying data source and returns true + * Propagates changes in the given {@code RowSet} object + * back to its underlying data source and returns {@code true} * if successful. The writer will check to see if * the data in the pre-modified rowset (the original values) differ * from the data in the underlying data source. If data in the data @@ -221,15 +221,15 @@ * access for concurrent users. * * This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. * - * Creates a CachedRowSet object from the given - * RowSet object + * Creates a {@code CachedRowSet} object from the given + * {@code RowSet} object * Makes a connection with the data source * * Disables autocommit mode if it is not already disabled @@ -237,32 +237,32 @@ * * Checks to see if the reader has read new data since the writer * was last called and, if so, calls the method - * initSQLStatements to initialize new SQL statements + * {@code initSQLStatements} to initialize new SQL statements * - * Builds new SELECT, UPDATE, - * INSERT, and DELETE statements - * Uses the CachedRowSet object's metadata to + * Builds new {@code SELECT}, {@code UPDATE}, + * {@code INSERT}, and {@code DELETE} statements + * Uses the {@code CachedRowSet} object's metadata to * determine the table name, column names, and the columns * that make up the primary key * * When there is no conflict, propagates changes made to the - * CachedRowSet object back to its underlying data source + * {@code CachedRowSet} object back to its underlying data source * - * Iterates through each row of the CachedRowSet object + * Iterates through each row of the {@code CachedRowSet} object * to determine whether it has been updated, inserted, or deleted * If the corresponding row in the data source has not been changed * since the rowset last read its * values, the writer will use the appropriate command to update, * insert, or delete the row * If any data in the data source does not match the original values - * for the CachedRowSet object, the writer will roll + * for the {@code CachedRowSet} object, the writer will roll * back any changes it has made to the row in the data source. * * * - * @return true if changes to the rowset were successfully + * @return {@code true} if changes to the rowset were successfully * written to the rowset's underlying data source; - * false otherwise + * {@code false} otherwise */ public boolean writeData(RowSetInternal caller) throws SQLException { long conflicts = 0; @@ -434,25 +434,25 @@ } //end writeData -/** - * Updates the given CachedRowSet object's underlying data - * source so that updates to the rowset are reflected in the original - * data source, and returns false if the update was successful. - * A return value of true indicates that there is a conflict, - * meaning that a value updated in the rowset has already been changed by - * someone else in the underlying data source. A conflict can also exist - * if, for example, more than one row in the data source would be affected - * by the update or if no rows would be affected. In any case, if there is - * a conflict, this method does not update the underlying data source. - * - * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + * + * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - * - * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + * + * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. * - * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - * - * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + * + * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. * * If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. * * The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. * * NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. * * This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. * - * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. * - * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. * * Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. * - * undoUpdateRowSet object backed by the same data as - * that of this CachedRowSetImpl object and sharing a set of cursors + * Returns a new {@code RowSet} object backed by the same data as + * that of this {@code CachedRowSetImpl} object and sharing a set of cursors * with it. This allows cursors to interate over a shared set of rows, providing * multiple views of the underlying data. * - * @return a RowSet object that is a copy of this CachedRowSetImpl + * @return a {@code RowSet} object that is a copy of this {@code CachedRowSetImpl} * object and shares a set of cursors with it * @throws SQLException if an error occurs or cloning is * not supported @@ -750,19 +750,19 @@ } /** - * Returns a new RowSet object containing by the same data - * as this CachedRowSetImpl object. This method - * differs from the method createCopy in that it throws a - * CloneNotSupportedException object instead of an - * SQLException object, as the method createShared - * does. This clone - * method is called internally by the method createShared, - * which catches the CloneNotSupportedException object - * and in turn throws a new SQLException object. + * Returns a new {@code RowSet} object containing by the same data + * as this {@code CachedRowSetImpl} object. This method + * differs from the method {@code createCopy} in that it throws a + * {@code CloneNotSupportedException} object instead of an + * {@code SQLException} object, as the method {@code createShared} + * does. This {@code clone} + * method is called internally by the method {@code createShared}, + * which catches the {@code CloneNotSupportedException} object + * and in turn throws a new {@code SQLException} object. * - * @return a copy of this CachedRowSetImpl object + * @return a copy of this {@code CachedRowSetImpl} object * @throws CloneNotSupportedException if an error occurs when - * attempting to clone this CachedRowSetImpl object + * attempting to clone this {@code CachedRowSetImpl} object * @see #createShared */ protected Object clone() throws CloneNotSupportedException { @@ -770,8 +770,8 @@ } /** - * Creates a RowSet object that is a deep copy of - * this CachedRowSetImpl object's data, including + * Creates a {@code RowSet} object that is a deep copy of + * this {@code CachedRowSetImpl} object's data, including * constraints. Updates made * on a copy are not visible to the original rowset; * a copy of a rowset is completely independent from the original. @@ -780,12 +780,12 @@ * from first principles, which can be quite expensive. * For example, it can eliminate the need to query a * remote database server. - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSet object and is - * completely independent from this CachedRowSetImpl + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSet} object and is + * completely independent from this {@code CachedRowSetImpl} * object. * @throws SQLException if an error occurs in generating the copy of this - * of the CachedRowSetImpl + * of the {@code CachedRowSetImpl} * @see #createShared * @see javax.sql.RowSetEvent * @see javax.sql.RowSetListener @@ -795,21 +795,21 @@ } /** - * Creates a RowSet object that is a copy of - * this CachedRowSetImpl object's table structure + * Creates a {@code RowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's table structure * and the constraints only. * There will be no data in the object being returned. * Updates made on a copy are not visible to the original rowset. * * This helps in getting the underlying XML schema which can - * be used as the basis for populating a WebRowSet. + * be used as the basis for populating a {@code WebRowSet}. * - * @return a new CachedRowSet object that is a copy - * of this CachedRowSetImpl object's schema and + * @return a new {@code CachedRowSet} object that is a copy + * of this {@code CachedRowSetImpl} object's schema and * retains all the constraints on the original rowset but contains * no data * @throws SQLException if an error occurs in generating the copy - * of the CachedRowSet object + * of the {@code CachedRowSet} object * @see #createShared * @see #createCopy * @see #createCopyNoConstraints @@ -821,17 +821,17 @@ } /** - * Creates a CachedRowSet object that is a copy of - * this CachedRowSetImpl object's data only. + * Creates a {@code CachedRowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's data only. * All constraints set in this object will not be there * in the returning object. Updates made * on a copy are not visible to the original rowset. * - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSetImpl object and is - * completely independent from this CachedRowSetImpl object + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSetImpl} object and is + * completely independent from this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the copy of the - * of the CachedRowSet + * of the {@code CachedRowSet} * @see #createShared * @see #createCopy * @see #createCopySchema @@ -843,15 +843,15 @@ } /** - * Converts this CachedRowSetImpl object to a collection - * of tables. The sample implementation utilitizes the TreeMap + * Converts this {@code CachedRowSetImpl} object to a collection + * of tables. The sample implementation utilitizes the {@code TreeMap} * collection type. * This class guarantees that the map will be in ascending key order, * sorted according to the natural order for the key's class. * - * @return a Collection object consisting of tables, + * @return a {@code Collection} object consisting of tables, * each of which is a copy of a row in this - * CachedRowSetImpl object + * {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the collection * @see #toCollection(int) * @see #toCollection(String) @@ -863,16 +863,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -886,16 +886,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -914,25 +914,25 @@ /** - * Returns the SyncProvider implementation being used - * with this CachedRowSetImpl implementation rowset. + * Returns the {@code SyncProvider} implementation being used + * with this {@code CachedRowSetImpl} implementation rowset. * * @return the SyncProvider used by the rowset. If not provider was * set when the rowset was instantiated, the reference * implementation (default) provider is returned. * @throws SQLException if error occurs while return the - * SyncProvider instance. + * {@code SyncProvider} instance. */ public SyncProvider getSyncProvider() throws SQLException { throw new UnsupportedOperationException(); } /** - * Sets the active SyncProvider and attempts to load - * load the new provider using the SyncFactory SPI. + * Sets the active {@code SyncProvider} and attempts to load + * load the new provider using the {@code SyncFactory} SPI. * * @throws SQLException if an error occurs while resetting the - * SyncProvider. + * {@code SyncProvider}. */ public void setSyncProvider(String providerStr) throws SQLException { throw new UnsupportedOperationException(); @@ -953,23 +953,23 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data. + * Populates this {@code CachedRowSetImpl} object with data. * This form of the method uses the rowset's user, password, and url or * data source name properties to create a database * connection. If properties that are needed * have not been set, this method will throw an exception. * - * Another form of this method uses an existing JDBC Connection + * Another form of this method uses an existing JDBC {@code Connection} * object instead of creating a new one; therefore, it ignores the * properties used for establishing a new connection. * * The query specified by the command property is executed to create a - * ResultSet object from which to retrieve data. + * {@code ResultSet} object from which to retrieve data. * The current contents of the rowset are discarded, and the * rowset's metadata is also (re)set. If there are outstanding updates, * they are also ignored. * - * The method execute closes any database connections that it + * The method {@code execute} closes any database connections that it * creates. * * @throws SQLException if an error occurs or the @@ -987,20 +987,20 @@ /** * Moves the cursor down one row from its current position and - * returns true if the new cursor position is a + * returns {@code true} if the new cursor position is a * valid row. - * The cursor for a new ResultSet object is initially + * The cursor for a new {@code ResultSet} object is initially * positioned before the first row. The first call to the method - * next moves the cursor to the first row, making it + * {@code next} moves the cursor to the first row, making it * the current row; the second call makes the second row the * current row, and so on. * * If an input stream from the previous row is open, it is - * implicitly closed. The ResultSet object's warning + * implicitly closed. The {@code ResultSet} object's warning * chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if an error occurs or * the cursor is not positioned in the rowset, before * the first row, or after the last row @@ -1010,9 +1010,9 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the next - * row and returns true if the cursor is still in the rowset; - * returns false if the cursor has moved to the position after + * Moves this {@code CachedRowSetImpl} object's cursor to the next + * row and returns {@code true} if the cursor is still in the rowset; + * returns {@code false} if the cursor has moved to the position after * the last row. * * This method handles the cases where the cursor moves to a row that @@ -1021,15 +1021,15 @@ * that has been deleted, this method moves the cursor to the next * row until the cursor is on a row that has not been deleted. * - * The method internalNext is called by methods such as - * next, absolute, and relative, + * The method {@code internalNext} is called by methods such as + * {@code next}, {@code absolute}, and {@code relative}, * and, as its name implies, is only called internally. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a valid row in this - * rowset; false if it is after the last row + * @return {@code true} if the cursor is on a valid row in this + * rowset; {@code false} if it is after the last row * @throws SQLException if an error occurs */ protected boolean internalNext() throws SQLException { @@ -1037,25 +1037,25 @@ } /** - * Closes this CachedRowSetImpl objecy and releases any resources + * Closes this {@code CachedRowSetImpl} objecy and releases any resources * it was using. * * @throws SQLException if an error occurs when releasing any resources in use - * by this CachedRowSetImpl object + * by this {@code CachedRowSetImpl} object */ public void close() throws SQLException { throw new UnsupportedOperationException(); } /** - * Reports whether the last column read was SQL NULL. - * Note that you must first call the method getXXX + * Reports whether the last column read was SQL {@code NULL}. + * Note that you must first call the method {@code getXXX} * on a column to try to read its value and then call the method - * wasNull to determine whether the value was - * SQL NULL. + * {@code wasNull} to determine whether the value was + * SQL {@code NULL}. * - * @return true if the value in the last column read - * was SQL NULL; false otherwise + * @return {@code true} if the value in the last column read + * was SQL {@code NULL}; {@code false} otherwise * @throws SQLException if an error occurs */ public boolean wasNull() throws SQLException { @@ -1064,9 +1064,9 @@ /** * Returns the insert row or the current row of this - * CachedRowSetImplobject. + * {@code CachedRowSetImpl}object. * - * @return the Row object on which this CachedRowSetImpl + * @return the {@code Row} object on which this {@code CachedRowSetImpl} * objects's cursor is positioned */ protected BaseRow getCurrentRow() { @@ -1077,7 +1077,7 @@ * Removes the row on which the cursor is positioned. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * * @throws SQLException if the cursor is positioned on the insert * row @@ -1089,20 +1089,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * String object. + * of this {@code CachedRowSetImpl} object as a + * {@code String} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} {@code CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type designates the * recommended return type. */ public String getString(int columnIndex) throws SQLException { @@ -1111,18 +1111,18 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * boolean value. + * of this {@code CachedRowSetImpl} object as a + * {@code boolean} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a boolean in the Java progamming language; - * if the value is SQL NULL, the result is false + * @return the column value as a {@code boolean} in the Java progamming language; + * if the value is SQL {@code NULL}, the result is {@code false} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BOOLEAN value + * SQL {@code BOOLEAN} value * @see #getBoolean(String) */ public boolean getBoolean(int columnIndex) throws SQLException { @@ -1131,20 +1131,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type + * SQL {@code TINYINT}, {@code SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type * designates the recommended return type. * @see #getByte(String) */ @@ -1154,21 +1154,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * short value. + * of this {@code CachedRowSetImpl} object as a + * {@code short} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT}, {@code SMALLINT}, + * {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(String) */ public short getShort(int columnIndex) throws SQLException { @@ -1177,21 +1178,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * int value. + * of this {@code CachedRowSetImpl} object as an + * {@code int} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1199,21 +1201,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * long value. + * of this {@code CachedRowSetImpl} object as a + * {@code long} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getLong(String) */ public long getLong(int columnIndex) throws SQLException { @@ -1222,21 +1225,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * float value. + * of this {@code CachedRowSetImpl} object as a + * {@code float} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,} + * {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC, + * BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(int columnIndex) throws SQLException { @@ -1245,21 +1248,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * double value. + * of this {@code CachedRowSetImpl} object as a + * {@code double} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,} + * {@code FLOAT, DOUBLE}, + * {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getDouble(String) * */ @@ -1269,21 +1273,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * This method is deprecated; use the version of getBigDecimal + * This method is deprecated; use the version of {@code getBigDecimal} * that does not take a scale parameter and returns a value with full * precision. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @param scale the number of digits to the right of the decimal point in the * value returned * @return the column value with the specified number of digits to the right - * of the decimal point; if the value is SQL NULL, the - * result is null + * of the decimal point; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails * @deprecated @@ -1295,22 +1299,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte array value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} array value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the - * result is null + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the + * result is {@code null} * * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or + * {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getBytes(String) */ public byte[] getBytes(int columnIndex) throws SQLException { @@ -1319,17 +1323,17 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Date object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Date} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a java.sql.Data object; if - * the value is SQL NULL, the - * result is null + * @return the column value as a {@code java.sql.Data} object; if + * the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, - * the cursor is not on a valid row, or this method fails + * the cursor is not on a valid row, or this method fails */ public java.sql.Date getDate(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1337,14 +1341,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Time object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Time} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1354,14 +1358,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1371,33 +1375,33 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The JDBC + * suitable for retrieving large {@code LONGVARCHAR} values. The JDBC * driver will do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. . Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(String) */ public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException { @@ -1416,8 +1420,8 @@ * stream may return 0 for available() whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of two byte Unicode characters. If the value is SQL NULL @@ -1432,30 +1436,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for - * CachedRowSetImpl.available() whether there is data + * stream may return {@code 0} for + * {@code CachedRowSetImpl.available()} whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes. If the value is SQL NULL - * then the result is null. + * as a stream of uninterpreted bytes. If the value is SQL {@code NULL} + * then the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY}. * The bold type indicates the SQL type that this method is recommened * to retrieve. * @see #getBinaryStream(String) @@ -1472,19 +1476,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a String object. + * of the current row as a {@code String} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR< value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} + * {@code CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. */ public String getString(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1492,17 +1496,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a boolean value. + * of the current row as a {@code boolean} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a boolean in the Java programming - * language; if the value is SQL NULL, - * the result is false + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code boolean} in the Java programming + * language; if the value is SQL {@code NULL}, + * the result is {@code false} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BOOLEAN value + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BOOLEAN} value * @see #getBoolean(int) */ public boolean getBoolean(String columnName) throws SQLException { @@ -1511,19 +1515,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte value. + * of the current row as a {@code byte} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The - * bold type designates the recommended return type + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT}, + * {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} + * value. The bold type designates the recommended return type. */ public byte getByte(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1531,19 +1535,20 @@ /** * Retrieves the value stored in the designated column - * of the current row as a short value. + * of the current row as a {@code short} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT,} + * {@code SMALLINT}, {@code INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(int) */ public short getShort(String columnName) throws SQLException { @@ -1552,20 +1557,21 @@ /** * Retrieves the value stored in the designated column - * of the current row as an int value. + * of the current row as an {@code int} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name - * of a column in this rowset, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * of a column in this rowset, + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1573,19 +1579,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a long value. + * of the current row as a {@code long} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getLong(int) */ public long getLong(String columnName) throws SQLException { @@ -1594,19 +1600,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a float value. + * of the current row as a {@code float} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT,} {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(String columnName) throws SQLException { @@ -1615,20 +1621,20 @@ /** * Retrieves the value stored in the designated column - * of the current row of this CachedRowSetImpl object - * as a double value. + * of the current row of this {@code CachedRowSetImpl} object + * as a {@code double} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return types. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL,} {@code FLOAT, DOUBLE}, {@code DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return types. * @see #getDouble(int) */ public double getDouble(String columnName) throws SQLException { @@ -1637,22 +1643,22 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.math.BigDecimal object. + * of the current row as a {@code java.math.BigDecimal} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @param scale the number of digits to the right of the decimal point - * @return a java.math.BugDecimal object with scale - * number of digits to the right of the decimal point. + * @return a java.math.BugDecimal object with {@code scale} + * number of digits to the right of the decimal point. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve. - * @deprecated Use the getBigDecimal(String columnName) + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. + * @deprecated Use the {@code getBigDecimal(String columnName)} * method instead */ @Deprecated @@ -1662,19 +1668,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte array. + * of the current row as a {@code byte} array. * The bytes represent the raw values returned by the driver. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BINARY, VARBINARY - * or LONGVARBINARY values - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BINARY, VARBINARY} + * or {@code LONGVARBINARY} values. + * The bold SQL type designates the recommended return type. * @see #getBytes(int) */ public byte[] getBytes(String columnName) throws SQLException { @@ -1683,17 +1689,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Date object. + * of the current row as a {@code java.sql.Date} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1701,12 +1707,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Time object. + * of the current row as a {@code java.sql.Time} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1717,12 +1723,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Timestamp object. + * of the current row as a {@code java.sql.Timestamp} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1733,32 +1739,32 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The - * SyncProvider will rely on the JDBC driver to do any necessary + * suitable for retrieving large {@code LONGVARCHAR} values. The + * {@code SyncProvider} will rely on the JDBC driver to do any necessary * conversion from the database format into ASCII format. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * a column in this rowset + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(int) */ public java.io.InputStream getAsciiStream(String columnName) throws SQLException { @@ -1769,23 +1775,23 @@ /** * A column value can be retrieved as a stream of Unicode characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will do any necessary conversion from the database * format into Unicode. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row - * @deprecated use the method getCharacterStream instead + * @deprecated use the method {@code getCharacterStream} instead */ @Deprecated public java.io.InputStream getUnicodeStream(String columnName) throws SQLException { @@ -1794,30 +1800,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of uninterpreted bytes. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is unknown, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY - * The bold type indicates the SQL type that this method is recommened - * to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY} + * The bold type indicates the SQL type that this method is recommened + * to retrieve. * @see #getBinaryStream(int) * */ @@ -1831,17 +1837,17 @@ //===================================================================== /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by statement + * by {@code ResultSet} methods. Any warning caused by statement * methods (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * * @return the first SQLWarning or null */ @@ -1850,10 +1856,10 @@ } /** - * Clears all the warnings reporeted for the CachedRowSetImpl - * object. After a call to this method, the getWarnings method - * returns null until a new warning is reported for this - * CachedRowSetImpl object. + * Clears all the warnings reporeted for the {@code CachedRowSetImpl} + * object. After a call to this method, the {@code getWarnings} method + * returns {@code null} until a new warning is reported for this + * {@code CachedRowSetImpl} object. */ public void clearWarnings() { throw new UnsupportedOperationException(); @@ -1861,25 +1867,25 @@ /** * Retrieves the name of the SQL cursor used by this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * * In SQL, a result table is retrieved through a cursor that is - * named. The current row of a ResultSet can be updated or deleted + * named. The current row of a {@code ResultSet} can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To ensure that the cursor has the proper isolation - * level to support an update operation, the cursor's SELECT - * statement should be of the form select for update. - * If the for update clause + * level to support an update operation, the cursor's {@code SELECT} + * statement should be of the form {@code select for update}. + * If the {@code for update} clause * is omitted, positioned updates may fail. * * JDBC supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. The current row + * SQL cursor used by a {@code ResultSet} object. The current row * of a result set is also the current row of this SQL cursor. * * Note: If positioned updates are not supported, an - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL cursor name for this CachedRowSetImpl object's + * @return the SQL cursor name for this {@code CachedRowSetImpl} object's * cursor * @throws SQLException if an error occurs */ @@ -1888,12 +1894,12 @@ } /** - * Retrieves a ResultSetMetaData object instance that - * contains information about the CachedRowSet object. + * Retrieves a {@code ResultSetMetaData} object instance that + * contains information about the {@code CachedRowSet} object. * However, applications should cast the returned object to a - * RowSetMetaData interface implementation. In the + * {@code RowSetMetaData} interface implementation. In the * reference implementation, this cast can be done on the - * RowSetMetaDataImpl class. + * {@code RowSetMetaDataImpl} class. * * For example: * @@ -1907,10 +1913,10 @@ * crs.setMetaData(metaData); * * - * @return the ResultSetMetaData object that describes this - * CachedRowSetImpl object's columns + * @return the {@code ResultSetMetaData} object that describes this + * {@code CachedRowSetImpl} object's columns * @throws SQLException if an error occurs in generating the RowSet - * meta data; or if the CachedRowSetImpl is empty. + * meta data; or if the {@code CachedRowSetImpl} is empty. * @see javax.sql.RowSetMetaData */ public ResultSetMetaData getMetaData() throws SQLException { @@ -1920,10 +1926,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1931,23 +1937,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes in the Java programming language. * When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(String) */ public Object getObject(int columnIndex) throws SQLException { @@ -1956,10 +1962,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1967,23 +1973,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes * in the Java programming language. When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name does not match one of * this rowset's column names, (2) the cursor is not * on a valid row, or (3) there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(int) */ public Object getObject(String columnName) throws SQLException { @@ -1993,10 +1999,10 @@ //---------------------------------------------------------------- /** - * Maps the given column name for one of this CachedRowSetImpl + * Maps the given column name for one of this {@code CachedRowSetImpl} * object's columns to its column number. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @return the column index of the given column name * @throws SQLException if the given column name does not match one @@ -2014,25 +2020,25 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java character stream that delivers the database column value * as a stream of two-byte unicode characters in a - * java.io.Reader object. If the value is - * SQL NULL, the result is null. + * {@code java.io.Reader} object. If the value is + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR,} {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getCharacterStream(String) */ public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{ @@ -2041,23 +2047,24 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY or LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code CHAR, VARCHAR,} + * {@code LONGVARCHAR}, + * {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -2065,21 +2072,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return types that this method is used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return types that this method is used to retrieve. * @see #getBigDecimal(String) */ public BigDecimal getBigDecimal(int columnIndex) throws SQLException { @@ -2088,21 +2096,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. * @see #getBigDecimal(int) */ public BigDecimal getBigDecimal(String columnName) throws SQLException { @@ -2114,7 +2122,7 @@ //--------------------------------------------------------------------- /** - * Returns the number of rows in this CachedRowSetImpl object. + * Returns the number of rows in this {@code CachedRowSetImpl} object. * * @return number of rows in the rowset */ @@ -2124,10 +2132,10 @@ /** * Indicates whether the cursor is before the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is before the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isBeforeFirst() throws SQLException { @@ -2136,10 +2144,10 @@ /** * Indicates whether the cursor is after the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is after the last row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isAfterLast() throws SQLException { @@ -2148,10 +2156,10 @@ /** * Indicates whether the cursor is on the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is on the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isFirst() throws SQLException { @@ -2160,14 +2168,14 @@ /** * Indicates whether the cursor is on the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * Note: Calling the method isLast may be expensive + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver might need to fetch ahead one row in order * to determine whether the current row is the last row in this rowset. * - * @return true if the cursor is on the last row; - * false otherwise or if this rowset contains no rows + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise or if this rowset contains no rows * @throws SQLException if an error occurs */ public boolean isLast() throws SQLException { @@ -2175,19 +2183,19 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the front of + * Moves this {@code CachedRowSetImpl} object's cursor to the front of * the rowset, just before the first row. This method has no effect if * this rowset contains no rows. * * @throws SQLException if an error occurs or the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public void beforeFirst() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the end of + * Moves this {@code CachedRowSetImpl} object's cursor to the end of * the rowset, just after the last row. This method has no effect if * this rowset contains no rows. * @@ -2198,34 +2206,34 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the first row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the first row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean first() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the first - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the first + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the methods first, - * isFirst, and absolute. - * It in turn calls the method internalNext in order to + * This method is called internally by the methods {@code first}, + * {@code isFirst}, and {@code absolute}. + * It in turn calls the method {@code internalNext} in order to * handle the case where the first row is a deleted row that is not visible. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the first row; - * false otherwise + * @return {@code true} if the cursor moved to the first row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalFirst() throws SQLException { @@ -2233,35 +2241,35 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the last row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the last row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean last() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the last - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the last + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the method last + * This method is called internally by the method {@code last} * when rows have been deleted and the deletions are not visible. - * The method internalLast handles the case where the + * The method {@code internalLast} handles the case where the * last row is a deleted row that is not visible by in turn calling - * the method internalPrevious. + * the method {@code internalPrevious}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the last row; - * false otherwise + * @return {@code true} if the cursor moved to the last row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalLast() throws SQLException { @@ -2269,12 +2277,12 @@ } /** - * Returns the number of the current row in this CachedRowSetImpl + * Returns the number of the current row in this {@code CachedRowSetImpl} * object. The first row is number 1, the second number 2, and so on. * - * @return the number of the current row; 0 if there is no + * @return the number of the current row; {@code 0} if there is no * current row - * @throws SQLException if an error occurs; or if the CacheRowSetImpl + * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl} * is empty */ public int getRow() throws SQLException { @@ -2282,51 +2290,51 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the row number + * Moves this {@code CachedRowSetImpl} object's cursor to the row number * specified. * * If the number is positive, the cursor moves to an absolute row with * respect to the beginning of the rowset. The first row is row 1, the second * is row 2, and so on. For example, the following command, in which - * crs is a CachedRowSetImpl object, moves the cursor + * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor * to the fourth row, starting from the beginning of the rowset. - * + * {@code * * crs.absolute(4); * - * + * } * * If the number is negative, the cursor moves to an absolute row position * with respect to the end of the rowset. For example, calling - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row, counting * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. * * @param row a positive number to indicate the row, starting row numbering from - * the first row, which is 1; a negative number to indicate + * the first row, which is {@code 1}; a negative number to indicate * the row, starting row numbering from the last row, which is - * -1; it must not be 0 - * @return true if the cursor is on the rowset; false + * {@code -1}; it must not be {@code 0} + * @return {@code true} if the cursor is on the rowset; {@code false} * otherwise - * @throws SQLException if the given cursor position is 0 or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * @throws SQLException if the given cursor position is {@code 0} or the + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean absolute( int row ) throws SQLException { throw new UnsupportedOperationException(); @@ -2340,80 +2348,80 @@ * If the number is positive, the cursor moves the specified number of * rows toward the end of the rowset, starting at the current row. * For example, the following command, in which - * crs is a CachedRowSetImpl object with 100 rows, + * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows, * moves the cursor forward four rows from the current row. If the * current row is 50, the cursor would move to row 54. - * + * {@code * * crs.relative(4); * - * + * } * * If the number is negative, the cursor moves back toward the beginning * the specified number of rows, starting at the current row. * For example, calling the method - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. In both cases, this method - * throws an SQLException. + * throws an {@code SQLException}. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). Calling relative(0) + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. Calling {@code relative(0)} * is valid, but it does not change the cursor position. * - * @param rows an int indicating the number of rows to move + * @param rows an {@code int} indicating the number of rows to move * the cursor, starting at the current row; a positive number * moves the cursor forward; a negative number moves the cursor * backward; must not move the cursor past the valid * rows - * @return true if the cursor is on a row in this - * CachedRowSetImpl object; false + * @return {@code true} if the cursor is on a row in this + * {@code CachedRowSetImpl} object; {@code false} * otherwise * @throws SQLException if there are no rows in this rowset, the cursor is * positioned either before the first row or after the last row, or - * the rowset is type ResultSet.TYPE_FORWARD_ONLY + * the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean relative(int rows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the - * previous row and returns true if the cursor is on - * a valid row or false if it is not. + * Moves this {@code CachedRowSetImpl} object's cursor to the + * previous row and returns {@code true} if the cursor is on + * a valid row or {@code false} if it is not. * This method also notifies all listeners registered with this - * CachedRowSetImpl object that its cursor has moved. + * {@code CachedRowSetImpl} object that its cursor has moved. * - * Note: calling the method previous() is not the same - * as calling the method relative(-1). This is true - * because it is possible to call previous() from the insert + * Note: calling the method {@code previous()} is not the same + * as calling the method {@code relative(-1)}. This is true + * because it is possible to call {@code previous()} from the insert * row, from after the last row, or from the current row, whereas - * relative may only be called from the current row. + * {@code relative} may only be called from the current row. * - * The method previous may used in a while + * The method {@code previous} may used in a {@code while} * loop to iterate through a rowset starting after the last row - * and moving toward the beginning. The loop ends when previous - * returns false, meaning that there are no more rows. + * and moving toward the beginning. The loop ends when {@code previous} + * returns {@code false}, meaning that there are no more rows. * For example, the following code fragment retrieves all the data in - * the CachedRowSetImpl object crs, which has + * the {@code CachedRowSetImpl} object {@code crs}, which has * three columns. Note that the cursor must initially be positioned * after the last row so that the first call to the method - * previous places the cursor on the last line. - * + * {@code previous} places the cursor on the last line. + * {@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - * - * This method throws an SQLException if the cursor is not + * } + * This method throws an {@code SQLException} if the cursor is not * on a row in the rowset, before the first row, or after the last row. * - * @return true if the cursor is on a valid row; - * false if it is before the first row or after the + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is before the first row or after the * last row * @throws SQLException if the cursor is not on a valid position or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean previous() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor to the previous row in this CachedRowSetImpl + * Moves the cursor to the previous row in this {@code CachedRowSetImpl} * object, skipping past deleted rows that are not visible; returns - * true if the cursor is on a row in this rowset and - * false when the cursor goes before the first row. + * {@code true} if the cursor is on a row in this rowset and + * {@code false} when the cursor goes before the first row. * - * This method is called internally by the method previous. + * This method is called internally by the method {@code previous}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a row in this rowset; - * false when the cursor reaches the position before + * @return {@code true} if the cursor is on a row in this rowset; + * {@code false} when the cursor reaches the position before * the first row * @throws SQLException if an error occurs */ @@ -2463,14 +2471,14 @@ //--------------------------------------------------------------------- /** - * Indicates whether the current row of this CachedRowSetImpl + * Indicates whether the current row of this {@code CachedRowSetImpl} * object has been updated. The value returned - * depends on whether this rowset can detect updates: false + * depends on whether this rowset can detect updates: {@code false} * will always be returned if it does not detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another and updates are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2482,13 +2490,13 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * * @param idx the index identifier of the column that may be have been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2500,14 +2508,14 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * - * @param columnName the String column name column that may be have + * @param columnName the {@code String} column name column that may be have * been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2521,8 +2529,8 @@ * Indicates whether the current row has been inserted. The value returned * depends on whether or not the rowset can detect visible inserts. * - * @return true if a row has been inserted and inserts are detected; - * false otherwise + * @return {@code true} if a row has been inserted and inserts are detected; + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2536,12 +2544,12 @@ * Indicates whether the current row has been deleted. A deleted row * may leave a visible "hole" in a rowset. This method can be used to * detect such holes if the rowset can detect deletions. This method - * will always return false if this rowset cannot detect + * will always return {@code false} if this rowset cannot detect * deletions. * - * @return true if (1)the current row is blank, indicating that + * @return {@code true} if (1)the current row is blank, indicating that * the row has been deleted, and (2)deletions are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on a valid row in this rowset * @see DatabaseMetaData#deletesAreDetected */ @@ -2551,8 +2559,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset; however, another method must be called to complete @@ -2565,15 +2573,15 @@ * * In order to propagate updates in this rowset to the underlying * data source, an application must call the method {@link #acceptChanges} - * after it calls either updateRow or insertRow. + * after it calls either {@code updateRow} or {@code insertRow}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -2581,8 +2589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2593,14 +2601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(int columnIndex, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -2608,8 +2616,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2620,14 +2628,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(int columnIndex, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -2635,8 +2643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2647,14 +2655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(int columnIndex, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -2662,8 +2670,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2674,14 +2682,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(int columnIndex, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -2689,8 +2697,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2701,14 +2709,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(int columnIndex, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -2717,8 +2725,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2729,14 +2737,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(int columnIndex, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -2744,8 +2752,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2756,14 +2764,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(int columnIndex, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -2771,8 +2779,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2783,14 +2791,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -2798,8 +2806,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2810,17 +2818,17 @@ * as inserted. Both of these methods must be called before the * cursor moves to another row. * - * The method acceptChanges must be called if the + * The method {@code acceptChanges} must be called if the * updated values are to be written back to the underlying database. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(int columnIndex, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -2828,8 +2836,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2840,14 +2848,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(int columnIndex, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -2855,8 +2863,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2867,15 +2875,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(int columnIndex, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -2883,8 +2891,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2895,15 +2903,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL TIME or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code TIME} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(int columnIndex, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -2911,8 +2919,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2923,16 +2931,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE, TIME, or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE}, {@code TIME}, or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -2940,7 +2948,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -2952,8 +2960,8 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -2965,8 +2973,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2977,17 +2985,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not binary, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException { throw new UnsupportedOperationException(); @@ -2995,8 +3003,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3007,19 +3015,19 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.Reader - * containing BINARY, VARBINARY, - * LONGVARBINARY, CHAR, VARCHAR, - * or LONGVARCHAR data + * @param x the new column value; must be a {@code java.io.Reader} + * containing {@code BINARY}, {@code VARBINARY}, + * {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR}, + * or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not a binary or * character type, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3027,11 +3035,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter indicates + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter indicates * the number of digits to the right of the decimal point and is ignored * if the new column value is not a type that will be mapped to an SQL - * DECIMAL or NUMERIC value. + * {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3042,16 +3050,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3059,8 +3067,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3071,14 +3079,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x) throws SQLException { throw new UnsupportedOperationException(); @@ -3087,8 +3095,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3098,12 +3106,12 @@ * must be called, which will insert the new row into both this rowset * and the database. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -3111,8 +3119,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3123,13 +3131,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(String columnName, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -3137,8 +3145,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3149,13 +3157,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(String columnName, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -3163,8 +3171,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3175,13 +3183,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(String columnName, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -3189,8 +3197,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3201,13 +3209,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(String columnName, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -3215,8 +3223,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3227,13 +3235,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(String columnName, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -3241,8 +3249,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3253,13 +3261,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(String columnName, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -3267,8 +3275,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3279,13 +3287,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(String columnName, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -3293,8 +3301,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3305,13 +3313,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -3319,8 +3327,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3331,13 +3339,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(String columnName, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -3345,8 +3353,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3357,13 +3365,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(String columnName, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -3371,8 +3379,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3383,15 +3391,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(String columnName, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -3399,8 +3407,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3411,15 +3419,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL TIME or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code TIME} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(String columnName, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -3427,8 +3435,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3439,7 +3447,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if the given column index is out of bounds or @@ -3448,9 +3456,9 @@ * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE, - * TIME, or TIMESTAMP, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP}, or (4) this + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -3458,7 +3466,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -3470,7 +3478,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -3483,8 +3491,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3495,17 +3503,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not binary, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3513,8 +3521,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3525,18 +3533,18 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param reader the new column value; must be a - * java.io.Reader containing BINARY, - * VARBINARY, LONGVARBINARY, CHAR, - * VARCHAR, or LONGVARCHAR data + * {@code java.io.Reader} containing {@code BINARY}, + * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR}, + * {@code VARCHAR}, or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not a binary or character type, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(String columnName, java.io.Reader reader, @@ -3546,11 +3554,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter * indicates the number of digits to the right of the decimal point * and is ignored if the new column value is not a type that will be - * mapped to an SQL DECIMAL or NUMERIC value. + * mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3561,15 +3569,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3577,8 +3585,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3589,20 +3597,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x) throws SQLException { throw new UnsupportedOperationException(); } /** - * Inserts the contents of this CachedRowSetImpl object's insert + * Inserts the contents of this {@code CachedRowSetImpl} object's insert * row into this rowset immediately following the current row. * If the current row is the * position after the last row or before the first row, the new row will @@ -3614,14 +3622,14 @@ * @throws SQLException if (1) the cursor is not on the insert row, * (2) one or more of the non-nullable columns in the insert * row has not been given a value, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void insertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Marks the current row of this CachedRowSetImpl object as + * Marks the current row of this {@code CachedRowSetImpl} object as * updated and notifies listeners registered with this rowset that the * row has changed. * @@ -3631,26 +3639,26 @@ * and the updates made before the cursor moved will be lost. * * @throws SQLException if the cursor is on the insert row or this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Deletes the current row from this CachedRowSetImpl object and + * Deletes the current row from this {@code CachedRowSetImpl} object and * notifies listeners registered with this rowset that a row has changed. * This method cannot be called when the cursor is on the insert row. * * This method marks the current row as deleted, but it does not delete * the row from the underlying data source. The method - * acceptChanges must be called to delete the row in + * {@code acceptChanges} must be called to delete the row in * the data source. * * @throws SQLException if (1) this method is called when the cursor * is on the insert row, before the first row, or after the * last row or (2) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void deleteRow() throws SQLException { throw new UnsupportedOperationException(); @@ -3659,7 +3667,7 @@ /** * Sets the current row with its original value and marks the row as * not updated, thus undoing any changes made to the row since the - * last call to the methods updateRow or deleteRow. + * last call to the methods {@code updateRow} or {@code deleteRow}. * This method should be called only when the cursor is on a row in * this rowset. * @@ -3672,11 +3680,11 @@ /** * Rolls back any updates made to the current row of this - * CachedRowSetImpl object and notifies listeners that + * {@code CachedRowSetImpl} object and notifies listeners that * a row has changed. To have an effect, this method - * must be called after an updateXXX method has been - * called and before the method updateRow has been called. - * If no updates have been made or the method updateRow + * must be called after an {@code updateXXX} method has been + * called and before the method {@code updateRow} has been called. + * If no updates have been made or the method {@code updateRow} * has already been called, this method has no effect. * * @throws SQLException if the cursor is on the insert row, before the @@ -3687,39 +3695,39 @@ } /** - * Moves the cursor for this CachedRowSetImpl object + * Moves the cursor for this {@code CachedRowSetImpl} object * to the insert row. The current row in the rowset is remembered * while the cursor is on the insert row. * * The insert row is a special row associated with an updatable * rowset. It is essentially a buffer where a new row may - * be constructed by calling the appropriate updateXXX + * be constructed by calling the appropriate {@code updateXXX} * methods to assign a value to each column in the row. A complete * row must be constructed; that is, every column that is not nullable * must be assigned a value. In order for the new row to become part - * of this rowset, the method insertRow must be called + * of this rowset, the method {@code insertRow} must be called * before the cursor is moved back to the rowset. * * Only certain methods may be invoked while the cursor is on the insert * row; many methods throw an exception if they are called while the - * cursor is there. In addition to the updateXXX - * and insertRow methods, only the getXXX methods - * may be called when the cursor is on the insert row. A getXXX - * method should be called on a column only after an updateXXX + * cursor is there. In addition to the {@code updateXXX} + * and {@code insertRow} methods, only the {@code getXXX} methods + * may be called when the cursor is on the insert row. A {@code getXXX} + * method should be called on a column only after an {@code updateXXX} * method has been called on that column; otherwise, the value returned is * undetermined. * - * @throws SQLException if this CachedRowSetImpl object is - * ResultSet.CONCUR_READ_ONLY + * @throws SQLException if this {@code CachedRowSetImpl} object is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void moveToInsertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor for this CachedRowSetImpl object to + * Moves the cursor for this {@code CachedRowSetImpl} object to * the current row. The current row is the row the cursor was on - * when the method moveToInsertRow was called. + * when the method {@code moveToInsertRow} was called. * * Calling this method has no effect unless it is called while the * cursor is on the insert row. @@ -3731,9 +3739,9 @@ } /** - * Returns null. + * Returns {@code null}. * - * @return null + * @return {@code null} * @throws SQLException if an error occurs */ public Statement getStatement() throws SQLException { @@ -3742,18 +3750,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column index is out of bounds or * the cursor is not on one of this rowset's rows or its * insert row @@ -3767,17 +3775,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL REF value + * SQL {@code REF} value * @see #getRef(String) */ public Ref getRef(int columnIndex) throws SQLException { @@ -3786,17 +3794,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BLOB value + * SQL {@code BLOB} value * @see #getBlob(String) */ public Blob getBlob(int columnIndex) throws SQLException { @@ -3805,17 +3813,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Clob object representing an SQL CLOB value + * @return a {@code Clob} object representing an SQL {@code CLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL CLOB value + * SQL {@code CLOB} value * @see #getClob(String) */ public Clob getClob(int columnIndex) throws SQLException { @@ -3824,18 +3832,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL ARRAY value + * SQL {@code ARRAY} value * @see #getArray(String) */ public Array getArray(int columnIndex) throws SQLException { @@ -3844,17 +3852,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column name is not the name of * a column in this rowset or the cursor is not on one of * this rowset's rows or its insert row @@ -3867,16 +3875,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the column value - * is not an SQL REF value + * is not an SQL {@code REF} value * @see #getRef(int) */ public Ref getRef(String colName) throws SQLException { @@ -3885,16 +3893,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BLOB value + * column does not store an SQL {@code BLOB} value * @see #getBlob(int) */ public Blob getBlob(String colName) throws SQLException { @@ -3903,17 +3911,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Clob object representing an SQL - * CLOB value + * @return a {@code Clob} object representing an SQL + * {@code CLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CLOB value + * column does not store an SQL {@code CLOB} value * @see #getClob(int) */ public Clob getClob(String colName) throws SQLException { @@ -3922,17 +3930,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming langugage. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL ARRAY value + * column does not store an SQL {@code ARRAY} value * @see #getArray(int) */ public Array getArray(String colName) throws SQLException { @@ -3941,22 +3949,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3964,21 +3972,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3986,22 +3994,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4009,21 +4017,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4031,22 +4039,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Timestamp - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4054,22 +4062,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object, using the given - * Calendar object to construct an appropriate + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object, using the given + * {@code Calendar} object to construct an appropriate * millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE, - * TIME, or TIMESTAMP value + * column does not store an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4080,13 +4088,13 @@ */ /** - * Retrieves the Connection object passed to this - * CachedRowSetImpl object. This connection may be + * Retrieves the {@code Connection} object passed to this + * {@code CachedRowSetImpl} object. This connection may be * used to populate this rowset with data or to write data back * to its underlying data source. * - * @return the Connection object passed to this rowset; - * may be null if there is no connection + * @return the {@code Connection} object passed to this rowset; + * may be {@code null} if there is no connection * @throws SQLException if an error occurs */ public Connection getConnection() throws SQLException{ @@ -4094,10 +4102,10 @@ } /** - * Sets the metadata for this CachedRowSetImpl object - * with the given RowSetMetaData object. + * Sets the metadata for this {@code CachedRowSetImpl} object + * with the given {@code RowSetMetaData} object. * - * @param md a RowSetMetaData object instance containing + * @param md a {@code RowSetMetaData} object instance containing * metadata about the columsn in the rowset * @throws SQLException if invalid meta data is supplied to the * rowset @@ -4108,17 +4116,17 @@ /** * Returns a result set containing the original value of the rowset. The - * original value is the state of the CachedRowSetImpl after the + * original value is the state of the {@code CachedRowSetImpl} after the * last population or synchronization (whichever occurred most recently) with * the data source. * * The cursor is positioned before the first row in the result set. - * Only rows contained in the result set returned by getOriginal() + * Only rows contained in the result set returned by {@code getOriginal()} * are said to have an original value. * * @return the original result set of the rowset * @throws SQLException if an error occurs produce the - * ResultSet object + * {@code ResultSet} object */ public ResultSet getOriginal() throws SQLException { throw new UnsupportedOperationException(); @@ -4127,7 +4135,7 @@ /** * Returns a result set containing the original value of the current * row only. - * The original value is the state of the CachedRowSetImpl after + * The original value is the state of the {@code CachedRowSetImpl} after * the last population or synchronization (whichever occurred most recently) * with the data source. * @@ -4153,7 +4161,7 @@ /** * Marks all rows in this rowset as being original rows. Any updates * made to the rows become the original values for the rowset. - * Calls to the method setOriginal connot be reversed. + * Calls to the method {@code setOriginal} connot be reversed. * * @throws SQLException if an error occurs */ @@ -4165,8 +4173,8 @@ * Returns an identifier for the object (table) that was used to create this * rowset. * - * @return a String object that identifies the table from - * which this CachedRowSetImpl object was derived + * @return a {@code String} object that identifies the table from + * which this {@code CachedRowSetImpl} object was derived * @throws SQLException if an error occurs */ public String getTableName() throws SQLException { @@ -4177,8 +4185,8 @@ * Sets the identifier for the table from which this rowset was derived * to the given table name. * - * @param tabName a String object that identifies the - * table from which this CachedRowSetImpl object + * @param tabName a {@code String} object that identifies the + * table from which this {@code CachedRowSetImpl} object * was derived * @throws SQLException if an error occurs */ @@ -4188,7 +4196,7 @@ /** * Returns the columns that make a key to uniquely identify a - * row in this CachedRowSetImpl object. + * row in this {@code CachedRowSetImpl} object. * * @return an array of column numbers that constitutes a primary * key for this rowset. This array should be empty @@ -4203,16 +4211,16 @@ /** - * Sets this CachedRowSetImpl object's - * keyCols field with the given array of column + * Sets this {@code CachedRowSetImpl} object's + * {@code keyCols} field with the given array of column * numbers, which forms a key for uniquely identifying a row * in this rowset. * - * @param keys an array of int indicating the + * @param keys an array of {@code int} indicating the * columns that form a primary key for this - * CachedRowSetImpl object; every + * {@code CachedRowSetImpl} object; every * element in the array must be greater than - * 0 and less than or equal to the number + * {@code 0} and less than or equal to the number * of columns in this rowset * @throws SQLException if any of the numbers in the * given array is not valid for this rowset @@ -4224,8 +4232,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4236,14 +4244,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4251,8 +4259,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4263,13 +4271,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4277,8 +4285,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4289,14 +4297,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + *
NCLOB
java.sql.Types.NCLOB
NClob
java.sql.SQLXML
XML
java.sql.RowId
ROWID
NCHAR
NVARCHAR
LONGNVARCHAR
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed PreparedStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -4795,14 +4795,14 @@ } /** - * Sets the designated parameter to a java.sql.NClob object. The object - * implements the java.sql.NClob interface. This NClob - * object maps to a SQL NCLOB. + * Sets the designated parameter to a {@code java.sql.NClob} object. The object + * implements the {@code java.sql.NClob} interface. This {@code NClob} + * object maps to a SQL {@code NCLOB}. * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(String parameterName, NClob value) throws SQLException { @@ -4810,17 +4810,17 @@ } - /** + /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language. + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language. * @param columnIndex the first column is 1, the second is 2, ... * @exception SQLException if a database access error occurs * @since 1.6 @@ -4832,16 +4832,16 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as a - * java.io.Reader object. + * of this {@code ResultSet} object as a + * {@code java.io.Reader} object. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the name of the column - * @return a java.io.Reader object that contains the column - * value; if the value is SQL NULL, the value returned is - * null in the Java programming language + * @return a {@code java.io.Reader} object that contains the column + * value; if the value is SQL {@code NULL}, the value returned is + * {@code null} in the Java programming language * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4850,11 +4850,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * @param columnIndex the first column is 1, the second 2, ... * @param xmlObject the value for the column to be updated @@ -4866,11 +4866,11 @@ } /** - * Updates the designated column with a java.sql.SQLXML value. + * Updates the designated column with a {@code java.sql.SQLXML} value. * The updater * methods are used to update column values in the current row or the insert * row. The updater methods do not update the underlying database; instead - * the updateRow or insertRow methods are called + * the {@code updateRow} or {@code insertRow} methods are called * to update the database. * * @param columnName the name of the column @@ -4884,15 +4884,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnIndex the first column is 1, the second is 2, ... - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4902,15 +4902,15 @@ /** * Retrieves the value of the designated column in the current row - * of this ResultSet object as - * a String in the Java programming language. + * of this {@code ResultSet} object as + * a {@code String} in the Java programming language. * It is intended for use when - * accessing NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * accessing {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * @param columnName the SQL name of the column - * @return the column value; if the value is SQL NULL, the - * value returned is null + * @return the column value; if the value is SQL {@code NULL}, the + * value returned is {@code null} * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4927,9 +4927,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnIndex - the first column is 1, the second is 2, ... - * @param x - the new column value - * @param length - the length of the stream + * @param columnIndex the first column is 1, the second is 2, ... + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4949,9 +4949,9 @@ * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. * - * @param columnName - name of the Column - * @param x - the new column value - * @param length - the length of the stream + * @param columnName name of the Column + * @param x the new column value + * @param length the length of the stream * @exception SQLException if a database access error occurs * @since 1.6 */ @@ -4963,26 +4963,27 @@ } /** - * Updates the designated column with a character stream value. The + * Updates the designated column with a character stream value. The * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * *
setNCharacterStream
java.sql.NClob
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} or this + * method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -4997,26 +4998,27 @@ * driver does the necessary conversion from Java character format to * the national character set in the database. * It is intended for use when - * updating NCHAR,NVARCHAR - * and LONGNVARCHAR columns. + * updating {@code NCHAR},{@code NVARCHAR} + * and {@code LONGNVARCHAR} columns. * * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * *
updateNCharacterStream
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNCharacterStream which takes a length parameter. + * {@code updateNCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY or this method is called on a closed result set - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * the result set concurrency is {@code CONCUR_READ_ONLY} or + * this method is called on a closed result set + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method * @since 1.6 */ public void updateNCharacterStream(String columnLabel, @@ -5027,9 +5029,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5039,16 +5041,16 @@ *
java.io.InputStream
* The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5060,9 +5062,9 @@ /** * Updates the designated column using the given input stream, which * will have the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5072,18 +5074,20 @@ *
* The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, + * then the label is the name of the column. * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream, long length) throws SQLException { @@ -5092,9 +5096,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5102,23 +5106,23 @@ * Java stream object or your own subclass that implements the * standard interface. * - *
Note: Consult your JDBC driver documentation to determine if + *
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBlob which takes a length parameter. + * {@code updateBlob} which takes a length parameter. *
updateBlob
* The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(int columnIndex, InputStream inputStream) throws SQLException { @@ -5127,9 +5131,9 @@ /** * Updates the designated column using the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -5138,22 +5142,23 @@ * standard interface. *
* The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBlob(String columnLabel, InputStream inputStream) throws SQLException { @@ -5161,11 +5166,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5175,17 +5180,17 @@ *
* The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5193,11 +5198,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5207,17 +5212,18 @@ *
* The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5225,33 +5231,33 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * *
Note: This stream object can either be a standard * Java stream object or your own subclass that implements the * standard interface. - *
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateClob which takes a length parameter. + * {@code updateClob} which takes a length parameter. *
updateClob
* The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(int columnIndex, Reader reader) throws SQLException { @@ -5259,34 +5265,35 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * *
* The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param reader An object that contains the data to set the parameter value to. * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateClob(String columnLabel, Reader reader) throws SQLException { @@ -5294,11 +5301,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5308,19 +5315,19 @@ *
* The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader, long length) throws SQLException { @@ -5328,11 +5335,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5342,19 +5349,20 @@ *
* The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader, long length) throws SQLException { @@ -5362,11 +5370,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5375,22 +5383,22 @@ * standard interface. *
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateNClob which takes a length parameter. + * {@code updateNClob} which takes a length parameter. *
updateNClob
* The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set, - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set, + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(int columnIndex, Reader reader) throws SQLException { @@ -5398,11 +5406,11 @@ } /** - * Updates the designated column using the given Reader + * Updates the designated column using the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -5411,23 +5419,24 @@ * standard interface. *
* The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; this method is called on a closed result set; - * if a database access error occurs or - * the result set concurrency is CONCUR_READ_ONLY + * error could occur; this method is called on a closed result set; + * if a database access error occurs or + * the result set concurrency is {@code CONCUR_READ_ONLY} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateNClob(String columnLabel, Reader reader) throws SQLException { @@ -5435,22 +5444,22 @@ } - /** + /** * Updates the designated column with an ascii stream value, which will have * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5464,17 +5473,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateBinaryStream(int columnIndex, @@ -5488,17 +5497,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5512,17 +5521,19 @@ * the specified number of bytes.. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5535,20 +5546,20 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * *
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(int columnIndex, @@ -5560,21 +5571,22 @@ * Updates the designated column with an ascii stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * *
updateAsciiStream
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateAsciiStream which takes a length parameter. + * {@code updateAsciiStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateAsciiStream(String columnLabel, @@ -5588,15 +5600,17 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5611,18 +5625,18 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * *
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5637,19 +5651,20 @@ * Updates the designated column with a binary stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * *
updateBinaryStream
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateBinaryStream which takes a length parameter. + * {@code updateBinaryStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support * this method * @since 1.6 @@ -5665,18 +5680,20 @@ * the specified number of bytes. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the label is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then + * the label is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @param length the length of the stream * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5689,20 +5706,20 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * *
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * * @param columnIndex the first column is 1, the second is 2, ... * @param x the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(int columnIndex, @@ -5714,22 +5731,23 @@ * Updates the designated column with a character stream value. * The updater methods are used to update column values in the * current row or the insert row. The updater methods do not - * update the underlying database; instead the updateRow or - * insertRow methods are called to update the database. + * update the underlying database; instead the {@code updateRow} or + * {@code insertRow} methods are called to update the database. * *
updateCharacterStream
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * updateCharacterStream which takes a length parameter. + * {@code updateCharacterStream} which takes a length parameter. * - * @param columnLabel the label for the column specified with the SQL AS clause. If the SQL AS clause was not specified, then the la -bel is the name of the column - * @param reader the java.io.Reader object containing + * @param columnLabel the label for the column specified with the SQL AS clause. + * If the SQL AS clause was not specified, then the label + * is the name of the column + * @param reader the {@code java.io.Reader} object containing * the new column value * @exception SQLException if a database access error occurs, - * the result set concurrency is CONCUR_READ_ONLY - * or this method is called on a closed result set + * the result set concurrency is {@code CONCUR_READ_ONLY} + * or this method is called on a closed result set * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void updateCharacterStream(String columnLabel, @@ -5738,97 +5756,98 @@ } - /** - * Sets the designated parameter to the given java.net.URL value. - * The driver converts this to an SQL DATALINK value - * when it sends it to the database. - * - * @param parameterIndex the first parameter is 1, the second is 2, ... - * @param x the java.net.URL object to be set - * @exception SQLException if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.4 - */ + /** + * Sets the designated parameter to the given {@code java.net.URL} value. + * The driver converts this to an SQL {@code DATALINK} value + * when it sends it to the database. + * + * @param parameterIndex the first parameter is 1, the second is 2, ... + * @param x the {@code java.net.URL} object to be set + * @exception SQLException if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * @since 1.4 + */ public void setURL(int parameterIndex, java.net.URL x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB - *
java.net.URL
DATALINK
setCharacterStream (int, Reader)
setCharacterStream
Note: Consult your JDBC driver documentation to determine if - * it might be more efficient to use a version of - * setNClob which takes a length parameter. - * - * @param parameterIndex index of the first parameter is 1, the second is 2, ... - * @param reader An object that contains the data to set the parameter value to. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement - * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * - * @since 1.6 - */ + /** + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + *
setNClob
Note: Consult your JDBC driver documentation to determine if + * it might be more efficient to use a version of + * {@code setNClob} which takes a length parameter. + * + * @param parameterIndex index of the first parameter is 1, the second is 2, ... + * @param reader An object that contains the data to set the parameter value to. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} + * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method + * + * @since 1.6 + */ public void setNClob(int parameterIndex, Reader reader) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB - * - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national - * character sets; if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * @since 1.6 - */ - public void setNClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. + * The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national + * character sets; if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * @since 1.6 + */ + public void setNClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); - } + } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGNVARCHAR or a NCLOB + * data should be send to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} *
reader
CallableStatement
setCharacterStream (int, Reader, int)
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNClob which takes a length parameter. + * {@code setNClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed CallableStatement + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5839,23 +5858,24 @@ } - /** - ** of characters specified by length otherwise a SQLException will becontain the number - * generated when the PreparedStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method + /** + * of characters specified by length otherwise a {@code SQLException} will becontain the number + * generated when the {@code PreparedStatement} is executed. + * This method differs from the {@code setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a NCLOB. When the setCharacterStream method is used, the + * the server as a {@code NCLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGNVARCHAR or a NCLOB + * data should be sent to the server as a {@code LONGNVARCHAR} or a {@code NCLOB} + * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * if the driver does not support national character sets; - * if the driver can detect that a data conversion - * error could occur; if a database access error occurs or - * this method is called on a closed PreparedStatement + * marker in the SQL statement; if the length specified is less than zero; + * if the driver does not support national character sets; + * if the driver can detect that a data conversion + * error could occur; if a database access error occurs or + * this method is called on a closed {@code PreparedStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -5867,14 +5887,14 @@ /** - * Sets the designated parameter to a java.sql.NClob object. The driver converts this to -a - * SQL NCLOB value when it sends it to the database. + * Sets the designated parameter to a {@code java.sql.NClob} object. + * The driver converts this to an + * SQL {@code NCLOB} value when it sends it to the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNClob(int parameterIndex, NClob value) throws SQLException{ @@ -5883,14 +5903,14 @@ /** - * Sets the designated parameter to the given String object. - * The driver converts this to a SQL NCHAR or - * NVARCHAR or LONGNVARCHAR + * Sets the designated parameter to the given {@code String} object. + * The driver converts this to a SQL {@code NCHAR} or + * {@code NVARCHAR} or {@code LONGNVARCHAR} * @param parameterName the name of the column to be set * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur; or if a database access error occurs + * error could occur; or if a database access error occurs * @since 1.6 */ public void setNString(String parameterName, String value) @@ -5899,8 +5919,8 @@ } /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterIndex of the first parameter is 1, the second is 2, ... @@ -5908,7 +5928,7 @@ * @param length the number of characters in the parameter data. * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; or if a database access error occurs + * error could occur ; or if a database access error occurs * @since 1.6 */ public void setNCharacterStream(int parameterIndex, Reader value, long length) throws SQLException{ @@ -5918,8 +5938,8 @@ /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. * @param parameterName the name of the column to be set @@ -5935,9 +5955,9 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The - * Reader reads the data till end-of-file is reached. The + /** + * Sets the designated parameter to a {@code Reader} object. The + * {@code Reader} reads the data till end-of-file is reached. The * driver does the necessary conversion from Java character format to * the national character set in the database. @@ -5946,14 +5966,14 @@ * standard interface. *
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setNCharacterStream which takes a length parameter. + * {@code setNCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param value the parameter value * @throws SQLException if the driver does not support national * character sets; if the driver can detect that a data conversion - * error could occur ; if a database access error occurs; or - * this method is called on a closed CallableStatement + * error could occur ; if a database access error occurs; or + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -5962,23 +5982,23 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIMESTAMP value, + * Sets the designated parameter to the given {@code java.sql.Timestamp} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIMESTAMP} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the timestamp + * a {@code Calendar} object, the driver can calculate the timestamp * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use - * to construct the timestamp + * @param cal the {@code Calendar} object the driver will use + * to construct the timestamp * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -5987,28 +6007,29 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setCharacterStream (int, Reader, int) method - * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the - * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB - * @param parameterName the name of the parameter to be set - * @param reader An object that contains the data to set the parameter value to. - * @param length the number of characters in the parameter data. - * @throws SQLException if parameterIndex does not correspond to a parameter - * marker in the SQL statement; if the length specified is less than zero; - * a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setClob(String parameterName, Reader reader, long length) + /** + * Sets the designated parameter to a {@code Reader} object. The {@code reader} 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 setCharacterStream (int, Reader, int)} method + * because it informs the driver that the parameter value should be sent to + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the + * driver may have to do extra work to determine whether the parameter + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} + * + * @param parameterName the name of the parameter to be set + * @param reader An object that contains the data to set the parameter value to. + * @param length the number of characters in the parameter data. + * @throws SQLException if parameterIndex does not correspond to a parameter + * marker in the SQL statement; if the length specified is less than zero; + * a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setClob(String parameterName, Reader reader, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } @@ -6016,16 +6037,16 @@ /** - * Sets the designated parameter to the given java.sql.Clob object. - * The driver converts this to an SQL CLOB value when it + * Sets the designated parameter to the given {@code java.sql.Clob} object. + * The driver converts this to an SQL {@code CLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Clob object that maps an SQL CLOB value + * @param x a {@code Clob} object that maps an SQL {@code CLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setClob (String parameterName, Clob x) throws SQLException{ @@ -6033,21 +6054,21 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARCHAR or a CLOB + * data should be send to the server as a {@code LONGVARCHAR} or a {@code CLOB} * *
Calendar
TIMESTAMP
java.sql.Clob
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterName the name of the parameter * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs or this method is called on - * a closed CallableStatement + * a closed {@code CallableStatement} * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6058,19 +6079,19 @@ } - /** - * Sets the designated parameter to the given java.sql.Date value + /** + * Sets the designated parameter to the given {@code java.sql.Date} value * using the default time zone of the virtual machine that is running * the application. * The driver converts this - * to an SQL DATE value when it sends it to the database. + * to an SQL {@code DATE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6080,23 +6101,23 @@ } /** - * Sets the designated parameter to the given java.sql.Date value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL DATE value, + * Sets the designated parameter to the given {@code java.sql.Date} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code DATE} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the date + * a {@code Calendar} object, the driver can calculate the date * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the date * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDate * @since 1.4 */ @@ -6107,16 +6128,16 @@ /** - * Sets the designated parameter to the given java.sql.Time value. + * Sets the designated parameter to the given {@code java.sql.Time} value. * The driver converts this - * to an SQL TIME value when it sends it to the database. + * to an SQL {@code TIME} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6126,23 +6147,23 @@ } /** - * Sets the designated parameter to the given java.sql.Time value, - * using the given Calendar object. The driver uses - * the Calendar object to construct an SQL TIME value, + * Sets the designated parameter to the given {@code java.sql.Time} value, + * using the given {@code Calendar} object. The driver uses + * the {@code Calendar} object to construct an SQL {@code TIME} value, * which the driver then sends to the database. With a - * a Calendar object, the driver can calculate the time + * a {@code Calendar} object, the driver can calculate the time * taking into account a custom timezone. If no - * Calendar object is specified, the driver uses the default + * {@code Calendar} object is specified, the driver uses the default * timezone, which is that of the virtual machine running the application. * * @param parameterName the name of the parameter * @param x the parameter value - * @param cal the Calendar object the driver will use + * @param cal the {@code Calendar} object the driver will use * to construct the time * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTime * @since 1.4 */ @@ -6152,22 +6173,22 @@ } /** - * Sets the designated parameter to a Reader object. - * This method differs from the setCharacterStream (int, Reader) method + * Sets the designated parameter to a {@code Reader} object. + * This method differs from the {@code setCharacterStream (int, Reader)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * *
setClob
DATE
TIME
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setClob which takes a length parameter. + * {@code setClob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatementor if parameterIndex does not correspond to a parameter - * marker in the SQL statement + * a closed {@code PreparedStatement}or if parameterIndex does not correspond to a parameter + * marker in the SQL statement * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 @@ -6179,19 +6200,19 @@ /** - * Sets the designated parameter to a Reader object. The reader must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - *This method differs from the setCharacterStream (int, Reader, int) method + * Sets the designated parameter to a {@code Reader} object. The reader 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 setCharacterStream (int, Reader, int)} method * because it informs the driver that the parameter value should be sent to - * the server as a CLOB. When the setCharacterStream method is used, the + * the server as a {@code CLOB}. When the {@code setCharacterStream} method is used, the * driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARCHAR or a CLOB + * data should be sent to the server as a {@code LONGVARCHAR} or a {@code CLOB} * @param parameterIndex index of the first parameter is 1, the second is 2, ... * @param reader An object that contains the data to set the parameter value to. * @param length the number of characters in the parameter data. * @throws SQLException if a database access error occurs, this method is called on - * a closed PreparedStatement, if parameterIndex does not correspond to a parameter + * a closed {@code PreparedStatement}, if parameterIndex does not correspond to a parameter * marker in the SQL statement, or if the length specified is less than zero. * * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method @@ -6204,25 +6225,26 @@ /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length otherwise a SQLException will be - * generated when the PreparedStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) + * Sets the designated parameter to a {@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)} * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... + * the second is 2, ... * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @param length the number of bytes in the parameter data. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement, - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, if the length specified - * is less than zero or if the number of bytes in the inputstream does not match - * the specified length. + * this method is called on a closed {@code PreparedStatement}, + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, if the length specified + * is less than zero or if the number of bytes in the inputstream does not match + * the specified length. * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6233,28 +6255,27 @@ } /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) - * This method differs from the setBinaryStream (int, InputStream) + * Sets the designated parameter to a {@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 - * sent to the server as a BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} * *
setBinaryStream (int, InputStream, int)
setBinaryStream
setBinaryStream (int, InputStream)
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterIndex index of the first parameter is 1, - * the second is 2, ... - - + * the second is 2, ... + * * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs, - * this method is called on a closed PreparedStatement or - * if parameterIndex does not correspond - * to a parameter marker in the SQL statement, + * this method is called on a closed {@code PreparedStatement} or + * if parameterIndex does not correspond + * to a parameter marker in the SQL statement, * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6264,72 +6285,72 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. The inputstream must contain the number - * of characters specified by length, otherwise a SQLException will be - * generated when the CallableStatement is executed. - * This method differs from the setBinaryStream (int, InputStream, int) - * method because it informs the driver that the parameter value should be - * sent to the server as a BLOB. When the setBinaryStream method is used, - * the driver may have to do extra work to determine whether the parameter - * data should be sent to the server as a LONGVARBINARY or a BLOB - * - * @param parameterName the name of the parameter to be set - * the second is 2, ... - * - * @param inputStream An object that contains the data to set the parameter - * value to. - * @param length the number of bytes in the parameter data. - * @throws SQLException if parameterIndex does not correspond - * to a parameter marker in the SQL statement, or if the length specified - * is less than zero; if the number of bytes in the inputstream does not match - * the specified length; if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method - * - * @since 1.6 - */ - public void setBlob(String parameterName, InputStream inputStream, long length) + /** + * Sets the designated parameter to a {@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)} + * 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, + * the driver may have to do extra work to determine whether the parameter + * data should be sent to the server as a {@code LONGVARBINARY} or a {@code BLOB} + * + * @param parameterName the name of the parameter to be set + * the second is 2, ... + * + * @param inputStream An object that contains the data to set the parameter + * value to. + * @param length the number of bytes in the parameter data. + * @throws SQLException if parameterIndex does not correspond + * to a parameter marker in the SQL statement, or if the length specified + * is less than zero; if the number of bytes in the inputstream does not match + * the specified length; if a database access error occurs or + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if the JDBC driver does not support + * this method + * + * @since 1.6 + */ + public void setBlob(String parameterName, InputStream inputStream, long length) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given java.sql.Blob object. - * The driver converts this to an SQL BLOB value when it + /** + * Sets the designated parameter to the given {@code java.sql.Blob} object. + * The driver converts this to an SQL {@code BLOB} value when it * sends it to the database. * * @param parameterName the name of the parameter - * @param x a Blob object that maps an SQL BLOB value + * @param x a {@code Blob} object that maps an SQL {@code BLOB} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.6 */ public void setBlob (String parameterName, Blob x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to a InputStream object. - * This method differs from the setBinaryStream (int, InputStream) + /** + * Sets the designated parameter to a {@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 BLOB. When the setBinaryStream method is used, + * sent to the server as a {@code BLOB}. When the {@code setBinaryStream} method is used, * the driver may have to do extra work to determine whether the parameter - * data should be send to the server as a LONGVARBINARY or a BLOB + * data should be send to the server as a {@code LONGVARBINARY} or a {@code BLOB} * *
setBlob
inputstream
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBlob which takes a length parameter. + * {@code setBlob} which takes a length parameter. * * @param parameterName the name of the parameter * @param inputStream An object that contains the data to set the parameter - * value to. + * value to. * @throws SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * * @since 1.6 @@ -6339,22 +6360,22 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. The second * argument must be an object type; for integral values, the - * java.lang equivalent objects should be used. + * {@code java.lang} equivalent objects should be used. * *
java.lang
The given Java object will be converted to the given targetSqlType * before being sent to the database. * * If the object has a custom mapping (is of a class implementing the - * interface SQLData), - * the JDBC driver should call the method SQLData.writeSQL to write it + * interface {@code SQLData}), + * the JDBC driver should call the method {@code SQLData.writeSQL} to write it * to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. *
SQLData
SQLData.writeSQL
Struct
* Note that this method may be used to pass datatabase- @@ -6365,17 +6386,17 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database. The scale argument may further qualify this type. * @param scale for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, - * this is the number of digits after the decimal point. For all other - * types, this value will be ignored. + * this is the number of digits after the decimal point. For all other + * types, this value will be ignored. * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see Types * @see #getObject * @since 1.4 @@ -6387,7 +6408,7 @@ /** * Sets the value of the designated parameter with the given object. - * This method is like the method setObject + * This method is like the method {@code setObject} * above, except that it assumes a scale of zero. * * @param parameterName the name of the parameter @@ -6395,14 +6416,14 @@ * @param targetSqlType the SQL type (as defined in java.sql.Types) to be * sent to the database * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement - * @exception SQLFeatureNotSupportedException if targetSqlType is - * a ARRAY, BLOB, CLOB, - * DATALINK, JAVA_OBJECT, NCHAR, - * NCLOB, NVARCHAR, LONGNVARCHAR, - * REF, ROWID, SQLXML - * or STRUCT data type and the JDBC driver does not support - * this data type + * this method is called on a closed {@code CallableStatement} + * @exception SQLFeatureNotSupportedException if {@code targetSqlType} is + * an {@code ARRAY, BLOB, CLOB, + * DATALINK, JAVA_OBJECT, NCHAR, + * NCLOB, NVARCHAR, LONGNVARCHAR, + * REF, ROWID, SQLXML} + * or {@code STRUCT} data type and the JDBC driver does not support + * this data type * @see #getObject * @since 1.4 */ @@ -6411,13 +6432,13 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** + /** * Sets the value of the designated parameter with the given object. - * The second parameter must be of type Object; therefore, the - * java.lang equivalent objects should be used for built-in types. + * The second parameter must be of type {@code Object}; therefore, the + * {@code java.lang} equivalent objects should be used for built-in types. * *
targetSqlType
JAVA_OBJECT
STRUCT
setObject
The JDBC specification specifies a standard mapping from - * Java Object types to SQL types. The given argument + * Java {@code Object} types to SQL types. The given argument * will be converted to the corresponding SQL type before being * sent to the database. * @@ -6425,13 +6446,13 @@ * specific abstract data types, by using a driver-specific Java * type. * - * If the object is of a class implementing the interface SQLData, - * the JDBC driver should call the method SQLData.writeSQL + * If the object is of a class implementing the interface {@code SQLData}, + * the JDBC driver should call the method {@code SQLData.writeSQL} * to write it to the SQL data stream. * If, on the other hand, the object is of a class implementing - * Ref, Blob, Clob, NClob, - * Struct, java.net.URL, - * or Array, the driver should pass it to the database as a + * {@code Ref}, {@code Blob}, {@code Clob}, {@code NClob}, + * {@code Struct}, {@code java.net.URL}, + * or {@code Array}, the driver should pass it to the database as a * value of the corresponding SQL type. *
* This method throws an exception if there is an ambiguity, for example, if the @@ -6440,10 +6461,10 @@ * @param parameterName the name of the parameter * @param x the object containing the input parameter value * @exception SQLException if a database access error occurs, - * this method is called on a closed CallableStatement or if the given - * Object parameter is ambiguous + * this method is called on a closed {@code CallableStatement} or if the given + * {@code Object} parameter is ambiguous * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getObject * @since 1.4 */ @@ -6454,9 +6475,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6468,9 +6489,9 @@ * @param x the Java input stream that contains the ASCII parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setAsciiStream(String parameterName, java.io.InputStream x, int length) @@ -6482,9 +6503,9 @@ /** * Sets the designated parameter to the given input stream, which will have * the specified number of bytes. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the stream + * {@code java.io.InputStream} object. The data will be read from the stream * as needed until end-of-file is reached. * *
Note: This stream object can either be a standard @@ -6495,9 +6516,9 @@ * @param x the java input stream which contains the binary parameter value * @param length the number of bytes in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBinaryStream(String parameterName, java.io.InputStream x, @@ -6506,11 +6527,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object, which is the given number of characters long. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6519,13 +6540,13 @@ * standard interface. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that + * @param reader the {@code java.io.Reader} object that * contains the UNICODE data used as the designated parameter * @param length the number of characters in the stream * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setCharacterStream(String parameterName, @@ -6536,9 +6557,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large ASCII value is input to a LONGVARCHAR + * When a very large ASCII value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.InputStream. Data will be read from the stream + * {@code java.io.InputStream}. Data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from ASCII to the database char format. * @@ -6547,15 +6568,15 @@ * standard interface. *
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setAsciiStream which takes a length parameter. + * {@code setAsciiStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the Java input stream that contains the ASCII parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method - * @since 1.6 - */ + * @since 1.6 + */ public void setAsciiStream(String parameterName, java.io.InputStream x) throws SQLException{ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); @@ -6564,9 +6585,9 @@ /** * Sets the designated parameter to the given input stream. - * When a very large binary value is input to a LONGVARBINARY + * When a very large binary value is input to a {@code LONGVARBINARY} * parameter, it may be more practical to send it via a - * java.io.InputStream object. The data will be read from the + * {@code java.io.InputStream} object. The data will be read from the * stream as needed until end-of-file is reached. * *
setAsciiStream
Note: This stream object can either be a standard @@ -6574,12 +6595,12 @@ * standard interface. *
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setBinaryStream which takes a length parameter. + * {@code setBinaryStream} which takes a length parameter. * * @param parameterName the name of the parameter * @param x the java input stream which contains the binary parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6589,11 +6610,11 @@ } /** - * Sets the designated parameter to the given Reader + * Sets the designated parameter to the given {@code Reader} * object. - * When a very large UNICODE value is input to a LONGVARCHAR + * When a very large UNICODE value is input to a {@code LONGVARCHAR} * parameter, it may be more practical to send it via a - * java.io.Reader object. The data will be read from the stream + * {@code java.io.Reader} object. The data will be read from the stream * as needed until end-of-file is reached. The JDBC driver will * do any necessary conversion from UNICODE to the database char format. * @@ -6602,13 +6623,13 @@ * standard interface. *
Note: Consult your JDBC driver documentation to determine if * it might be more efficient to use a version of - * setCharacterStream which takes a length parameter. + * {@code setCharacterStream} which takes a length parameter. * * @param parameterName the name of the parameter - * @param reader the java.io.Reader object that contains the + * @param reader the {@code java.io.Reader} object that contains the * Unicode data * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @since 1.6 */ @@ -6619,16 +6640,16 @@ /** * Sets the designated parameter to the given - * java.math.BigDecimal value. - * The driver converts this to an SQL NUMERIC value when + * {@code java.math.BigDecimal} value. + * The driver converts this to an SQL {@code NUMERIC} value when * it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBigDecimal * @since 1.4 */ @@ -6636,20 +6657,20 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java String value. + /** + * Sets the designated parameter to the given Java {@code String} value. * The driver converts this - * to an SQL VARCHAR or LONGVARCHAR value + * to an SQL {@code VARCHAR} or {@code LONGVARCHAR} value * (depending on the argument's - * size relative to the driver's limits on VARCHAR values) + * size relative to the driver's limits on {@code VARCHAR} values) * when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getString * @since 1.4 */ @@ -6659,19 +6680,19 @@ - /** + /** * Sets the designated parameter to the given Java array of bytes. - * The driver converts this to an SQL VARBINARY or - * LONGVARBINARY (depending on the argument's size relative - * to the driver's limits on VARBINARY values) when it sends + * The driver converts this to an SQL {@code VARBINARY} or + * {@code LONGVARBINARY} (depending on the argument's size relative + * to the driver's limits on {@code VARBINARY} values) when it sends * it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getBytes * @since 1.4 */ @@ -6680,17 +6701,17 @@ } /** - * Sets the designated parameter to the given java.sql.Timestamp value. + * Sets the designated parameter to the given {@code java.sql.Timestamp} value. * The driver - * converts this to an SQL TIMESTAMP value when it sends it to the + * converts this to an SQL {@code TIMESTAMP} value when it sends it to the * database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getTimestamp * @since 1.4 */ @@ -6700,16 +6721,16 @@ } /** - * Sets the designated parameter to SQL NULL. + * Sets the designated parameter to SQL {@code NULL}. * *
NUMERIC
VARCHAR
VARBINARY
Note: You must specify the parameter's SQL type. * * @param parameterName the name of the parameter - * @param sqlType the SQL type code defined in java.sql.Types + * @param sqlType the SQL type code defined in {@code java.sql.Types} * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull(String parameterName, int sqlType) throws SQLException { @@ -6717,8 +6738,8 @@ } /** - * Sets the designated parameter to SQL NULL. - * This version of the method setNull should + * Sets the designated parameter to SQL {@code NULL}. + * This version of the method {@code setNull} should * be used for user-defined types and REF type parameters. Examples * of user-defined types include: STRUCT, DISTINCT, JAVA_OBJECT, and * named array types. @@ -6738,14 +6759,14 @@ * * * @param parameterName the name of the parameter - * @param sqlType a value from java.sql.Types + * @param sqlType a value from {@code java.sql.Types} * @param typeName the fully-qualified name of an SQL user-defined type; * ignored if the parameter is not a user-defined type or - * SQL REF value + * SQL {@code REF} value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setNull (String parameterName, int sqlType, String typeName) @@ -6754,17 +6775,17 @@ } /** - * Sets the designated parameter to the given Java boolean value. + * Sets the designated parameter to the given Java {@code boolean} value. * The driver converts this - * to an SQL BIT or BOOLEAN value when it sends it to the database. + * to an SQL {@code BIT} or {@code BOOLEAN} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @see #getBoolean * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @since 1.4 */ public void setBoolean(String parameterName, boolean x) throws SQLException{ @@ -6774,16 +6795,16 @@ /** - * Sets the designated parameter to the given Java byte value. + * Sets the designated parameter to the given Java {@code byte} value. * The driver converts this - * to an SQL TINYINT value when it sends it to the database. + * to an SQL {@code TINYINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getByte * @since 1.4 */ @@ -6793,16 +6814,16 @@ /** - * Sets the designated parameter to the given Java short value. + * Sets the designated parameter to the given Java {@code short} value. * The driver converts this - * to an SQL SMALLINT value when it sends it to the database. + * to an SQL {@code SMALLINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getShort * @since 1.4 */ @@ -6812,16 +6833,16 @@ /** - * Sets the designated parameter to the given Java int value. + * Sets the designated parameter to the given Java {@code int} value. * The driver converts this - * to an SQL INTEGER value when it sends it to the database. + * to an SQL {@code INTEGER} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getInt * @since 1.4 */ @@ -6829,17 +6850,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java long value. + /** + * Sets the designated parameter to the given Java {@code long} value. * The driver converts this - * to an SQL BIGINT value when it sends it to the database. + * to an SQL {@code BIGINT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getLong * @since 1.4 */ @@ -6848,17 +6869,17 @@ } - /** - * Sets the designated parameter to the given Java float value. + /** + * Sets the designated parameter to the given Java {@code float} value. * The driver converts this - * to an SQL FLOAT value when it sends it to the database. + * to an SQL {@code FLOAT} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getFloat * @since 1.4 */ @@ -6866,17 +6887,17 @@ throw new SQLFeatureNotSupportedException(resBundle.handleGetObject("jdbcrowsetimpl.featnotsupp").toString()); } - /** - * Sets the designated parameter to the given Java double value. + /** + * Sets the designated parameter to the given Java {@code double} value. * The driver converts this - * to an SQL DOUBLE value when it sends it to the database. + * to an SQL {@code DOUBLE} value when it sends it to the database. * * @param parameterName the name of the parameter * @param x the parameter value * @exception SQLException if a database access error occurs or - * this method is called on a closed CallableStatement + * this method is called on a closed {@code CallableStatement} * @exception SQLFeatureNotSupportedException if the JDBC driver does not support - * this method + * this method * @see #getDouble * @since 1.4 */ @@ -6887,7 +6908,6 @@ /** * This method re populates the resBundle * during the deserialization process - * */ private void readObject(ObjectInputStream ois) throws IOException, ClassNotFoundException { // Default state initialization happens here --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.803466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/CachedRowSetWriter.java 2015-06-05 21:04:34.635466074 +0400 @@ -43,22 +43,22 @@ /** - * The facility called on internally by the RIOptimisticProvider implementation to + * The facility called on internally by the {@code RIOptimisticProvider} implementation to * propagate changes back to the data source from which the rowset got its data. *
java.sql.Types
setNull
BIT
BOOLEAN
TINYINT
SMALLINT
INTEGER
BIGINT
FLOAT
DOUBLE
RIOptimisticProvider
- * A CachedRowSetWriter object, called a writer, has the public - * method writeData for writing modified data to the underlying data source. + * A {@code CachedRowSetWriter} object, called a writer, has the public + * method {@code writeData} for writing modified data to the underlying data source. * This method is invoked by the rowset internally and is never invoked directly by an application. * A writer also has public methods for setting and getting - * the CachedRowSetReader object, called a reader, that is associated + * the {@code CachedRowSetReader} object, called a reader, that is associated * with the writer. The remainder of the methods in this class are private and * are invoked internally, either directly or indirectly, by the method - * writeData. + * {@code writeData}. *
CachedRowSetWriter
writeData
CachedRowSetReader
- * Typically the SyncFactory manages the RowSetReader and - * the RowSetWriter implementations using SyncProvider objects. + * Typically the {@code SyncFactory} manages the {@code RowSetReader} and + * the {@code RowSetWriter} implementations using {@code SyncProvider} objects. * Standard JDBC RowSet implementations provide an object instance of this - * writer by invoking the SyncProvider.getRowSetWriter() method. + * writer by invoking the {@code SyncProvider.getRowSetWriter()} method. * * @version 0.2 * @author Jonathan Bruce @@ -69,15 +69,15 @@ public class CachedRowSetWriter implements TransactionalWriter, Serializable { /** - * The Connection object that this writer will use to make a + * The {@code Connection} object that this writer will use to make a * connection to the data source to which it will write data. * */ private transient Connection con; /** - * The SQL SELECT command that this writer will call - * internally. The method initSQLStatements builds this + * The SQL {@code SELECT} command that this writer will call + * internally. The method {@code initSQLStatements} builds this * command by supplying the words "SELECT" and "FROM," and using * metadata to get the table name and column names . * @@ -86,9 +86,9 @@ private String selectCmd; /** - * The SQL UPDATE command that this writer will call + * The SQL {@code UPDATE} command that this writer will call * internally to write data to the rowset's underlying data source. - * The method initSQLStatements builds this String + * The method {@code initSQLStatements} builds this {@code String} * object. * * @serial @@ -96,8 +96,8 @@ private String updateCmd; /** - * The SQL WHERE clause the writer will use for update - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for update + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -105,7 +105,7 @@ private String updateWhere; /** - * The SQL DELETE command that this writer will call + * The SQL {@code DELETE} command that this writer will call * internally to delete a row in the rowset's underlying data source. * * @serial @@ -113,8 +113,8 @@ private String deleteCmd; /** - * The SQL WHERE clause the writer will use for delete - * statements in the PreparedStatement object + * The SQL {@code WHERE} clause the writer will use for delete + * statements in the {@code PreparedStatement} object * it sends to the underlying data source. * * @serial @@ -122,9 +122,9 @@ private String deleteWhere; /** - * The SQL INSERT INTO command that this writer will internally use + * The SQL {@code INSERT INTO} command that this writer will internally use * to insert data into the rowset's underlying data source. The method - * initSQLStatements builds this command with a question + * {@code initSQLStatements} builds this command with a question * mark parameter placeholder for each column in the rowset. * * @serial @@ -133,8 +133,8 @@ /** * An array containing the column numbers of the columns that are - * needed to uniquely identify a row in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * needed to uniquely identify a row in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ @@ -142,7 +142,7 @@ /** * An array of the parameters that should be used to set the parameter - * placeholders in a PreparedStatement object that this + * placeholders in a {@code PreparedStatement} object that this * writer will execute. * * @serial @@ -150,33 +150,33 @@ private Object[] params; /** - * The CachedRowSetReader object that has been - * set as the reader for the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code CachedRowSetReader} object that has been + * set as the reader for the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private CachedRowSetReader reader; /** - * The ResultSetMetaData object that contains information - * about the columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The {@code ResultSetMetaData} object that contains information + * about the columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private ResultSetMetaData callerMd; /** - * The number of columns in the CachedRowSet object - * for which this CachedRowSetWriter object is the writer. + * The number of columns in the {@code CachedRowSet} object + * for which this {@code CachedRowSetWriter} object is the writer. * * @serial */ private int callerColumnCount; /** - * This CachedRowSet will hold the conflicting values + * This {@code CachedRowSet} will hold the conflicting values * retrieved from the db and hold it. */ private CachedRowSetImpl crsResolve; @@ -209,8 +209,8 @@ } /** - * Propagates changes in the given RowSet object - * back to its underlying data source and returns true + * Propagates changes in the given {@code RowSet} object + * back to its underlying data source and returns {@code true} * if successful. The writer will check to see if * the data in the pre-modified rowset (the original values) differ * from the data in the underlying data source. If data in the data @@ -221,15 +221,15 @@ * access for concurrent users. * * This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. * - * Creates a CachedRowSet object from the given - * RowSet object + * Creates a {@code CachedRowSet} object from the given + * {@code RowSet} object * Makes a connection with the data source * * Disables autocommit mode if it is not already disabled @@ -237,32 +237,32 @@ * * Checks to see if the reader has read new data since the writer * was last called and, if so, calls the method - * initSQLStatements to initialize new SQL statements + * {@code initSQLStatements} to initialize new SQL statements * - * Builds new SELECT, UPDATE, - * INSERT, and DELETE statements - * Uses the CachedRowSet object's metadata to + * Builds new {@code SELECT}, {@code UPDATE}, + * {@code INSERT}, and {@code DELETE} statements + * Uses the {@code CachedRowSet} object's metadata to * determine the table name, column names, and the columns * that make up the primary key * * When there is no conflict, propagates changes made to the - * CachedRowSet object back to its underlying data source + * {@code CachedRowSet} object back to its underlying data source * - * Iterates through each row of the CachedRowSet object + * Iterates through each row of the {@code CachedRowSet} object * to determine whether it has been updated, inserted, or deleted * If the corresponding row in the data source has not been changed * since the rowset last read its * values, the writer will use the appropriate command to update, * insert, or delete the row * If any data in the data source does not match the original values - * for the CachedRowSet object, the writer will roll + * for the {@code CachedRowSet} object, the writer will roll * back any changes it has made to the row in the data source. * * * - * @return true if changes to the rowset were successfully + * @return {@code true} if changes to the rowset were successfully * written to the rowset's underlying data source; - * false otherwise + * {@code false} otherwise */ public boolean writeData(RowSetInternal caller) throws SQLException { long conflicts = 0; @@ -434,25 +434,25 @@ } //end writeData -/** - * Updates the given CachedRowSet object's underlying data - * source so that updates to the rowset are reflected in the original - * data source, and returns false if the update was successful. - * A return value of true indicates that there is a conflict, - * meaning that a value updated in the rowset has already been changed by - * someone else in the underlying data source. A conflict can also exist - * if, for example, more than one row in the data source would be affected - * by the update or if no rows would be affected. In any case, if there is - * a conflict, this method does not update the underlying data source. - * - * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + * + * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - * - * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + * + * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. * - * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - * - * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + * + * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. * * If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. * * The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. * * NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. * * This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. * - * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. * - * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. * * Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. * - * undoUpdateRowSet object backed by the same data as - * that of this CachedRowSetImpl object and sharing a set of cursors + * Returns a new {@code RowSet} object backed by the same data as + * that of this {@code CachedRowSetImpl} object and sharing a set of cursors * with it. This allows cursors to interate over a shared set of rows, providing * multiple views of the underlying data. * - * @return a RowSet object that is a copy of this CachedRowSetImpl + * @return a {@code RowSet} object that is a copy of this {@code CachedRowSetImpl} * object and shares a set of cursors with it * @throws SQLException if an error occurs or cloning is * not supported @@ -750,19 +750,19 @@ } /** - * Returns a new RowSet object containing by the same data - * as this CachedRowSetImpl object. This method - * differs from the method createCopy in that it throws a - * CloneNotSupportedException object instead of an - * SQLException object, as the method createShared - * does. This clone - * method is called internally by the method createShared, - * which catches the CloneNotSupportedException object - * and in turn throws a new SQLException object. + * Returns a new {@code RowSet} object containing by the same data + * as this {@code CachedRowSetImpl} object. This method + * differs from the method {@code createCopy} in that it throws a + * {@code CloneNotSupportedException} object instead of an + * {@code SQLException} object, as the method {@code createShared} + * does. This {@code clone} + * method is called internally by the method {@code createShared}, + * which catches the {@code CloneNotSupportedException} object + * and in turn throws a new {@code SQLException} object. * - * @return a copy of this CachedRowSetImpl object + * @return a copy of this {@code CachedRowSetImpl} object * @throws CloneNotSupportedException if an error occurs when - * attempting to clone this CachedRowSetImpl object + * attempting to clone this {@code CachedRowSetImpl} object * @see #createShared */ protected Object clone() throws CloneNotSupportedException { @@ -770,8 +770,8 @@ } /** - * Creates a RowSet object that is a deep copy of - * this CachedRowSetImpl object's data, including + * Creates a {@code RowSet} object that is a deep copy of + * this {@code CachedRowSetImpl} object's data, including * constraints. Updates made * on a copy are not visible to the original rowset; * a copy of a rowset is completely independent from the original. @@ -780,12 +780,12 @@ * from first principles, which can be quite expensive. * For example, it can eliminate the need to query a * remote database server. - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSet object and is - * completely independent from this CachedRowSetImpl + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSet} object and is + * completely independent from this {@code CachedRowSetImpl} * object. * @throws SQLException if an error occurs in generating the copy of this - * of the CachedRowSetImpl + * of the {@code CachedRowSetImpl} * @see #createShared * @see javax.sql.RowSetEvent * @see javax.sql.RowSetListener @@ -795,21 +795,21 @@ } /** - * Creates a RowSet object that is a copy of - * this CachedRowSetImpl object's table structure + * Creates a {@code RowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's table structure * and the constraints only. * There will be no data in the object being returned. * Updates made on a copy are not visible to the original rowset. * * This helps in getting the underlying XML schema which can - * be used as the basis for populating a WebRowSet. + * be used as the basis for populating a {@code WebRowSet}. * - * @return a new CachedRowSet object that is a copy - * of this CachedRowSetImpl object's schema and + * @return a new {@code CachedRowSet} object that is a copy + * of this {@code CachedRowSetImpl} object's schema and * retains all the constraints on the original rowset but contains * no data * @throws SQLException if an error occurs in generating the copy - * of the CachedRowSet object + * of the {@code CachedRowSet} object * @see #createShared * @see #createCopy * @see #createCopyNoConstraints @@ -821,17 +821,17 @@ } /** - * Creates a CachedRowSet object that is a copy of - * this CachedRowSetImpl object's data only. + * Creates a {@code CachedRowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's data only. * All constraints set in this object will not be there * in the returning object. Updates made * on a copy are not visible to the original rowset. * - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSetImpl object and is - * completely independent from this CachedRowSetImpl object + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSetImpl} object and is + * completely independent from this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the copy of the - * of the CachedRowSet + * of the {@code CachedRowSet} * @see #createShared * @see #createCopy * @see #createCopySchema @@ -843,15 +843,15 @@ } /** - * Converts this CachedRowSetImpl object to a collection - * of tables. The sample implementation utilitizes the TreeMap + * Converts this {@code CachedRowSetImpl} object to a collection + * of tables. The sample implementation utilitizes the {@code TreeMap} * collection type. * This class guarantees that the map will be in ascending key order, * sorted according to the natural order for the key's class. * - * @return a Collection object consisting of tables, + * @return a {@code Collection} object consisting of tables, * each of which is a copy of a row in this - * CachedRowSetImpl object + * {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the collection * @see #toCollection(int) * @see #toCollection(String) @@ -863,16 +863,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -886,16 +886,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -914,25 +914,25 @@ /** - * Returns the SyncProvider implementation being used - * with this CachedRowSetImpl implementation rowset. + * Returns the {@code SyncProvider} implementation being used + * with this {@code CachedRowSetImpl} implementation rowset. * * @return the SyncProvider used by the rowset. If not provider was * set when the rowset was instantiated, the reference * implementation (default) provider is returned. * @throws SQLException if error occurs while return the - * SyncProvider instance. + * {@code SyncProvider} instance. */ public SyncProvider getSyncProvider() throws SQLException { throw new UnsupportedOperationException(); } /** - * Sets the active SyncProvider and attempts to load - * load the new provider using the SyncFactory SPI. + * Sets the active {@code SyncProvider} and attempts to load + * load the new provider using the {@code SyncFactory} SPI. * * @throws SQLException if an error occurs while resetting the - * SyncProvider. + * {@code SyncProvider}. */ public void setSyncProvider(String providerStr) throws SQLException { throw new UnsupportedOperationException(); @@ -953,23 +953,23 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data. + * Populates this {@code CachedRowSetImpl} object with data. * This form of the method uses the rowset's user, password, and url or * data source name properties to create a database * connection. If properties that are needed * have not been set, this method will throw an exception. * - * Another form of this method uses an existing JDBC Connection + * Another form of this method uses an existing JDBC {@code Connection} * object instead of creating a new one; therefore, it ignores the * properties used for establishing a new connection. * * The query specified by the command property is executed to create a - * ResultSet object from which to retrieve data. + * {@code ResultSet} object from which to retrieve data. * The current contents of the rowset are discarded, and the * rowset's metadata is also (re)set. If there are outstanding updates, * they are also ignored. * - * The method execute closes any database connections that it + * The method {@code execute} closes any database connections that it * creates. * * @throws SQLException if an error occurs or the @@ -987,20 +987,20 @@ /** * Moves the cursor down one row from its current position and - * returns true if the new cursor position is a + * returns {@code true} if the new cursor position is a * valid row. - * The cursor for a new ResultSet object is initially + * The cursor for a new {@code ResultSet} object is initially * positioned before the first row. The first call to the method - * next moves the cursor to the first row, making it + * {@code next} moves the cursor to the first row, making it * the current row; the second call makes the second row the * current row, and so on. * * If an input stream from the previous row is open, it is - * implicitly closed. The ResultSet object's warning + * implicitly closed. The {@code ResultSet} object's warning * chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if an error occurs or * the cursor is not positioned in the rowset, before * the first row, or after the last row @@ -1010,9 +1010,9 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the next - * row and returns true if the cursor is still in the rowset; - * returns false if the cursor has moved to the position after + * Moves this {@code CachedRowSetImpl} object's cursor to the next + * row and returns {@code true} if the cursor is still in the rowset; + * returns {@code false} if the cursor has moved to the position after * the last row. * * This method handles the cases where the cursor moves to a row that @@ -1021,15 +1021,15 @@ * that has been deleted, this method moves the cursor to the next * row until the cursor is on a row that has not been deleted. * - * The method internalNext is called by methods such as - * next, absolute, and relative, + * The method {@code internalNext} is called by methods such as + * {@code next}, {@code absolute}, and {@code relative}, * and, as its name implies, is only called internally. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a valid row in this - * rowset; false if it is after the last row + * @return {@code true} if the cursor is on a valid row in this + * rowset; {@code false} if it is after the last row * @throws SQLException if an error occurs */ protected boolean internalNext() throws SQLException { @@ -1037,25 +1037,25 @@ } /** - * Closes this CachedRowSetImpl objecy and releases any resources + * Closes this {@code CachedRowSetImpl} objecy and releases any resources * it was using. * * @throws SQLException if an error occurs when releasing any resources in use - * by this CachedRowSetImpl object + * by this {@code CachedRowSetImpl} object */ public void close() throws SQLException { throw new UnsupportedOperationException(); } /** - * Reports whether the last column read was SQL NULL. - * Note that you must first call the method getXXX + * Reports whether the last column read was SQL {@code NULL}. + * Note that you must first call the method {@code getXXX} * on a column to try to read its value and then call the method - * wasNull to determine whether the value was - * SQL NULL. + * {@code wasNull} to determine whether the value was + * SQL {@code NULL}. * - * @return true if the value in the last column read - * was SQL NULL; false otherwise + * @return {@code true} if the value in the last column read + * was SQL {@code NULL}; {@code false} otherwise * @throws SQLException if an error occurs */ public boolean wasNull() throws SQLException { @@ -1064,9 +1064,9 @@ /** * Returns the insert row or the current row of this - * CachedRowSetImplobject. + * {@code CachedRowSetImpl}object. * - * @return the Row object on which this CachedRowSetImpl + * @return the {@code Row} object on which this {@code CachedRowSetImpl} * objects's cursor is positioned */ protected BaseRow getCurrentRow() { @@ -1077,7 +1077,7 @@ * Removes the row on which the cursor is positioned. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * * @throws SQLException if the cursor is positioned on the insert * row @@ -1089,20 +1089,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * String object. + * of this {@code CachedRowSetImpl} object as a + * {@code String} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} {@code CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type designates the * recommended return type. */ public String getString(int columnIndex) throws SQLException { @@ -1111,18 +1111,18 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * boolean value. + * of this {@code CachedRowSetImpl} object as a + * {@code boolean} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a boolean in the Java progamming language; - * if the value is SQL NULL, the result is false + * @return the column value as a {@code boolean} in the Java progamming language; + * if the value is SQL {@code NULL}, the result is {@code false} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BOOLEAN value + * SQL {@code BOOLEAN} value * @see #getBoolean(String) */ public boolean getBoolean(int columnIndex) throws SQLException { @@ -1131,20 +1131,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type + * SQL {@code TINYINT}, {@code SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type * designates the recommended return type. * @see #getByte(String) */ @@ -1154,21 +1154,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * short value. + * of this {@code CachedRowSetImpl} object as a + * {@code short} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT}, {@code SMALLINT}, + * {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(String) */ public short getShort(int columnIndex) throws SQLException { @@ -1177,21 +1178,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * int value. + * of this {@code CachedRowSetImpl} object as an + * {@code int} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1199,21 +1201,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * long value. + * of this {@code CachedRowSetImpl} object as a + * {@code long} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getLong(String) */ public long getLong(int columnIndex) throws SQLException { @@ -1222,21 +1225,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * float value. + * of this {@code CachedRowSetImpl} object as a + * {@code float} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,} + * {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC, + * BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(int columnIndex) throws SQLException { @@ -1245,21 +1248,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * double value. + * of this {@code CachedRowSetImpl} object as a + * {@code double} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,} + * {@code FLOAT, DOUBLE}, + * {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getDouble(String) * */ @@ -1269,21 +1273,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * This method is deprecated; use the version of getBigDecimal + * This method is deprecated; use the version of {@code getBigDecimal} * that does not take a scale parameter and returns a value with full * precision. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @param scale the number of digits to the right of the decimal point in the * value returned * @return the column value with the specified number of digits to the right - * of the decimal point; if the value is SQL NULL, the - * result is null + * of the decimal point; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails * @deprecated @@ -1295,22 +1299,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte array value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} array value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the - * result is null + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the + * result is {@code null} * * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or + * {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getBytes(String) */ public byte[] getBytes(int columnIndex) throws SQLException { @@ -1319,17 +1323,17 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Date object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Date} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a java.sql.Data object; if - * the value is SQL NULL, the - * result is null + * @return the column value as a {@code java.sql.Data} object; if + * the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, - * the cursor is not on a valid row, or this method fails + * the cursor is not on a valid row, or this method fails */ public java.sql.Date getDate(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1337,14 +1341,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Time object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Time} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1354,14 +1358,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1371,33 +1375,33 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The JDBC + * suitable for retrieving large {@code LONGVARCHAR} values. The JDBC * driver will do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. . Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(String) */ public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException { @@ -1416,8 +1420,8 @@ * stream may return 0 for available() whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of two byte Unicode characters. If the value is SQL NULL @@ -1432,30 +1436,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for - * CachedRowSetImpl.available() whether there is data + * stream may return {@code 0} for + * {@code CachedRowSetImpl.available()} whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes. If the value is SQL NULL - * then the result is null. + * as a stream of uninterpreted bytes. If the value is SQL {@code NULL} + * then the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY}. * The bold type indicates the SQL type that this method is recommened * to retrieve. * @see #getBinaryStream(String) @@ -1472,19 +1476,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a String object. + * of the current row as a {@code String} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR< value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} + * {@code CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. */ public String getString(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1492,17 +1496,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a boolean value. + * of the current row as a {@code boolean} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a boolean in the Java programming - * language; if the value is SQL NULL, - * the result is false + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code boolean} in the Java programming + * language; if the value is SQL {@code NULL}, + * the result is {@code false} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BOOLEAN value + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BOOLEAN} value * @see #getBoolean(int) */ public boolean getBoolean(String columnName) throws SQLException { @@ -1511,19 +1515,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte value. + * of the current row as a {@code byte} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The - * bold type designates the recommended return type + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT}, + * {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} + * value. The bold type designates the recommended return type. */ public byte getByte(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1531,19 +1535,20 @@ /** * Retrieves the value stored in the designated column - * of the current row as a short value. + * of the current row as a {@code short} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT,} + * {@code SMALLINT}, {@code INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(int) */ public short getShort(String columnName) throws SQLException { @@ -1552,20 +1557,21 @@ /** * Retrieves the value stored in the designated column - * of the current row as an int value. + * of the current row as an {@code int} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name - * of a column in this rowset, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * of a column in this rowset, + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1573,19 +1579,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a long value. + * of the current row as a {@code long} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getLong(int) */ public long getLong(String columnName) throws SQLException { @@ -1594,19 +1600,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a float value. + * of the current row as a {@code float} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT,} {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(String columnName) throws SQLException { @@ -1615,20 +1621,20 @@ /** * Retrieves the value stored in the designated column - * of the current row of this CachedRowSetImpl object - * as a double value. + * of the current row of this {@code CachedRowSetImpl} object + * as a {@code double} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return types. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL,} {@code FLOAT, DOUBLE}, {@code DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return types. * @see #getDouble(int) */ public double getDouble(String columnName) throws SQLException { @@ -1637,22 +1643,22 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.math.BigDecimal object. + * of the current row as a {@code java.math.BigDecimal} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @param scale the number of digits to the right of the decimal point - * @return a java.math.BugDecimal object with scale - * number of digits to the right of the decimal point. + * @return a java.math.BugDecimal object with {@code scale} + * number of digits to the right of the decimal point. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve. - * @deprecated Use the getBigDecimal(String columnName) + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. + * @deprecated Use the {@code getBigDecimal(String columnName)} * method instead */ @Deprecated @@ -1662,19 +1668,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte array. + * of the current row as a {@code byte} array. * The bytes represent the raw values returned by the driver. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BINARY, VARBINARY - * or LONGVARBINARY values - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BINARY, VARBINARY} + * or {@code LONGVARBINARY} values. + * The bold SQL type designates the recommended return type. * @see #getBytes(int) */ public byte[] getBytes(String columnName) throws SQLException { @@ -1683,17 +1689,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Date object. + * of the current row as a {@code java.sql.Date} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1701,12 +1707,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Time object. + * of the current row as a {@code java.sql.Time} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1717,12 +1723,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Timestamp object. + * of the current row as a {@code java.sql.Timestamp} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1733,32 +1739,32 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The - * SyncProvider will rely on the JDBC driver to do any necessary + * suitable for retrieving large {@code LONGVARCHAR} values. The + * {@code SyncProvider} will rely on the JDBC driver to do any necessary * conversion from the database format into ASCII format. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * a column in this rowset + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(int) */ public java.io.InputStream getAsciiStream(String columnName) throws SQLException { @@ -1769,23 +1775,23 @@ /** * A column value can be retrieved as a stream of Unicode characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will do any necessary conversion from the database * format into Unicode. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row - * @deprecated use the method getCharacterStream instead + * @deprecated use the method {@code getCharacterStream} instead */ @Deprecated public java.io.InputStream getUnicodeStream(String columnName) throws SQLException { @@ -1794,30 +1800,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of uninterpreted bytes. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is unknown, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY - * The bold type indicates the SQL type that this method is recommened - * to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY} + * The bold type indicates the SQL type that this method is recommened + * to retrieve. * @see #getBinaryStream(int) * */ @@ -1831,17 +1837,17 @@ //===================================================================== /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by statement + * by {@code ResultSet} methods. Any warning caused by statement * methods (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * * @return the first SQLWarning or null */ @@ -1850,10 +1856,10 @@ } /** - * Clears all the warnings reporeted for the CachedRowSetImpl - * object. After a call to this method, the getWarnings method - * returns null until a new warning is reported for this - * CachedRowSetImpl object. + * Clears all the warnings reporeted for the {@code CachedRowSetImpl} + * object. After a call to this method, the {@code getWarnings} method + * returns {@code null} until a new warning is reported for this + * {@code CachedRowSetImpl} object. */ public void clearWarnings() { throw new UnsupportedOperationException(); @@ -1861,25 +1867,25 @@ /** * Retrieves the name of the SQL cursor used by this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * * In SQL, a result table is retrieved through a cursor that is - * named. The current row of a ResultSet can be updated or deleted + * named. The current row of a {@code ResultSet} can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To ensure that the cursor has the proper isolation - * level to support an update operation, the cursor's SELECT - * statement should be of the form select for update. - * If the for update clause + * level to support an update operation, the cursor's {@code SELECT} + * statement should be of the form {@code select for update}. + * If the {@code for update} clause * is omitted, positioned updates may fail. * * JDBC supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. The current row + * SQL cursor used by a {@code ResultSet} object. The current row * of a result set is also the current row of this SQL cursor. * * Note: If positioned updates are not supported, an - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL cursor name for this CachedRowSetImpl object's + * @return the SQL cursor name for this {@code CachedRowSetImpl} object's * cursor * @throws SQLException if an error occurs */ @@ -1888,12 +1894,12 @@ } /** - * Retrieves a ResultSetMetaData object instance that - * contains information about the CachedRowSet object. + * Retrieves a {@code ResultSetMetaData} object instance that + * contains information about the {@code CachedRowSet} object. * However, applications should cast the returned object to a - * RowSetMetaData interface implementation. In the + * {@code RowSetMetaData} interface implementation. In the * reference implementation, this cast can be done on the - * RowSetMetaDataImpl class. + * {@code RowSetMetaDataImpl} class. * * For example: * @@ -1907,10 +1913,10 @@ * crs.setMetaData(metaData); * * - * @return the ResultSetMetaData object that describes this - * CachedRowSetImpl object's columns + * @return the {@code ResultSetMetaData} object that describes this + * {@code CachedRowSetImpl} object's columns * @throws SQLException if an error occurs in generating the RowSet - * meta data; or if the CachedRowSetImpl is empty. + * meta data; or if the {@code CachedRowSetImpl} is empty. * @see javax.sql.RowSetMetaData */ public ResultSetMetaData getMetaData() throws SQLException { @@ -1920,10 +1926,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1931,23 +1937,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes in the Java programming language. * When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(String) */ public Object getObject(int columnIndex) throws SQLException { @@ -1956,10 +1962,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1967,23 +1973,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes * in the Java programming language. When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name does not match one of * this rowset's column names, (2) the cursor is not * on a valid row, or (3) there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(int) */ public Object getObject(String columnName) throws SQLException { @@ -1993,10 +1999,10 @@ //---------------------------------------------------------------- /** - * Maps the given column name for one of this CachedRowSetImpl + * Maps the given column name for one of this {@code CachedRowSetImpl} * object's columns to its column number. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @return the column index of the given column name * @throws SQLException if the given column name does not match one @@ -2014,25 +2020,25 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java character stream that delivers the database column value * as a stream of two-byte unicode characters in a - * java.io.Reader object. If the value is - * SQL NULL, the result is null. + * {@code java.io.Reader} object. If the value is + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR,} {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getCharacterStream(String) */ public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{ @@ -2041,23 +2047,24 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY or LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code CHAR, VARCHAR,} + * {@code LONGVARCHAR}, + * {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -2065,21 +2072,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return types that this method is used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return types that this method is used to retrieve. * @see #getBigDecimal(String) */ public BigDecimal getBigDecimal(int columnIndex) throws SQLException { @@ -2088,21 +2096,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. * @see #getBigDecimal(int) */ public BigDecimal getBigDecimal(String columnName) throws SQLException { @@ -2114,7 +2122,7 @@ //--------------------------------------------------------------------- /** - * Returns the number of rows in this CachedRowSetImpl object. + * Returns the number of rows in this {@code CachedRowSetImpl} object. * * @return number of rows in the rowset */ @@ -2124,10 +2132,10 @@ /** * Indicates whether the cursor is before the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is before the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isBeforeFirst() throws SQLException { @@ -2136,10 +2144,10 @@ /** * Indicates whether the cursor is after the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is after the last row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isAfterLast() throws SQLException { @@ -2148,10 +2156,10 @@ /** * Indicates whether the cursor is on the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is on the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isFirst() throws SQLException { @@ -2160,14 +2168,14 @@ /** * Indicates whether the cursor is on the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * Note: Calling the method isLast may be expensive + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver might need to fetch ahead one row in order * to determine whether the current row is the last row in this rowset. * - * @return true if the cursor is on the last row; - * false otherwise or if this rowset contains no rows + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise or if this rowset contains no rows * @throws SQLException if an error occurs */ public boolean isLast() throws SQLException { @@ -2175,19 +2183,19 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the front of + * Moves this {@code CachedRowSetImpl} object's cursor to the front of * the rowset, just before the first row. This method has no effect if * this rowset contains no rows. * * @throws SQLException if an error occurs or the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public void beforeFirst() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the end of + * Moves this {@code CachedRowSetImpl} object's cursor to the end of * the rowset, just after the last row. This method has no effect if * this rowset contains no rows. * @@ -2198,34 +2206,34 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the first row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the first row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean first() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the first - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the first + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the methods first, - * isFirst, and absolute. - * It in turn calls the method internalNext in order to + * This method is called internally by the methods {@code first}, + * {@code isFirst}, and {@code absolute}. + * It in turn calls the method {@code internalNext} in order to * handle the case where the first row is a deleted row that is not visible. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the first row; - * false otherwise + * @return {@code true} if the cursor moved to the first row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalFirst() throws SQLException { @@ -2233,35 +2241,35 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the last row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the last row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean last() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the last - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the last + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the method last + * This method is called internally by the method {@code last} * when rows have been deleted and the deletions are not visible. - * The method internalLast handles the case where the + * The method {@code internalLast} handles the case where the * last row is a deleted row that is not visible by in turn calling - * the method internalPrevious. + * the method {@code internalPrevious}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the last row; - * false otherwise + * @return {@code true} if the cursor moved to the last row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalLast() throws SQLException { @@ -2269,12 +2277,12 @@ } /** - * Returns the number of the current row in this CachedRowSetImpl + * Returns the number of the current row in this {@code CachedRowSetImpl} * object. The first row is number 1, the second number 2, and so on. * - * @return the number of the current row; 0 if there is no + * @return the number of the current row; {@code 0} if there is no * current row - * @throws SQLException if an error occurs; or if the CacheRowSetImpl + * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl} * is empty */ public int getRow() throws SQLException { @@ -2282,51 +2290,51 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the row number + * Moves this {@code CachedRowSetImpl} object's cursor to the row number * specified. * * If the number is positive, the cursor moves to an absolute row with * respect to the beginning of the rowset. The first row is row 1, the second * is row 2, and so on. For example, the following command, in which - * crs is a CachedRowSetImpl object, moves the cursor + * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor * to the fourth row, starting from the beginning of the rowset. - * + * {@code * * crs.absolute(4); * - * + * } * * If the number is negative, the cursor moves to an absolute row position * with respect to the end of the rowset. For example, calling - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row, counting * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. * * @param row a positive number to indicate the row, starting row numbering from - * the first row, which is 1; a negative number to indicate + * the first row, which is {@code 1}; a negative number to indicate * the row, starting row numbering from the last row, which is - * -1; it must not be 0 - * @return true if the cursor is on the rowset; false + * {@code -1}; it must not be {@code 0} + * @return {@code true} if the cursor is on the rowset; {@code false} * otherwise - * @throws SQLException if the given cursor position is 0 or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * @throws SQLException if the given cursor position is {@code 0} or the + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean absolute( int row ) throws SQLException { throw new UnsupportedOperationException(); @@ -2340,80 +2348,80 @@ * If the number is positive, the cursor moves the specified number of * rows toward the end of the rowset, starting at the current row. * For example, the following command, in which - * crs is a CachedRowSetImpl object with 100 rows, + * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows, * moves the cursor forward four rows from the current row. If the * current row is 50, the cursor would move to row 54. - * + * {@code * * crs.relative(4); * - * + * } * * If the number is negative, the cursor moves back toward the beginning * the specified number of rows, starting at the current row. * For example, calling the method - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. In both cases, this method - * throws an SQLException. + * throws an {@code SQLException}. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). Calling relative(0) + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. Calling {@code relative(0)} * is valid, but it does not change the cursor position. * - * @param rows an int indicating the number of rows to move + * @param rows an {@code int} indicating the number of rows to move * the cursor, starting at the current row; a positive number * moves the cursor forward; a negative number moves the cursor * backward; must not move the cursor past the valid * rows - * @return true if the cursor is on a row in this - * CachedRowSetImpl object; false + * @return {@code true} if the cursor is on a row in this + * {@code CachedRowSetImpl} object; {@code false} * otherwise * @throws SQLException if there are no rows in this rowset, the cursor is * positioned either before the first row or after the last row, or - * the rowset is type ResultSet.TYPE_FORWARD_ONLY + * the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean relative(int rows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the - * previous row and returns true if the cursor is on - * a valid row or false if it is not. + * Moves this {@code CachedRowSetImpl} object's cursor to the + * previous row and returns {@code true} if the cursor is on + * a valid row or {@code false} if it is not. * This method also notifies all listeners registered with this - * CachedRowSetImpl object that its cursor has moved. + * {@code CachedRowSetImpl} object that its cursor has moved. * - * Note: calling the method previous() is not the same - * as calling the method relative(-1). This is true - * because it is possible to call previous() from the insert + * Note: calling the method {@code previous()} is not the same + * as calling the method {@code relative(-1)}. This is true + * because it is possible to call {@code previous()} from the insert * row, from after the last row, or from the current row, whereas - * relative may only be called from the current row. + * {@code relative} may only be called from the current row. * - * The method previous may used in a while + * The method {@code previous} may used in a {@code while} * loop to iterate through a rowset starting after the last row - * and moving toward the beginning. The loop ends when previous - * returns false, meaning that there are no more rows. + * and moving toward the beginning. The loop ends when {@code previous} + * returns {@code false}, meaning that there are no more rows. * For example, the following code fragment retrieves all the data in - * the CachedRowSetImpl object crs, which has + * the {@code CachedRowSetImpl} object {@code crs}, which has * three columns. Note that the cursor must initially be positioned * after the last row so that the first call to the method - * previous places the cursor on the last line. - * + * {@code previous} places the cursor on the last line. + * {@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - * - * This method throws an SQLException if the cursor is not + * } + * This method throws an {@code SQLException} if the cursor is not * on a row in the rowset, before the first row, or after the last row. * - * @return true if the cursor is on a valid row; - * false if it is before the first row or after the + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is before the first row or after the * last row * @throws SQLException if the cursor is not on a valid position or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean previous() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor to the previous row in this CachedRowSetImpl + * Moves the cursor to the previous row in this {@code CachedRowSetImpl} * object, skipping past deleted rows that are not visible; returns - * true if the cursor is on a row in this rowset and - * false when the cursor goes before the first row. + * {@code true} if the cursor is on a row in this rowset and + * {@code false} when the cursor goes before the first row. * - * This method is called internally by the method previous. + * This method is called internally by the method {@code previous}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a row in this rowset; - * false when the cursor reaches the position before + * @return {@code true} if the cursor is on a row in this rowset; + * {@code false} when the cursor reaches the position before * the first row * @throws SQLException if an error occurs */ @@ -2463,14 +2471,14 @@ //--------------------------------------------------------------------- /** - * Indicates whether the current row of this CachedRowSetImpl + * Indicates whether the current row of this {@code CachedRowSetImpl} * object has been updated. The value returned - * depends on whether this rowset can detect updates: false + * depends on whether this rowset can detect updates: {@code false} * will always be returned if it does not detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another and updates are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2482,13 +2490,13 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * * @param idx the index identifier of the column that may be have been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2500,14 +2508,14 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * - * @param columnName the String column name column that may be have + * @param columnName the {@code String} column name column that may be have * been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2521,8 +2529,8 @@ * Indicates whether the current row has been inserted. The value returned * depends on whether or not the rowset can detect visible inserts. * - * @return true if a row has been inserted and inserts are detected; - * false otherwise + * @return {@code true} if a row has been inserted and inserts are detected; + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2536,12 +2544,12 @@ * Indicates whether the current row has been deleted. A deleted row * may leave a visible "hole" in a rowset. This method can be used to * detect such holes if the rowset can detect deletions. This method - * will always return false if this rowset cannot detect + * will always return {@code false} if this rowset cannot detect * deletions. * - * @return true if (1)the current row is blank, indicating that + * @return {@code true} if (1)the current row is blank, indicating that * the row has been deleted, and (2)deletions are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on a valid row in this rowset * @see DatabaseMetaData#deletesAreDetected */ @@ -2551,8 +2559,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset; however, another method must be called to complete @@ -2565,15 +2573,15 @@ * * In order to propagate updates in this rowset to the underlying * data source, an application must call the method {@link #acceptChanges} - * after it calls either updateRow or insertRow. + * after it calls either {@code updateRow} or {@code insertRow}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -2581,8 +2589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2593,14 +2601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(int columnIndex, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -2608,8 +2616,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2620,14 +2628,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(int columnIndex, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -2635,8 +2643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2647,14 +2655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(int columnIndex, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -2662,8 +2670,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2674,14 +2682,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(int columnIndex, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -2689,8 +2697,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2701,14 +2709,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(int columnIndex, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -2717,8 +2725,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2729,14 +2737,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(int columnIndex, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -2744,8 +2752,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2756,14 +2764,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(int columnIndex, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -2771,8 +2779,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2783,14 +2791,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -2798,8 +2806,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2810,17 +2818,17 @@ * as inserted. Both of these methods must be called before the * cursor moves to another row. * - * The method acceptChanges must be called if the + * The method {@code acceptChanges} must be called if the * updated values are to be written back to the underlying database. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(int columnIndex, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -2828,8 +2836,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2840,14 +2848,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(int columnIndex, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -2855,8 +2863,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2867,15 +2875,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(int columnIndex, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -2883,8 +2891,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2895,15 +2903,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL TIME or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code TIME} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(int columnIndex, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -2911,8 +2919,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2923,16 +2931,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE, TIME, or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE}, {@code TIME}, or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -2940,7 +2948,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -2952,8 +2960,8 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -2965,8 +2973,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2977,17 +2985,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not binary, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException { throw new UnsupportedOperationException(); @@ -2995,8 +3003,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3007,19 +3015,19 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.Reader - * containing BINARY, VARBINARY, - * LONGVARBINARY, CHAR, VARCHAR, - * or LONGVARCHAR data + * @param x the new column value; must be a {@code java.io.Reader} + * containing {@code BINARY}, {@code VARBINARY}, + * {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR}, + * or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not a binary or * character type, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3027,11 +3035,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter indicates + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter indicates * the number of digits to the right of the decimal point and is ignored * if the new column value is not a type that will be mapped to an SQL - * DECIMAL or NUMERIC value. + * {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3042,16 +3050,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3059,8 +3067,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3071,14 +3079,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x) throws SQLException { throw new UnsupportedOperationException(); @@ -3087,8 +3095,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3098,12 +3106,12 @@ * must be called, which will insert the new row into both this rowset * and the database. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -3111,8 +3119,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3123,13 +3131,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(String columnName, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -3137,8 +3145,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3149,13 +3157,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(String columnName, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -3163,8 +3171,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3175,13 +3183,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(String columnName, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -3189,8 +3197,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3201,13 +3209,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(String columnName, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -3215,8 +3223,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3227,13 +3235,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(String columnName, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -3241,8 +3249,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3253,13 +3261,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(String columnName, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -3267,8 +3275,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3279,13 +3287,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(String columnName, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -3293,8 +3301,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3305,13 +3313,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -3319,8 +3327,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3331,13 +3339,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(String columnName, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -3345,8 +3353,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3357,13 +3365,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(String columnName, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -3371,8 +3379,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3383,15 +3391,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(String columnName, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -3399,8 +3407,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3411,15 +3419,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL TIME or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code TIME} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(String columnName, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -3427,8 +3435,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3439,7 +3447,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if the given column index is out of bounds or @@ -3448,9 +3456,9 @@ * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE, - * TIME, or TIMESTAMP, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP}, or (4) this + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -3458,7 +3466,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -3470,7 +3478,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -3483,8 +3491,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3495,17 +3503,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not binary, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3513,8 +3521,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3525,18 +3533,18 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param reader the new column value; must be a - * java.io.Reader containing BINARY, - * VARBINARY, LONGVARBINARY, CHAR, - * VARCHAR, or LONGVARCHAR data + * {@code java.io.Reader} containing {@code BINARY}, + * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR}, + * {@code VARCHAR}, or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not a binary or character type, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(String columnName, java.io.Reader reader, @@ -3546,11 +3554,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter * indicates the number of digits to the right of the decimal point * and is ignored if the new column value is not a type that will be - * mapped to an SQL DECIMAL or NUMERIC value. + * mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3561,15 +3569,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3577,8 +3585,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3589,20 +3597,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x) throws SQLException { throw new UnsupportedOperationException(); } /** - * Inserts the contents of this CachedRowSetImpl object's insert + * Inserts the contents of this {@code CachedRowSetImpl} object's insert * row into this rowset immediately following the current row. * If the current row is the * position after the last row or before the first row, the new row will @@ -3614,14 +3622,14 @@ * @throws SQLException if (1) the cursor is not on the insert row, * (2) one or more of the non-nullable columns in the insert * row has not been given a value, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void insertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Marks the current row of this CachedRowSetImpl object as + * Marks the current row of this {@code CachedRowSetImpl} object as * updated and notifies listeners registered with this rowset that the * row has changed. * @@ -3631,26 +3639,26 @@ * and the updates made before the cursor moved will be lost. * * @throws SQLException if the cursor is on the insert row or this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Deletes the current row from this CachedRowSetImpl object and + * Deletes the current row from this {@code CachedRowSetImpl} object and * notifies listeners registered with this rowset that a row has changed. * This method cannot be called when the cursor is on the insert row. * * This method marks the current row as deleted, but it does not delete * the row from the underlying data source. The method - * acceptChanges must be called to delete the row in + * {@code acceptChanges} must be called to delete the row in * the data source. * * @throws SQLException if (1) this method is called when the cursor * is on the insert row, before the first row, or after the * last row or (2) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void deleteRow() throws SQLException { throw new UnsupportedOperationException(); @@ -3659,7 +3667,7 @@ /** * Sets the current row with its original value and marks the row as * not updated, thus undoing any changes made to the row since the - * last call to the methods updateRow or deleteRow. + * last call to the methods {@code updateRow} or {@code deleteRow}. * This method should be called only when the cursor is on a row in * this rowset. * @@ -3672,11 +3680,11 @@ /** * Rolls back any updates made to the current row of this - * CachedRowSetImpl object and notifies listeners that + * {@code CachedRowSetImpl} object and notifies listeners that * a row has changed. To have an effect, this method - * must be called after an updateXXX method has been - * called and before the method updateRow has been called. - * If no updates have been made or the method updateRow + * must be called after an {@code updateXXX} method has been + * called and before the method {@code updateRow} has been called. + * If no updates have been made or the method {@code updateRow} * has already been called, this method has no effect. * * @throws SQLException if the cursor is on the insert row, before the @@ -3687,39 +3695,39 @@ } /** - * Moves the cursor for this CachedRowSetImpl object + * Moves the cursor for this {@code CachedRowSetImpl} object * to the insert row. The current row in the rowset is remembered * while the cursor is on the insert row. * * The insert row is a special row associated with an updatable * rowset. It is essentially a buffer where a new row may - * be constructed by calling the appropriate updateXXX + * be constructed by calling the appropriate {@code updateXXX} * methods to assign a value to each column in the row. A complete * row must be constructed; that is, every column that is not nullable * must be assigned a value. In order for the new row to become part - * of this rowset, the method insertRow must be called + * of this rowset, the method {@code insertRow} must be called * before the cursor is moved back to the rowset. * * Only certain methods may be invoked while the cursor is on the insert * row; many methods throw an exception if they are called while the - * cursor is there. In addition to the updateXXX - * and insertRow methods, only the getXXX methods - * may be called when the cursor is on the insert row. A getXXX - * method should be called on a column only after an updateXXX + * cursor is there. In addition to the {@code updateXXX} + * and {@code insertRow} methods, only the {@code getXXX} methods + * may be called when the cursor is on the insert row. A {@code getXXX} + * method should be called on a column only after an {@code updateXXX} * method has been called on that column; otherwise, the value returned is * undetermined. * - * @throws SQLException if this CachedRowSetImpl object is - * ResultSet.CONCUR_READ_ONLY + * @throws SQLException if this {@code CachedRowSetImpl} object is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void moveToInsertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor for this CachedRowSetImpl object to + * Moves the cursor for this {@code CachedRowSetImpl} object to * the current row. The current row is the row the cursor was on - * when the method moveToInsertRow was called. + * when the method {@code moveToInsertRow} was called. * * Calling this method has no effect unless it is called while the * cursor is on the insert row. @@ -3731,9 +3739,9 @@ } /** - * Returns null. + * Returns {@code null}. * - * @return null + * @return {@code null} * @throws SQLException if an error occurs */ public Statement getStatement() throws SQLException { @@ -3742,18 +3750,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column index is out of bounds or * the cursor is not on one of this rowset's rows or its * insert row @@ -3767,17 +3775,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL REF value + * SQL {@code REF} value * @see #getRef(String) */ public Ref getRef(int columnIndex) throws SQLException { @@ -3786,17 +3794,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BLOB value + * SQL {@code BLOB} value * @see #getBlob(String) */ public Blob getBlob(int columnIndex) throws SQLException { @@ -3805,17 +3813,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Clob object representing an SQL CLOB value + * @return a {@code Clob} object representing an SQL {@code CLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL CLOB value + * SQL {@code CLOB} value * @see #getClob(String) */ public Clob getClob(int columnIndex) throws SQLException { @@ -3824,18 +3832,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL ARRAY value + * SQL {@code ARRAY} value * @see #getArray(String) */ public Array getArray(int columnIndex) throws SQLException { @@ -3844,17 +3852,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column name is not the name of * a column in this rowset or the cursor is not on one of * this rowset's rows or its insert row @@ -3867,16 +3875,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the column value - * is not an SQL REF value + * is not an SQL {@code REF} value * @see #getRef(int) */ public Ref getRef(String colName) throws SQLException { @@ -3885,16 +3893,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BLOB value + * column does not store an SQL {@code BLOB} value * @see #getBlob(int) */ public Blob getBlob(String colName) throws SQLException { @@ -3903,17 +3911,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Clob object representing an SQL - * CLOB value + * @return a {@code Clob} object representing an SQL + * {@code CLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CLOB value + * column does not store an SQL {@code CLOB} value * @see #getClob(int) */ public Clob getClob(String colName) throws SQLException { @@ -3922,17 +3930,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming langugage. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL ARRAY value + * column does not store an SQL {@code ARRAY} value * @see #getArray(int) */ public Array getArray(String colName) throws SQLException { @@ -3941,22 +3949,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3964,21 +3972,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3986,22 +3994,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4009,21 +4017,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4031,22 +4039,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Timestamp - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4054,22 +4062,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object, using the given - * Calendar object to construct an appropriate + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object, using the given + * {@code Calendar} object to construct an appropriate * millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE, - * TIME, or TIMESTAMP value + * column does not store an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4080,13 +4088,13 @@ */ /** - * Retrieves the Connection object passed to this - * CachedRowSetImpl object. This connection may be + * Retrieves the {@code Connection} object passed to this + * {@code CachedRowSetImpl} object. This connection may be * used to populate this rowset with data or to write data back * to its underlying data source. * - * @return the Connection object passed to this rowset; - * may be null if there is no connection + * @return the {@code Connection} object passed to this rowset; + * may be {@code null} if there is no connection * @throws SQLException if an error occurs */ public Connection getConnection() throws SQLException{ @@ -4094,10 +4102,10 @@ } /** - * Sets the metadata for this CachedRowSetImpl object - * with the given RowSetMetaData object. + * Sets the metadata for this {@code CachedRowSetImpl} object + * with the given {@code RowSetMetaData} object. * - * @param md a RowSetMetaData object instance containing + * @param md a {@code RowSetMetaData} object instance containing * metadata about the columsn in the rowset * @throws SQLException if invalid meta data is supplied to the * rowset @@ -4108,17 +4116,17 @@ /** * Returns a result set containing the original value of the rowset. The - * original value is the state of the CachedRowSetImpl after the + * original value is the state of the {@code CachedRowSetImpl} after the * last population or synchronization (whichever occurred most recently) with * the data source. * * The cursor is positioned before the first row in the result set. - * Only rows contained in the result set returned by getOriginal() + * Only rows contained in the result set returned by {@code getOriginal()} * are said to have an original value. * * @return the original result set of the rowset * @throws SQLException if an error occurs produce the - * ResultSet object + * {@code ResultSet} object */ public ResultSet getOriginal() throws SQLException { throw new UnsupportedOperationException(); @@ -4127,7 +4135,7 @@ /** * Returns a result set containing the original value of the current * row only. - * The original value is the state of the CachedRowSetImpl after + * The original value is the state of the {@code CachedRowSetImpl} after * the last population or synchronization (whichever occurred most recently) * with the data source. * @@ -4153,7 +4161,7 @@ /** * Marks all rows in this rowset as being original rows. Any updates * made to the rows become the original values for the rowset. - * Calls to the method setOriginal connot be reversed. + * Calls to the method {@code setOriginal} connot be reversed. * * @throws SQLException if an error occurs */ @@ -4165,8 +4173,8 @@ * Returns an identifier for the object (table) that was used to create this * rowset. * - * @return a String object that identifies the table from - * which this CachedRowSetImpl object was derived + * @return a {@code String} object that identifies the table from + * which this {@code CachedRowSetImpl} object was derived * @throws SQLException if an error occurs */ public String getTableName() throws SQLException { @@ -4177,8 +4185,8 @@ * Sets the identifier for the table from which this rowset was derived * to the given table name. * - * @param tabName a String object that identifies the - * table from which this CachedRowSetImpl object + * @param tabName a {@code String} object that identifies the + * table from which this {@code CachedRowSetImpl} object * was derived * @throws SQLException if an error occurs */ @@ -4188,7 +4196,7 @@ /** * Returns the columns that make a key to uniquely identify a - * row in this CachedRowSetImpl object. + * row in this {@code CachedRowSetImpl} object. * * @return an array of column numbers that constitutes a primary * key for this rowset. This array should be empty @@ -4203,16 +4211,16 @@ /** - * Sets this CachedRowSetImpl object's - * keyCols field with the given array of column + * Sets this {@code CachedRowSetImpl} object's + * {@code keyCols} field with the given array of column * numbers, which forms a key for uniquely identifying a row * in this rowset. * - * @param keys an array of int indicating the + * @param keys an array of {@code int} indicating the * columns that form a primary key for this - * CachedRowSetImpl object; every + * {@code CachedRowSetImpl} object; every * element in the array must be greater than - * 0 and less than or equal to the number + * {@code 0} and less than or equal to the number * of columns in this rowset * @throws SQLException if any of the numbers in the * given array is not valid for this rowset @@ -4224,8 +4232,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4236,14 +4244,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4251,8 +4259,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4263,13 +4271,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4277,8 +4285,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4289,14 +4297,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + *
SyncFactory
RowSetReader
RowSetWriter
SyncProvider
SyncProvider.getRowSetWriter()
SELECT
initSQLStatements
UPDATE
WHERE
DELETE
INSERT INTO
CachedRowSet
CachedRowSet will hold the conflicting values + * This {@code CachedRowSet} will hold the conflicting values * retrieved from the db and hold it. */ private CachedRowSetImpl crsResolve; @@ -209,8 +209,8 @@ } /** - * Propagates changes in the given RowSet object - * back to its underlying data source and returns true + * Propagates changes in the given {@code RowSet} object + * back to its underlying data source and returns {@code true} * if successful. The writer will check to see if * the data in the pre-modified rowset (the original values) differ * from the data in the underlying data source. If data in the data @@ -221,15 +221,15 @@ * access for concurrent users. * * This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. * - * Creates a CachedRowSet object from the given - * RowSet object + * Creates a {@code CachedRowSet} object from the given + * {@code RowSet} object * Makes a connection with the data source * * Disables autocommit mode if it is not already disabled @@ -237,32 +237,32 @@ * * Checks to see if the reader has read new data since the writer * was last called and, if so, calls the method - * initSQLStatements to initialize new SQL statements + * {@code initSQLStatements} to initialize new SQL statements * - * Builds new SELECT, UPDATE, - * INSERT, and DELETE statements - * Uses the CachedRowSet object's metadata to + * Builds new {@code SELECT}, {@code UPDATE}, + * {@code INSERT}, and {@code DELETE} statements + * Uses the {@code CachedRowSet} object's metadata to * determine the table name, column names, and the columns * that make up the primary key * * When there is no conflict, propagates changes made to the - * CachedRowSet object back to its underlying data source + * {@code CachedRowSet} object back to its underlying data source * - * Iterates through each row of the CachedRowSet object + * Iterates through each row of the {@code CachedRowSet} object * to determine whether it has been updated, inserted, or deleted * If the corresponding row in the data source has not been changed * since the rowset last read its * values, the writer will use the appropriate command to update, * insert, or delete the row * If any data in the data source does not match the original values - * for the CachedRowSet object, the writer will roll + * for the {@code CachedRowSet} object, the writer will roll * back any changes it has made to the row in the data source. * * * - * @return true if changes to the rowset were successfully + * @return {@code true} if changes to the rowset were successfully * written to the rowset's underlying data source; - * false otherwise + * {@code false} otherwise */ public boolean writeData(RowSetInternal caller) throws SQLException { long conflicts = 0; @@ -434,25 +434,25 @@ } //end writeData -/** - * Updates the given CachedRowSet object's underlying data - * source so that updates to the rowset are reflected in the original - * data source, and returns false if the update was successful. - * A return value of true indicates that there is a conflict, - * meaning that a value updated in the rowset has already been changed by - * someone else in the underlying data source. A conflict can also exist - * if, for example, more than one row in the data source would be affected - * by the update or if no rows would be affected. In any case, if there is - * a conflict, this method does not update the underlying data source. - * - * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + * + * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - * - * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + * + * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. * - * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - * - * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + * + * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. * * If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. * * The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. * * NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. * * This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. * - * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. * - * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. * * Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. * - * undoUpdateRowSet object backed by the same data as - * that of this CachedRowSetImpl object and sharing a set of cursors + * Returns a new {@code RowSet} object backed by the same data as + * that of this {@code CachedRowSetImpl} object and sharing a set of cursors * with it. This allows cursors to interate over a shared set of rows, providing * multiple views of the underlying data. * - * @return a RowSet object that is a copy of this CachedRowSetImpl + * @return a {@code RowSet} object that is a copy of this {@code CachedRowSetImpl} * object and shares a set of cursors with it * @throws SQLException if an error occurs or cloning is * not supported @@ -750,19 +750,19 @@ } /** - * Returns a new RowSet object containing by the same data - * as this CachedRowSetImpl object. This method - * differs from the method createCopy in that it throws a - * CloneNotSupportedException object instead of an - * SQLException object, as the method createShared - * does. This clone - * method is called internally by the method createShared, - * which catches the CloneNotSupportedException object - * and in turn throws a new SQLException object. + * Returns a new {@code RowSet} object containing by the same data + * as this {@code CachedRowSetImpl} object. This method + * differs from the method {@code createCopy} in that it throws a + * {@code CloneNotSupportedException} object instead of an + * {@code SQLException} object, as the method {@code createShared} + * does. This {@code clone} + * method is called internally by the method {@code createShared}, + * which catches the {@code CloneNotSupportedException} object + * and in turn throws a new {@code SQLException} object. * - * @return a copy of this CachedRowSetImpl object + * @return a copy of this {@code CachedRowSetImpl} object * @throws CloneNotSupportedException if an error occurs when - * attempting to clone this CachedRowSetImpl object + * attempting to clone this {@code CachedRowSetImpl} object * @see #createShared */ protected Object clone() throws CloneNotSupportedException { @@ -770,8 +770,8 @@ } /** - * Creates a RowSet object that is a deep copy of - * this CachedRowSetImpl object's data, including + * Creates a {@code RowSet} object that is a deep copy of + * this {@code CachedRowSetImpl} object's data, including * constraints. Updates made * on a copy are not visible to the original rowset; * a copy of a rowset is completely independent from the original. @@ -780,12 +780,12 @@ * from first principles, which can be quite expensive. * For example, it can eliminate the need to query a * remote database server. - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSet object and is - * completely independent from this CachedRowSetImpl + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSet} object and is + * completely independent from this {@code CachedRowSetImpl} * object. * @throws SQLException if an error occurs in generating the copy of this - * of the CachedRowSetImpl + * of the {@code CachedRowSetImpl} * @see #createShared * @see javax.sql.RowSetEvent * @see javax.sql.RowSetListener @@ -795,21 +795,21 @@ } /** - * Creates a RowSet object that is a copy of - * this CachedRowSetImpl object's table structure + * Creates a {@code RowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's table structure * and the constraints only. * There will be no data in the object being returned. * Updates made on a copy are not visible to the original rowset. * * This helps in getting the underlying XML schema which can - * be used as the basis for populating a WebRowSet. + * be used as the basis for populating a {@code WebRowSet}. * - * @return a new CachedRowSet object that is a copy - * of this CachedRowSetImpl object's schema and + * @return a new {@code CachedRowSet} object that is a copy + * of this {@code CachedRowSetImpl} object's schema and * retains all the constraints on the original rowset but contains * no data * @throws SQLException if an error occurs in generating the copy - * of the CachedRowSet object + * of the {@code CachedRowSet} object * @see #createShared * @see #createCopy * @see #createCopyNoConstraints @@ -821,17 +821,17 @@ } /** - * Creates a CachedRowSet object that is a copy of - * this CachedRowSetImpl object's data only. + * Creates a {@code CachedRowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's data only. * All constraints set in this object will not be there * in the returning object. Updates made * on a copy are not visible to the original rowset. * - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSetImpl object and is - * completely independent from this CachedRowSetImpl object + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSetImpl} object and is + * completely independent from this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the copy of the - * of the CachedRowSet + * of the {@code CachedRowSet} * @see #createShared * @see #createCopy * @see #createCopySchema @@ -843,15 +843,15 @@ } /** - * Converts this CachedRowSetImpl object to a collection - * of tables. The sample implementation utilitizes the TreeMap + * Converts this {@code CachedRowSetImpl} object to a collection + * of tables. The sample implementation utilitizes the {@code TreeMap} * collection type. * This class guarantees that the map will be in ascending key order, * sorted according to the natural order for the key's class. * - * @return a Collection object consisting of tables, + * @return a {@code Collection} object consisting of tables, * each of which is a copy of a row in this - * CachedRowSetImpl object + * {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the collection * @see #toCollection(int) * @see #toCollection(String) @@ -863,16 +863,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -886,16 +886,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -914,25 +914,25 @@ /** - * Returns the SyncProvider implementation being used - * with this CachedRowSetImpl implementation rowset. + * Returns the {@code SyncProvider} implementation being used + * with this {@code CachedRowSetImpl} implementation rowset. * * @return the SyncProvider used by the rowset. If not provider was * set when the rowset was instantiated, the reference * implementation (default) provider is returned. * @throws SQLException if error occurs while return the - * SyncProvider instance. + * {@code SyncProvider} instance. */ public SyncProvider getSyncProvider() throws SQLException { throw new UnsupportedOperationException(); } /** - * Sets the active SyncProvider and attempts to load - * load the new provider using the SyncFactory SPI. + * Sets the active {@code SyncProvider} and attempts to load + * load the new provider using the {@code SyncFactory} SPI. * * @throws SQLException if an error occurs while resetting the - * SyncProvider. + * {@code SyncProvider}. */ public void setSyncProvider(String providerStr) throws SQLException { throw new UnsupportedOperationException(); @@ -953,23 +953,23 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data. + * Populates this {@code CachedRowSetImpl} object with data. * This form of the method uses the rowset's user, password, and url or * data source name properties to create a database * connection. If properties that are needed * have not been set, this method will throw an exception. * - * Another form of this method uses an existing JDBC Connection + * Another form of this method uses an existing JDBC {@code Connection} * object instead of creating a new one; therefore, it ignores the * properties used for establishing a new connection. * * The query specified by the command property is executed to create a - * ResultSet object from which to retrieve data. + * {@code ResultSet} object from which to retrieve data. * The current contents of the rowset are discarded, and the * rowset's metadata is also (re)set. If there are outstanding updates, * they are also ignored. * - * The method execute closes any database connections that it + * The method {@code execute} closes any database connections that it * creates. * * @throws SQLException if an error occurs or the @@ -987,20 +987,20 @@ /** * Moves the cursor down one row from its current position and - * returns true if the new cursor position is a + * returns {@code true} if the new cursor position is a * valid row. - * The cursor for a new ResultSet object is initially + * The cursor for a new {@code ResultSet} object is initially * positioned before the first row. The first call to the method - * next moves the cursor to the first row, making it + * {@code next} moves the cursor to the first row, making it * the current row; the second call makes the second row the * current row, and so on. * * If an input stream from the previous row is open, it is - * implicitly closed. The ResultSet object's warning + * implicitly closed. The {@code ResultSet} object's warning * chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if an error occurs or * the cursor is not positioned in the rowset, before * the first row, or after the last row @@ -1010,9 +1010,9 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the next - * row and returns true if the cursor is still in the rowset; - * returns false if the cursor has moved to the position after + * Moves this {@code CachedRowSetImpl} object's cursor to the next + * row and returns {@code true} if the cursor is still in the rowset; + * returns {@code false} if the cursor has moved to the position after * the last row. * * This method handles the cases where the cursor moves to a row that @@ -1021,15 +1021,15 @@ * that has been deleted, this method moves the cursor to the next * row until the cursor is on a row that has not been deleted. * - * The method internalNext is called by methods such as - * next, absolute, and relative, + * The method {@code internalNext} is called by methods such as + * {@code next}, {@code absolute}, and {@code relative}, * and, as its name implies, is only called internally. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a valid row in this - * rowset; false if it is after the last row + * @return {@code true} if the cursor is on a valid row in this + * rowset; {@code false} if it is after the last row * @throws SQLException if an error occurs */ protected boolean internalNext() throws SQLException { @@ -1037,25 +1037,25 @@ } /** - * Closes this CachedRowSetImpl objecy and releases any resources + * Closes this {@code CachedRowSetImpl} objecy and releases any resources * it was using. * * @throws SQLException if an error occurs when releasing any resources in use - * by this CachedRowSetImpl object + * by this {@code CachedRowSetImpl} object */ public void close() throws SQLException { throw new UnsupportedOperationException(); } /** - * Reports whether the last column read was SQL NULL. - * Note that you must first call the method getXXX + * Reports whether the last column read was SQL {@code NULL}. + * Note that you must first call the method {@code getXXX} * on a column to try to read its value and then call the method - * wasNull to determine whether the value was - * SQL NULL. + * {@code wasNull} to determine whether the value was + * SQL {@code NULL}. * - * @return true if the value in the last column read - * was SQL NULL; false otherwise + * @return {@code true} if the value in the last column read + * was SQL {@code NULL}; {@code false} otherwise * @throws SQLException if an error occurs */ public boolean wasNull() throws SQLException { @@ -1064,9 +1064,9 @@ /** * Returns the insert row or the current row of this - * CachedRowSetImplobject. + * {@code CachedRowSetImpl}object. * - * @return the Row object on which this CachedRowSetImpl + * @return the {@code Row} object on which this {@code CachedRowSetImpl} * objects's cursor is positioned */ protected BaseRow getCurrentRow() { @@ -1077,7 +1077,7 @@ * Removes the row on which the cursor is positioned. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * * @throws SQLException if the cursor is positioned on the insert * row @@ -1089,20 +1089,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * String object. + * of this {@code CachedRowSetImpl} object as a + * {@code String} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} {@code CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type designates the * recommended return type. */ public String getString(int columnIndex) throws SQLException { @@ -1111,18 +1111,18 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * boolean value. + * of this {@code CachedRowSetImpl} object as a + * {@code boolean} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a boolean in the Java progamming language; - * if the value is SQL NULL, the result is false + * @return the column value as a {@code boolean} in the Java progamming language; + * if the value is SQL {@code NULL}, the result is {@code false} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BOOLEAN value + * SQL {@code BOOLEAN} value * @see #getBoolean(String) */ public boolean getBoolean(int columnIndex) throws SQLException { @@ -1131,20 +1131,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type + * SQL {@code TINYINT}, {@code SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type * designates the recommended return type. * @see #getByte(String) */ @@ -1154,21 +1154,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * short value. + * of this {@code CachedRowSetImpl} object as a + * {@code short} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT}, {@code SMALLINT}, + * {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(String) */ public short getShort(int columnIndex) throws SQLException { @@ -1177,21 +1178,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * int value. + * of this {@code CachedRowSetImpl} object as an + * {@code int} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1199,21 +1201,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * long value. + * of this {@code CachedRowSetImpl} object as a + * {@code long} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getLong(String) */ public long getLong(int columnIndex) throws SQLException { @@ -1222,21 +1225,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * float value. + * of this {@code CachedRowSetImpl} object as a + * {@code float} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,} + * {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC, + * BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(int columnIndex) throws SQLException { @@ -1245,21 +1248,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * double value. + * of this {@code CachedRowSetImpl} object as a + * {@code double} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,} + * {@code FLOAT, DOUBLE}, + * {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getDouble(String) * */ @@ -1269,21 +1273,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * This method is deprecated; use the version of getBigDecimal + * This method is deprecated; use the version of {@code getBigDecimal} * that does not take a scale parameter and returns a value with full * precision. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @param scale the number of digits to the right of the decimal point in the * value returned * @return the column value with the specified number of digits to the right - * of the decimal point; if the value is SQL NULL, the - * result is null + * of the decimal point; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails * @deprecated @@ -1295,22 +1299,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte array value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} array value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the - * result is null + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the + * result is {@code null} * * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or + * {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getBytes(String) */ public byte[] getBytes(int columnIndex) throws SQLException { @@ -1319,17 +1323,17 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Date object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Date} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a java.sql.Data object; if - * the value is SQL NULL, the - * result is null + * @return the column value as a {@code java.sql.Data} object; if + * the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, - * the cursor is not on a valid row, or this method fails + * the cursor is not on a valid row, or this method fails */ public java.sql.Date getDate(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1337,14 +1341,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Time object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Time} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1354,14 +1358,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1371,33 +1375,33 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The JDBC + * suitable for retrieving large {@code LONGVARCHAR} values. The JDBC * driver will do any necessary conversion from the database format into ASCII. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. . Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(String) */ public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException { @@ -1416,8 +1420,8 @@ * stream may return 0 for available() whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of two byte Unicode characters. If the value is SQL NULL @@ -1432,30 +1436,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for - * CachedRowSetImpl.available() whether there is data + * stream may return {@code 0} for + * {@code CachedRowSetImpl.available()} whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes. If the value is SQL NULL - * then the result is null. + * as a stream of uninterpreted bytes. If the value is SQL {@code NULL} + * then the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY}. * The bold type indicates the SQL type that this method is recommened * to retrieve. * @see #getBinaryStream(String) @@ -1472,19 +1476,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a String object. + * of the current row as a {@code String} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR< value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} + * {@code CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. */ public String getString(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1492,17 +1496,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a boolean value. + * of the current row as a {@code boolean} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a boolean in the Java programming - * language; if the value is SQL NULL, - * the result is false + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code boolean} in the Java programming + * language; if the value is SQL {@code NULL}, + * the result is {@code false} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BOOLEAN value + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BOOLEAN} value * @see #getBoolean(int) */ public boolean getBoolean(String columnName) throws SQLException { @@ -1511,19 +1515,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte value. + * of the current row as a {@code byte} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The - * bold type designates the recommended return type + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT}, + * {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} + * value. The bold type designates the recommended return type. */ public byte getByte(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1531,19 +1535,20 @@ /** * Retrieves the value stored in the designated column - * of the current row as a short value. + * of the current row as a {@code short} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT,} + * {@code SMALLINT}, {@code INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(int) */ public short getShort(String columnName) throws SQLException { @@ -1552,20 +1557,21 @@ /** * Retrieves the value stored in the designated column - * of the current row as an int value. + * of the current row as an {@code int} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name - * of a column in this rowset, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * of a column in this rowset, + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1573,19 +1579,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a long value. + * of the current row as a {@code long} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getLong(int) */ public long getLong(String columnName) throws SQLException { @@ -1594,19 +1600,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a float value. + * of the current row as a {@code float} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT,} {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(String columnName) throws SQLException { @@ -1615,20 +1621,20 @@ /** * Retrieves the value stored in the designated column - * of the current row of this CachedRowSetImpl object - * as a double value. + * of the current row of this {@code CachedRowSetImpl} object + * as a {@code double} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return types. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL,} {@code FLOAT, DOUBLE}, {@code DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return types. * @see #getDouble(int) */ public double getDouble(String columnName) throws SQLException { @@ -1637,22 +1643,22 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.math.BigDecimal object. + * of the current row as a {@code java.math.BigDecimal} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @param scale the number of digits to the right of the decimal point - * @return a java.math.BugDecimal object with scale - * number of digits to the right of the decimal point. + * @return a java.math.BugDecimal object with {@code scale} + * number of digits to the right of the decimal point. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve. - * @deprecated Use the getBigDecimal(String columnName) + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. + * @deprecated Use the {@code getBigDecimal(String columnName)} * method instead */ @Deprecated @@ -1662,19 +1668,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte array. + * of the current row as a {@code byte} array. * The bytes represent the raw values returned by the driver. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BINARY, VARBINARY - * or LONGVARBINARY values - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BINARY, VARBINARY} + * or {@code LONGVARBINARY} values. + * The bold SQL type designates the recommended return type. * @see #getBytes(int) */ public byte[] getBytes(String columnName) throws SQLException { @@ -1683,17 +1689,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Date object. + * of the current row as a {@code java.sql.Date} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1701,12 +1707,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Time object. + * of the current row as a {@code java.sql.Time} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1717,12 +1723,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Timestamp object. + * of the current row as a {@code java.sql.Timestamp} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1733,32 +1739,32 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The - * SyncProvider will rely on the JDBC driver to do any necessary + * suitable for retrieving large {@code LONGVARCHAR} values. The + * {@code SyncProvider} will rely on the JDBC driver to do any necessary * conversion from the database format into ASCII format. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * a column in this rowset + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(int) */ public java.io.InputStream getAsciiStream(String columnName) throws SQLException { @@ -1769,23 +1775,23 @@ /** * A column value can be retrieved as a stream of Unicode characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will do any necessary conversion from the database * format into Unicode. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row - * @deprecated use the method getCharacterStream instead + * @deprecated use the method {@code getCharacterStream} instead */ @Deprecated public java.io.InputStream getUnicodeStream(String columnName) throws SQLException { @@ -1794,30 +1800,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * * Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of uninterpreted bytes. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is unknown, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY - * The bold type indicates the SQL type that this method is recommened - * to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY} + * The bold type indicates the SQL type that this method is recommened + * to retrieve. * @see #getBinaryStream(int) * */ @@ -1831,17 +1837,17 @@ //===================================================================== /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by statement + * by {@code ResultSet} methods. Any warning caused by statement * methods (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * * @return the first SQLWarning or null */ @@ -1850,10 +1856,10 @@ } /** - * Clears all the warnings reporeted for the CachedRowSetImpl - * object. After a call to this method, the getWarnings method - * returns null until a new warning is reported for this - * CachedRowSetImpl object. + * Clears all the warnings reporeted for the {@code CachedRowSetImpl} + * object. After a call to this method, the {@code getWarnings} method + * returns {@code null} until a new warning is reported for this + * {@code CachedRowSetImpl} object. */ public void clearWarnings() { throw new UnsupportedOperationException(); @@ -1861,25 +1867,25 @@ /** * Retrieves the name of the SQL cursor used by this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * * In SQL, a result table is retrieved through a cursor that is - * named. The current row of a ResultSet can be updated or deleted + * named. The current row of a {@code ResultSet} can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To ensure that the cursor has the proper isolation - * level to support an update operation, the cursor's SELECT - * statement should be of the form select for update. - * If the for update clause + * level to support an update operation, the cursor's {@code SELECT} + * statement should be of the form {@code select for update}. + * If the {@code for update} clause * is omitted, positioned updates may fail. * * JDBC supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. The current row + * SQL cursor used by a {@code ResultSet} object. The current row * of a result set is also the current row of this SQL cursor. * * Note: If positioned updates are not supported, an - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL cursor name for this CachedRowSetImpl object's + * @return the SQL cursor name for this {@code CachedRowSetImpl} object's * cursor * @throws SQLException if an error occurs */ @@ -1888,12 +1894,12 @@ } /** - * Retrieves a ResultSetMetaData object instance that - * contains information about the CachedRowSet object. + * Retrieves a {@code ResultSetMetaData} object instance that + * contains information about the {@code CachedRowSet} object. * However, applications should cast the returned object to a - * RowSetMetaData interface implementation. In the + * {@code RowSetMetaData} interface implementation. In the * reference implementation, this cast can be done on the - * RowSetMetaDataImpl class. + * {@code RowSetMetaDataImpl} class. * * For example: * @@ -1907,10 +1913,10 @@ * crs.setMetaData(metaData); * * - * @return the ResultSetMetaData object that describes this - * CachedRowSetImpl object's columns + * @return the {@code ResultSetMetaData} object that describes this + * {@code CachedRowSetImpl} object's columns * @throws SQLException if an error occurs in generating the RowSet - * meta data; or if the CachedRowSetImpl is empty. + * meta data; or if the {@code CachedRowSetImpl} is empty. * @see javax.sql.RowSetMetaData */ public ResultSetMetaData getMetaData() throws SQLException { @@ -1920,10 +1926,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1931,23 +1937,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes in the Java programming language. * When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(String) */ public Object getObject(int columnIndex) throws SQLException { @@ -1956,10 +1962,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. * - * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1967,23 +1973,23 @@ * This method may also be used to read datatabase-specific * abstract data types. * - * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes * in the Java programming language. When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name does not match one of * this rowset's column names, (2) the cursor is not * on a valid row, or (3) there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(int) */ public Object getObject(String columnName) throws SQLException { @@ -1993,10 +1999,10 @@ //---------------------------------------------------------------- /** - * Maps the given column name for one of this CachedRowSetImpl + * Maps the given column name for one of this {@code CachedRowSetImpl} * object's columns to its column number. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @return the column index of the given column name * @throws SQLException if the given column name does not match one @@ -2014,25 +2020,25 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java character stream that delivers the database column value * as a stream of two-byte unicode characters in a - * java.io.Reader object. If the value is - * SQL NULL, the result is null. + * {@code java.io.Reader} object. If the value is + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR,} {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getCharacterStream(String) */ public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{ @@ -2041,23 +2047,24 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * * Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY or LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code CHAR, VARCHAR,} + * {@code LONGVARCHAR}, + * {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -2065,21 +2072,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return types that this method is used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return types that this method is used to retrieve. * @see #getBigDecimal(String) */ public BigDecimal getBigDecimal(int columnIndex) throws SQLException { @@ -2088,21 +2096,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. * @see #getBigDecimal(int) */ public BigDecimal getBigDecimal(String columnName) throws SQLException { @@ -2114,7 +2122,7 @@ //--------------------------------------------------------------------- /** - * Returns the number of rows in this CachedRowSetImpl object. + * Returns the number of rows in this {@code CachedRowSetImpl} object. * * @return number of rows in the rowset */ @@ -2124,10 +2132,10 @@ /** * Indicates whether the cursor is before the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is before the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isBeforeFirst() throws SQLException { @@ -2136,10 +2144,10 @@ /** * Indicates whether the cursor is after the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is after the last row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isAfterLast() throws SQLException { @@ -2148,10 +2156,10 @@ /** * Indicates whether the cursor is on the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is on the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isFirst() throws SQLException { @@ -2160,14 +2168,14 @@ /** * Indicates whether the cursor is on the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * Note: Calling the method isLast may be expensive + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver might need to fetch ahead one row in order * to determine whether the current row is the last row in this rowset. * - * @return true if the cursor is on the last row; - * false otherwise or if this rowset contains no rows + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise or if this rowset contains no rows * @throws SQLException if an error occurs */ public boolean isLast() throws SQLException { @@ -2175,19 +2183,19 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the front of + * Moves this {@code CachedRowSetImpl} object's cursor to the front of * the rowset, just before the first row. This method has no effect if * this rowset contains no rows. * * @throws SQLException if an error occurs or the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public void beforeFirst() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the end of + * Moves this {@code CachedRowSetImpl} object's cursor to the end of * the rowset, just after the last row. This method has no effect if * this rowset contains no rows. * @@ -2198,34 +2206,34 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the first row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the first row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean first() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the first - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the first + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the methods first, - * isFirst, and absolute. - * It in turn calls the method internalNext in order to + * This method is called internally by the methods {@code first}, + * {@code isFirst}, and {@code absolute}. + * It in turn calls the method {@code internalNext} in order to * handle the case where the first row is a deleted row that is not visible. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the first row; - * false otherwise + * @return {@code true} if the cursor moved to the first row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalFirst() throws SQLException { @@ -2233,35 +2241,35 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the last row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the last row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean last() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the last - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the last + * row and returns {@code true} if the operation is successful. * - * This method is called internally by the method last + * This method is called internally by the method {@code last} * when rows have been deleted and the deletions are not visible. - * The method internalLast handles the case where the + * The method {@code internalLast} handles the case where the * last row is a deleted row that is not visible by in turn calling - * the method internalPrevious. + * the method {@code internalPrevious}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the last row; - * false otherwise + * @return {@code true} if the cursor moved to the last row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalLast() throws SQLException { @@ -2269,12 +2277,12 @@ } /** - * Returns the number of the current row in this CachedRowSetImpl + * Returns the number of the current row in this {@code CachedRowSetImpl} * object. The first row is number 1, the second number 2, and so on. * - * @return the number of the current row; 0 if there is no + * @return the number of the current row; {@code 0} if there is no * current row - * @throws SQLException if an error occurs; or if the CacheRowSetImpl + * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl} * is empty */ public int getRow() throws SQLException { @@ -2282,51 +2290,51 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the row number + * Moves this {@code CachedRowSetImpl} object's cursor to the row number * specified. * * If the number is positive, the cursor moves to an absolute row with * respect to the beginning of the rowset. The first row is row 1, the second * is row 2, and so on. For example, the following command, in which - * crs is a CachedRowSetImpl object, moves the cursor + * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor * to the fourth row, starting from the beginning of the rowset. - * + * {@code * * crs.absolute(4); * - * + * } * * If the number is negative, the cursor moves to an absolute row position * with respect to the end of the rowset. For example, calling - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row, counting * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. * * @param row a positive number to indicate the row, starting row numbering from - * the first row, which is 1; a negative number to indicate + * the first row, which is {@code 1}; a negative number to indicate * the row, starting row numbering from the last row, which is - * -1; it must not be 0 - * @return true if the cursor is on the rowset; false + * {@code -1}; it must not be {@code 0} + * @return {@code true} if the cursor is on the rowset; {@code false} * otherwise - * @throws SQLException if the given cursor position is 0 or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * @throws SQLException if the given cursor position is {@code 0} or the + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean absolute( int row ) throws SQLException { throw new UnsupportedOperationException(); @@ -2340,80 +2348,80 @@ * If the number is positive, the cursor moves the specified number of * rows toward the end of the rowset, starting at the current row. * For example, the following command, in which - * crs is a CachedRowSetImpl object with 100 rows, + * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows, * moves the cursor forward four rows from the current row. If the * current row is 50, the cursor would move to row 54. - * + * {@code * * crs.relative(4); * - * + * } * * If the number is negative, the cursor moves back toward the beginning * the specified number of rows, starting at the current row. * For example, calling the method - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row * from the beginning. - * + * {@code * * crs.absolute(-4); * - * + * } * * If the number specified is larger than the number of rows, the cursor * will move to the position after the last row. If the number specified * would move the cursor one or more rows before the first row, the cursor * moves to the position before the first row. In both cases, this method - * throws an SQLException. + * throws an {@code SQLException}. * - * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). Calling relative(0) + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. Calling {@code relative(0)} * is valid, but it does not change the cursor position. * - * @param rows an int indicating the number of rows to move + * @param rows an {@code int} indicating the number of rows to move * the cursor, starting at the current row; a positive number * moves the cursor forward; a negative number moves the cursor * backward; must not move the cursor past the valid * rows - * @return true if the cursor is on a row in this - * CachedRowSetImpl object; false + * @return {@code true} if the cursor is on a row in this + * {@code CachedRowSetImpl} object; {@code false} * otherwise * @throws SQLException if there are no rows in this rowset, the cursor is * positioned either before the first row or after the last row, or - * the rowset is type ResultSet.TYPE_FORWARD_ONLY + * the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean relative(int rows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the - * previous row and returns true if the cursor is on - * a valid row or false if it is not. + * Moves this {@code CachedRowSetImpl} object's cursor to the + * previous row and returns {@code true} if the cursor is on + * a valid row or {@code false} if it is not. * This method also notifies all listeners registered with this - * CachedRowSetImpl object that its cursor has moved. + * {@code CachedRowSetImpl} object that its cursor has moved. * - * Note: calling the method previous() is not the same - * as calling the method relative(-1). This is true - * because it is possible to call previous() from the insert + * Note: calling the method {@code previous()} is not the same + * as calling the method {@code relative(-1)}. This is true + * because it is possible to call {@code previous()} from the insert * row, from after the last row, or from the current row, whereas - * relative may only be called from the current row. + * {@code relative} may only be called from the current row. * - * The method previous may used in a while + * The method {@code previous} may used in a {@code while} * loop to iterate through a rowset starting after the last row - * and moving toward the beginning. The loop ends when previous - * returns false, meaning that there are no more rows. + * and moving toward the beginning. The loop ends when {@code previous} + * returns {@code false}, meaning that there are no more rows. * For example, the following code fragment retrieves all the data in - * the CachedRowSetImpl object crs, which has + * the {@code CachedRowSetImpl} object {@code crs}, which has * three columns. Note that the cursor must initially be positioned * after the last row so that the first call to the method - * previous places the cursor on the last line. - * + * {@code previous} places the cursor on the last line. + * {@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - * - * This method throws an SQLException if the cursor is not + * } + * This method throws an {@code SQLException} if the cursor is not * on a row in the rowset, before the first row, or after the last row. * - * @return true if the cursor is on a valid row; - * false if it is before the first row or after the + * @return {@code true} if the cursor is on a valid row; + * {@code false} if it is before the first row or after the * last row * @throws SQLException if the cursor is not on a valid position or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean previous() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor to the previous row in this CachedRowSetImpl + * Moves the cursor to the previous row in this {@code CachedRowSetImpl} * object, skipping past deleted rows that are not visible; returns - * true if the cursor is on a row in this rowset and - * false when the cursor goes before the first row. + * {@code true} if the cursor is on a row in this rowset and + * {@code false} when the cursor goes before the first row. * - * This method is called internally by the method previous. + * This method is called internally by the method {@code previous}. * * This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a row in this rowset; - * false when the cursor reaches the position before + * @return {@code true} if the cursor is on a row in this rowset; + * {@code false} when the cursor reaches the position before * the first row * @throws SQLException if an error occurs */ @@ -2463,14 +2471,14 @@ //--------------------------------------------------------------------- /** - * Indicates whether the current row of this CachedRowSetImpl + * Indicates whether the current row of this {@code CachedRowSetImpl} * object has been updated. The value returned - * depends on whether this rowset can detect updates: false + * depends on whether this rowset can detect updates: {@code false} * will always be returned if it does not detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another and updates are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2482,13 +2490,13 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * * @param idx the index identifier of the column that may be have been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2500,14 +2508,14 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * - * @param columnName the String column name column that may be have + * @param columnName the {@code String} column name column that may be have * been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2521,8 +2529,8 @@ * Indicates whether the current row has been inserted. The value returned * depends on whether or not the rowset can detect visible inserts. * - * @return true if a row has been inserted and inserts are detected; - * false otherwise + * @return {@code true} if a row has been inserted and inserts are detected; + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2536,12 +2544,12 @@ * Indicates whether the current row has been deleted. A deleted row * may leave a visible "hole" in a rowset. This method can be used to * detect such holes if the rowset can detect deletions. This method - * will always return false if this rowset cannot detect + * will always return {@code false} if this rowset cannot detect * deletions. * - * @return true if (1)the current row is blank, indicating that + * @return {@code true} if (1)the current row is blank, indicating that * the row has been deleted, and (2)deletions are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on a valid row in this rowset * @see DatabaseMetaData#deletesAreDetected */ @@ -2551,8 +2559,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset; however, another method must be called to complete @@ -2565,15 +2573,15 @@ * * In order to propagate updates in this rowset to the underlying * data source, an application must call the method {@link #acceptChanges} - * after it calls either updateRow or insertRow. + * after it calls either {@code updateRow} or {@code insertRow}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -2581,8 +2589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2593,14 +2601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(int columnIndex, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -2608,8 +2616,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2620,14 +2628,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(int columnIndex, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -2635,8 +2643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2647,14 +2655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(int columnIndex, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -2662,8 +2670,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2674,14 +2682,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(int columnIndex, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -2689,8 +2697,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2701,14 +2709,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(int columnIndex, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -2717,8 +2725,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2729,14 +2737,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(int columnIndex, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -2744,8 +2752,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2756,14 +2764,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(int columnIndex, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -2771,8 +2779,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2783,14 +2791,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -2798,8 +2806,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2810,17 +2818,17 @@ * as inserted. Both of these methods must be called before the * cursor moves to another row. * - * The method acceptChanges must be called if the + * The method {@code acceptChanges} must be called if the * updated values are to be written back to the underlying database. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(int columnIndex, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -2828,8 +2836,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2840,14 +2848,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(int columnIndex, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -2855,8 +2863,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2867,15 +2875,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(int columnIndex, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -2883,8 +2891,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2895,15 +2903,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL TIME or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code TIME} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(int columnIndex, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -2911,8 +2919,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2923,16 +2931,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE, TIME, or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE}, {@code TIME}, or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -2940,7 +2948,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -2952,8 +2960,8 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -2965,8 +2973,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2977,17 +2985,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not binary, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException { throw new UnsupportedOperationException(); @@ -2995,8 +3003,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3007,19 +3015,19 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.Reader - * containing BINARY, VARBINARY, - * LONGVARBINARY, CHAR, VARCHAR, - * or LONGVARCHAR data + * @param x the new column value; must be a {@code java.io.Reader} + * containing {@code BINARY}, {@code VARBINARY}, + * {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR}, + * or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not a binary or * character type, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3027,11 +3035,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter indicates + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter indicates * the number of digits to the right of the decimal point and is ignored * if the new column value is not a type that will be mapped to an SQL - * DECIMAL or NUMERIC value. + * {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3042,16 +3050,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3059,8 +3067,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3071,14 +3079,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x) throws SQLException { throw new UnsupportedOperationException(); @@ -3087,8 +3095,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3098,12 +3106,12 @@ * must be called, which will insert the new row into both this rowset * and the database. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -3111,8 +3119,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3123,13 +3131,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(String columnName, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -3137,8 +3145,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3149,13 +3157,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(String columnName, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -3163,8 +3171,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3175,13 +3183,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(String columnName, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -3189,8 +3197,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3201,13 +3209,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(String columnName, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -3215,8 +3223,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3227,13 +3235,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(String columnName, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -3241,8 +3249,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3253,13 +3261,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(String columnName, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -3267,8 +3275,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3279,13 +3287,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(String columnName, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -3293,8 +3301,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. * * This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3305,13 +3313,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -3319,8 +3327,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3331,13 +3339,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(String columnName, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -3345,8 +3353,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3357,13 +3365,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(String columnName, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -3371,8 +3379,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3383,15 +3391,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(String columnName, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -3399,8 +3407,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3411,15 +3419,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL TIME or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code TIME} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(String columnName, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -3427,8 +3435,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3439,7 +3447,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if the given column index is out of bounds or @@ -3448,9 +3456,9 @@ * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE, - * TIME, or TIMESTAMP, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP}, or (4) this + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -3458,7 +3466,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. * * This method updates a column value in either the current row or @@ -3470,7 +3478,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -3483,8 +3491,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3495,17 +3503,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not binary, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3513,8 +3521,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3525,18 +3533,18 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param reader the new column value; must be a - * java.io.Reader containing BINARY, - * VARBINARY, LONGVARBINARY, CHAR, - * VARCHAR, or LONGVARCHAR data + * {@code java.io.Reader} containing {@code BINARY}, + * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR}, + * {@code VARCHAR}, or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not a binary or character type, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(String columnName, java.io.Reader reader, @@ -3546,11 +3554,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter * indicates the number of digits to the right of the decimal point * and is ignored if the new column value is not a type that will be - * mapped to an SQL DECIMAL or NUMERIC value. + * mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3561,15 +3569,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3577,8 +3585,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3589,20 +3597,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x) throws SQLException { throw new UnsupportedOperationException(); } /** - * Inserts the contents of this CachedRowSetImpl object's insert + * Inserts the contents of this {@code CachedRowSetImpl} object's insert * row into this rowset immediately following the current row. * If the current row is the * position after the last row or before the first row, the new row will @@ -3614,14 +3622,14 @@ * @throws SQLException if (1) the cursor is not on the insert row, * (2) one or more of the non-nullable columns in the insert * row has not been given a value, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void insertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Marks the current row of this CachedRowSetImpl object as + * Marks the current row of this {@code CachedRowSetImpl} object as * updated and notifies listeners registered with this rowset that the * row has changed. * @@ -3631,26 +3639,26 @@ * and the updates made before the cursor moved will be lost. * * @throws SQLException if the cursor is on the insert row or this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Deletes the current row from this CachedRowSetImpl object and + * Deletes the current row from this {@code CachedRowSetImpl} object and * notifies listeners registered with this rowset that a row has changed. * This method cannot be called when the cursor is on the insert row. * * This method marks the current row as deleted, but it does not delete * the row from the underlying data source. The method - * acceptChanges must be called to delete the row in + * {@code acceptChanges} must be called to delete the row in * the data source. * * @throws SQLException if (1) this method is called when the cursor * is on the insert row, before the first row, or after the * last row or (2) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void deleteRow() throws SQLException { throw new UnsupportedOperationException(); @@ -3659,7 +3667,7 @@ /** * Sets the current row with its original value and marks the row as * not updated, thus undoing any changes made to the row since the - * last call to the methods updateRow or deleteRow. + * last call to the methods {@code updateRow} or {@code deleteRow}. * This method should be called only when the cursor is on a row in * this rowset. * @@ -3672,11 +3680,11 @@ /** * Rolls back any updates made to the current row of this - * CachedRowSetImpl object and notifies listeners that + * {@code CachedRowSetImpl} object and notifies listeners that * a row has changed. To have an effect, this method - * must be called after an updateXXX method has been - * called and before the method updateRow has been called. - * If no updates have been made or the method updateRow + * must be called after an {@code updateXXX} method has been + * called and before the method {@code updateRow} has been called. + * If no updates have been made or the method {@code updateRow} * has already been called, this method has no effect. * * @throws SQLException if the cursor is on the insert row, before the @@ -3687,39 +3695,39 @@ } /** - * Moves the cursor for this CachedRowSetImpl object + * Moves the cursor for this {@code CachedRowSetImpl} object * to the insert row. The current row in the rowset is remembered * while the cursor is on the insert row. * * The insert row is a special row associated with an updatable * rowset. It is essentially a buffer where a new row may - * be constructed by calling the appropriate updateXXX + * be constructed by calling the appropriate {@code updateXXX} * methods to assign a value to each column in the row. A complete * row must be constructed; that is, every column that is not nullable * must be assigned a value. In order for the new row to become part - * of this rowset, the method insertRow must be called + * of this rowset, the method {@code insertRow} must be called * before the cursor is moved back to the rowset. * * Only certain methods may be invoked while the cursor is on the insert * row; many methods throw an exception if they are called while the - * cursor is there. In addition to the updateXXX - * and insertRow methods, only the getXXX methods - * may be called when the cursor is on the insert row. A getXXX - * method should be called on a column only after an updateXXX + * cursor is there. In addition to the {@code updateXXX} + * and {@code insertRow} methods, only the {@code getXXX} methods + * may be called when the cursor is on the insert row. A {@code getXXX} + * method should be called on a column only after an {@code updateXXX} * method has been called on that column; otherwise, the value returned is * undetermined. * - * @throws SQLException if this CachedRowSetImpl object is - * ResultSet.CONCUR_READ_ONLY + * @throws SQLException if this {@code CachedRowSetImpl} object is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void moveToInsertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor for this CachedRowSetImpl object to + * Moves the cursor for this {@code CachedRowSetImpl} object to * the current row. The current row is the row the cursor was on - * when the method moveToInsertRow was called. + * when the method {@code moveToInsertRow} was called. * * Calling this method has no effect unless it is called while the * cursor is on the insert row. @@ -3731,9 +3739,9 @@ } /** - * Returns null. + * Returns {@code null}. * - * @return null + * @return {@code null} * @throws SQLException if an error occurs */ public Statement getStatement() throws SQLException { @@ -3742,18 +3750,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column index is out of bounds or * the cursor is not on one of this rowset's rows or its * insert row @@ -3767,17 +3775,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL REF value + * SQL {@code REF} value * @see #getRef(String) */ public Ref getRef(int columnIndex) throws SQLException { @@ -3786,17 +3794,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BLOB value + * SQL {@code BLOB} value * @see #getBlob(String) */ public Blob getBlob(int columnIndex) throws SQLException { @@ -3805,17 +3813,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Clob object representing an SQL CLOB value + * @return a {@code Clob} object representing an SQL {@code CLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL CLOB value + * SQL {@code CLOB} value * @see #getClob(String) */ public Clob getClob(int columnIndex) throws SQLException { @@ -3824,18 +3832,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL ARRAY value + * SQL {@code ARRAY} value * @see #getArray(String) */ public Array getArray(int columnIndex) throws SQLException { @@ -3844,17 +3852,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column name is not the name of * a column in this rowset or the cursor is not on one of * this rowset's rows or its insert row @@ -3867,16 +3875,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the column value - * is not an SQL REF value + * is not an SQL {@code REF} value * @see #getRef(int) */ public Ref getRef(String colName) throws SQLException { @@ -3885,16 +3893,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BLOB value + * column does not store an SQL {@code BLOB} value * @see #getBlob(int) */ public Blob getBlob(String colName) throws SQLException { @@ -3903,17 +3911,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Clob object representing an SQL - * CLOB value + * @return a {@code Clob} object representing an SQL + * {@code CLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CLOB value + * column does not store an SQL {@code CLOB} value * @see #getClob(int) */ public Clob getClob(String colName) throws SQLException { @@ -3922,17 +3930,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming langugage. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL ARRAY value + * column does not store an SQL {@code ARRAY} value * @see #getArray(int) */ public Array getArray(String colName) throws SQLException { @@ -3941,22 +3949,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3964,21 +3972,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3986,22 +3994,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4009,21 +4017,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4031,22 +4039,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Timestamp - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4054,22 +4062,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object, using the given - * Calendar object to construct an appropriate + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object, using the given + * {@code Calendar} object to construct an appropriate * millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE, - * TIME, or TIMESTAMP value + * column does not store an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4080,13 +4088,13 @@ */ /** - * Retrieves the Connection object passed to this - * CachedRowSetImpl object. This connection may be + * Retrieves the {@code Connection} object passed to this + * {@code CachedRowSetImpl} object. This connection may be * used to populate this rowset with data or to write data back * to its underlying data source. * - * @return the Connection object passed to this rowset; - * may be null if there is no connection + * @return the {@code Connection} object passed to this rowset; + * may be {@code null} if there is no connection * @throws SQLException if an error occurs */ public Connection getConnection() throws SQLException{ @@ -4094,10 +4102,10 @@ } /** - * Sets the metadata for this CachedRowSetImpl object - * with the given RowSetMetaData object. + * Sets the metadata for this {@code CachedRowSetImpl} object + * with the given {@code RowSetMetaData} object. * - * @param md a RowSetMetaData object instance containing + * @param md a {@code RowSetMetaData} object instance containing * metadata about the columsn in the rowset * @throws SQLException if invalid meta data is supplied to the * rowset @@ -4108,17 +4116,17 @@ /** * Returns a result set containing the original value of the rowset. The - * original value is the state of the CachedRowSetImpl after the + * original value is the state of the {@code CachedRowSetImpl} after the * last population or synchronization (whichever occurred most recently) with * the data source. * * The cursor is positioned before the first row in the result set. - * Only rows contained in the result set returned by getOriginal() + * Only rows contained in the result set returned by {@code getOriginal()} * are said to have an original value. * * @return the original result set of the rowset * @throws SQLException if an error occurs produce the - * ResultSet object + * {@code ResultSet} object */ public ResultSet getOriginal() throws SQLException { throw new UnsupportedOperationException(); @@ -4127,7 +4135,7 @@ /** * Returns a result set containing the original value of the current * row only. - * The original value is the state of the CachedRowSetImpl after + * The original value is the state of the {@code CachedRowSetImpl} after * the last population or synchronization (whichever occurred most recently) * with the data source. * @@ -4153,7 +4161,7 @@ /** * Marks all rows in this rowset as being original rows. Any updates * made to the rows become the original values for the rowset. - * Calls to the method setOriginal connot be reversed. + * Calls to the method {@code setOriginal} connot be reversed. * * @throws SQLException if an error occurs */ @@ -4165,8 +4173,8 @@ * Returns an identifier for the object (table) that was used to create this * rowset. * - * @return a String object that identifies the table from - * which this CachedRowSetImpl object was derived + * @return a {@code String} object that identifies the table from + * which this {@code CachedRowSetImpl} object was derived * @throws SQLException if an error occurs */ public String getTableName() throws SQLException { @@ -4177,8 +4185,8 @@ * Sets the identifier for the table from which this rowset was derived * to the given table name. * - * @param tabName a String object that identifies the - * table from which this CachedRowSetImpl object + * @param tabName a {@code String} object that identifies the + * table from which this {@code CachedRowSetImpl} object * was derived * @throws SQLException if an error occurs */ @@ -4188,7 +4196,7 @@ /** * Returns the columns that make a key to uniquely identify a - * row in this CachedRowSetImpl object. + * row in this {@code CachedRowSetImpl} object. * * @return an array of column numbers that constitutes a primary * key for this rowset. This array should be empty @@ -4203,16 +4211,16 @@ /** - * Sets this CachedRowSetImpl object's - * keyCols field with the given array of column + * Sets this {@code CachedRowSetImpl} object's + * {@code keyCols} field with the given array of column * numbers, which forms a key for uniquely identifying a row * in this rowset. * - * @param keys an array of int indicating the + * @param keys an array of {@code int} indicating the * columns that form a primary key for this - * CachedRowSetImpl object; every + * {@code CachedRowSetImpl} object; every * element in the array must be greater than - * 0 and less than or equal to the number + * {@code 0} and less than or equal to the number * of columns in this rowset * @throws SQLException if any of the numbers in the * given array is not valid for this rowset @@ -4224,8 +4232,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4236,14 +4244,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4251,8 +4259,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4263,13 +4271,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4277,8 +4285,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4289,14 +4297,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + *
will hold the conflicting values + * This {@code CachedRowSet} will hold the conflicting values * retrieved from the db and hold it. */ private CachedRowSetImpl crsResolve; @@ -209,8 +209,8 @@ } /** - * Propagates changes in the given RowSet object - * back to its underlying data source and returns true + * Propagates changes in the given {@code RowSet} object + * back to its underlying data source and returns {@code true} * if successful. The writer will check to see if * the data in the pre-modified rowset (the original values) differ * from the data in the underlying data source. If data in the data @@ -221,15 +221,15 @@ * access for concurrent users. * * This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. * - * Creates a CachedRowSet object from the given - * RowSet object + * Creates a {@code CachedRowSet} object from the given + * {@code RowSet} object * Makes a connection with the data source * * Disables autocommit mode if it is not already disabled @@ -237,32 +237,32 @@ * * Checks to see if the reader has read new data since the writer * was last called and, if so, calls the method - * initSQLStatements to initialize new SQL statements + * {@code initSQLStatements} to initialize new SQL statements * - * Builds new SELECT, UPDATE, - * INSERT, and DELETE statements - * Uses the CachedRowSet object's metadata to + * Builds new {@code SELECT}, {@code UPDATE}, + * {@code INSERT}, and {@code DELETE} statements + * Uses the {@code CachedRowSet} object's metadata to * determine the table name, column names, and the columns * that make up the primary key * * When there is no conflict, propagates changes made to the - * CachedRowSet object back to its underlying data source + * {@code CachedRowSet} object back to its underlying data source * - * Iterates through each row of the CachedRowSet object + * Iterates through each row of the {@code CachedRowSet} object * to determine whether it has been updated, inserted, or deleted * If the corresponding row in the data source has not been changed * since the rowset last read its * values, the writer will use the appropriate command to update, * insert, or delete the row * If any data in the data source does not match the original values - * for the CachedRowSet object, the writer will roll + * for the {@code CachedRowSet} object, the writer will roll * back any changes it has made to the row in the data source. * * * - * @return true if changes to the rowset were successfully + * @return {@code true} if changes to the rowset were successfully * written to the rowset's underlying data source; - * false otherwise + * {@code false} otherwise */ public boolean writeData(RowSetInternal caller) throws SQLException { long conflicts = 0; @@ -434,25 +434,25 @@ } //end writeData -/** - * Updates the given CachedRowSet object's underlying data - * source so that updates to the rowset are reflected in the original - * data source, and returns false if the update was successful. - * A return value of true indicates that there is a conflict, - * meaning that a value updated in the rowset has already been changed by - * someone else in the underlying data source. A conflict can also exist - * if, for example, more than one row in the data source would be affected - * by the update or if no rows would be affected. In any case, if there is - * a conflict, this method does not update the underlying data source. - * - * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + * + * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - * - * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + * + * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. * - * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - * - * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + * + * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. * * If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. * * The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. * * NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. * * This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. * - * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. * - * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. * * Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. * - * undoUpdateRowSet
* This method is called by the rowset internally when - * the application invokes the method acceptChanges. - * The writeData method in turn calls private methods that + * the application invokes the method {@code acceptChanges}. + * The {@code writeData} method in turn calls private methods that * it defines internally. * The following is a general summary of what the method - * writeData does, much of which is accomplished + * {@code writeData} does, much of which is accomplished * through calls to its own internal methods. *
acceptChanges
INSERT
- * This method is called internally by the method writeData - * if a row in the CachedRowSet object for which this - * CachedRowSetWriter object is the writer has been updated. - * - * @return false if the update to the underlying data source is - * successful; true otherwise - * @throws SQLException if a database access error occurs - */ + /** + * Updates the given {@code CachedRowSet} object's underlying data + * source so that updates to the rowset are reflected in the original + * data source, and returns {@code false} if the update was successful. + * A return value of {@code true} indicates that there is a conflict, + * meaning that a value updated in the rowset has already been changed by + * someone else in the underlying data source. A conflict can also exist + * if, for example, more than one row in the data source would be affected + * by the update or if no rows would be affected. In any case, if there is + * a conflict, this method does not update the underlying data source. + *
+ * This method is called internally by the method {@code writeData} + * if a row in the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer has been updated. + * + * @return {@code false} if the update to the underlying data source is + * successful; {@code true} otherwise + * @throws SQLException if a database access error occurs + */ private boolean updateOriginalRow(CachedRowSet crs) throws SQLException { PreparedStatement pstmt; @@ -805,16 +805,16 @@ /** * Inserts a row that has been inserted into the given - * CachedRowSet object into the data source from which - * the rowset is derived, returning false if the insertion + * {@code CachedRowSet} object into the data source from which + * the rowset is derived, returning {@code false} if the insertion * was successful. * - * @param crs the CachedRowSet object that has had a row inserted + * @param crs the {@code CachedRowSet} object that has had a row inserted * and to whose underlying data source the row will be inserted - * @param pstmt the PreparedStatement object that will be used + * @param pstmt the {@code PreparedStatement} object that will be used * to execute the insertion - * @return false to indicate that the insertion was successful; - * true otherwise + * @return {@code false} to indicate that the insertion was successful; + * {@code true} otherwise * @throws SQLException if a database access error occurs */ private boolean insertNewRow(CachedRowSet crs, @@ -917,24 +917,24 @@ } } -/** - * Deletes the row in the underlying data source that corresponds to - * a row that has been deleted in the given CachedRowSet object - * and returns false if the deletion was successful. - *
- * This method is called internally by this writer's writeData - * method when a row in the rowset has been deleted. The values in the - * deleted row are the same as those that are stored in the original row - * of the given CachedRowSet object. If the values in the - * original row differ from the row in the underlying data source, the row - * in the data source is not deleted, and deleteOriginalRow - * returns true to indicate that there was a conflict. - * - * - * @return false if the deletion was successful, which means that - * there was no conflict; true otherwise - * @throws SQLException if there was a database access error - */ + /** + * Deletes the row in the underlying data source that corresponds to + * a row that has been deleted in the given {@code CachedRowSet} object + * and returns {@code false} if the deletion was successful. + *
deleteOriginalRow
+ * This method is called internally by this writer's {@code writeData} + * method when a row in the rowset has been deleted. The values in the + * deleted row are the same as those that are stored in the original row + * of the given {@code CachedRowSet} object. If the values in the + * original row differ from the row in the underlying data source, the row + * in the data source is not deleted, and {@code deleteOriginalRow} + * returns {@code true} to indicate that there was a conflict. + * + * + * @return {@code false} if the deletion was successful, which means that + * there was no conflict; {@code true} otherwise + * @throws SQLException if there was a database access error + */ private boolean deleteOriginalRow(CachedRowSet crs, CachedRowSetImpl crsRes) throws SQLException { PreparedStatement pstmt; int i; @@ -1056,13 +1056,13 @@ } /** - * Composes a SELECT, UPDATE, INSERT, - * and DELETE statement that can be used by this writer to - * write data to the data source backing the given CachedRowSet + * Composes a {@code SELECT}, {@code UPDATE}, {@code INSERT}, + * and {@code DELETE} statement that can be used by this writer to + * write data to the data source backing the given {@code CachedRowSet} * object. * - * @ param caller a CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param caller a {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * @throws SQLException if a database access error occurs */ private void initSQLStatements(CachedRowSet caller) throws SQLException { @@ -1177,13 +1177,13 @@ * table names. The given metadata object is used to get the proper order * and separator. * - * @param dbmd a DatabaseMetaData object that contains metadata - * about this writer's CachedRowSet object - * @param catalog a String object with the rowset's catalog + * @param dbmd a {@code DatabaseMetaData} object that contains metadata + * about this writer's {@code CachedRowSet} object + * @param catalog a {@code String} object with the rowset's catalog * name - * @param table a String object with the name of the table from + * @param table a {@code String} object with the name of the table from * which this writer's rowset was derived - * @return a String object with the fully qualified name of the + * @return a {@code String} object with the fully qualified name of the * table from which this writer's rowset was derived * @throws SQLException if a database access error occurs */ @@ -1221,21 +1221,21 @@ } /** - * Assigns to the given CachedRowSet object's - * params + * Assigns to the given {@code CachedRowSet} object's + * {@code params} * field an array whose length equals the number of columns needed * to uniquely identify a row in the rowset. The array is given - * values by the method buildWhereClause. + * values by the method {@code buildWhereClause}. *
params
buildWhereClause
- * If the CachedRowSet object's keyCols - * field has length 0 or is null, the array + * If the {@code CachedRowSet} object's {@code keyCols} + * field has length {@code 0} or is {@code null}, the array * is set with the column number of every column in the rowset. - * Otherwise, the array in the field keyCols is set with only + * Otherwise, the array in the field {@code keyCols} is set with only * the column numbers of the columns that are required to form a unique * identifier for a row. * - * @param crs the CachedRowSet object for which this - * CachedRowSetWriter object is the writer + * @param crs the {@code CachedRowSet} object for which this + * {@code CachedRowSetWriter} object is the writer * * @throws SQLException if a database access error occurs */ @@ -1263,29 +1263,29 @@ } /** - * Constructs an SQL WHERE clause using the given - * string as a starting point. The resulting clause will contain - * a column name and " = ?" for each key column, that is, each column - * that is needed to form a unique identifier for a row in the rowset. - * This WHERE clause can be added to - * a PreparedStatement object that updates, inserts, or - * deletes a row. - *
keyCols
- * This method uses the given result set to access values in the - * CachedRowSet object that called this writer. These - * values are used to build the array of parameters that will serve as - * replacements for the "?" parameter placeholders in the - * PreparedStatement object that is sent to the - * CachedRowSet object's underlying data source. - * - * @param whereClause a String object that is an empty - * string ("") - * @param rs a ResultSet object that can be used - * to access the CachedRowSet object's data - * @return a WHERE clause of the form "WHERE - * columnName = ? AND columnName = ? AND columnName = ? ..." - * @throws SQLException if a database access error occurs - */ + * Constructs an SQL {@code WHERE} clause using the given + * string as a starting point. The resulting clause will contain + * a column name and " = ?" for each key column, that is, each column + * that is needed to form a unique identifier for a row in the rowset. + * This {@code WHERE} clause can be added to + * a {@code PreparedStatement} object that updates, inserts, or + * deletes a row. + *
+ * This method uses the given result set to access values in the + * {@code CachedRowSet} object that called this writer. These + * values are used to build the array of parameters that will serve as + * replacements for the "?" parameter placeholders in the + * {@code PreparedStatement} object that is sent to the + * {@code CachedRowSet} object's underlying data source. + * + * @param whereClause a {@code String} object that is an empty + * string ("") + * @param rs a {@code ResultSet} object that can be used + * to access the {@code CachedRowSet} object's data + * @return a {@code WHERE} clause of the form "{@code WHERE} + * columnName = ? AND columnName = ? AND columnName = ? ..." + * @throws SQLException if a database access error occurs + */ private String buildWhereClause(String whereClause, ResultSet rs) throws SQLException { whereClause = "WHERE "; --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.335466074 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/SyncResolverImpl.java 2015-06-05 21:04:35.167466074 +0400 @@ -39,8 +39,8 @@ /** * There will be two sets of data which will be maintained by the rowset at the - * time of synchronization. The SyncProvider will utilize the - * SyncResolver to synchronize the changes back to database. + * time of synchronization. The {@code SyncProvider} will utilize the + * {@code SyncResolver} to synchronize the changes back to database. */ public class SyncResolverImpl extends CachedRowSetImpl implements SyncResolver { /** @@ -79,19 +79,19 @@ private int rowStatus; /** - * This will contain the size of the CachedRowSet object + * This will contain the size of the {@code CachedRowSet} object */ private int sz; /** - * The Connection handle used to synchronize the changes + * The {@code Connection} handle used to synchronize the changes * back to datasource. This is the same connection handle as was passed * to the CachedRowSet while fetching the data. */ private transient Connection con; /** - * The CachedRowSet object which will encapsulate + * The {@code CachedRowSet} object which will encapsulate * a row at any time. This will be built from CachedRowSet and * SyncResolver values. Synchronization takes place on a row by * row basis encapsulated as a CahedRowSet. @@ -123,13 +123,13 @@ /** * Retrieves the conflict status of the current row of this - * SyncResolver, which indicates the operationthe RowSet + * {@code SyncResolver}, which indicates the operationthe {@code RowSet} * object was attempting when the conflict occurred. * * @return one of the following constants: - * SyncResolver.UPDATE_ROW_CONFLICT, - * SyncResolver.DELETE_ROW_CONFLICT, or - * SyncResolver.INSERT_ROW_CONFLICT + * {@code SyncResolver.UPDATE_ROW_CONFLICT}, + * {@code SyncResolver.DELETE_ROW_CONFLICT}, or + * {@code SyncResolver.INSERT_ROW_CONFLICT} */ public int getStatus() { return ((Integer)stats.get(rowStatus-1)).intValue(); @@ -137,10 +137,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param index int designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param index {@code int} designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(int index) throws SQLException { @@ -153,10 +153,10 @@ /** * Retrieves the value in the designated column in the current row of this - * SyncResolver object, which is the value that caused a conflict. + * {@code SyncResolver} object, which is the value that caused a conflict. * - * @param columnName a String object designating the column in this row of this - * SyncResolver object from which to retrieve the value + * @param columnName a {@code String} object designating the column in this row of this + * {@code SyncResolver} object from which to retrieve the value * causing a conflict */ public Object getConflictValue(String columnName) throws SQLException { @@ -169,12 +169,12 @@ /** * Sets obj as the value in column index in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param index an int giving the number of the column into which to + * @param index an {@code int} giving the number of the column into which to * set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(int index, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -291,18 +291,18 @@ * This passes a CachedRowSet as a row to the CachedRowSetWriter * after the values have been resolved, back to the datasource. * - * @param row a CachedRowSet object which will hold the + * @param row a {@code CachedRowSet} object which will hold the * values of a particular row after they have been resolved by * the user to synchronize back to datasource. * @throws SQLException if synchronization does not happen properly - * maybe beacuse Connection has timed out. + * maybe beacuse {@code Connection} has timed out. **/ private void writeData(CachedRowSet row) throws SQLException { crw.updateResolvedConflictToDB(row, crw.getReader().connect((RowSetInternal)crsSync)); } /** - * This function builds a row as a CachedRowSet object + * This function builds a row as a {@code CachedRowSet} object * which has been resolved and is ready to be synchrinized to the datasource * * @throws SQLException if there is problem in building @@ -385,12 +385,12 @@ /** * Sets obj as the value in column columnName in the current row of the - * RowSet object. This value is the resolved value that is to be + * {@code RowSet} object. This value is the resolved value that is to be * persisted in the data source. * - * @param columnName a String object giving the name of the column + * @param columnName a {@code String} object giving the name of the column * into which to set the value to be persisted - * @param obj an Object that is the value to be set in the data source + * @param obj an {@code Object} that is the value to be set in the data source */ public void setResolvedValue(String columnName, Object obj) throws SQLException { // modify method to throw SQLException in spec @@ -445,13 +445,13 @@ } /** - * Moves the cursor down one row from its current position. A SyncResolver + * Moves the cursor down one row from its current position. A {@code SyncResolver} * cursor is initially positioned before the first conflict row; the first call to the - * method nextConflict() makes the first conflict row the current row; + * method {@code nextConflict()} makes the first conflict row the current row; * the second call makes the second conflict row the current row, and so on. *
SyncResolver
SyncResolver.UPDATE_ROW_CONFLICT
SyncResolver.DELETE_ROW_CONFLICT
SyncResolver.INSERT_ROW_CONFLICT
nextConflict()
* If an input stream is open for the current row, a call to the method next will - * implicitly close it. A SyncResolver object's warning chain is cleared + * implicitly close it. A {@code SyncResolver} object's warning chain is cleared * when a new row * * @return true if the new current row is valid; false if there are no more rows @@ -495,9 +495,9 @@ /** - * Moves the cursor to the previous conflict row in this SyncResolver object. + * Moves the cursor to the previous conflict row in this {@code SyncResolver} object. * - * @return true if the cursor is on a valid row; false + * @return {@code true} if the cursor is on a valid row; {@code false} * if it is off the result set * @throws SQLException if a database access error occurs or the result set type * is TYPE_FORWARD_ONLY @@ -511,17 +511,17 @@ //----------------------------------------------------------------------- /** - * Sets this CachedRowSetImpl object's command property - * to the given String object and clears the parameters, + * Sets this {@code CachedRowSetImpl} object's command property + * to the given {@code String} object and clears the parameters, * if any, that were set for the previous command. *
CachedRowSetImpl
* The command property may not be needed * if the rowset is produced by a data source, such as a spreadsheet, * that does not support commands. Thus, this property is optional - * and may be null. + * and may be {@code null}. * - * @param cmd a String object containing an SQL query - * that will be set as the command; may be null + * @param cmd a {@code String} object containing an SQL query + * that will be set as the command; may be {@code null} * @throws SQLException if an error occurs */ public void setCommand(String cmd) throws SQLException { @@ -534,25 +534,25 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data from - * the given ResultSet object. This - * method is an alternative to the method execute - * for filling the rowset with data. The method populate + * Populates this {@code CachedRowSetImpl} object with data from + * the given {@code ResultSet} object. This + * method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. *
populate
* After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet * @see #execute @@ -562,18 +562,18 @@ } /** - * Populates this CachedRowSetImpl object with data, + * Populates this {@code CachedRowSetImpl} object with data, * using the given connection to produce the result set from * which data will be read. A second form of this method, * which takes no arguments, uses the values from this rowset's * user, password, and either url or data source properties to - * create a new database connection. The form of execute + * create a new database connection. The form of {@code execute} * that is given a connection ignores these properties. * - * @param conn A standard JDBC Connection object that this - * CachedRowSet object can pass to a synchronization provider + * @param conn A standard JDBC {@code Connection} object that this + * {@code CachedRowSet} object can pass to a synchronization provider * to establish a connection to the data source - * @throws SQLException if an invalid Connection is supplied + * @throws SQLException if an invalid {@code Connection} is supplied * or an error occurs in establishing the connection to the * data source * @see #populate @@ -585,11 +585,11 @@ /** * Propagates all row update, insert, and delete changes to the - * underlying data source backing this CachedRowSetImpl + * underlying data source backing this {@code CachedRowSetImpl} * object. *
RowSetChangedEvent
* NoteIn the reference implementation an optimistic concurrency implementation - * is provided as a sample implementation of a the SyncProvider + * is provided as a sample implementation of a the {@code SyncProvider} * abstract class. *
* This method fails if any of the updates cannot be propagated back @@ -601,17 +601,17 @@ * In that case, when deleted rows are not shown, which is usually true, * the current row is not affected. *
- * If no SyncProvider is configured, the reference implementation - * leverages the RIOptimisticProvider available which provides the + * If no {@code SyncProvider} is configured, the reference implementation + * leverages the {@code RIOptimisticProvider} available which provides the * default and reference synchronization capabilities for disconnected - * RowSets. + * {@code RowSets}. * * @throws SQLException if the cursor is on the insert row or the underlying * reference synchronization provider fails to commit the updates * to the datasource * @throws SyncProviderException if an internal error occurs within the - * SyncProvider instance during either during the - * process or at any time when the SyncProvider + * {@code SyncProvider} instance during either during the + * process or at any time when the {@code SyncProvider} * instance touches the data source. * @see #acceptChanges(java.sql.Connection) * @see javax.sql.RowSetWriter @@ -623,18 +623,18 @@ /** * Propagates all row update, insert, and delete changes to the - * data source backing this CachedRowSetImpl object - * using the given Connection object. + * data source backing this {@code CachedRowSetImpl} object + * using the given {@code Connection} object. *
RowSets
- * The reference implementation RIOptimisticProvider + * The reference implementation {@code RIOptimisticProvider} * modifies its synchronization to a write back function given * the updated connection * The reference implementation modifies its synchronization behaviour - * via the SyncProvider to ensure the synchronization - * occurs according to the updated JDBC Connection + * via the {@code SyncProvider} to ensure the synchronization + * occurs according to the updated JDBC {@code Connection} * properties. * - * @param con a standard JDBC Connection object + * @param con a standard JDBC {@code Connection} object * @throws SQLException if the cursor is on the insert row or the underlying * synchronization provider fails to commit the updates * back to the data source @@ -648,11 +648,11 @@ } /** - * Restores this CachedRowSetImpl object to its original state, + * Restores this {@code CachedRowSetImpl} object to its original state, * that is, its state before the last set of changes. *
* Before returning, this method moves the cursor before the first row - * and sends a rowSetChanged event to all registered + * and sends a {@code rowSetChanged} event to all registered * listeners. * @throws SQLException if an error is occurs rolling back the RowSet * state to the definied original value. @@ -663,8 +663,8 @@ } /** - * Releases the current contents of this CachedRowSetImpl - * object and sends a rowSetChanged event object to all + * Releases the current contents of this {@code CachedRowSetImpl} + * object and sends a {@code rowSetChanged} event object to all * registered listeners. * * @throws SQLException if an error occurs flushing the contents of @@ -690,7 +690,7 @@ /** * Immediately removes the current row from this - * CachedRowSetImpl object if the row has been inserted, and + * {@code CachedRowSetImpl} object if the row has been inserted, and * also notifies listeners the a row has changed. An exception is thrown * if the row is not a row that has been inserted or the cursor is before * the first row, after the last row, or on the insert row. @@ -710,10 +710,10 @@ * row has been modified. This method can be * called to reverse updates on a all columns until all updates in a row have * been rolled back to their originating state since the last synchronization - * (acceptChanges) or population. This method may also be called + * ({@code acceptChanges}) or population. This method may also be called * while performing updates to the insert row. *
rowSetChanged
- * undoUpdateRowSet
undoUpdate
createCopy
CloneNotSupportedException
createShared
clone
* This helps in getting the underlying XML schema which can - * be used as the basis for populating a WebRowSet. + * be used as the basis for populating a {@code WebRowSet}. * - * @return a new CachedRowSet object that is a copy - * of this CachedRowSetImpl object's schema and + * @return a new {@code CachedRowSet} object that is a copy + * of this {@code CachedRowSetImpl} object's schema and * retains all the constraints on the original rowset but contains * no data * @throws SQLException if an error occurs in generating the copy - * of the CachedRowSet object + * of the {@code CachedRowSet} object * @see #createShared * @see #createCopy * @see #createCopyNoConstraints @@ -821,17 +821,17 @@ } /** - * Creates a CachedRowSet object that is a copy of - * this CachedRowSetImpl object's data only. + * Creates a {@code CachedRowSet} object that is a copy of + * this {@code CachedRowSetImpl} object's data only. * All constraints set in this object will not be there * in the returning object. Updates made * on a copy are not visible to the original rowset. * - * @return a new CachedRowSet object that is a deep copy - * of this CachedRowSetImpl object and is - * completely independent from this CachedRowSetImpl object + * @return a new {@code CachedRowSet} object that is a deep copy + * of this {@code CachedRowSetImpl} object and is + * completely independent from this {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the copy of the - * of the CachedRowSet + * of the {@code CachedRowSet} * @see #createShared * @see #createCopy * @see #createCopySchema @@ -843,15 +843,15 @@ } /** - * Converts this CachedRowSetImpl object to a collection - * of tables. The sample implementation utilitizes the TreeMap + * Converts this {@code CachedRowSetImpl} object to a collection + * of tables. The sample implementation utilitizes the {@code TreeMap} * collection type. * This class guarantees that the map will be in ascending key order, * sorted according to the natural order for the key's class. * - * @return a Collection object consisting of tables, + * @return a {@code Collection} object consisting of tables, * each of which is a copy of a row in this - * CachedRowSetImpl object + * {@code CachedRowSetImpl} object * @throws SQLException if an error occurs in generating the collection * @see #toCollection(int) * @see #toCollection(String) @@ -863,16 +863,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -886,16 +886,16 @@ } /** - * Returns the specified column of this CachedRowSetImpl object - * as a Collection object. This method makes a copy of the - * column's data and utilitizes the Vector to establish the - * collection. The Vector class implements a growable array + * Returns the specified column of this {@code CachedRowSetImpl} object + * as a {@code Collection} object. This method makes a copy of the + * column's data and utilitizes the {@code Vector} to establish the + * collection. The {@code Vector} class implements a growable array * objects allowing the individual components to be accessed using an * an integer index similar to that of an array. * - * @return a Collection object that contains the value(s) + * @return a {@code Collection} object that contains the value(s) * stored in the specified column of this - * CachedRowSetImpl + * {@code CachedRowSetImpl} * object * @throws SQLException if an error occurs generated the collection; or * an invalid column is provided. @@ -914,25 +914,25 @@ /** - * Returns the SyncProvider implementation being used - * with this CachedRowSetImpl implementation rowset. + * Returns the {@code SyncProvider} implementation being used + * with this {@code CachedRowSetImpl} implementation rowset. * * @return the SyncProvider used by the rowset. If not provider was * set when the rowset was instantiated, the reference * implementation (default) provider is returned. * @throws SQLException if error occurs while return the - * SyncProvider instance. + * {@code SyncProvider} instance. */ public SyncProvider getSyncProvider() throws SQLException { throw new UnsupportedOperationException(); } /** - * Sets the active SyncProvider and attempts to load - * load the new provider using the SyncFactory SPI. + * Sets the active {@code SyncProvider} and attempts to load + * load the new provider using the {@code SyncFactory} SPI. * * @throws SQLException if an error occurs while resetting the - * SyncProvider. + * {@code SyncProvider}. */ public void setSyncProvider(String providerStr) throws SQLException { throw new UnsupportedOperationException(); @@ -953,23 +953,23 @@ //--------------------------------------------------------------------- /** - * Populates this CachedRowSetImpl object with data. + * Populates this {@code CachedRowSetImpl} object with data. * This form of the method uses the rowset's user, password, and url or * data source name properties to create a database * connection. If properties that are needed * have not been set, this method will throw an exception. *
WebRowSet
TreeMap
Collection
Vector
- * Another form of this method uses an existing JDBC Connection + * Another form of this method uses an existing JDBC {@code Connection} * object instead of creating a new one; therefore, it ignores the * properties used for establishing a new connection. *
* The query specified by the command property is executed to create a - * ResultSet object from which to retrieve data. + * {@code ResultSet} object from which to retrieve data. * The current contents of the rowset are discarded, and the * rowset's metadata is also (re)set. If there are outstanding updates, * they are also ignored. *
- * The method execute closes any database connections that it + * The method {@code execute} closes any database connections that it * creates. * * @throws SQLException if an error occurs or the @@ -987,20 +987,20 @@ /** * Moves the cursor down one row from its current position and - * returns true if the new cursor position is a + * returns {@code true} if the new cursor position is a * valid row. - * The cursor for a new ResultSet object is initially + * The cursor for a new {@code ResultSet} object is initially * positioned before the first row. The first call to the method - * next moves the cursor to the first row, making it + * {@code next} moves the cursor to the first row, making it * the current row; the second call makes the second row the * current row, and so on. * *
If an input stream from the previous row is open, it is - * implicitly closed. The ResultSet object's warning + * implicitly closed. The {@code ResultSet} object's warning * chain is cleared when a new row is read. * - * @return true if the new current row is valid; - * false if there are no more rows + * @return {@code true} if the new current row is valid; + * {@code false} if there are no more rows * @throws SQLException if an error occurs or * the cursor is not positioned in the rowset, before * the first row, or after the last row @@ -1010,9 +1010,9 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the next - * row and returns true if the cursor is still in the rowset; - * returns false if the cursor has moved to the position after + * Moves this {@code CachedRowSetImpl} object's cursor to the next + * row and returns {@code true} if the cursor is still in the rowset; + * returns {@code false} if the cursor has moved to the position after * the last row. *
* This method handles the cases where the cursor moves to a row that @@ -1021,15 +1021,15 @@ * that has been deleted, this method moves the cursor to the next * row until the cursor is on a row that has not been deleted. *
- * The method internalNext is called by methods such as - * next, absolute, and relative, + * The method {@code internalNext} is called by methods such as + * {@code next}, {@code absolute}, and {@code relative}, * and, as its name implies, is only called internally. *
internalNext
absolute
relative
* This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a valid row in this - * rowset; false if it is after the last row + * @return {@code true} if the cursor is on a valid row in this + * rowset; {@code false} if it is after the last row * @throws SQLException if an error occurs */ protected boolean internalNext() throws SQLException { @@ -1037,25 +1037,25 @@ } /** - * Closes this CachedRowSetImpl objecy and releases any resources + * Closes this {@code CachedRowSetImpl} objecy and releases any resources * it was using. * * @throws SQLException if an error occurs when releasing any resources in use - * by this CachedRowSetImpl object + * by this {@code CachedRowSetImpl} object */ public void close() throws SQLException { throw new UnsupportedOperationException(); } /** - * Reports whether the last column read was SQL NULL. - * Note that you must first call the method getXXX + * Reports whether the last column read was SQL {@code NULL}. + * Note that you must first call the method {@code getXXX} * on a column to try to read its value and then call the method - * wasNull to determine whether the value was - * SQL NULL. + * {@code wasNull} to determine whether the value was + * SQL {@code NULL}. * - * @return true if the value in the last column read - * was SQL NULL; false otherwise + * @return {@code true} if the value in the last column read + * was SQL {@code NULL}; {@code false} otherwise * @throws SQLException if an error occurs */ public boolean wasNull() throws SQLException { @@ -1064,9 +1064,9 @@ /** * Returns the insert row or the current row of this - * CachedRowSetImplobject. + * {@code CachedRowSetImpl}object. * - * @return the Row object on which this CachedRowSetImpl + * @return the {@code Row} object on which this {@code CachedRowSetImpl} * objects's cursor is positioned */ protected BaseRow getCurrentRow() { @@ -1077,7 +1077,7 @@ * Removes the row on which the cursor is positioned. *
Row
* This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * * @throws SQLException if the cursor is positioned on the insert * row @@ -1089,20 +1089,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * String object. + * of this {@code CachedRowSetImpl} object as a + * {@code String} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} {@code CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type designates the * recommended return type. */ public String getString(int columnIndex) throws SQLException { @@ -1111,18 +1111,18 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * boolean value. + * of this {@code CachedRowSetImpl} object as a + * {@code boolean} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a boolean in the Java progamming language; - * if the value is SQL NULL, the result is false + * @return the column value as a {@code boolean} in the Java progamming language; + * if the value is SQL {@code NULL}, the result is {@code false} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BOOLEAN value + * SQL {@code BOOLEAN} value * @see #getBoolean(String) */ public boolean getBoolean(int columnIndex) throws SQLException { @@ -1131,20 +1131,20 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type + * SQL {@code TINYINT}, {@code SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type * designates the recommended return type. * @see #getByte(String) */ @@ -1154,21 +1154,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * short value. + * of this {@code CachedRowSetImpl} object as a + * {@code short} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT}, {@code SMALLINT}, + * {@code INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(String) */ public short getShort(int columnIndex) throws SQLException { @@ -1177,21 +1178,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * int value. + * of this {@code CachedRowSetImpl} object as an + * {@code int} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1199,21 +1201,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * long value. + * of this {@code CachedRowSetImpl} object as a + * {@code long} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getLong(String) */ public long getLong(int columnIndex) throws SQLException { @@ -1222,21 +1225,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * float value. + * of this {@code CachedRowSetImpl} object as a + * {@code float} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT,} + * {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, NUMERIC, + * BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(int columnIndex) throws SQLException { @@ -1245,21 +1248,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * double value. + * of this {@code CachedRowSetImpl} object as a + * {@code double} value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is 0 + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code 0} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL,} + * {@code FLOAT, DOUBLE}, + * {@code DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} + * or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getDouble(String) * */ @@ -1269,21 +1273,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. *
TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR
TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR
- * This method is deprecated; use the version of getBigDecimal + * This method is deprecated; use the version of {@code getBigDecimal} * that does not take a scale parameter and returns a value with full * precision. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @param scale the number of digits to the right of the decimal point in the * value returned * @return the column value with the specified number of digits to the right - * of the decimal point; if the value is SQL NULL, the - * result is null + * of the decimal point; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails * @deprecated @@ -1295,22 +1299,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * byte array value. + * of this {@code CachedRowSetImpl} object as a + * {@code byte} array value. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the - * result is null + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the + * result is {@code null} * * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or + * {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getBytes(String) */ public byte[] getBytes(int columnIndex) throws SQLException { @@ -1319,17 +1323,17 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Date object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Date} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value as a java.sql.Data object; if - * the value is SQL NULL, the - * result is null + * @return the column value as a {@code java.sql.Data} object; if + * the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, - * the cursor is not on a valid row, or this method fails + * the cursor is not on a valid row, or this method fails */ public java.sql.Date getDate(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -1337,14 +1341,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Time object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Time} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1354,14 +1358,14 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return the column value; if the value is SQL NULL, the - * result is null + * @return the column value; if the value is SQL {@code NULL}, the + * result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or this method fails */ @@ -1371,33 +1375,33 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The JDBC + * suitable for retrieving large {@code LONGVARCHAR} values. The JDBC * driver will do any necessary conversion from the database format into ASCII. * *
getBigDecimal
BINARY, VARBINARY or - * LONGVARBINARY
java.sql.Data
Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. . Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(String) */ public java.io.InputStream getAsciiStream(int columnIndex) throws SQLException { @@ -1416,8 +1420,8 @@ * stream may return 0 for available() whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @return a Java input stream that delivers the database column value * as a stream of two byte Unicode characters. If the value is SQL NULL @@ -1432,30 +1436,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. *
CachedRowSetImpl.available()
CHAR, VARCHAR
BINARY, VARBINARY
* A column value can be retrieved as a stream of uninterpreted bytes * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARBINARY values. + * suitable for retrieving large {@code LONGVARBINARY} values. * *
Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for - * CachedRowSetImpl.available() whether there is data + * stream may return {@code 0} for + * {@code CachedRowSetImpl.available()} whether there is data * available or not. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java input stream that delivers the database column value - * as a stream of uninterpreted bytes. If the value is SQL NULL - * then the result is null. + * as a stream of uninterpreted bytes. If the value is SQL {@code NULL} + * then the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY}. * The bold type indicates the SQL type that this method is recommened * to retrieve. * @see #getBinaryStream(String) @@ -1472,19 +1476,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a String object. + * of the current row as a {@code String} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR< value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT,} + * {@code CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. */ public String getString(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1492,17 +1496,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a boolean value. + * of the current row as a {@code boolean} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a boolean in the Java programming - * language; if the value is SQL NULL, - * the result is false + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code boolean} in the Java programming + * language; if the value is SQL {@code NULL}, + * the result is {@code false} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BOOLEAN value + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BOOLEAN} value * @see #getBoolean(int) */ public boolean getBoolean(String columnName) throws SQLException { @@ -1511,19 +1515,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte value. + * of the current row as a {@code byte} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte in the Java programming - * language; if the value is SQL NULL, the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The - * bold type designates the recommended return type + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT}, + * {@code SMALLINT, INTEGER, BIGINT, REAL, FLOAT, DOUBLE, + * DECIMAL, NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} + * value. The bold type designates the recommended return type. */ public byte getByte(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1531,19 +1535,20 @@ /** * Retrieves the value stored in the designated column - * of the current row as a short value. + * of the current row as a {@code short} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT,} + * {@code SMALLINT}, {@code INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, + * VARCHAR} or {@code LONGVARCHAR} value. The bold SQL type + * designates the recommended return type. * @see #getShort(int) */ public short getShort(String columnName) throws SQLException { @@ -1552,20 +1557,21 @@ /** * Retrieves the value stored in the designated column - * of the current row as an int value. + * of the current row as an {@code int} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name - * of a column in this rowset, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return type. + * of a column in this rowset, + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT,} {@code INTEGER}, + * {@code BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return type. */ public int getInt(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1573,19 +1579,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a long value. + * of the current row as a {@code long} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER,} + * {@code BIGINT}, {@code REAL, FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getLong(int) */ public long getLong(String columnName) throws SQLException { @@ -1594,19 +1600,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a float value. + * of the current row as a {@code float} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT,} {@code REAL}, {@code FLOAT, DOUBLE, DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type. * @see #getFloat(String) */ public float getFloat(String columnName) throws SQLException { @@ -1615,20 +1621,20 @@ /** * Retrieves the value stored in the designated column - * of the current row of this CachedRowSetImpl object - * as a double value. + * of the current row of this {@code CachedRowSetImpl} object + * as a {@code double} value. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is 0 + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code 0} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return types. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL,} {@code FLOAT, DOUBLE}, {@code DECIMAL, + * NUMERIC, BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return types. * @see #getDouble(int) */ public double getDouble(String columnName) throws SQLException { @@ -1637,22 +1643,22 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.math.BigDecimal object. + * of the current row as a {@code java.math.BigDecimal} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @param scale the number of digits to the right of the decimal point - * @return a java.math.BugDecimal object with scale - * number of digits to the right of the decimal point. + * @return a java.math.BugDecimal object with {@code scale} + * number of digits to the right of the decimal point. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve. - * @deprecated Use the getBigDecimal(String columnName) + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. + * @deprecated Use the {@code getBigDecimal(String columnName)} * method instead */ @Deprecated @@ -1662,19 +1668,19 @@ /** * Retrieves the value stored in the designated column - * of the current row as a byte array. + * of the current row as a {@code byte} array. * The bytes represent the raw values returned by the driver. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value as a byte array in the Java programming - * language; if the value is SQL NULL, the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value as a {@code byte} array in the Java programming + * language; if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BINARY, VARBINARY - * or LONGVARBINARY values - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code BINARY, VARBINARY} + * or {@code LONGVARBINARY} values. + * The bold SQL type designates the recommended return type. * @see #getBytes(int) */ public byte[] getBytes(String columnName) throws SQLException { @@ -1683,17 +1689,17 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Date object. + * of the current row as a {@code java.sql.Date} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -1701,12 +1707,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Time object. + * of the current row as a {@code java.sql.Time} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1717,12 +1723,12 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.sql.Timestamp object. + * of the current row as a {@code java.sql.Timestamp} object. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object - * @return the column value; if the value is SQL NULL, - * the result is null + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row @@ -1733,32 +1739,32 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. * * A column value can be retrieved as a stream of ASCII characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. The - * SyncProvider will rely on the JDBC driver to do any necessary + * suitable for retrieving large {@code LONGVARCHAR} values. The + * {@code SyncProvider} will rely on the JDBC driver to do any necessary * conversion from the database format into ASCII format. * *
TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR
LONGVARCHAR<
TINYINT, SMALLINT, INTEGER, - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, - * VARCHAR
scale
TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR
getBigDecimal(String columnName)
BINARY, VARBINARY - *
Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of one-byte ASCII characters. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR - * BINARY, VARBINARY or LONGVARBINARY value. The - * bold SQL type designates the recommended return types that this method is - * used to retrieve. + * a column in this rowset + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR}, {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. The + * bold SQL type designates the recommended return types + * that this method is used to retrieve. * @see #getAsciiStream(int) */ public java.io.InputStream getAsciiStream(String columnName) throws SQLException { @@ -1769,23 +1775,23 @@ /** * A column value can be retrieved as a stream of Unicode characters * and then read in chunks from the stream. This method is particularly - * suitable for retrieving large LONGVARCHAR values. + * suitable for retrieving large {@code LONGVARCHAR} values. * The JDBC driver will do any necessary conversion from the database * format into Unicode. * *
Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if the given column name does not match one of * this rowset's column names or the cursor is not on one of * this rowset's rows or its insert row - * @deprecated use the method getCharacterStream instead + * @deprecated use the method {@code getCharacterStream} instead */ @Deprecated public java.io.InputStream getUnicodeStream(String columnName) throws SQLException { @@ -1794,30 +1800,30 @@ /** * Retrieves the value of the designated column in the current row of this - * CachedRowSetImpl object as a java.io.InputStream + * {@code CachedRowSetImpl} object as a {@code java.io.InputStream} * object. *
Note: All the data in the returned stream must be * read prior to getting the value of any other column. The next * call to a get method implicitly closes the stream. Also, a - * stream may return 0 for CachedRowSetImpl.available() + * stream may return {@code 0} for {@code CachedRowSetImpl.available()} * whether there is data available or not. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of uninterpreted bytes. If the value is SQL - * NULL, the result is null. + * {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is unknown, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL BINARY, VARBINARY or LONGVARBINARY - * The bold type indicates the SQL type that this method is recommened - * to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code BINARY, VARBINARY} or {@code LONGVARBINARY} + * The bold type indicates the SQL type that this method is recommened + * to retrieve. * @see #getBinaryStream(int) * */ @@ -1831,17 +1837,17 @@ //===================================================================== /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. * *
Note: This warning chain only covers warnings caused - * by ResultSet methods. Any warning caused by statement + * by {@code ResultSet} methods. Any warning caused by statement * methods (such as reading OUT parameters) will be chained on the - * Statement object. + * {@code Statement} object. * * @return the first SQLWarning or null */ @@ -1850,10 +1856,10 @@ } /** - * Clears all the warnings reporeted for the CachedRowSetImpl - * object. After a call to this method, the getWarnings method - * returns null until a new warning is reported for this - * CachedRowSetImpl object. + * Clears all the warnings reporeted for the {@code CachedRowSetImpl} + * object. After a call to this method, the {@code getWarnings} method + * returns {@code null} until a new warning is reported for this + * {@code CachedRowSetImpl} object. */ public void clearWarnings() { throw new UnsupportedOperationException(); @@ -1861,25 +1867,25 @@ /** * Retrieves the name of the SQL cursor used by this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * *
In SQL, a result table is retrieved through a cursor that is - * named. The current row of a ResultSet can be updated or deleted + * named. The current row of a {@code ResultSet} can be updated or deleted * using a positioned update/delete statement that references the * cursor name. To ensure that the cursor has the proper isolation - * level to support an update operation, the cursor's SELECT - * statement should be of the form select for update. - * If the for update clause + * level to support an update operation, the cursor's {@code SELECT} + * statement should be of the form {@code select for update}. + * If the {@code for update} clause * is omitted, positioned updates may fail. * *
select for update
for update
JDBC supports this SQL feature by providing the name of the - * SQL cursor used by a ResultSet object. The current row + * SQL cursor used by a {@code ResultSet} object. The current row * of a result set is also the current row of this SQL cursor. * *
Note: If positioned updates are not supported, an - * SQLException is thrown. + * {@code SQLException} is thrown. * - * @return the SQL cursor name for this CachedRowSetImpl object's + * @return the SQL cursor name for this {@code CachedRowSetImpl} object's * cursor * @throws SQLException if an error occurs */ @@ -1888,12 +1894,12 @@ } /** - * Retrieves a ResultSetMetaData object instance that - * contains information about the CachedRowSet object. + * Retrieves a {@code ResultSetMetaData} object instance that + * contains information about the {@code CachedRowSet} object. * However, applications should cast the returned object to a - * RowSetMetaData interface implementation. In the + * {@code RowSetMetaData} interface implementation. In the * reference implementation, this cast can be done on the - * RowSetMetaDataImpl class. + * {@code RowSetMetaDataImpl} class. *
* For example: *
@@ -1907,10 +1913,10 @@ * crs.setMetaData(metaData); *
- * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1931,23 +1937,23 @@ * This method may also be used to read datatabase-specific * abstract data types. *
- * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes in the Java programming language. * When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if the given column index is out of bounds, * the cursor is not on a valid row, or there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(String) */ public Object getObject(int columnIndex) throws SQLException { @@ -1956,10 +1962,10 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as an - * Object value. + * of this {@code CachedRowSetImpl} object as an + * {@code Object} value. *
Class
- * The type of the Object will be the default + * The type of the {@code Object} will be the default * Java object type corresponding to the column's SQL type, * following the mapping for built-in types specified in the JDBC 3.0 * specification. @@ -1967,23 +1973,23 @@ * This method may also be used to read datatabase-specific * abstract data types. *
- * This implementation of the method getObject extends its + * This implementation of the method {@code getObject} extends its * behavior so that it gets the attributes of an SQL structured type - * as an array of Object values. This method also custom + * as an array of {@code Object} values. This method also custom * maps SQL user-defined types to classes * in the Java programming language. When the specified column contains * a structured or distinct value, the behavior of this method is as - * if it were a call to the method getObject(columnIndex, - * this.getStatement().getConnection().getTypeMap()). + * if it were a call to the method {@code getObject(columnIndex, + * this.getStatement().getConnection().getTypeMap())}. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.lang.Object holding the column value; - * if the value is SQL NULL, the result is null + * @return a {@code java.lang.Object} holding the column value; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name does not match one of * this rowset's column names, (2) the cursor is not * on a valid row, or (3) there is a problem getting - * the Class object for a custom mapping + * the {@code Class} object for a custom mapping * @see #getObject(int) */ public Object getObject(String columnName) throws SQLException { @@ -1993,10 +1999,10 @@ //---------------------------------------------------------------- /** - * Maps the given column name for one of this CachedRowSetImpl + * Maps the given column name for one of this {@code CachedRowSetImpl} * object's columns to its column number. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @return the column index of the given column name * @throws SQLException if the given column name does not match one @@ -2014,25 +2020,25 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * *
Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset * @return a Java character stream that delivers the database column value * as a stream of two-byte unicode characters in a - * java.io.Reader object. If the value is - * SQL NULL, the result is null. + * {@code java.io.Reader} object. If the value is + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY or - * LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code CHAR, VARCHAR,} {@code LONGVARCHAR}, + * {@code BINARY, VARBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. * @see #getCharacterStream(String) */ public java.io.Reader getCharacterStream(int columnIndex) throws SQLException{ @@ -2041,23 +2047,24 @@ /** * Retrieves the value stored in the designated column - * of the current row as a java.io.Reader object. + * of the current row as a {@code java.io.Reader} object. * *
CHAR, VARCHAR, LONGVARCHAR, BINARY, VARBINARY
Note: All the data in the returned stream must * be read prior to getting the value of any other column. The - * next call to a getXXX method implicitly closes the stream. + * next call to a {@code getXXX} method implicitly closes the stream. * - * @param columnName a String object giving the SQL name of - * a column in this CachedRowSetImpl object + * @param columnName a {@code String} object giving the SQL name of + * a column in this {@code CachedRowSetImpl} object * @return a Java input stream that delivers the database column value * as a stream of two-byte Unicode characters. If the value is - * SQL NULL, the result is null. + * SQL {@code NULL}, the result is {@code null}. * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY or LONGVARBINARY value. - * The bold SQL type designates the recommended return type. + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code CHAR, VARCHAR,} + * {@code LONGVARCHAR}, + * {@code BINARY, VARYBINARY} or {@code LONGVARBINARY} value. + * The bold SQL type designates the recommended return type. */ public java.io.Reader getCharacterStream(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -2065,21 +2072,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column index is out of bounds, - * (2) the cursor is not on one of this rowset's rows or its - * insert row, or (3) the designated column does not store an - * SQL TINYINT, SMALLINT, INTEGER, BIGINT, REAL, - * FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT, CHAR, VARCHAR - * or LONGVARCHAR value. The bold SQL type designates the - * recommended return types that this method is used to retrieve. + * (2) the cursor is not on one of this rowset's rows or its + * insert row, or (3) the designated column does not store an + * SQL {@code TINYINT, SMALLINT, INTEGER, BIGINT, REAL, + * FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT, CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the + * recommended return types that this method is used to retrieve. * @see #getBigDecimal(String) */ public BigDecimal getBigDecimal(int columnIndex) throws SQLException { @@ -2088,21 +2096,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.math.BigDecimal object. + * of this {@code CachedRowSetImpl} object as a + * {@code java.math.BigDecimal} object. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a java.math.BigDecimal value with full precision; - * if the value is SQL NULL, the result is null + * @return a {@code java.math.BigDecimal} value with full precision; + * if the value is SQL {@code NULL}, the result is {@code null} * @throws SQLException if (1) the given column name is not the name of - * a column in this rowset, (2) the cursor is not on one of - * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TINYINT, SMALLINT, INTEGER - * BIGINT, REAL, FLOAT, DOUBLE, DECIMAL, NUMERIC, BIT CHAR, - * VARCHAR or LONGVARCHAR value. The bold SQL type - * designates the recommended return type that this method is used to - * retrieve + * a column in this rowset, (2) the cursor is not on one of + * this rowset's rows or its insert row, or (3) the designated + * column does not store an SQL {@code TINYINT, SMALLINT, INTEGER, + * BIGINT, REAL, FLOAT, DOUBLE,} {@code DECIMAL, NUMERIC}, + * {@code BIT CHAR, VARCHAR} or {@code LONGVARCHAR} value. + * The bold SQL type designates the recommended return type + * that this method is used to retrieve. * @see #getBigDecimal(int) */ public BigDecimal getBigDecimal(String columnName) throws SQLException { @@ -2114,7 +2122,7 @@ //--------------------------------------------------------------------- /** - * Returns the number of rows in this CachedRowSetImpl object. + * Returns the number of rows in this {@code CachedRowSetImpl} object. * * @return number of rows in the rowset */ @@ -2124,10 +2132,10 @@ /** * Indicates whether the cursor is before the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is before the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is before the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isBeforeFirst() throws SQLException { @@ -2136,10 +2144,10 @@ /** * Indicates whether the cursor is after the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is after the last row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is after the last row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isAfterLast() throws SQLException { @@ -2148,10 +2156,10 @@ /** * Indicates whether the cursor is on the first row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. * - * @return true if the cursor is on the first row; - * false otherwise or if the rowset contains no rows + * @return {@code true} if the cursor is on the first row; + * {@code false} otherwise or if the rowset contains no rows * @throws SQLException if an error occurs */ public boolean isFirst() throws SQLException { @@ -2160,14 +2168,14 @@ /** * Indicates whether the cursor is on the last row in this - * CachedRowSetImpl object. + * {@code CachedRowSetImpl} object. *
CHAR, VARCHAR, LONGVARCHAR, - * BINARY, VARYBINARY
- * Note: Calling the method isLast may be expensive + * Note: Calling the method {@code isLast} may be expensive * because the JDBC driver might need to fetch ahead one row in order * to determine whether the current row is the last row in this rowset. * - * @return true if the cursor is on the last row; - * false otherwise or if this rowset contains no rows + * @return {@code true} if the cursor is on the last row; + * {@code false} otherwise or if this rowset contains no rows * @throws SQLException if an error occurs */ public boolean isLast() throws SQLException { @@ -2175,19 +2183,19 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the front of + * Moves this {@code CachedRowSetImpl} object's cursor to the front of * the rowset, just before the first row. This method has no effect if * this rowset contains no rows. * * @throws SQLException if an error occurs or the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public void beforeFirst() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the end of + * Moves this {@code CachedRowSetImpl} object's cursor to the end of * the rowset, just after the last row. This method has no effect if * this rowset contains no rows. * @@ -2198,34 +2206,34 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the first row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the first row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean first() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the first - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the first + * row and returns {@code true} if the operation is successful. *
- * This method is called internally by the methods first, - * isFirst, and absolute. - * It in turn calls the method internalNext in order to + * This method is called internally by the methods {@code first}, + * {@code isFirst}, and {@code absolute}. + * It in turn calls the method {@code internalNext} in order to * handle the case where the first row is a deleted row that is not visible. *
first
isFirst
* This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the first row; - * false otherwise + * @return {@code true} if the cursor moved to the first row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalFirst() throws SQLException { @@ -2233,35 +2241,35 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the last row - * and returns true if the operation was successful. This + * Moves this {@code CachedRowSetImpl} object's cursor to the last row + * and returns {@code true} if the operation was successful. This * method also notifies registered listeners that the cursor has moved. * - * @return true if the cursor is on a valid row; - * false otherwise or if there are no rows in this - * CachedRowSetImpl object + * @return {@code true} if the cursor is on a valid row; + * {@code false} otherwise or if there are no rows in this + * {@code CachedRowSetImpl} object * @throws SQLException if the type of this rowset - * is ResultSet.TYPE_FORWARD_ONLY + * is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean last() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the last - * row and returns true if the operation is successful. + * Moves this {@code CachedRowSetImpl} object's cursor to the last + * row and returns {@code true} if the operation is successful. *
- * This method is called internally by the method last + * This method is called internally by the method {@code last} * when rows have been deleted and the deletions are not visible. - * The method internalLast handles the case where the + * The method {@code internalLast} handles the case where the * last row is a deleted row that is not visible by in turn calling - * the method internalPrevious. + * the method {@code internalPrevious}. *
last
internalLast
internalPrevious
* This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor moved to the last row; - * false otherwise + * @return {@code true} if the cursor moved to the last row; + * {@code false} otherwise * @throws SQLException if an error occurs */ protected boolean internalLast() throws SQLException { @@ -2269,12 +2277,12 @@ } /** - * Returns the number of the current row in this CachedRowSetImpl + * Returns the number of the current row in this {@code CachedRowSetImpl} * object. The first row is number 1, the second number 2, and so on. * - * @return the number of the current row; 0 if there is no + * @return the number of the current row; {@code 0} if there is no * current row - * @throws SQLException if an error occurs; or if the CacheRowSetImpl + * @throws SQLException if an error occurs; or if the {@code CacheRowSetImpl} * is empty */ public int getRow() throws SQLException { @@ -2282,51 +2290,51 @@ } /** - * Moves this CachedRowSetImpl object's cursor to the row number + * Moves this {@code CachedRowSetImpl} object's cursor to the row number * specified. * *
CacheRowSetImpl
If the number is positive, the cursor moves to an absolute row with * respect to the beginning of the rowset. The first row is row 1, the second * is row 2, and so on. For example, the following command, in which - * crs is a CachedRowSetImpl object, moves the cursor + * {@code crs} is a {@code CachedRowSetImpl} object, moves the cursor * to the fourth row, starting from the beginning of the rowset. - *
crs
+ * {@code * * crs.absolute(4); * - *
{@code * * crs.absolute(4); * - *
* If the number is negative, the cursor moves to an absolute row position * with respect to the end of the rowset. For example, calling - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row, counting * from the beginning. - *
+ * {@code * * crs.absolute(-4); * - *
{@code * * crs.absolute(-4); * - *
- * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. * * @param row a positive number to indicate the row, starting row numbering from - * the first row, which is 1; a negative number to indicate + * the first row, which is {@code 1}; a negative number to indicate * the row, starting row numbering from the last row, which is - * -1; it must not be 0 - * @return true if the cursor is on the rowset; false + * {@code -1}; it must not be {@code 0} + * @return {@code true} if the cursor is on the rowset; {@code false} * otherwise - * @throws SQLException if the given cursor position is 0 or the - * type of this rowset is ResultSet.TYPE_FORWARD_ONLY + * @throws SQLException if the given cursor position is {@code 0} or the + * type of this rowset is {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean absolute( int row ) throws SQLException { throw new UnsupportedOperationException(); @@ -2340,80 +2348,80 @@ * If the number is positive, the cursor moves the specified number of * rows toward the end of the rowset, starting at the current row. * For example, the following command, in which - * crs is a CachedRowSetImpl object with 100 rows, + * {@code crs} is a {@code CachedRowSetImpl} object with 100 rows, * moves the cursor forward four rows from the current row. If the * current row is 50, the cursor would move to row 54. - *
+ * {@code * * crs.relative(4); * - *
{@code * * crs.relative(4); * - *
* If the number is negative, the cursor moves back toward the beginning * the specified number of rows, starting at the current row. * For example, calling the method - * absolute(-1) positions the cursor on the last row, - * absolute(-2) moves it on the next-to-last row, and so on. - * If the CachedRowSetImpl object crs has five rows, + * {@code absolute(-1)} positions the cursor on the last row, + * {@code absolute(-2)} moves it on the next-to-last row, and so on. + * If the {@code CachedRowSetImpl} object {@code crs} has five rows, * the following command moves the cursor to the fourth-to-last row, which * in the case of a rowset with five rows, is also the second row * from the beginning. - *
- * Note: Calling absolute(1) is the same as calling the - * method first(). Calling absolute(-1) is the - * same as calling last(). Calling relative(0) + * Note: Calling {@code absolute(1)} is the same as calling the + * method {@code first()}. Calling {@code absolute(-1)} is the + * same as calling {@code last()}. Calling {@code relative(0)} * is valid, but it does not change the cursor position. * - * @param rows an int indicating the number of rows to move + * @param rows an {@code int} indicating the number of rows to move * the cursor, starting at the current row; a positive number * moves the cursor forward; a negative number moves the cursor * backward; must not move the cursor past the valid * rows - * @return true if the cursor is on a row in this - * CachedRowSetImpl object; false + * @return {@code true} if the cursor is on a row in this + * {@code CachedRowSetImpl} object; {@code false} * otherwise * @throws SQLException if there are no rows in this rowset, the cursor is * positioned either before the first row or after the last row, or - * the rowset is type ResultSet.TYPE_FORWARD_ONLY + * the rowset is type {@code ResultSet.TYPE_FORWARD_ONLY} */ public boolean relative(int rows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves this CachedRowSetImpl object's cursor to the - * previous row and returns true if the cursor is on - * a valid row or false if it is not. + * Moves this {@code CachedRowSetImpl} object's cursor to the + * previous row and returns {@code true} if the cursor is on + * a valid row or {@code false} if it is not. * This method also notifies all listeners registered with this - * CachedRowSetImpl object that its cursor has moved. + * {@code CachedRowSetImpl} object that its cursor has moved. *
- * Note: calling the method previous() is not the same - * as calling the method relative(-1). This is true - * because it is possible to call previous() from the insert + * Note: calling the method {@code previous()} is not the same + * as calling the method {@code relative(-1)}. This is true + * because it is possible to call {@code previous()} from the insert * row, from after the last row, or from the current row, whereas - * relative may only be called from the current row. + * {@code relative} may only be called from the current row. *
- * The method previous may used in a while + * The method {@code previous} may used in a {@code while} * loop to iterate through a rowset starting after the last row - * and moving toward the beginning. The loop ends when previous - * returns false, meaning that there are no more rows. + * and moving toward the beginning. The loop ends when {@code previous} + * returns {@code false}, meaning that there are no more rows. * For example, the following code fragment retrieves all the data in - * the CachedRowSetImpl object crs, which has + * the {@code CachedRowSetImpl} object {@code crs}, which has * three columns. Note that the cursor must initially be positioned * after the last row so that the first call to the method - * previous places the cursor on the last line. - *
previous
while
+ * {@code previous} places the cursor on the last line. + * {@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - *
{@code * * crs.afterLast(); * while (previous()) { @@ -2423,33 +2431,33 @@ * System.out.println(name + " " + age + " " + ssn); * } * - *
- * This method is called internally by the method previous. + * This method is called internally by the method {@code previous}. *
* This is a implementation only method and is not required as a standard - * implementation of the CachedRowSet interface. + * implementation of the {@code CachedRowSet} interface. * - * @return true if the cursor is on a row in this rowset; - * false when the cursor reaches the position before + * @return {@code true} if the cursor is on a row in this rowset; + * {@code false} when the cursor reaches the position before * the first row * @throws SQLException if an error occurs */ @@ -2463,14 +2471,14 @@ //--------------------------------------------------------------------- /** - * Indicates whether the current row of this CachedRowSetImpl + * Indicates whether the current row of this {@code CachedRowSetImpl} * object has been updated. The value returned - * depends on whether this rowset can detect updates: false + * depends on whether this rowset can detect updates: {@code false} * will always be returned if it does not detect updates. * - * @return true if the row has been visibly updated + * @return {@code true} if the row has been visibly updated * by the owner or another and updates are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2482,13 +2490,13 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * * @param idx the index identifier of the column that may be have been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2500,14 +2508,14 @@ /** * Indicates whether the designated column of the current row of - * this CachedRowSetImpl object has been updated. The + * this {@code CachedRowSetImpl} object has been updated. The * value returned depends on whether this rowset can detcted updates: - * false will always be returned if it does not detect updates. + * {@code false} will always be returned if it does not detect updates. * - * @param columnName the String column name column that may be have + * @param columnName the {@code String} column name column that may be have * been updated. - * @return true is the designated column has been updated - * and the rowset detects updates; false if the rowset has not + * @return {@code true} is the designated column has been updated + * and the rowset detects updates; {@code false} if the rowset has not * been updated or the rowset does not detect updates * @throws SQLException if the cursor is on the insert row or not * on a valid row @@ -2521,8 +2529,8 @@ * Indicates whether the current row has been inserted. The value returned * depends on whether or not the rowset can detect visible inserts. * - * @return true if a row has been inserted and inserts are detected; - * false otherwise + * @return {@code true} if a row has been inserted and inserts are detected; + * {@code false} otherwise * @throws SQLException if the cursor is on the insert row or not * not on a valid row * @@ -2536,12 +2544,12 @@ * Indicates whether the current row has been deleted. A deleted row * may leave a visible "hole" in a rowset. This method can be used to * detect such holes if the rowset can detect deletions. This method - * will always return false if this rowset cannot detect + * will always return {@code false} if this rowset cannot detect * deletions. * - * @return true if (1)the current row is blank, indicating that + * @return {@code true} if (1)the current row is blank, indicating that * the row has been deleted, and (2)deletions are detected; - * false otherwise + * {@code false} otherwise * @throws SQLException if the cursor is on a valid row in this rowset * @see DatabaseMetaData#deletesAreDetected */ @@ -2551,8 +2559,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. *
* This method updates a column value in the current row or the insert * row of this rowset; however, another method must be called to complete @@ -2565,15 +2573,15 @@ *
* In order to propagate updates in this rowset to the underlying * data source, an application must call the method {@link #acceptChanges} - * after it calls either updateRow or insertRow. + * after it calls either {@code updateRow} or {@code insertRow}. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(int columnIndex) throws SQLException { throw new UnsupportedOperationException(); @@ -2581,8 +2589,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2593,14 +2601,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(int columnIndex, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -2608,8 +2616,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2620,14 +2628,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(int columnIndex, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -2635,8 +2643,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2647,14 +2655,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(int columnIndex, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -2662,8 +2670,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2674,14 +2682,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(int columnIndex, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -2689,8 +2697,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2701,14 +2709,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(int columnIndex, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -2717,8 +2725,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2729,14 +2737,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(int columnIndex, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -2744,8 +2752,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2756,14 +2764,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(int columnIndex, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -2771,8 +2779,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -2783,14 +2791,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(int columnIndex, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -2798,8 +2806,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. *
* This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2810,17 +2818,17 @@ * as inserted. Both of these methods must be called before the * cursor moves to another row. *
- * The method acceptChanges must be called if the + * The method {@code acceptChanges} must be called if the * updated values are to be written back to the underlying database. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(int columnIndex, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -2828,8 +2836,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2840,14 +2848,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(int columnIndex, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -2855,8 +2863,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2867,15 +2875,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(int columnIndex, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -2883,8 +2891,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2895,15 +2903,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL TIME or TIMESTAMP, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * an SQL {@code TIME} or {@code TIMESTAMP}, or + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(int columnIndex, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -2911,8 +2919,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2923,16 +2931,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the type of the designated column is not - * an SQL DATE, TIME, or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * an SQL {@code DATE}, {@code TIME}, or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(int columnIndex, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -2940,7 +2948,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. *
Date
Time
Timestamp
* This method updates a column value in either the current row or @@ -2952,8 +2960,8 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -2965,8 +2973,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. *
* This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -2977,17 +2985,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not binary, or - * (4) this rowset is ResultSet.CONCUR_READ_ONLY + * (4) this rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(int columnIndex, java.io.InputStream x,int length) throws SQLException { throw new UnsupportedOperationException(); @@ -2995,8 +3003,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. *
BINARY
* This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3007,19 +3015,19 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param x the new column value; must be a java.io.Reader - * containing BINARY, VARBINARY, - * LONGVARBINARY, CHAR, VARCHAR, - * or LONGVARCHAR data + * @param x the new column value; must be a {@code java.io.Reader} + * containing {@code BINARY}, {@code VARBINARY}, + * {@code LONGVARBINARY}, {@code CHAR}, {@code VARCHAR}, + * or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, (3) the data in the stream is not a binary or * character type, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(int columnIndex, java.io.Reader x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3027,11 +3035,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter indicates + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter indicates * the number of digits to the right of the decimal point and is ignored * if the new column value is not a type that will be mapped to an SQL - * DECIMAL or NUMERIC value. + * {@code DECIMAL} or {@code NUMERIC} value. *
CHAR
DECIMAL
* This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3042,16 +3050,16 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3059,8 +3067,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. *
* This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3071,14 +3079,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset * @param x the new column value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(int columnIndex, Object x) throws SQLException { throw new UnsupportedOperationException(); @@ -3087,8 +3095,8 @@ /** * Sets the designated nullable column in the current row or the - * insert row of this CachedRowSetImpl object with - * null value. + * insert row of this {@code CachedRowSetImpl} object with + * {@code null} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3098,12 +3106,12 @@ * must be called, which will insert the new row into both this rowset * and the database. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateNull(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -3111,8 +3119,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * boolean value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code boolean} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3123,13 +3131,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBoolean(String columnName, boolean x) throws SQLException { throw new UnsupportedOperationException(); @@ -3137,8 +3145,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3149,13 +3157,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateByte(String columnName, byte x) throws SQLException { throw new UnsupportedOperationException(); @@ -3163,8 +3171,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * short value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code short} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3175,13 +3183,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateShort(String columnName, short x) throws SQLException { throw new UnsupportedOperationException(); @@ -3189,8 +3197,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * int value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code int} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3201,13 +3209,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateInt(String columnName, int x) throws SQLException { throw new UnsupportedOperationException(); @@ -3215,8 +3223,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * long value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code long} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3227,13 +3235,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateLong(String columnName, long x) throws SQLException { throw new UnsupportedOperationException(); @@ -3241,8 +3249,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * float value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code float} value. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3253,13 +3261,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateFloat(String columnName, float x) throws SQLException { throw new UnsupportedOperationException(); @@ -3267,8 +3275,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3279,13 +3287,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDouble(String columnName, double x) throws SQLException { throw new UnsupportedOperationException(); @@ -3293,8 +3301,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.math.BigDecimal object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.math.BigDecimal} object. *
* This method updates a column value in the current row or the insert * row of this rowset, but it does not update the database. @@ -3305,13 +3313,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBigDecimal(String columnName, BigDecimal x) throws SQLException { throw new UnsupportedOperationException(); @@ -3319,8 +3327,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * String object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code String} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3331,13 +3339,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateString(String columnName, String x) throws SQLException { throw new UnsupportedOperationException(); @@ -3345,8 +3353,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * byte array. + * row of this {@code CachedRowSetImpl} object with the given + * {@code byte} array. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3357,13 +3365,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBytes(String columnName, byte x[]) throws SQLException { throw new UnsupportedOperationException(); @@ -3371,8 +3379,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Date object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Date} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3383,15 +3391,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateDate(String columnName, java.sql.Date x) throws SQLException { throw new UnsupportedOperationException(); @@ -3399,8 +3407,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Time object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Time} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3411,15 +3419,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL TIME or - * TIMESTAMP, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code TIME} or + * {@code TIMESTAMP}, or (4) this rowset is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTime(String columnName, java.sql.Time x) throws SQLException { throw new UnsupportedOperationException(); @@ -3427,8 +3435,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Timestamp object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Timestamp} object. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3439,7 +3447,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if the given column index is out of bounds or @@ -3448,9 +3456,9 @@ * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the type - * of the designated column is not an SQL DATE, - * TIME, or TIMESTAMP, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * of the designated column is not an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP}, or (4) this + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateTimestamp(String columnName, java.sql.Timestamp x) throws SQLException { throw new UnsupportedOperationException(); @@ -3458,7 +3466,7 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given + * row of this {@code CachedRowSetImpl} object with the given * ASCII stream value. *
* This method updates a column value in either the current row or @@ -3470,7 +3478,7 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param length the number of one-byte ASCII characters in the stream @@ -3483,8 +3491,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.InputStream object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.InputStream} object. *
* This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3495,17 +3503,17 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param x the new column value; must be a java.io.InputStream - * containing BINARY, VARBINARY, or - * LONGVARBINARY data + * @param x the new column value; must be a {@code java.io.InputStream} + * containing {@code BINARY}, {@code VARBINARY}, or + * {@code LONGVARBINARY} data * @param length the length of the stream in bytes * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not binary, or (4) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBinaryStream(String columnName, java.io.InputStream x, int length) throws SQLException { throw new UnsupportedOperationException(); @@ -3513,8 +3521,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.io.Reader object. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.io.Reader} object. *
* This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3525,18 +3533,18 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param reader the new column value; must be a - * java.io.Reader containing BINARY, - * VARBINARY, LONGVARBINARY, CHAR, - * VARCHAR, or LONGVARCHAR data + * {@code java.io.Reader} containing {@code BINARY}, + * {@code VARBINARY}, {@code LONGVARBINARY}, {@code CHAR}, + * {@code VARCHAR}, or {@code LONGVARCHAR} data * @param length the length of the stream in characters * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, (3) the data * in the stream is not a binary or character type, or (4) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateCharacterStream(String columnName, java.io.Reader reader, @@ -3546,11 +3554,11 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. The scale parameter + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. The {@code scale} parameter * indicates the number of digits to the right of the decimal point * and is ignored if the new column value is not a type that will be - * mapped to an SQL DECIMAL or NUMERIC value. + * mapped to an SQL {@code DECIMAL} or {@code NUMERIC} value. *
* This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3561,15 +3569,15 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @param scale the number of digits to the right of the decimal point (for - * DECIMAL and NUMERIC types only) + * {@code DECIMAL} and {@code NUMERIC} types only) * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x, int scale) throws SQLException { throw new UnsupportedOperationException(); @@ -3577,8 +3585,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * Object value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code Object} value. *
* This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -3589,20 +3597,20 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case * @param x the new column value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateObject(String columnName, Object x) throws SQLException { throw new UnsupportedOperationException(); } /** - * Inserts the contents of this CachedRowSetImpl object's insert + * Inserts the contents of this {@code CachedRowSetImpl} object's insert * row into this rowset immediately following the current row. * If the current row is the * position after the last row or before the first row, the new row will @@ -3614,14 +3622,14 @@ * @throws SQLException if (1) the cursor is not on the insert row, * (2) one or more of the non-nullable columns in the insert * row has not been given a value, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void insertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Marks the current row of this CachedRowSetImpl object as + * Marks the current row of this {@code CachedRowSetImpl} object as * updated and notifies listeners registered with this rowset that the * row has changed. *
@@ -3631,26 +3639,26 @@ * and the updates made before the cursor moved will be lost. * * @throws SQLException if the cursor is on the insert row or this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Deletes the current row from this CachedRowSetImpl object and + * Deletes the current row from this {@code CachedRowSetImpl} object and * notifies listeners registered with this rowset that a row has changed. * This method cannot be called when the cursor is on the insert row. *
* This method marks the current row as deleted, but it does not delete * the row from the underlying data source. The method - * acceptChanges must be called to delete the row in + * {@code acceptChanges} must be called to delete the row in * the data source. * * @throws SQLException if (1) this method is called when the cursor * is on the insert row, before the first row, or after the * last row or (2) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void deleteRow() throws SQLException { throw new UnsupportedOperationException(); @@ -3659,7 +3667,7 @@ /** * Sets the current row with its original value and marks the row as * not updated, thus undoing any changes made to the row since the - * last call to the methods updateRow or deleteRow. + * last call to the methods {@code updateRow} or {@code deleteRow}. * This method should be called only when the cursor is on a row in * this rowset. * @@ -3672,11 +3680,11 @@ /** * Rolls back any updates made to the current row of this - * CachedRowSetImpl object and notifies listeners that + * {@code CachedRowSetImpl} object and notifies listeners that * a row has changed. To have an effect, this method - * must be called after an updateXXX method has been - * called and before the method updateRow has been called. - * If no updates have been made or the method updateRow + * must be called after an {@code updateXXX} method has been + * called and before the method {@code updateRow} has been called. + * If no updates have been made or the method {@code updateRow} * has already been called, this method has no effect. * * @throws SQLException if the cursor is on the insert row, before the @@ -3687,39 +3695,39 @@ } /** - * Moves the cursor for this CachedRowSetImpl object + * Moves the cursor for this {@code CachedRowSetImpl} object * to the insert row. The current row in the rowset is remembered * while the cursor is on the insert row. *
deleteRow
* The insert row is a special row associated with an updatable * rowset. It is essentially a buffer where a new row may - * be constructed by calling the appropriate updateXXX + * be constructed by calling the appropriate {@code updateXXX} * methods to assign a value to each column in the row. A complete * row must be constructed; that is, every column that is not nullable * must be assigned a value. In order for the new row to become part - * of this rowset, the method insertRow must be called + * of this rowset, the method {@code insertRow} must be called * before the cursor is moved back to the rowset. *
* Only certain methods may be invoked while the cursor is on the insert * row; many methods throw an exception if they are called while the - * cursor is there. In addition to the updateXXX - * and insertRow methods, only the getXXX methods - * may be called when the cursor is on the insert row. A getXXX - * method should be called on a column only after an updateXXX + * cursor is there. In addition to the {@code updateXXX} + * and {@code insertRow} methods, only the {@code getXXX} methods + * may be called when the cursor is on the insert row. A {@code getXXX} + * method should be called on a column only after an {@code updateXXX} * method has been called on that column; otherwise, the value returned is * undetermined. * - * @throws SQLException if this CachedRowSetImpl object is - * ResultSet.CONCUR_READ_ONLY + * @throws SQLException if this {@code CachedRowSetImpl} object is + * {@code ResultSet.CONCUR_READ_ONLY} */ public void moveToInsertRow() throws SQLException { throw new UnsupportedOperationException(); } /** - * Moves the cursor for this CachedRowSetImpl object to + * Moves the cursor for this {@code CachedRowSetImpl} object to * the current row. The current row is the row the cursor was on - * when the method moveToInsertRow was called. + * when the method {@code moveToInsertRow} was called. *
moveToInsertRow
* Calling this method has no effect unless it is called while the * cursor is on the insert row. @@ -3731,9 +3739,9 @@ } /** - * Returns null. + * Returns {@code null}. * - * @return null + * @return {@code null} * @throws SQLException if an error occurs */ public Statement getStatement() throws SQLException { @@ -3742,18 +3750,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column index is out of bounds or * the cursor is not on one of this rowset's rows or its * insert row @@ -3767,17 +3775,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL REF value + * SQL {@code REF} value * @see #getRef(String) */ public Ref getRef(int columnIndex) throws SQLException { @@ -3786,17 +3794,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL BLOB value + * SQL {@code BLOB} value * @see #getBlob(String) */ public Blob getBlob(int columnIndex) throws SQLException { @@ -3805,17 +3813,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return a Clob object representing an SQL CLOB value + * @return a {@code Clob} object representing an SQL {@code CLOB} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL CLOB value + * SQL {@code CLOB} value * @see #getClob(String) */ public Clob getClob(int columnIndex) throws SQLException { @@ -3824,18 +3832,18 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming language. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL ARRAY value + * SQL {@code ARRAY} value * @see #getArray(String) */ public Array getArray(int columnIndex) throws SQLException { @@ -3844,17 +3852,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Object in + * {@code CachedRowSetImpl} object as an {@code Object} in * the Java programming language, using the given - * java.util.Map object to custom map the value if + * {@code java.util.Map} object to custom map the value if * appropriate. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param map a java.util.Map object showing the mapping + * @param map a {@code java.util.Map} object showing the mapping * from SQL type names to classes in the Java programming * language - * @return an Object representing the SQL value + * @return an {@code Object} representing the SQL value * @throws SQLException if the given column name is not the name of * a column in this rowset or the cursor is not on one of * this rowset's rows or its insert row @@ -3867,16 +3875,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Ref object + * {@code CachedRowSetImpl} object as a {@code Ref} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Ref object representing an SQL REF value + * @return a {@code Ref} object representing an SQL{@code REF} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the column value - * is not an SQL REF value + * is not an SQL {@code REF} value * @see #getRef(int) */ public Ref getRef(String colName) throws SQLException { @@ -3885,16 +3893,16 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Blob object + * {@code CachedRowSetImpl} object as a {@code Blob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Blob object representing an SQL BLOB value + * @return a {@code Blob} object representing an SQL {@code BLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL BLOB value + * column does not store an SQL {@code BLOB} value * @see #getBlob(int) */ public Blob getBlob(String colName) throws SQLException { @@ -3903,17 +3911,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a Clob object + * {@code CachedRowSetImpl} object as a {@code Clob} object * in the Java programming language. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return a Clob object representing an SQL - * CLOB value + * @return a {@code Clob} object representing an SQL + * {@code CLOB} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL CLOB value + * column does not store an SQL {@code CLOB} value * @see #getClob(int) */ public Clob getClob(String colName) throws SQLException { @@ -3922,17 +3930,17 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as an Array object + * {@code CachedRowSetImpl} object as an {@code Array} object * in the Java programming langugage. * - * @param colName a String object that must match the + * @param colName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @return an Array object representing an SQL - * ARRAY value + * @return an {@code Array} object representing an SQL + * {@code ARRAY} value * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL ARRAY value + * column does not store an SQL {@code ARRAY} value * @see #getArray(int) */ public Array getArray(String colName) throws SQLException { @@ -3941,22 +3949,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3964,21 +3972,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Date - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Date} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE or - * TIMESTAMP value + * column does not store an SQL {@code DATE} or + * {@code TIMESTAMP} value */ public java.sql.Date getDate(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -3986,22 +3994,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4009,21 +4017,21 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Time - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Time} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Time getTime(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4031,22 +4039,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a java.sql.Timestamp - * object, using the given Calendar object to construct an + * of this {@code CachedRowSetImpl} object as a {@code java.sql.Timestamp} + * object, using the given {@code Calendar} object to construct an * appropriate millisecond value for the date. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in the rowset - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL TIME or - * TIMESTAMP value + * column does not store an SQL {@code TIME} or + * {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(int columnIndex, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4054,22 +4062,22 @@ /** * Retrieves the value of the designated column in the current row - * of this CachedRowSetImpl object as a - * java.sql.Timestamp object, using the given - * Calendar object to construct an appropriate + * of this {@code CachedRowSetImpl} object as a + * {@code java.sql.Timestamp} object, using the given + * {@code Calendar} object to construct an appropriate * millisecond value for the date. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param cal the java.util.Calendar object to use in + * @param cal the {@code java.util.Calendar} object to use in * constructing the date - * @return the column value; if the value is SQL NULL, - * the result is null + * @return the column value; if the value is SQL {@code NULL}, + * the result is {@code null} * @throws SQLException if (1) the given column name is not the name of * a column in this rowset, (2) the cursor is not on one of * this rowset's rows or its insert row, or (3) the designated - * column does not store an SQL DATE, - * TIME, or TIMESTAMP value + * column does not store an SQL {@code DATE}, + * {@code TIME}, or {@code TIMESTAMP} value */ public java.sql.Timestamp getTimestamp(String columnName, Calendar cal) throws SQLException { throw new UnsupportedOperationException(); @@ -4080,13 +4088,13 @@ */ /** - * Retrieves the Connection object passed to this - * CachedRowSetImpl object. This connection may be + * Retrieves the {@code Connection} object passed to this + * {@code CachedRowSetImpl} object. This connection may be * used to populate this rowset with data or to write data back * to its underlying data source. * - * @return the Connection object passed to this rowset; - * may be null if there is no connection + * @return the {@code Connection} object passed to this rowset; + * may be {@code null} if there is no connection * @throws SQLException if an error occurs */ public Connection getConnection() throws SQLException{ @@ -4094,10 +4102,10 @@ } /** - * Sets the metadata for this CachedRowSetImpl object - * with the given RowSetMetaData object. + * Sets the metadata for this {@code CachedRowSetImpl} object + * with the given {@code RowSetMetaData} object. * - * @param md a RowSetMetaData object instance containing + * @param md a {@code RowSetMetaData} object instance containing * metadata about the columsn in the rowset * @throws SQLException if invalid meta data is supplied to the * rowset @@ -4108,17 +4116,17 @@ /** * Returns a result set containing the original value of the rowset. The - * original value is the state of the CachedRowSetImpl after the + * original value is the state of the {@code CachedRowSetImpl} after the * last population or synchronization (whichever occurred most recently) with * the data source. *
* The cursor is positioned before the first row in the result set. - * Only rows contained in the result set returned by getOriginal() + * Only rows contained in the result set returned by {@code getOriginal()} * are said to have an original value. * * @return the original result set of the rowset * @throws SQLException if an error occurs produce the - * ResultSet object + * {@code ResultSet} object */ public ResultSet getOriginal() throws SQLException { throw new UnsupportedOperationException(); @@ -4127,7 +4135,7 @@ /** * Returns a result set containing the original value of the current * row only. - * The original value is the state of the CachedRowSetImpl after + * The original value is the state of the {@code CachedRowSetImpl} after * the last population or synchronization (whichever occurred most recently) * with the data source. * @@ -4153,7 +4161,7 @@ /** * Marks all rows in this rowset as being original rows. Any updates * made to the rows become the original values for the rowset. - * Calls to the method setOriginal connot be reversed. + * Calls to the method {@code setOriginal} connot be reversed. * * @throws SQLException if an error occurs */ @@ -4165,8 +4173,8 @@ * Returns an identifier for the object (table) that was used to create this * rowset. * - * @return a String object that identifies the table from - * which this CachedRowSetImpl object was derived + * @return a {@code String} object that identifies the table from + * which this {@code CachedRowSetImpl} object was derived * @throws SQLException if an error occurs */ public String getTableName() throws SQLException { @@ -4177,8 +4185,8 @@ * Sets the identifier for the table from which this rowset was derived * to the given table name. * - * @param tabName a String object that identifies the - * table from which this CachedRowSetImpl object + * @param tabName a {@code String} object that identifies the + * table from which this {@code CachedRowSetImpl} object * was derived * @throws SQLException if an error occurs */ @@ -4188,7 +4196,7 @@ /** * Returns the columns that make a key to uniquely identify a - * row in this CachedRowSetImpl object. + * row in this {@code CachedRowSetImpl} object. * * @return an array of column numbers that constitutes a primary * key for this rowset. This array should be empty @@ -4203,16 +4211,16 @@ /** - * Sets this CachedRowSetImpl object's - * keyCols field with the given array of column + * Sets this {@code CachedRowSetImpl} object's + * {@code keyCols} field with the given array of column * numbers, which forms a key for uniquely identifying a row * in this rowset. * - * @param keys an array of int indicating the + * @param keys an array of {@code int} indicating the * columns that form a primary key for this - * CachedRowSetImpl object; every + * {@code CachedRowSetImpl} object; every * element in the array must be greater than - * 0 and less than or equal to the number + * {@code 0} and less than or equal to the number * of columns in this rowset * @throws SQLException if any of the numbers in the * given array is not valid for this rowset @@ -4224,8 +4232,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4236,14 +4244,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(int columnIndex, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4251,8 +4259,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4263,13 +4271,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param ref the new column java.sql.Ref value + * @param ref the new column {@code java.sql.Ref} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateRef(String columnName, java.sql.Ref ref) throws SQLException { throw new UnsupportedOperationException(); @@ -4277,8 +4285,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4289,14 +4297,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param c the new column Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + *
getOriginal()
setOriginal
java.sql.Ref
Clob value + * @param c the new column {@code Clob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(int columnIndex, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4304,8 +4312,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * double value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code double} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4316,13 +4324,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param c the new column Clobvalue + * @param c the new column {@code Clob}value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateClob(String columnName, Clob c) throws SQLException { throw new UnsupportedOperationException(); @@ -4330,8 +4338,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4342,14 +4350,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(int columnIndex, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4357,8 +4365,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Blob value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Blob } value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4369,13 +4377,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param b the new column Blob value + * @param b the new column {@code Blob} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateBlob(String columnName, Blob b) throws SQLException { throw new UnsupportedOperationException(); @@ -4383,8 +4391,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array values. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} values. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4395,14 +4403,14 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnIndex the first column is 1, the second - * is 2, and so on; must be 1 or larger + * @param columnIndex the first column is {@code 1}, the second + * is {@code 2}, and so on; must be {@code 1} or larger * and equal to or less than the number of columns in this rowset - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) this rowset is - * ResultSet.CONCUR_READ_ONLY + * {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(int columnIndex, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4410,8 +4418,8 @@ /** * Sets the designated column in either the current row or the insert - * row of this CachedRowSetImpl object with the given - * java.sql.Array value. + * row of this {@code CachedRowSetImpl} object with the given + * {@code java.sql.Array} value. * * This method updates a column value in either the current row or * the insert row of this rowset, but it does not update the @@ -4422,13 +4430,13 @@ * and the database. Both of these methods must be called before the * cursor moves to another row. * - * @param columnName a String object that must match the + * @param columnName a {@code String} object that must match the * SQL name of a column in this rowset, ignoring case - * @param a the new column Array value + * @param a the new column {@code Array} value * @throws SQLException if (1) the given column name does not match the * name of a column in this rowset, (2) the cursor is not on * one of this rowset's rows or its insert row, or (3) this - * rowset is ResultSet.CONCUR_READ_ONLY + * rowset is {@code ResultSet.CONCUR_READ_ONLY} */ public void updateArray(String columnName, Array a) throws SQLException { throw new UnsupportedOperationException(); @@ -4437,7 +4445,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4445,7 +4453,7 @@ * @throws SQLException if (1) the given column index is out of bounds, * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(String) */ public java.net.URL getURL(int columnIndex) throws SQLException { @@ -4454,7 +4462,7 @@ /** * Retrieves the value of the designated column in this - * CachedRowSetImpl object as a java.net.URL object + * {@code CachedRowSetImpl} object as a {@code java.net.URL} object * in the Java programming language. * * @return a java.net.URL object containing the resource reference described by @@ -4463,7 +4471,7 @@ * in this rowset, or * (2) the cursor is not on one of this rowset's rows or its * insert row, or (3) the designated column does not store an - * SQL DATALINK value. + * SQL {@code DATALINK} value. * @see #getURL(int) */ public java.net.URL getURL(String columnName) throws SQLException { @@ -4472,20 +4480,20 @@ } /** - * The first warning reported by calls on this CachedRowSetImpl - * object is returned. Subsequent CachedRowSetImpl warnings will - * be chained to this SQLWarning. All RowSetWarnings + * The first warning reported by calls on this {@code CachedRowSetImpl} + * object is returned. Subsequent {@code CachedRowSetImpl} warnings will + * be chained to this {@code SQLWarning}. All {@code RowSetWarnings} * warnings are generated in the disconnected environment and remain a - * seperate warning chain to that provided by the getWarnings + * seperate warning chain to that provided by the {@code getWarnings} * method. * * The warning chain is automatically cleared each time a new * row is read. * * Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. * * The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. * * The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. * * The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. * * After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + *
RowSetWarnings
Note: This warning chain only covers warnings caused - * by CachedRowSet (and their child interface) - * methods. All SQLWarnings can be obtained using the - * getWarnings method which tracks warnings generated + * by {@code CachedRowSet} (and their child interface) + * methods. All {@code SQLWarnings} can be obtained using the + * {@code getWarnings} method which tracks warnings generated * by the underlying JDBC driver. * @return the first SQLWarning or null * @@ -4495,7 +4503,7 @@ } /** - * Commits all changes performed by the acceptChanges() + * Commits all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#commit @@ -4505,7 +4513,7 @@ } /** - * Rolls back all changes performed by the acceptChanges() + * Rolls back all changes performed by the {@code acceptChanges()} * methods * * @see java.sql.Connection#rollback @@ -4515,8 +4523,8 @@ } /** - * Rolls back all changes performed by the acceptChanges() - * to the last Savepoint transaction marker. + * Rolls back all changes performed by the {@code acceptChanges()} + * to the last {@code Savepoint} transaction marker. * * @see java.sql.Connection#rollback(Savepoint) */ @@ -4526,7 +4534,7 @@ /** * Unsets the designated parameter to the given int array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. *
SQLWarnings
acceptChanges()
* The parameter value unset by this method should be same @@ -4536,7 +4544,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int []) + * not the same as set using {@code setMatchColumn(int [])} */ public void unsetMatchColumn(int[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); @@ -4544,7 +4552,7 @@ /** * Unsets the designated parameter to the given String array. - * This was set using setMatchColumn + * This was set using {@code setMatchColumn} * as the column which will form the basis of the join. *
* The parameter value unset by this method should be same @@ -4554,18 +4562,18 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String []) + * not the same as set using {@code setMatchColumn(String [])} */ public void unsetMatchColumn(String[] columnIdxes) throws SQLException { throw new UnsupportedOperationException(); } /** - * Retrieves the column name as String array - * that was set using setMatchColumn(String []) + * Retrieves the column name as {@code String} array + * that was set using {@code setMatchColumn(String [])} * for this rowset. * - * @return a String array object that contains the column names + * @return a {@code String} array object that contains the column names * for the rowset which has this the match columns * * @throws SQLException if an error occurs or column name is not set @@ -4575,10 +4583,10 @@ } /** - * Retrieves the column id as int array that was set using - * setMatchColumn(int []) for this rowset. + * Retrieves the column id as {@code int} array that was set using + * {@code setMatchColumn(int [])} for this rowset. * - * @return a int array object that contains the column ids + * @return a {@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 @@ -4590,17 +4598,17 @@ /** * Sets the designated parameter to the given int array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. *
* The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumnIndexes is called. + * command when the method {@code getMatchColumnIndexes} is called. * * @param columnIdxes the indexes into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4611,12 +4619,12 @@ /** * Sets the designated parameter to the given String array. * This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. *
* The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnNames the name of the column into this rowset * object's internal representation of parameter values @@ -4629,19 +4637,19 @@ /** - * Sets the designated parameter to the given int + * Sets the designated parameter to the given {@code int} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. *
* The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnIdx the index into this rowset * object's internal representation of parameter values; the * first parameter is 0, the second is 1, and so on; must be - * 0 or greater + * {@code 0} or greater * @throws SQLException if an error occurs or the * parameter index is out of bounds */ @@ -4650,14 +4658,14 @@ } /** - * Sets the designated parameter to the given String + * Sets the designated parameter to the given {@code String} * object. This forms the basis of the join for the - * JoinRowSet as the column which will form the basis of the + * {@code JoinRowSet} as the column which will form the basis of the * join. *
* The parameter value set by this method is stored internally and * will be supplied as the appropriate parameter in this rowset's - * command when the method getMatchColumn is called. + * command when the method {@code getMatchColumn} is called. * * @param columnName the name of the column into this rowset * object's internal representation of parameter values @@ -4669,8 +4677,8 @@ } /** - * Unsets the designated parameter to the given int - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code int} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. *
* The parameter value unset by this method should be same @@ -4680,15 +4688,15 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnIdx is - * not the same as set using setMatchColumn(int) + * not the same as set using {@code setMatchColumn(int)} */ public void unsetMatchColumn(int columnIdx) throws SQLException { throw new UnsupportedOperationException(); } /** - * Unsets the designated parameter to the given String - * object. This was set using setMatchColumn + * Unsets the designated parameter to the given {@code String} + * object. This was set using {@code setMatchColumn} * as the column which will form the basis of the join. *
* The parameter value unset by this method should be same @@ -4698,7 +4706,7 @@ * object's internal representation of parameter values * @throws SQLException if an error occurs or the * parameter index is out of bounds or if the columnName is - * not the same as set using setMatchColumn(String) + * not the same as set using {@code setMatchColumn(String)} */ public void unsetMatchColumn(String columnName) throws SQLException { throw new UnsupportedOperationException(); @@ -4706,48 +4714,48 @@ /** * Notifies registered listeners that a RowSet object in the given RowSetEvent - * object has populated a number of additional rows. The numRows parameter - * ensures that this event will only be fired every numRow. + * object has populated a number of additional rows. The {@code numRows} parameter + * ensures that this event will only be fired every {@code numRow}. *
numRows
numRow
* The source of the event can be retrieved with the method event.getSource. * - * @param event a RowSetEvent object that contains the - * RowSet object that is the source of the events + * @param event a {@code RowSetEvent} object that contains the + * {@code RowSet} object that is the source of the events * @param numRows when populating, the number of rows interval on which the - * CachedRowSet populated should fire; the default value - * is zero; cannot be less than fetchSize or zero + * {@code CachedRowSet} populated should fire; the default value + * is zero; cannot be less than {@code fetchSize} or zero */ public void rowSetPopulated(RowSetEvent event, int numRows) throws SQLException { throw new UnsupportedOperationException(); } /** - * Populates this CachedRowSet object with data from - * the given ResultSet object. While related to the populate(ResultSet) + * Populates this {@code CachedRowSet} object with data from + * the given {@code ResultSet} object. While related to the {@code populate(ResultSet)} * method, an additional parameter is provided to allow starting position within - * the ResultSet from where to populate the CachedRowSet + * the {@code ResultSet} from where to populate the CachedRowSet * instance. * - * This method is an alternative to the method execute - * for filling the rowset with data. The method populate + * This method is an alternative to the method {@code execute} + * for filling the rowset with data. The method {@code populate} * does not require that the properties needed by the method - * execute, such as the command property, - * be set. This is true because the method populate - * is given the ResultSet object from + * {@code execute}, such as the {@code command} property, + * be set. This is true because the method {@code populate} + * is given the {@code ResultSet} object from * which to get data and thus does not need to use the properties * required for setting up a connection and executing this - * CachedRowSetImpl object's command. + * {@code CachedRowSetImpl} object's command. *
RowSetEvent
fetchSize
populate(ResultSet)
* After populating this rowset with data, the method - * populate sets the rowset's metadata and - * then sends a RowSetChangedEvent object + * {@code populate} sets the rowset's metadata and + * then sends a {@code RowSetChangedEvent} object * to all registered listeners prior to returning. * - * @param data the ResultSet object containing the data - * to be read into this CachedRowSetImpl object + * @param data the {@code ResultSet} object containing the data + * to be read into this {@code CachedRowSetImpl} object * @param start the integer specifing the position in the - * ResultSet object to popultate the - * CachedRowSetImpl object. + * {@code ResultSet} object to popultate the + * {@code CachedRowSetImpl} object. * @throws SQLException if an error occurs; or the max row setting is * violated while populating the RowSet.Also id the start position * is negative. @@ -4759,7 +4767,7 @@ } /** - * The nextPage gets the next page, that is a CachedRowSetImpl object + * The nextPage gets the next page, that is a {@code CachedRowSetImpl} object * containing the number of rows specified by page size. * @return boolean value true indicating whether there are more pages to come and * false indicating that this is the last page. @@ -4796,7 +4804,7 @@ * @return boolean value true if it retrieves the previous page, flase if it * is on the first page. * @throws SQLException if it is called before populate is called or ResultSet - * is of type ResultSet.TYPE_FORWARD_ONLY or if an error + * is of type {@code ResultSet.TYPE_FORWARD_ONLY} or if an error * occurs. */ public boolean previousPage() throws SQLException { @@ -4807,7 +4815,7 @@ * Updates the designated column with a character stream value, which will * have the specified number of bytes. The driver does the necessary conversion * from Java character format to the national character set in the database. - * It is intended for use when updating NCHAR,NVARCHAR and LONGNVARCHAR columns. + * It is intended for use when updating NCHAR, NVARCHAR and LONGNVARCHAR columns. * The updater methods are used to update column values in the current row or * the insert row. The updater methods do not update the underlying database; * instead the updateRow or insertRow methods are called to update the database. --- old/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.207466073 +0400 +++ new/src/java.sql.rowset/share/classes/com/sun/rowset/internal/WebRowSetXmlWriter.java 2015-06-05 21:04:36.039466073 +0400 @@ -36,24 +36,24 @@ import javax.sql.rowset.spi.*; /** - * An implementation of the XmlWriter interface, which writes a - * WebRowSet object to an output stream as an XML document. + * An implementation of the {@code XmlWriter} interface, which writes a + * {@code WebRowSet} object to an output stream as an XML document. */ public class WebRowSetXmlWriter implements XmlWriter, Serializable { /** - * The java.io.Writer object to which this WebRowSetXmlWriter - * object will write when its writeXML method is called. The value - * for this field is set with the java.io.Writer object given - * as the second argument to the writeXML method. + * The {@code java.io.Writer} object to which this {@code WebRowSetXmlWriter} + * object will write when its {@code writeXML} method is called. The value + * for this field is set with the {@code java.io.Writer} object given + * as the second argument to the {@code writeXML} method. */ private transient java.io.Writer writer; /** - * The java.util.Stack object that this WebRowSetXmlWriter + * The {@code java.util.Stack} object that this {@code WebRowSetXmlWriter} * object will use for storing the tags to be used for writing the calling - * WebRowSet object as an XML document. + * {@code WebRowSet} object as an XML document. */ private java.util.Stack stack; @@ -69,24 +69,24 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.Writer object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.Writer} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. * - * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - * * * @see URI * @see VmIdentifier --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.723466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/MonitoredVm.java 2015-06-05 21:04:37.551466072 +0400 @@ -74,9 +74,10 @@ * * @param patternString a string containing a pattern as described in * {@link java.util.regex.Pattern}. - * @return List - a List of {@link Monitor} objects that can be used to + * @return {@code List} - a List of {@link Monitor} + * objects that can be used to * monitor the instrumentation objects whose names match - * the given pattern. If no instrumentation objects have` + * the given pattern. If no instrumentation objects have * names matching the given pattern, then an empty List * is returned. * @throws MonitorException Thrown if an error occurs while communicating --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.223466071 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/VmIdentifier.java 2015-06-05 21:04:38.055466071 +0400 @@ -39,86 +39,85 @@ * [protocol:][//]lvmid[@hostname][:port][/servername] * * The only required component of this string is the Local Virtual Machine - * Identifier, or lvmid, which uniquely identifies the target + * Identifier, or {@code lvmid}, which uniquely identifies the target * Java Virtual Machine on a host. The optional components of the VmIdentifier * include: * - * protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - * - * hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - * - * port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * - * servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - * + * {@code protocol} - The communications protocol. A VmIdentifier + * omitting the protocol must be resolved against a HostIdentifier + * using {@link HostIdentifier#resolve}. + * + * {@code hostname} - A hostname or IP address indicating the target + * host. A VmIdentifier omitting the protocol must be resolved + * against a HostIdentifier using {@link HostIdentifier#resolve}. + * + * {@code port} - The port for the communications protocol. + * Treatment of the {@code port} parameter is implementation + * (protocol) specific. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * + * {@code servername} - The treatment of the Path, Query, and + * Fragment components of the VmIdentifier are implementation + * (protocol) dependent. A VmIdentifier omitting the protocol should + * be resolved against a HostIdentifier using + * {@link HostIdentifier#resolve}. + * * * * All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - * * * With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - * + * VmIdentifier strings must include a {@code lvmid}. Attempting to construct + * a non-file based VmIdentifier that doesn't include a {@code lvmid} + * component will result in a {@code MonitorException}. * * Here are some examples of VmIdentifier strings. * - * Relative URIs + * Relative URIs * - * 1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - * - * 1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - * - * 1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - * + * 1234 - Specifies the Java Virtual Machine + * identified by lvmid 1234 on an unnamed host. + * This string is transformed into the absolute form + * //1234, which must be resolved against a + * HostIdentifier. + * + * 1234@hostname - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol. + * This string is transformed into the absolute form + * //1234@hostname, which must be resolved against + * a HostIdentifier. + * + * 1234@hostname:2099 - Specifies the Java Virtual + * Machine identified by lvmid 1234 on host + * hostname with an unnamed protocol, but with + * port 2099. This string is transformed into + * the absolute form //1234@hostname:2099, which + * must be resolved against a HostIdentifier. + * * - * Absolute URIs + *
XmlWriter
java.io.Writer
WebRowSetXmlWriter
writeXML
java.util.Stack
- * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param wrt the java.io.Writer object to which - * caller will be written + * @param wrt the {@code java.io.Writer} object to which + * {@code caller} will be written * @exception SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ @@ -100,26 +100,26 @@ } /** - * Writes the given WebRowSet object as an XML document - * using the given java.io.OutputStream object. The XML document - * will include the WebRowSet object's data, metadata, and + * Writes the given {@code WebRowSet} object as an XML document + * using the given {@code java.io.OutputStream} object. The XML document + * will include the {@code WebRowSet} object's data, metadata, and * properties. If a data value has been updated, that information is also * included. *
xmlWriter
XmlWriter.writeXML
caller
java.io.OutputStream
- * Using stream is a faster way than using java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - *
java.io.Writer + * Using stream is a faster way than using {@code java.io.Writer} * - * This method is called by the XmlWriter object that is - * referenced in the calling WebRowSet object's - * xmlWriter field. The XmlWriter.writeXML + * This method is called by the {@code XmlWriter} object that is + * referenced in the calling {@code WebRowSet} object's + * {@code xmlWriter} field. The {@code XmlWriter.writeXML} * method passes to this method the arguments that were supplied to it. * - * @param caller the WebRowSet object to be written; must - * be a rowset for which this WebRowSetXmlWriter object + * @param caller the {@code WebRowSet} object to be written; must + * be a rowset for which this {@code WebRowSetXmlWriter} object * is the writer - * @param oStream the java.io.OutputStream object to which - * caller will be written + * @param oStream the {@code java.io.OutputStream} object to which + * {@code caller} will be written * @throws SQLException if a database access error occurs or - * this WebRowSetXmlWriter object is not the writer + * this {@code WebRowSetXmlWriter} object is not the writer * for the given rowset * @see XmlWriter#writeXML */ --- old/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.715466073 +0400 +++ new/src/jdk.jdi/share/classes/com/sun/tools/jdi/VirtualMachineManagerService.java 2015-06-05 21:04:36.547466073 +0400 @@ -37,7 +37,6 @@ /** * Replaces the default connector. * - * @return the default {@link LaunchingConnector} * @throws java.lang.IllegalArgumentException if the given * connector is not a member of the list returned by * {@link #launchingConnectors} --- old/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.219466072 +0400 +++ new/src/jdk.jvmstat/share/classes/sun/jvmstat/monitor/HostIdentifier.java 2015-06-05 21:04:37.047466072 +0400 @@ -81,16 +81,15 @@ * valid HostIdentifier strings: * * - * < null > - transformed into "//localhost" - * localhost - transformed into "//localhost" - * hostname - transformed into "//hostname" - * hostname:port - transformed into "//hostname:port" - * proto:hostname - transformed into "proto://hostname" - * proto:hostname:port - transformed into - * "proto://hostname:port" - * proto://hostname:port + * {@code } - transformed into "//localhost" + * localhost - transformed into "//localhost" + * hostname - transformed into "//hostname" + * hostname:port - transformed into "//hostname:port" + * proto:hostname - transformed into "proto://hostname" + * proto:hostname:port - transformed into + * "proto://hostname:port" + * proto://hostname:port * - *
< null > - transformed into "//localhost"
localhost - transformed into "//localhost"
hostname - transformed into "//hostname"
hostname:port - transformed into "//hostname:port"
proto:hostname - transformed into "proto://hostname"
proto:hostname:port - transformed into - * "proto://hostname:port"
proto://hostname:port
protocol - The communications protocol. A VmIdentifier - * omitting the protocol must be resolved against a HostIdentifier - * using {@link HostIdentifier#resolve}. - *
hostname - A hostname or IP address indicating the target - * host. A VmIdentifier omitting the protocol must be resolved - * against a HostIdentifier using {@link HostIdentifier#resolve}. - *
port - The port for the communications protocol. - * Treatment of the port parameter is implementation - * (protocol) specific. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - *
servername - The treatment of the Path, Query, and - * Fragment components of the VmIdentifier are implementation - * (protocol) dependent. A VmIdentifier omitting the protocol should - * be resolved against a HostIdentifier using - * {@link HostIdentifier#resolve}. - *
* All VmIdentifier instances are constructed as absolute, hierarchical URIs. * The constructors will accept relative (and even some malformed, * though convenient) URI strings. Such strings are transformed into * legitimate, absolute URI strings. - *
* With the exception of file: based VmIdentifier strings, all - * VmIdentifier strings must include a lvmid. Attempting to construct - * a non-file based VmIdentifier that doesn't include a lvmid - * component will result in a MonitorException. - *
* Here are some examples of VmIdentifier strings. *
Relative URIs
1234 - Specifies the Java Virtual Machine - * identified by lvmid 1234 on an unnamed host. - * This string is transformed into the absolute form - * //1234, which must be resolved against a - * HostIdentifier. - *
1234@hostname - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol. - * This string is transformed into the absolute form - * //1234@hostname, which must be resolved against - * a HostIdentifier. - *
1234@hostname:2099 - Specifies the Java Virtual - * Machine identified by lvmid 1234 on host - * hostname with an unnamed protocol, but with - * port 2099. This string is transformed into - * the absolute form //1234@hostname:2099, which - * must be resolved against a HostIdentifier. - *
Absolute URIs
rmi://1234@hostname:2099/remoteobjectname - - * Specifies the Java Virtual Machine identified by lvmid - * 1234 on host hostname accessed - * using the rmi: protocol through the rmi remote - * object named remoteobjectname as registered with - * the rmiserver on port 2099 on host - * hostname. - *
file:/path/file - Identifies a Java Virtual Machine - * through accessing a special file based protocol to use as - * the communications mechanism. - *
- * For example, a VmIdentifier that specifies only a lvmid + * For example, a VmIdentifier that specifies only a {@code lvmid} * will result in a HostIdentifier for localhost utilizing * the default local protocol, local:. A VmIdentifier that - * specifies both a vmid and a hostname will result + * specifies both a {@code vmid} and a {@code hostname} will result * in a HostIdentifier for the specified host with the default remote * protocol, rmi:, using the protocol defaults for the - * port and servername components. - *