archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-28 07:14:30 +02:00
Code Issues Projects Releases Packages Wiki Activity Actions

8252537: Updated @exception with @throws

Browse source 
8252536: Replace @exception with @throws for core-libs
8252539: Replace @exception with @throws java.rmi.activation package
8252540: Replace @exception with @throws java.rmi.registry package
8252541: Replace @exception with @throws java.rmi.server package

Reviewed-by: rriggs, sspitsyn, lancea
This commit is contained in:
Vipin Sharma 2020-10-02 14:50:53 +00:00 • committed by Lance Andersen
parent 406db1c270
commit dffe9db25c
86 changed files with 2109 additions and 2109 deletions
Download patch file Download diff file Expand all files Collapse all files

4
src/java.management/share/classes/java/lang/management/ClassLoadingMXBean.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2008, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -105,7 +105,7 @@ public interface ClassLoadingMXBean extends PlatformManagedObject {
* @param value {@code true} to enable the verbose output; * @param value {@code true} to enable the verbose output;
* {@code false} to disable. * {@code false} to disable.
* *
* @exception java.lang.SecurityException if a security manager * @throws java.lang.SecurityException if a security manager
* exists and the caller does not have * exists and the caller does not have
* ManagementPermission("control"). * ManagementPermission("control").
*/ */

4
src/java.management/share/classes/java/lang/management/ManagementFactory.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2019, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -465,7 +465,7 @@ public class ManagementFactory {
* MXBeans are registered into the platform {@code MBeanServer} * MXBeans are registered into the platform {@code MBeanServer}
* at the first time this method is called. * at the first time this method is called.
* *
* @exception SecurityException if there is a security manager * @throws SecurityException if there is a security manager
* and the caller does not have the permission required by * and the caller does not have the permission required by
* {@link javax.management.MBeanServerFactory#createMBeanServer}. * {@link javax.management.MBeanServerFactory#createMBeanServer}.
* *

4
src/java.management/share/classes/java/lang/management/MemoryMXBean.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2019, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -283,7 +283,7 @@ public interface MemoryMXBean extends PlatformManagedObject {
* @param value {@code true} to enable verbose output; * @param value {@code true} to enable verbose output;
* {@code false} to disable. * {@code false} to disable.
* *
* @exception java.lang.SecurityException if a security manager * @throws java.lang.SecurityException if a security manager
* exists and the caller does not have * exists and the caller does not have
* ManagementPermission("control"). * ManagementPermission("control").
*/ */

26
src/java.naming/share/classes/javax/naming/CompositeName.java
View file

@ -231,7 +231,7 @@ public class CompositeName implements Name {
* description. * description.
* *
* @param n The non-null string to parse. * @param n The non-null string to parse.
* @exception InvalidNameException If n has invalid composite name syntax. * @throws InvalidNameException If n has invalid composite name syntax.
*/ */
public CompositeName(String n) throws InvalidNameException { public CompositeName(String n) throws InvalidNameException {
impl = new NameImpl(null, n); // null means use default syntax impl = new NameImpl(null, n); // null means use default syntax
@ -321,7 +321,7 @@ public class CompositeName implements Name {
* *
* @return a negative integer, zero, or a positive integer as this Name * @return a negative integer, zero, or a positive integer as this Name
* is less than, equal to, or greater than the given Object. * is less than, equal to, or greater than the given Object.
* @exception ClassCastException if obj is not a CompositeName. * @throws ClassCastException if obj is not a CompositeName.
*/ */
public int compareTo(Object obj) { public int compareTo(Object obj) {
if (!(obj instanceof CompositeName)) { if (!(obj instanceof CompositeName)) {
@ -380,7 +380,7 @@ public class CompositeName implements Name {
* @param posn The 0-based index of the component to retrieve. * @param posn The 0-based index of the component to retrieve.
* Must be in the range [0,size()). * Must be in the range [0,size()).
* @return The non-null component at index posn. * @return The non-null component at index posn.
* @exception ArrayIndexOutOfBoundsException if posn is outside the * @throws ArrayIndexOutOfBoundsException if posn is outside the
* specified range. * specified range.
*/ */
public String get(int posn) { public String get(int posn) {
@ -396,7 +396,7 @@ public class CompositeName implements Name {
* Must be in the range [0,size()]. * Must be in the range [0,size()].
* @return A composite name consisting of the components at indexes in * @return A composite name consisting of the components at indexes in
* the range [0,posn). * the range [0,posn).
* @exception ArrayIndexOutOfBoundsException * @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range. * If posn is outside the specified range.
*/ */
public Name getPrefix(int posn) { public Name getPrefix(int posn) {
@ -414,7 +414,7 @@ public class CompositeName implements Name {
* @return A composite name consisting of the components at indexes in * @return A composite name consisting of the components at indexes in
* the range [posn,size()). If posn is equal to * the range [posn,size()). If posn is equal to
* size(), an empty composite name is returned. * size(), an empty composite name is returned.
* @exception ArrayIndexOutOfBoundsException * @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range. * If posn is outside the specified range.
*/ */
public Name getSuffix(int posn) { public Name getSuffix(int posn) {
@ -465,7 +465,7 @@ public class CompositeName implements Name {
* *
* @param suffix The non-null components to add. * @param suffix The non-null components to add.
* @return The updated CompositeName, not a new one. Cannot be null. * @return The updated CompositeName, not a new one. Cannot be null.
* @exception InvalidNameException If suffix is not a composite name. * @throws InvalidNameException If suffix is not a composite name.
*/ */
public Name addAll(Name suffix) public Name addAll(Name suffix)
throws InvalidNameException throws InvalidNameException
@ -490,8 +490,8 @@ public class CompositeName implements Name {
* @param posn The index in this name at which to add the new * @param posn The index in this name at which to add the new
* components. Must be in the range [0,size()]. * components. Must be in the range [0,size()].
* @return The updated CompositeName, not a new one. Cannot be null. * @return The updated CompositeName, not a new one. Cannot be null.
* @exception InvalidNameException If n is not a composite name. * @throws InvalidNameException If n is not a composite name.
* @exception ArrayIndexOutOfBoundsException * @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range. * If posn is outside the specified range.
*/ */
public Name addAll(int posn, Name n) public Name addAll(int posn, Name n)
@ -511,7 +511,7 @@ public class CompositeName implements Name {
* *
* @param comp The non-null component to add. * @param comp The non-null component to add.
* @return The updated CompositeName, not a new one. Cannot be null. * @return The updated CompositeName, not a new one. Cannot be null.
* @exception InvalidNameException If adding comp at end of the name * @throws InvalidNameException If adding comp at end of the name
* would violate the name's syntax. * would violate the name's syntax.
*/ */
public Name add(String comp) throws InvalidNameException { public Name add(String comp) throws InvalidNameException {
@ -530,9 +530,9 @@ public class CompositeName implements Name {
* @param posn The index at which to add the new component. * @param posn The index at which to add the new component.
* Must be in the range [0,size()]. * Must be in the range [0,size()].
* @return The updated CompositeName, not a new one. Cannot be null. * @return The updated CompositeName, not a new one. Cannot be null.
* @exception ArrayIndexOutOfBoundsException * @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range. * If posn is outside the specified range.
* @exception InvalidNameException If adding comp at the specified position * @throws InvalidNameException If adding comp at the specified position
* would violate the name's syntax. * would violate the name's syntax.
*/ */
public Name add(int posn, String comp) public Name add(int posn, String comp)
@ -551,10 +551,10 @@ public class CompositeName implements Name {
* @param posn The index of the component to delete. * @param posn The index of the component to delete.
* Must be in the range [0,size()). * Must be in the range [0,size()).
* @return The component removed (a String). * @return The component removed (a String).
* @exception ArrayIndexOutOfBoundsException * @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range (includes case where * If posn is outside the specified range (includes case where
* composite name is empty). * composite name is empty).
* @exception InvalidNameException If deleting the component * @throws InvalidNameException If deleting the component
* would violate the name's syntax. * would violate the name's syntax.
*/ */
public Object remove(int posn) throws InvalidNameException{ public Object remove(int posn) throws InvalidNameException{

26
src/java.naming/share/classes/javax/naming/CompoundName.java
View file

@ -192,7 +192,7 @@ public class CompoundName implements Name {
* @param syntax A non-null list of properties that specify the syntax of * @param syntax A non-null list of properties that specify the syntax of
* this compound name. See class description for * this compound name. See class description for
* contents of properties. * contents of properties.
* @exception InvalidNameException If 'n' violates the syntax specified * @throws InvalidNameException If 'n' violates the syntax specified
* by {@code syntax}. * by {@code syntax}.
*/ */
public CompoundName(String n, Properties syntax) throws InvalidNameException { public CompoundName(String n, Properties syntax) throws InvalidNameException {
@ -304,7 +304,7 @@ public class CompoundName implements Name {
* @param obj The non-null object to compare against. * @param obj The non-null object to compare against.
* @return a negative integer, zero, or a positive integer as this Name * @return a negative integer, zero, or a positive integer as this Name
* is less than, equal to, or greater than the given Object. * is less than, equal to, or greater than the given Object.
* @exception ClassCastException if obj is not a CompoundName. * @throws ClassCastException if obj is not a CompoundName.
* @see #equals(java.lang.Object) * @see #equals(java.lang.Object)
*/ */
public int compareTo(Object obj) { public int compareTo(Object obj) {
@ -352,7 +352,7 @@ public class CompoundName implements Name {
* @param posn The 0-based index of the component to retrieve. * @param posn The 0-based index of the component to retrieve.
* Must be in the range [0,size()). * Must be in the range [0,size()).
* @return The component at index posn. * @return The component at index posn.
* @exception ArrayIndexOutOfBoundsException if posn is outside the * @throws ArrayIndexOutOfBoundsException if posn is outside the
* specified range. * specified range.
*/ */
public String get(int posn) { public String get(int posn) {
@ -371,7 +371,7 @@ public class CompoundName implements Name {
* Must be in the range [0,size()]. * Must be in the range [0,size()].
* @return A compound name consisting of the components at indexes in * @return A compound name consisting of the components at indexes in
* the range [0,posn). * the range [0,posn).
* @exception ArrayIndexOutOfBoundsException * @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range. * If posn is outside the specified range.
*/ */
public Name getPrefix(int posn) { public Name getPrefix(int posn) {
@ -391,7 +391,7 @@ public class CompoundName implements Name {
* @return A compound name consisting of the components at indexes in * @return A compound name consisting of the components at indexes in
* the range [posn,size()). If posn is equal to * the range [posn,size()). If posn is equal to
* size(), an empty compound name is returned. * size(), an empty compound name is returned.
* @exception ArrayIndexOutOfBoundsException * @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range. * If posn is outside the specified range.
*/ */
public Name getSuffix(int posn) { public Name getSuffix(int posn) {
@ -449,7 +449,7 @@ public class CompoundName implements Name {
* is not used or checked. They might be in the future. * is not used or checked. They might be in the future.
* @param suffix The non-null components to add. * @param suffix The non-null components to add.
* @return The updated CompoundName, not a new one. Cannot be null. * @return The updated CompoundName, not a new one. Cannot be null.
* @exception InvalidNameException If suffix is not a compound name, * @throws InvalidNameException If suffix is not a compound name,
* or if the addition of the components violates the syntax * or if the addition of the components violates the syntax
* of this compound name (e.g. exceeding number of components). * of this compound name (e.g. exceeding number of components).
*/ */
@ -477,9 +477,9 @@ public class CompoundName implements Name {
* @param posn The index in this name at which to add the new * @param posn The index in this name at which to add the new
* components. Must be in the range [0,size()]. * components. Must be in the range [0,size()].
* @return The updated CompoundName, not a new one. Cannot be null. * @return The updated CompoundName, not a new one. Cannot be null.
* @exception ArrayIndexOutOfBoundsException * @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range. * If posn is outside the specified range.
* @exception InvalidNameException If n is not a compound name, * @throws InvalidNameException If n is not a compound name,
* or if the addition of the components violates the syntax * or if the addition of the components violates the syntax
* of this compound name (e.g. exceeding number of components). * of this compound name (e.g. exceeding number of components).
*/ */
@ -498,7 +498,7 @@ public class CompoundName implements Name {
* *
* @param comp The non-null component to add. * @param comp The non-null component to add.
* @return The updated CompoundName, not a new one. Cannot be null. * @return The updated CompoundName, not a new one. Cannot be null.
* @exception InvalidNameException If adding comp at end of the name * @throws InvalidNameException If adding comp at end of the name
* would violate the compound name's syntax. * would violate the compound name's syntax.
*/ */
public Name add(String comp) throws InvalidNameException{ public Name add(String comp) throws InvalidNameException{
@ -516,10 +516,10 @@ public class CompoundName implements Name {
* @param comp The non-null component to add. * @param comp The non-null component to add.
* @param posn The index at which to add the new component. * @param posn The index at which to add the new component.
* Must be in the range [0,size()]. * Must be in the range [0,size()].
* @exception ArrayIndexOutOfBoundsException * @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range. * If posn is outside the specified range.
* @return The updated CompoundName, not a new one. Cannot be null. * @return The updated CompoundName, not a new one. Cannot be null.
* @exception InvalidNameException If adding comp at the specified position * @throws InvalidNameException If adding comp at the specified position
* would violate the compound name's syntax. * would violate the compound name's syntax.
*/ */
public Name add(int posn, String comp) throws InvalidNameException{ public Name add(int posn, String comp) throws InvalidNameException{
@ -536,10 +536,10 @@ public class CompoundName implements Name {
* @param posn The index of the component to delete. * @param posn The index of the component to delete.
* Must be in the range [0,size()). * Must be in the range [0,size()).
* @return The component removed (a String). * @return The component removed (a String).
* @exception ArrayIndexOutOfBoundsException * @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range (includes case where * If posn is outside the specified range (includes case where
* compound name is empty). * compound name is empty).
* @exception InvalidNameException If deleting the component * @throws InvalidNameException If deleting the component
* would violate the compound name's syntax. * would violate the compound name's syntax.
*/ */
public Object remove(int posn) throws InvalidNameException { public Object remove(int posn) throws InvalidNameException {

14
src/java.naming/share/classes/javax/naming/InitialContext.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -297,8 +297,8 @@ public class InitialContext implements Context {
* and cache it in defaultInitCtx. * and cache it in defaultInitCtx.
* Set <code>gotDefault</code> so that we know we've tried this before. * Set <code>gotDefault</code> so that we know we've tried this before.
* @return The non-null cached initial context. * @return The non-null cached initial context.
* @exception NoInitialContextException If cannot find an initial context. * @throws NoInitialContextException If cannot find an initial context.
* @exception NamingException If a naming exception was encountered. * @throws NamingException If a naming exception was encountered.
*/ */
protected Context getDefaultInitCtx() throws NamingException{ protected Context getDefaultInitCtx() throws NamingException{
if (!gotDefault) { if (!gotDefault) {
@ -323,8 +323,8 @@ public class InitialContext implements Context {
* @param name The non-null name for which to get the context. * @param name The non-null name for which to get the context.
* @return A URL context for <code>name</code> or the cached * @return A URL context for <code>name</code> or the cached
* initial context. The result cannot be null. * initial context. The result cannot be null.
* @exception NoInitialContextException If cannot find an initial context. * @throws NoInitialContextException If cannot find an initial context.
* @exception NamingException In a naming exception is encountered. * @throws NamingException In a naming exception is encountered.
* @see javax.naming.spi.NamingManager#getURLContext * @see javax.naming.spi.NamingManager#getURLContext
*/ */
protected Context getURLOrDefaultInitCtx(String name) protected Context getURLOrDefaultInitCtx(String name)
@ -379,8 +379,8 @@ public class InitialContext implements Context {
* @param name The non-null name for which to get the context. * @param name The non-null name for which to get the context.
* @return A URL context for <code>name</code> or the cached * @return A URL context for <code>name</code> or the cached
* initial context. The result cannot be null. * initial context. The result cannot be null.
* @exception NoInitialContextException If cannot find an initial context. * @throws NoInitialContextException If cannot find an initial context.
* @exception NamingException In a naming exception is encountered. * @throws NamingException In a naming exception is encountered.
* *
* @see javax.naming.spi.NamingManager#getURLContext * @see javax.naming.spi.NamingManager#getURLContext
*/ */

6
src/java.naming/share/classes/javax/naming/LinkRef.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -97,8 +97,8 @@ public class LinkRef extends Reference {
* Retrieves the name of this link. * Retrieves the name of this link.
* *
* @return The non-null name of this link. * @return The non-null name of this link.
* @exception MalformedLinkException If a link name could not be extracted * @throws MalformedLinkException If a link name could not be extracted
* @exception NamingException If a naming exception was encountered. * @throws NamingException If a naming exception was encountered.
*/ */
public String getLinkName() throws NamingException { public String getLinkName() throws NamingException {
if (className != null && className.equals(linkClassName)) { if (className != null && className.equals(linkClassName)) {

6
src/java.naming/share/classes/javax/naming/NameParser.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -49,9 +49,9 @@ public interface NameParser {
* @param name The non-null string name to parse. * @param name The non-null string name to parse.
* @return A non-null parsed form of the name using the naming convention * @return A non-null parsed form of the name using the naming convention
* of this parser. * of this parser.
* @exception InvalidNameException If name does not conform to * @throws InvalidNameException If name does not conform to
* syntax defined for the namespace. * syntax defined for the namespace.
* @exception NamingException If a naming exception was encountered. * @throws NamingException If a naming exception was encountered.
*/ */
Name parse(String name) throws NamingException; Name parse(String name) throws NamingException;
} }

10
src/java.naming/share/classes/javax/naming/NamingEnumeration.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -96,10 +96,10 @@ public interface NamingEnumeration<T> extends Enumeration<T> {
* null is only valid for enumerations that can return * null is only valid for enumerations that can return
* null (e.g. Attribute.getAll() returns an enumeration of * null (e.g. Attribute.getAll() returns an enumeration of
* attribute values, and an attribute value can be null). * attribute values, and an attribute value can be null).
* @exception NamingException If a naming exception is encountered while attempting * @throws NamingException If a naming exception is encountered while attempting
* to retrieve the next element. See NamingException * to retrieve the next element. See NamingException
* and its subclasses for the possible naming exceptions. * and its subclasses for the possible naming exceptions.
* @exception java.util.NoSuchElementException If attempting to get the next element when none is available. * @throws java.util.NoSuchElementException If attempting to get the next element when none is available.
* @see java.util.Enumeration#nextElement * @see java.util.Enumeration#nextElement
*/ */
public T next() throws NamingException; public T next() throws NamingException;
@ -111,7 +111,7 @@ public interface NamingEnumeration<T> extends Enumeration<T> {
* by the application. * by the application.
* *
* @return true if there is more in the enumeration ; false otherwise. * @return true if there is more in the enumeration ; false otherwise.
* @exception NamingException * @throws NamingException
* If a naming exception is encountered while attempting * If a naming exception is encountered while attempting
* to determine whether there is another element * to determine whether there is another element
* in the enumeration. See NamingException * in the enumeration. See NamingException
@ -139,7 +139,7 @@ public interface NamingEnumeration<T> extends Enumeration<T> {
* Implementations are encouraged to use appropriate algorithms to * Implementations are encouraged to use appropriate algorithms to
* manage their resources when client omits the {@code close()} calls. * manage their resources when client omits the {@code close()} calls.
* *
* @exception NamingException If a naming exception is encountered * @throws NamingException If a naming exception is encountered
* while closing the enumeration. * while closing the enumeration.
* @since 1.3 * @since 1.3
*/ */

8
src/java.naming/share/classes/javax/naming/Reference.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -237,7 +237,7 @@ public class Reference implements Cloneable, java.io.Serializable {
* @param posn The index of the address to retrieve. * @param posn The index of the address to retrieve.
* @return The address at the 0-based index posn. It must be in the * @return The address at the 0-based index posn. It must be in the
* range [0,getAddressCount()). * range [0,getAddressCount()).
* @exception ArrayIndexOutOfBoundsException If posn not in the specified * @throws ArrayIndexOutOfBoundsException If posn not in the specified
* range. * range.
*/ */
public RefAddr get(int posn) { public RefAddr get(int posn) {
@ -283,7 +283,7 @@ public class Reference implements Cloneable, java.io.Serializable {
* *
* @param posn The 0-based index of the list to insert addr. * @param posn The 0-based index of the list to insert addr.
* @param addr The non-null address to add. * @param addr The non-null address to add.
* @exception ArrayIndexOutOfBoundsException If posn not in the specified * @throws ArrayIndexOutOfBoundsException If posn not in the specified
* range. * range.
*/ */
public void add(int posn, RefAddr addr) { public void add(int posn, RefAddr addr) {
@ -297,7 +297,7 @@ public class Reference implements Cloneable, java.io.Serializable {
* *
* @param posn The 0-based index of in address to delete. * @param posn The 0-based index of in address to delete.
* @return The address removed. * @return The address removed.
* @exception ArrayIndexOutOfBoundsException If posn not in the specified * @throws ArrayIndexOutOfBoundsException If posn not in the specified
* range. * range.
*/ */
public Object remove(int posn) { public Object remove(int posn) {

4
src/java.naming/share/classes/javax/naming/Referenceable.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -51,7 +51,7 @@ public interface Referenceable {
* Retrieves the Reference of this object. * Retrieves the Reference of this object.
* *
* @return The non-null Reference of this object. * @return The non-null Reference of this object.
* @exception NamingException If a naming exception was encountered * @throws NamingException If a naming exception was encountered
* while retrieving the reference. * while retrieving the reference.
*/ */
Reference getReference() throws NamingException; Reference getReference() throws NamingException;

6
src/java.naming/share/classes/javax/naming/ReferralException.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -113,7 +113,7 @@ public abstract class ReferralException extends NamingException {
* the method using the same arguments as the original invocation. * the method using the same arguments as the original invocation.
* *
* @return The non-null context at which to continue the method. * @return The non-null context at which to continue the method.
* @exception NamingException If a naming exception was encountered. * @throws NamingException If a naming exception was encountered.
* Call either {@code retryReferral()} or {@code skipReferral()} * Call either {@code retryReferral()} or {@code skipReferral()}
* to continue processing referrals. * to continue processing referrals.
*/ */
@ -142,7 +142,7 @@ public abstract class ReferralException extends NamingException {
* referral context. If null, no environment properties will be used. * referral context. If null, no environment properties will be used.
* *
* @return The non-null context at which to continue the method. * @return The non-null context at which to continue the method.
* @exception NamingException If a naming exception was encountered. * @throws NamingException If a naming exception was encountered.
* Call either {@code retryReferral()} or {@code skipReferral()} * Call either {@code retryReferral()} or {@code skipReferral()}
* to continue processing referrals. * to continue processing referrals.
*/ */

10
src/java.naming/share/classes/javax/naming/event/EventContext.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2019, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -193,7 +193,7 @@ public interface EventContext extends Context {
* @param scope One of {@code OBJECT_SCOPE}, {@code ONELEVEL_SCOPE}, or * @param scope One of {@code OBJECT_SCOPE}, {@code ONELEVEL_SCOPE}, or
* {@code SUBTREE_SCOPE}. * {@code SUBTREE_SCOPE}.
* @param l The nonnull listener. * @param l The nonnull listener.
* @exception NamingException If a problem was encountered while * @throws NamingException If a problem was encountered while
* adding the listener. * adding the listener.
* @see #removeNamingListener * @see #removeNamingListener
*/ */
@ -211,7 +211,7 @@ public interface EventContext extends Context {
* @param scope One of {@code OBJECT_SCOPE}, {@code ONELEVEL_SCOPE}, or * @param scope One of {@code OBJECT_SCOPE}, {@code ONELEVEL_SCOPE}, or
* {@code SUBTREE_SCOPE}. * {@code SUBTREE_SCOPE}.
* @param l The nonnull listener. * @param l The nonnull listener.
* @exception NamingException If a problem was encountered while * @throws NamingException If a problem was encountered while
* adding the listener. * adding the listener.
* @see #removeNamingListener * @see #removeNamingListener
*/ */
@ -231,7 +231,7 @@ public interface EventContext extends Context {
* this {@code EventContext} instance, this method does not do anything. * this {@code EventContext} instance, this method does not do anything.
* *
* @param l The nonnull listener. * @param l The nonnull listener.
* @exception NamingException If a problem was encountered while * @throws NamingException If a problem was encountered while
* removing the listener. * removing the listener.
* @see #addNamingListener * @see #addNamingListener
*/ */
@ -242,7 +242,7 @@ public interface EventContext extends Context {
* that does not exist. * that does not exist.
* *
* @return true if the target must exist; false if the target need not exist. * @return true if the target must exist; false if the target need not exist.
* @exception NamingException If the context's behavior in this regard cannot * @throws NamingException If the context's behavior in this regard cannot
* be determined. * be determined.
*/ */
boolean targetMustExist() throws NamingException; boolean targetMustExist() throws NamingException;

10
src/java.naming/share/classes/javax/naming/event/EventDirContext.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -81,7 +81,7 @@ public interface EventDirContext extends EventContext, DirContext {
* @param ctls The possibly null search controls. If null, the default * @param ctls The possibly null search controls. If null, the default
* search controls are used. * search controls are used.
* @param l The nonnull listener. * @param l The nonnull listener.
* @exception NamingException If a problem was encountered while * @throws NamingException If a problem was encountered while
* adding the listener. * adding the listener.
* @see EventContext#removeNamingListener * @see EventContext#removeNamingListener
* @see javax.naming.directory.DirContext#search(javax.naming.Name, java.lang.String, javax.naming.directory.SearchControls) * @see javax.naming.directory.DirContext#search(javax.naming.Name, java.lang.String, javax.naming.directory.SearchControls)
@ -101,7 +101,7 @@ public interface EventDirContext extends EventContext, DirContext {
* @param ctls The possibly null search controls. If null, the default * @param ctls The possibly null search controls. If null, the default
* search controls is used. * search controls is used.
* @param l The nonnull listener. * @param l The nonnull listener.
* @exception NamingException If a problem was encountered while * @throws NamingException If a problem was encountered while
* adding the listener. * adding the listener.
* @see EventContext#removeNamingListener * @see EventContext#removeNamingListener
* @see javax.naming.directory.DirContext#search(java.lang.String, java.lang.String, javax.naming.directory.SearchControls) * @see javax.naming.directory.DirContext#search(java.lang.String, java.lang.String, javax.naming.directory.SearchControls)
@ -128,7 +128,7 @@ public interface EventDirContext extends EventContext, DirContext {
* @param ctls The possibly null search controls. If null, the default * @param ctls The possibly null search controls. If null, the default
* search controls are used. * search controls are used.
* @param l The nonnull listener. * @param l The nonnull listener.
* @exception NamingException If a problem was encountered while * @throws NamingException If a problem was encountered while
* adding the listener. * adding the listener.
* @see EventContext#removeNamingListener * @see EventContext#removeNamingListener
* @see javax.naming.directory.DirContext#search(javax.naming.Name, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls) * @see javax.naming.directory.DirContext#search(javax.naming.Name, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls)
@ -150,7 +150,7 @@ public interface EventDirContext extends EventContext, DirContext {
* @param ctls The possibly null search controls. If null, the default * @param ctls The possibly null search controls. If null, the default
* search controls is used. * search controls is used.
* @param l The nonnull listener. * @param l The nonnull listener.
* @exception NamingException If a problem was encountered while * @throws NamingException If a problem was encountered while
* adding the listener. * adding the listener.
* @see EventContext#removeNamingListener * @see EventContext#removeNamingListener
* @see javax.naming.directory.DirContext#search(java.lang.String, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls) */ * @see javax.naming.directory.DirContext#search(java.lang.String, java.lang.String, java.lang.Object[], javax.naming.directory.SearchControls) */

6
src/java.naming/share/classes/javax/naming/ldap/ControlFactory.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -87,7 +87,7 @@ public abstract class ControlFactory {
* @param ctl A non-null control. * @param ctl A non-null control.
* *
* @return A possibly null Control. * @return A possibly null Control.
* @exception NamingException If {@code ctl} contains invalid data that prevents it * @throws NamingException If {@code ctl} contains invalid data that prevents it
* from being used to create a control. A factory should only throw * from being used to create a control. A factory should only throw
* an exception if it knows how to produce the control (identified by the OID) * an exception if it knows how to produce the control (identified by the OID)
* but is unable to because of, for example invalid BER data. * but is unable to because of, for example invalid BER data.
@ -126,7 +126,7 @@ public abstract class ControlFactory {
* @return A control object created using {@code ctl}; or * @return A control object created using {@code ctl}; or
* {@code ctl} if a control object cannot be created using * {@code ctl} if a control object cannot be created using
* the algorithm described above. * the algorithm described above.
* @exception NamingException if a naming exception was encountered * @throws NamingException if a naming exception was encountered
* while attempting to create the control object. * while attempting to create the control object.
* If one of the factories accessed throws an * If one of the factories accessed throws an
* exception, it is propagated up to the caller. * exception, it is propagated up to the caller.

6
src/java.naming/share/classes/javax/naming/ldap/ExtendedRequest.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2010, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -106,7 +106,7 @@ public interface ExtendedRequest extends java.io.Serializable {
* @return A possibly null byte array representing the ASN.1 BER encoded * @return A possibly null byte array representing the ASN.1 BER encoded
* contents of the LDAP {@code ExtendedRequest.requestValue} * contents of the LDAP {@code ExtendedRequest.requestValue}
* component. * component.
* @exception IllegalStateException If the encoded value cannot be retrieved * @throws IllegalStateException If the encoded value cannot be retrieved
* because the request contains insufficient or invalid data/state. * because the request contains insufficient or invalid data/state.
*/ */
public byte[] getEncodedValue(); public byte[] getEncodedValue();
@ -137,7 +137,7 @@ public interface ExtendedRequest extends java.io.Serializable {
* @param length The number of bytes in berValue to use. * @param length The number of bytes in berValue to use.
* *
* @return A non-null object. * @return A non-null object.
* @exception NamingException if cannot create extended response * @throws NamingException if cannot create extended response
* due to an error. * due to an error.
* @see ExtendedResponse * @see ExtendedResponse
*/ */

10
src/java.naming/share/classes/javax/naming/ldap/LdapContext.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2019, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -208,7 +208,7 @@ public interface LdapContext extends DirContext {
* If null, the context is initialized with no request controls. * If null, the context is initialized with no request controls.
* *
* @return A non-null {@code LdapContext} instance. * @return A non-null {@code LdapContext} instance.
* @exception NamingException If an error occurred while creating * @throws NamingException If an error occurred while creating
* the new instance. * the new instance.
* @see InitialLdapContext * @see InitialLdapContext
*/ */
@ -239,7 +239,7 @@ public interface LdapContext extends DirContext {
* in the class description for implementation details. * in the class description for implementation details.
* @param connCtls The possibly null controls to use. If null, no * @param connCtls The possibly null controls to use. If null, no
* controls are used. * controls are used.
* @exception NamingException If an error occurred while reconnecting. * @throws NamingException If an error occurred while reconnecting.
* @see #getConnectControls * @see #getConnectControls
* @see #newInstance * @see #newInstance
*/ */
@ -253,7 +253,7 @@ public interface LdapContext extends DirContext {
* *
* @return A possibly-null array of controls. null means no connect controls * @return A possibly-null array of controls. null means no connect controls
* have been set for this context. * have been set for this context.
* @exception NamingException If an error occurred while getting the request * @throws NamingException If an error occurred while getting the request
* controls. * controls.
*/ */
public Control[] getConnectControls() throws NamingException; public Control[] getConnectControls() throws NamingException;
@ -279,7 +279,7 @@ public interface LdapContext extends DirContext {
* {@code getRequestControls()}. * {@code getRequestControls()}.
* @param requestControls The possibly null controls to use. If null, no * @param requestControls The possibly null controls to use. If null, no
* controls are used. * controls are used.
* @exception NamingException If an error occurred while setting the * @throws NamingException If an error occurred while setting the
* request controls. * request controls.
* @see #getRequestControls * @see #getRequestControls
*/ */

8
src/java.naming/share/classes/javax/naming/ldap/LdapReferralException.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -85,7 +85,7 @@ public abstract class LdapReferralException extends ReferralException {
* See {@code ReferralException} for how to use this method. * See {@code ReferralException} for how to use this method.
* *
* @return The non-null context at which to continue the method. * @return The non-null context at which to continue the method.
* @exception NamingException If a naming exception was encountered. * @throws NamingException If a naming exception was encountered.
* Call either {@code retryReferral()} or {@code skipReferral()} * Call either {@code retryReferral()} or {@code skipReferral()}
* to continue processing referrals. * to continue processing referrals.
*/ */
@ -109,7 +109,7 @@ public abstract class LdapReferralException extends ReferralException {
* referral context. If null, no environment properties will be used. * referral context. If null, no environment properties will be used.
* *
* @return The non-null context at which to continue the method. * @return The non-null context at which to continue the method.
* @exception NamingException If a naming exception was encountered. * @throws NamingException If a naming exception was encountered.
* Call either {@code retryReferral()} or {@code skipReferral()} * Call either {@code retryReferral()} or {@code skipReferral()}
* to continue processing referrals. * to continue processing referrals.
*/ */
@ -149,7 +149,7 @@ public abstract class LdapReferralException extends ReferralException {
* for the new context. If null, the context is initialized with no environment * for the new context. If null, the context is initialized with no environment
* properties. * properties.
* @return The non-null context at which to continue the method. * @return The non-null context at which to continue the method.
* @exception NamingException If a naming exception was encountered. * @throws NamingException If a naming exception was encountered.
* Call either {@code retryReferral()} or {@code skipReferral()} * Call either {@code retryReferral()} or {@code skipReferral()}
* to continue processing referrals. * to continue processing referrals.
*/ */

10
src/java.naming/share/classes/javax/naming/ldap/PagedResultsControl.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -132,7 +132,7 @@ final public class PagedResultsControl extends BasicControl {
* pageSize or refuse to perform the search. * pageSize or refuse to perform the search.
* If false, then the server need not honor the * If false, then the server need not honor the
* control. * control.
* @exception IOException If an error was encountered while encoding the * @throws IOException If an error was encountered while encoding the
* supplied arguments into a control. * supplied arguments into a control.
*/ */
public PagedResultsControl(int pageSize, boolean criticality) public PagedResultsControl(int pageSize, boolean criticality)
@ -158,7 +158,7 @@ final public class PagedResultsControl extends BasicControl {
* pageSize or refuse to perform the search. * pageSize or refuse to perform the search.
* If false, then the server need not honor the * If false, then the server need not honor the
* control. * control.
* @exception IOException If an error was encountered while encoding the * @throws IOException If an error was encountered while encoding the
* supplied arguments into a control. * supplied arguments into a control.
*/ */
public PagedResultsControl(int pageSize, byte[] cookie, public PagedResultsControl(int pageSize, byte[] cookie,
@ -171,7 +171,7 @@ final public class PagedResultsControl extends BasicControl {
value = setEncodedValue(pageSize, cookie); value = setEncodedValue(pageSize, cookie);
} }
/* /**
* Encodes the paged-results control's value using ASN.1 BER. * Encodes the paged-results control's value using ASN.1 BER.
* The result includes the BER tag and length for the control's value but * The result includes the BER tag and length for the control's value but
* does not include the control's object identifier and criticality setting. * does not include the control's object identifier and criticality setting.
@ -180,7 +180,7 @@ final public class PagedResultsControl extends BasicControl {
* @param cookie A non-null server-generated cookie. * @param cookie A non-null server-generated cookie.
* @return A possibly null byte array representing the ASN.1 BER encoded * @return A possibly null byte array representing the ASN.1 BER encoded
* value of the LDAP paged-results control. * value of the LDAP paged-results control.
* @exception IOException If a BER encoding error occurs. * @throws IOException If a BER encoding error occurs.
*/ */
private byte[] setEncodedValue(int pageSize, byte[] cookie) private byte[] setEncodedValue(int pageSize, byte[] cookie)
throws IOException { throws IOException {

4
src/java.naming/share/classes/javax/naming/ldap/PagedResultsResponseControl.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -90,7 +90,7 @@ final public class PagedResultsResponseControl extends BasicControl {
* @param value The control's ASN.1 BER encoded value. * @param value The control's ASN.1 BER encoded value.
* It is not cloned - any changes to value * It is not cloned - any changes to value
* will affect the contents of the control. * will affect the contents of the control.
* @exception IOException If an error was encountered while decoding * @throws IOException If an error was encountered while decoding
* the control's value. * the control's value.
*/ */
public PagedResultsResponseControl(String id, boolean criticality, public PagedResultsResponseControl(String id, boolean criticality,

2
src/java.naming/share/classes/javax/naming/ldap/Rdn.java
View file

@ -315,7 +315,7 @@ public class Rdn implements Serializable, Comparable<Object> {
* @param obj The non-null object to compare against. * @param obj The non-null object to compare against.
* @return A negative integer, zero, or a positive integer as this Rdn * @return A negative integer, zero, or a positive integer as this Rdn
* is less than, equal to, or greater than the given Object. * is less than, equal to, or greater than the given Object.
* @exception ClassCastException if obj is null or not a Rdn. * @throws ClassCastException if obj is null or not a Rdn.
*/ */
public int compareTo(Object obj) { public int compareTo(Object obj) {
if (!(obj instanceof Rdn)) { if (!(obj instanceof Rdn)) {

12
src/java.naming/share/classes/javax/naming/ldap/SortControl.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -127,7 +127,7 @@ final public class SortControl extends BasicControl {
* requested or refuse to perform the search. * requested or refuse to perform the search.
* If false, then the server need not honor the * If false, then the server need not honor the
* control. * control.
* @exception IOException If an error was encountered while encoding the * @throws IOException If an error was encountered while encoding the
* supplied arguments into a control. * supplied arguments into a control.
*/ */
public SortControl(String sortBy, boolean criticality) throws IOException { public SortControl(String sortBy, boolean criticality) throws IOException {
@ -149,7 +149,7 @@ final public class SortControl extends BasicControl {
* requested or refuse to perform the search. * requested or refuse to perform the search.
* If false, then the server need not honor the * If false, then the server need not honor the
* control. * control.
* @exception IOException If an error was encountered while encoding the * @throws IOException If an error was encountered while encoding the
* supplied arguments into a control. * supplied arguments into a control.
*/ */
public SortControl(String[] sortBy, boolean criticality) public SortControl(String[] sortBy, boolean criticality)
@ -175,7 +175,7 @@ final public class SortControl extends BasicControl {
* requested or refuse to perform the search. * requested or refuse to perform the search.
* If false, then the server need not honor the * If false, then the server need not honor the
* control. * control.
* @exception IOException If an error was encountered while encoding the * @throws IOException If an error was encountered while encoding the
* supplied arguments into a control. * supplied arguments into a control.
*/ */
public SortControl(SortKey[] sortBy, boolean criticality) public SortControl(SortKey[] sortBy, boolean criticality)
@ -185,7 +185,7 @@ final public class SortControl extends BasicControl {
super.value = setEncodedValue(sortBy); super.value = setEncodedValue(sortBy);
} }
/* /**
* Encodes the sort control's value using ASN.1 BER. * Encodes the sort control's value using ASN.1 BER.
* The result includes the BER tag and length for the control's value but * The result includes the BER tag and length for the control's value but
* does not include the control's object identifier and criticality setting. * does not include the control's object identifier and criticality setting.
@ -193,7 +193,7 @@ final public class SortControl extends BasicControl {
* @param sortKeys A non-null list of keys to sort by. * @param sortKeys A non-null list of keys to sort by.
* @return A possibly null byte array representing the ASN.1 BER encoded * @return A possibly null byte array representing the ASN.1 BER encoded
* value of the sort control. * value of the sort control.
* @exception IOException If a BER encoding error occurs. * @throws IOException If a BER encoding error occurs.
*/ */
private byte[] setEncodedValue(SortKey[] sortKeys) throws IOException { private byte[] setEncodedValue(SortKey[] sortKeys) throws IOException {

4
src/java.naming/share/classes/javax/naming/ldap/SortResponseControl.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2003, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -109,7 +109,7 @@ final public class SortResponseControl extends BasicControl {
* @param value The control's ASN.1 BER encoded value. * @param value The control's ASN.1 BER encoded value.
* It is not cloned - any changes to value * It is not cloned - any changes to value
* will affect the contents of the control. * will affect the contents of the control.
* @exception IOException if an error is encountered * @throws IOException if an error is encountered
* while decoding the control's value. * while decoding the control's value.
*/ */
public SortResponseControl(String id, boolean criticality, byte[] value) public SortResponseControl(String id, boolean criticality, byte[] value)

4
src/java.naming/share/classes/javax/naming/ldap/StartTlsRequest.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -165,7 +165,7 @@ public class StartTlsRequest implements ExtendedRequest {
* Its value is ignored because a Start TLS response * Its value is ignored because a Start TLS response
* is not expected to contain any response value. * is not expected to contain any response value.
* @return The StartTLS extended response object. * @return The StartTLS extended response object.
* @exception NamingException If a naming exception was encountered * @throws NamingException If a naming exception was encountered
* while creating the StartTLS extended response object. * while creating the StartTLS extended response object.
*/ */
public ExtendedResponse createExtendedResponse(String id, byte[] berValue, public ExtendedResponse createExtendedResponse(String id, byte[] berValue,

4
src/java.naming/share/classes/javax/naming/spi/DirObjectFactory.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -118,7 +118,7 @@ public interface DirObjectFactory extends ObjectFactory {
* to get it, either using {@code obj}, or {@code name} and {@code nameCtx}. * to get it, either using {@code obj}, or {@code name} and {@code nameCtx}.
* The factory must not modify attrs. * The factory must not modify attrs.
* @return The object created; null if an object cannot be created. * @return The object created; null if an object cannot be created.
* @exception Exception If this object factory encountered an exception * @throws Exception If this object factory encountered an exception
* while attempting to create an object, and no other object factories are * while attempting to create an object, and no other object factories are
* to be tried. * to be tried.
* *

4
src/java.naming/share/classes/javax/naming/spi/DirStateFactory.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -133,7 +133,7 @@ public interface DirStateFactory extends StateFactory {
* @return A {@code Result} containing the object's state for binding * @return A {@code Result} containing the object's state for binding
* and the corresponding * and the corresponding
* attributes to be bound; null if the object don't use this factory. * attributes to be bound; null if the object don't use this factory.
* @exception NamingException If this factory encountered an exception * @throws NamingException If this factory encountered an exception
* while attempting to get the object's state, and no other factories are * while attempting to get the object's state, and no other factories are
* to be tried. * to be tried.
* *

10
src/java.naming/share/classes/javax/naming/spi/DirectoryManager.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2011, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -80,7 +80,7 @@ public class DirectoryManager extends NamingManager {
* @param cpe * @param cpe
* The non-null exception that triggered this continuation. * The non-null exception that triggered this continuation.
* @return A non-null {@code DirContext} object for continuing the operation. * @return A non-null {@code DirContext} object for continuing the operation.
* @exception NamingException If a naming exception occurred. * @throws NamingException If a naming exception occurred.
* *
* @see NamingManager#getContinuationContext(CannotProceedException) * @see NamingManager#getContinuationContext(CannotProceedException)
*/ */
@ -136,10 +136,10 @@ public class DirectoryManager extends NamingManager {
* @return An object created using {@code refInfo} and {@code attrs}; or * @return An object created using {@code refInfo} and {@code attrs}; or
* {@code refInfo} if an object cannot be created by * {@code refInfo} if an object cannot be created by
* a factory. * a factory.
* @exception NamingException If a naming exception was encountered * @throws NamingException If a naming exception was encountered
* while attempting to get a URL context, or if one of the * while attempting to get a URL context, or if one of the
* factories accessed throws a NamingException. * factories accessed throws a NamingException.
* @exception Exception If one of the factories accessed throws an * @throws Exception If one of the factories accessed throws an
* exception, or if an error was encountered while loading * exception, or if an error was encountered while loading
* and instantiating the factory and object classes. * and instantiating the factory and object classes.
* A factory should only throw an exception if it does not want * A factory should only throw an exception if it does not want
@ -289,7 +289,7 @@ public class DirectoryManager extends NamingManager {
* the object and attributes to be bound. * the object and attributes to be bound.
* If no state factory returns a non-null answer, the result will contain * If no state factory returns a non-null answer, the result will contain
* the object ({@code obj}) itself with the original attributes. * the object ({@code obj}) itself with the original attributes.
* @exception NamingException If a naming exception was encountered * @throws NamingException If a naming exception was encountered
* while using the factories. * while using the factories.
* A factory should only throw an exception if it does not want * A factory should only throw an exception if it does not want
* other factories to be used in an attempt to create an object. * other factories to be used in an attempt to create an object.

4
src/java.naming/share/classes/javax/naming/spi/InitialContextFactory.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -65,7 +65,7 @@ public interface InitialContextFactory {
* of the initial context. * of the initial context.
* @return A non-null initial context object that implements the Context * @return A non-null initial context object that implements the Context
* interface. * interface.
* @exception NamingException If cannot create an initial context. * @throws NamingException If cannot create an initial context.
*/ */
public Context getInitialContext(Hashtable<?,?> environment) public Context getInitialContext(Hashtable<?,?> environment)
throws NamingException; throws NamingException;

4
src/java.naming/share/classes/javax/naming/spi/InitialContextFactoryBuilder.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -63,7 +63,7 @@ public interface InitialContextFactoryBuilder {
* @param environment Environment used in creating an initial * @param environment Environment used in creating an initial
* context implementation. Can be null. * context implementation. Can be null.
* @return A non-null initial context factory. * @return A non-null initial context factory.
* @exception NamingException If an initial context factory could not be created. * @throws NamingException If an initial context factory could not be created.
*/ */
public InitialContextFactory public InitialContextFactory
createInitialContextFactory(Hashtable<?,?> environment) createInitialContextFactory(Hashtable<?,?> environment)

26
src/java.naming/share/classes/javax/naming/spi/NamingManager.java
View file

@ -99,11 +99,11 @@ public class NamingManager {
* *
* @param builder The factory builder to install. If null, no builder * @param builder The factory builder to install. If null, no builder
* is installed. * is installed.
* @exception SecurityException builder cannot be installed * @throws SecurityException builder cannot be installed
* for security reasons. * for security reasons.
* @exception NamingException builder cannot be installed for * @throws NamingException builder cannot be installed for
* a non-security-related reason. * a non-security-related reason.
* @exception IllegalStateException If a factory has already been installed. * @throws IllegalStateException If a factory has already been installed.
* @see #getObjectInstance * @see #getObjectInstance
* @see ObjectFactory * @see ObjectFactory
* @see ObjectFactoryBuilder * @see ObjectFactoryBuilder
@ -280,10 +280,10 @@ public class NamingManager {
* @return An object created using {@code refInfo}; or * @return An object created using {@code refInfo}; or
* {@code refInfo} if an object cannot be created using * {@code refInfo} if an object cannot be created using
* the algorithm described above. * the algorithm described above.
* @exception NamingException if a naming exception was encountered * @throws NamingException if a naming exception was encountered
* while attempting to get a URL context, or if one of the * while attempting to get a URL context, or if one of the
* factories accessed throws a NamingException. * factories accessed throws a NamingException.
* @exception Exception if one of the factories accessed throws an * @throws Exception if one of the factories accessed throws an
* exception, or if an error was encountered while loading * exception, or if an error was encountered while loading
* and instantiating the factory and object classes. * and instantiating the factory and object classes.
* A factory should only throw an exception if it does not want * A factory should only throw an exception if it does not want
@ -547,7 +547,7 @@ public class NamingManager {
* scheme id {@code scheme}; * scheme id {@code scheme};
* {@code null} if the factory for creating the * {@code null} if the factory for creating the
* context is not found. * context is not found.
* @exception NamingException If a naming exception occurs while creating * @throws NamingException If a naming exception occurs while creating
* the context. * the context.
* @see #getObjectInstance * @see #getObjectInstance
* @see ObjectFactory#getObjectInstance * @see ObjectFactory#getObjectInstance
@ -665,13 +665,13 @@ public class NamingManager {
* @param env The possibly null environment properties used when * @param env The possibly null environment properties used when
* creating the context. * creating the context.
* @return A non-null initial context. * @return A non-null initial context.
* @exception NoInitialContextException If the * @throws NoInitialContextException If the
* {@code Context.INITIAL_CONTEXT_FACTORY} property * {@code Context.INITIAL_CONTEXT_FACTORY} property
* is not found or names a nonexistent * is not found or names a nonexistent
* class or a class that cannot be instantiated, * class or a class that cannot be instantiated,
* or if the initial context could not be created for some other * or if the initial context could not be created for some other
* reason. * reason.
* @exception NamingException If some other naming exception was encountered. * @throws NamingException If some other naming exception was encountered.
* @see javax.naming.InitialContext * @see javax.naming.InitialContext
* @see javax.naming.directory.InitialDirContext * @see javax.naming.directory.InitialDirContext
*/ */
@ -766,11 +766,11 @@ public class NamingManager {
* be replaced. * be replaced.
* @param builder The initial context factory builder to install. If null, * @param builder The initial context factory builder to install. If null,
* no builder is set. * no builder is set.
* @exception SecurityException builder cannot be installed for security * @throws SecurityException builder cannot be installed for security
* reasons. * reasons.
* @exception NamingException builder cannot be installed for * @throws NamingException builder cannot be installed for
* a non-security-related reason. * a non-security-related reason.
* @exception IllegalStateException If a builder was previous installed. * @throws IllegalStateException If a builder was previous installed.
* @see #hasInitialContextFactoryBuilder * @see #hasInitialContextFactoryBuilder
* @see java.lang.SecurityManager#checkSetFactory * @see java.lang.SecurityManager#checkSetFactory
*/ */
@ -841,7 +841,7 @@ public class NamingManager {
* @param cpe * @param cpe
* The non-null exception that triggered this continuation. * The non-null exception that triggered this continuation.
* @return A non-null Context object for continuing the operation. * @return A non-null Context object for continuing the operation.
* @exception NamingException If a naming exception occurred. * @throws NamingException If a naming exception occurred.
*/ */
@SuppressWarnings("unchecked") @SuppressWarnings("unchecked")
public static Context getContinuationContext(CannotProceedException cpe) public static Context getContinuationContext(CannotProceedException cpe)
@ -913,7 +913,7 @@ public class NamingManager {
* the object's state. * the object's state.
* @return The non-null object representing {@code obj}'s state for * @return The non-null object representing {@code obj}'s state for
* binding. It could be the object ({@code obj}) itself. * binding. It could be the object ({@code obj}) itself.
* @exception NamingException If one of the factories accessed throws an * @throws NamingException If one of the factories accessed throws an
* exception, or if an error was encountered while loading * exception, or if an error was encountered while loading
* and instantiating the factory and object classes. * and instantiating the factory and object classes.
* A factory should only throw an exception if it does not want * A factory should only throw an exception if it does not want

4
src/java.naming/share/classes/javax/naming/spi/ObjectFactory.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -163,7 +163,7 @@ public interface ObjectFactory {
* @param environment The possibly null environment that is used in * @param environment The possibly null environment that is used in
* creating the object. * creating the object.
* @return The object created; null if an object cannot be created. * @return The object created; null if an object cannot be created.
* @exception Exception if this object factory encountered an exception * @throws Exception if this object factory encountered an exception
* while attempting to create an object, and no other object factories are * while attempting to create an object, and no other object factories are
* to be tried. * to be tried.
* *

4
src/java.naming/share/classes/javax/naming/spi/ObjectFactoryBuilder.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -66,7 +66,7 @@ public interface ObjectFactoryBuilder {
* @param environment Environment to use when creating the factory. * @param environment Environment to use when creating the factory.
* Can be null. * Can be null.
* @return A non-null new instance of an ObjectFactory. * @return A non-null new instance of an ObjectFactory.
* @exception NamingException If an object factory cannot be created. * @throws NamingException If an object factory cannot be created.
* *
*/ */
public ObjectFactory createObjectFactory(Object obj, public ObjectFactory createObjectFactory(Object obj,

4
src/java.naming/share/classes/javax/naming/spi/StateFactory.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1999, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1999, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -128,7 +128,7 @@ public interface StateFactory {
* be used in the creation of the object's state. * be used in the creation of the object's state.
* @return The object's state for binding; * @return The object's state for binding;
* null if the factory is not returning any changes. * null if the factory is not returning any changes.
* @exception NamingException if this factory encountered an exception * @throws NamingException if this factory encountered an exception
* while attempting to get the object's state, and no other factories are * while attempting to get the object's state, and no other factories are
* to be tried. * to be tried.
* *

68
src/java.rmi/share/classes/java/rmi/activation/Activatable.java
View file

@ -94,11 +94,11 @@ public abstract class Activatable extends RemoteServer {
* activated on demand. Specifying <code>restart</code> to be * activated on demand. Specifying <code>restart</code> to be
* <code>true</code> does not force an initial immediate activation of * <code>true</code> does not force an initial immediate activation of
* a newly registered object; initial activation is lazy. * a newly registered object; initial activation is lazy.
* @exception ActivationException if object registration fails. * @throws ActivationException if object registration fails.
* @exception RemoteException if either of the following fails: * @throws RemoteException if either of the following fails:
* a) registering the object with the activation system or b) exporting * a) registering the object with the activation system or b) exporting
* the object to the RMI runtime. * the object to the RMI runtime.
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation. * not supported by this implementation.
* @since 1.2 * @since 1.2
**/ **/
@ -146,11 +146,11 @@ public abstract class Activatable extends RemoteServer {
* @param csf the client-side socket factory for making calls to the * @param csf the client-side socket factory for making calls to the
* remote object * remote object
* @param ssf the server-side socket factory for receiving remote calls * @param ssf the server-side socket factory for receiving remote calls
* @exception ActivationException if object registration fails. * @throws ActivationException if object registration fails.
* @exception RemoteException if either of the following fails: * @throws RemoteException if either of the following fails:
* a) registering the object with the activation system or b) exporting * a) registering the object with the activation system or b) exporting
* the object to the RMI runtime. * the object to the RMI runtime.
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation. * not supported by this implementation.
* @since 1.2 * @since 1.2
**/ **/
@ -182,9 +182,9 @@ public abstract class Activatable extends RemoteServer {
* *
* @param id activation identifier for the object * @param id activation identifier for the object
* @param port the port number on which the object is exported * @param port the port number on which the object is exported
* @exception RemoteException if exporting the object to the RMI * @throws RemoteException if exporting the object to the RMI
* runtime fails * runtime fails
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
*/ */
@ -215,9 +215,9 @@ public abstract class Activatable extends RemoteServer {
* @param csf the client-side socket factory for making calls to the * @param csf the client-side socket factory for making calls to the
* remote object * remote object
* @param ssf the server-side socket factory for receiving remote calls * @param ssf the server-side socket factory for receiving remote calls
* @exception RemoteException if exporting the object to the RMI * @throws RemoteException if exporting the object to the RMI
* runtime fails * runtime fails
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
*/ */
@ -248,11 +248,11 @@ public abstract class Activatable extends RemoteServer {
* *
* @param desc the object's descriptor * @param desc the object's descriptor
* @return the stub for the activatable remote object * @return the stub for the activatable remote object
* @exception UnknownGroupException if group id in <code>desc</code> * @throws UnknownGroupException if group id in <code>desc</code>
* is not registered with the activation system * is not registered with the activation system
* @exception ActivationException if activation system is not running * @throws ActivationException if activation system is not running
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
*/ */
@ -284,11 +284,11 @@ public abstract class Activatable extends RemoteServer {
* either already unexported or is currently exported and has no * either already unexported or is currently exported and has no
* pending/executing calls); false is returned if the object has * pending/executing calls); false is returned if the object has
* pending/executing calls in which case it cannot be deactivated * pending/executing calls in which case it cannot be deactivated
* @exception UnknownObjectException if object is not known (it may * @throws UnknownObjectException if object is not known (it may
* already be inactive) * already be inactive)
* @exception ActivationException if group is not active * @throws ActivationException if group is not active
* @exception RemoteException if call informing monitor fails * @throws RemoteException if call informing monitor fails
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
*/ */
@ -304,10 +304,10 @@ public abstract class Activatable extends RemoteServer {
* activated via that <code>id</code>. * activated via that <code>id</code>.
* *
* @param id the object's activation identifier * @param id the object's activation identifier
* @exception UnknownObjectException if object (<code>id</code>) is unknown * @throws UnknownObjectException if object (<code>id</code>) is unknown
* @exception ActivationException if activation system is not running * @throws ActivationException if activation system is not running
* @exception RemoteException if remote call to activation system fails * @throws RemoteException if remote call to activation system fails
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
*/ */
@ -351,9 +351,9 @@ public abstract class Activatable extends RemoteServer {
* @return the activation identifier obtained from registering the * @return the activation identifier obtained from registering the
* descriptor, <code>desc</code>, with the activation system * descriptor, <code>desc</code>, with the activation system
* the wrong group * the wrong group
* @exception ActivationException if activation group is not active * @throws ActivationException if activation group is not active
* @exception RemoteException if object registration or export fails * @throws RemoteException if object registration or export fails
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
**/ **/
@ -426,9 +426,9 @@ public abstract class Activatable extends RemoteServer {
* @param ssf the server-side socket factory for receiving remote calls * @param ssf the server-side socket factory for receiving remote calls
* @return the activation identifier obtained from registering the * @return the activation identifier obtained from registering the
* descriptor with the activation system * descriptor with the activation system
* @exception ActivationException if activation group is not active * @throws ActivationException if activation group is not active
* @exception RemoteException if object registration or export fails * @throws RemoteException if object registration or export fails
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
**/ **/
@ -495,8 +495,8 @@ public abstract class Activatable extends RemoteServer {
* @param id the object's activation identifier * @param id the object's activation identifier
* @param port the port on which the object is exported (an anonymous * @param port the port on which the object is exported (an anonymous
* port is used if port=0) * port is used if port=0)
* @exception RemoteException if object export fails * @throws RemoteException if object export fails
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
*/ */
@ -527,8 +527,8 @@ public abstract class Activatable extends RemoteServer {
* @param csf the client-side socket factory for making calls to the * @param csf the client-side socket factory for making calls to the
* remote object * remote object
* @param ssf the server-side socket factory for receiving remote calls * @param ssf the server-side socket factory for receiving remote calls
* @exception RemoteException if object export fails * @throws RemoteException if object export fails
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
*/ */
@ -556,9 +556,9 @@ public abstract class Activatable extends RemoteServer {
* pending or in-progress calls; if false, only unexports the object * pending or in-progress calls; if false, only unexports the object
* if there are no pending or in-progress calls * if there are no pending or in-progress calls
* @return true if operation is successful, false otherwise * @return true if operation is successful, false otherwise
* @exception NoSuchObjectException if the remote object is not * @throws NoSuchObjectException if the remote object is not
* currently exported * currently exported
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
*/ */

16
src/java.rmi/share/classes/java/rmi/activation/ActivationDesc.java
View file

@ -109,8 +109,8 @@ public final class ActivationDesc implements Serializable {
* loaded) * loaded)
* @param data the object's initialization (activation) data contained * @param data the object's initialization (activation) data contained
* in marshalled form. * in marshalled form.
* @exception ActivationException if the current group is nonexistent * @throws ActivationException if the current group is nonexistent
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
*/ */
@ -148,8 +148,8 @@ public final class ActivationDesc implements Serializable {
* activated on demand. Specifying <code>restart</code> to be * activated on demand. Specifying <code>restart</code> to be
* <code>true</code> does not force an initial immediate activation of * <code>true</code> does not force an initial immediate activation of
* a newly registered object; initial activation is lazy. * a newly registered object; initial activation is lazy.
* @exception ActivationException if the current group is nonexistent * @throws ActivationException if the current group is nonexistent
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
*/ */
@ -184,8 +184,8 @@ public final class ActivationDesc implements Serializable {
* loaded) * loaded)
* @param data the object's initialization (activation) data contained * @param data the object's initialization (activation) data contained
* in marshalled form. * in marshalled form.
* @exception IllegalArgumentException if <code>groupID</code> is null * @throws IllegalArgumentException if <code>groupID</code> is null
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
*/ */
@ -218,8 +218,8 @@ public final class ActivationDesc implements Serializable {
* activated on demand. Specifying <code>restart</code> to be * activated on demand. Specifying <code>restart</code> to be
* <code>true</code> does not force an initial immediate activation of * <code>true</code> does not force an initial immediate activation of
* a newly registered object; initial activation is lazy. * a newly registered object; initial activation is lazy.
* @exception IllegalArgumentException if <code>groupID</code> is null * @throws IllegalArgumentException if <code>groupID</code> is null
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @since 1.2 * @since 1.2
*/ */

44
src/java.rmi/share/classes/java/rmi/activation/ActivationGroup.java
View file

@ -183,10 +183,10 @@ public abstract class ActivationGroup
* @param id the object's activation identifier * @param id the object's activation identifier
* @return true if the object was successfully deactivated; otherwise * @return true if the object was successfully deactivated; otherwise
* returns false. * returns false.
* @exception UnknownObjectException if object is unknown (may already * @throws UnknownObjectException if object is unknown (may already
* be inactive) * be inactive)
* @exception RemoteException if call informing monitor fails * @throws RemoteException if call informing monitor fails
* @exception ActivationException if group is inactive * @throws ActivationException if group is inactive
* @since 1.2 * @since 1.2
*/ */
public boolean inactiveObject(ActivationID id) public boolean inactiveObject(ActivationID id)
@ -207,9 +207,9 @@ public abstract class ActivationGroup
* *
* @param id the object's identifier * @param id the object's identifier
* @param obj the remote object implementation * @param obj the remote object implementation
* @exception UnknownObjectException if object is not registered * @throws UnknownObjectException if object is not registered
* @exception RemoteException if call informing monitor fails * @throws RemoteException if call informing monitor fails
* @exception ActivationException if group is inactive * @throws ActivationException if group is inactive
* @since 1.2 * @since 1.2
*/ */
public abstract void activeObject(ActivationID id, Remote obj) public abstract void activeObject(ActivationID id, Remote obj)
@ -269,13 +269,13 @@ public abstract class ActivationGroup
* @param incarnation the group's incarnation number (zero on group's * @param incarnation the group's incarnation number (zero on group's
* initial creation) * initial creation)
* @return the activation group for the VM * @return the activation group for the VM
* @exception ActivationException if group already exists or if error * @throws ActivationException if group already exists or if error
* occurs during group creation * occurs during group creation
* @exception SecurityException if permission to create group is denied. * @throws SecurityException if permission to create group is denied.
* (Note: The default implementation of the security manager * (Note: The default implementation of the security manager
* <code>checkSetFactory</code> * <code>checkSetFactory</code>
* method requires the RuntimePermission "setFactory") * method requires the RuntimePermission "setFactory")
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @see SecurityManager#checkSetFactory * @see SecurityManager#checkSetFactory
* @since 1.2 * @since 1.2
@ -355,7 +355,7 @@ public abstract class ActivationGroup
/** /**
* Returns the current activation group's identifier. Returns null * Returns the current activation group's identifier. Returns null
* if no group is currently active for this VM. * if no group is currently active for this VM.
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @return the activation group's identifier * @return the activation group's identifier
* @since 1.2 * @since 1.2
@ -371,7 +371,7 @@ public abstract class ActivationGroup
* so if a group has already become active and deactivated. * so if a group has already become active and deactivated.
* *
* @return the activation group identifier * @return the activation group identifier
* @exception ActivationException if error occurs during group * @throws ActivationException if error occurs during group
* creation, if security manager is not set, or if the group * creation, if security manager is not set, or if the group
* has already been created and deactivated. * has already been created and deactivated.
*/ */
@ -401,12 +401,12 @@ public abstract class ActivationGroup
* This could result in a SecurityException. * This could result in a SecurityException.
* *
* @param system remote reference to the <code>ActivationSystem</code> * @param system remote reference to the <code>ActivationSystem</code>
* @exception ActivationException if activation system is already set * @throws ActivationException if activation system is already set
* @exception SecurityException if permission to set the activation system is denied. * @throws SecurityException if permission to set the activation system is denied.
* (Note: The default implementation of the security manager * (Note: The default implementation of the security manager
* <code>checkSetFactory</code> * <code>checkSetFactory</code>
* method requires the RuntimePermission "setFactory") * method requires the RuntimePermission "setFactory")
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @see #getSystem * @see #getSystem
* @see SecurityManager#checkSetFactory * @see SecurityManager#checkSetFactory
@ -439,10 +439,10 @@ public abstract class ActivationGroup
* <code>java.rmi.activation.port</code>. * <code>java.rmi.activation.port</code>.
* *
* @return the activation system for the VM/group * @return the activation system for the VM/group
* @exception ActivationException if activation system cannot be * @throws ActivationException if activation system cannot be
* obtained or is not bound * obtained or is not bound
* (means that it is not running) * (means that it is not running)
* @exception UnsupportedOperationException if and only if activation is * @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation * not supported by this implementation
* @see #setSystem * @see #setSystem
* @since 1.2 * @since 1.2
@ -473,9 +473,9 @@ public abstract class ActivationGroup
* *
* @param id the object's identifier * @param id the object's identifier
* @param mobj a marshalled object containing the remote object's stub * @param mobj a marshalled object containing the remote object's stub
* @exception UnknownObjectException if object is not registered * @throws UnknownObjectException if object is not registered
* @exception RemoteException if call informing monitor fails * @throws RemoteException if call informing monitor fails
* @exception ActivationException if an activation error occurs * @throws ActivationException if an activation error occurs
* @since 1.2 * @since 1.2
*/ */
protected void activeObject(ActivationID id, protected void activeObject(ActivationID id,
@ -492,8 +492,8 @@ public abstract class ActivationGroup
* <code>ActivationMonitor</code>. Also, the current group * <code>ActivationMonitor</code>. Also, the current group
* for the VM is set to null. * for the VM is set to null.
* *
* @exception UnknownGroupException if group is not registered * @throws UnknownGroupException if group is not registered
* @exception RemoteException if call informing monitor fails * @throws RemoteException if call informing monitor fails
* @since 1.2 * @since 1.2
*/ */
protected void inactiveGroup() protected void inactiveGroup()
@ -529,7 +529,7 @@ public abstract class ActivationGroup
/** /**
* Returns the current group for the VM. * Returns the current group for the VM.
* @exception ActivationException if current group is null (not active) * @throws ActivationException if current group is null (not active)
*/ */
static synchronized ActivationGroup currentGroup() static synchronized ActivationGroup currentGroup()
throws ActivationException throws ActivationException

6
src/java.rmi/share/classes/java/rmi/activation/ActivationID.java
View file

@ -125,9 +125,9 @@ public class ActivationID implements Serializable {
* when activating the object (instead of returning a cached reference); * when activating the object (instead of returning a cached reference);
* if false, returning a cached value is acceptable. * if false, returning a cached value is acceptable.
* @return the reference to the active remote object * @return the reference to the active remote object
* @exception ActivationException if activation fails * @throws ActivationException if activation fails
* @exception UnknownObjectException if the object is unknown * @throws UnknownObjectException if the object is unknown
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @since 1.2 * @since 1.2
*/ */
public Remote activate(boolean force) public Remote activate(boolean force)

4
src/java.rmi/share/classes/java/rmi/activation/ActivationInstantiator.java
View file

@ -84,8 +84,8 @@ public interface ActivationInstantiator extends Remote {
* @param desc the object's descriptor * @param desc the object's descriptor
* @return a marshalled object containing the serialized * @return a marshalled object containing the serialized
* representation of remote object's stub * representation of remote object's stub
* @exception ActivationException if object activation fails * @throws ActivationException if object activation fails
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @since 1.2 * @since 1.2
*/ */
public MarshalledObject<? extends Remote> newInstance(ActivationID id, public MarshalledObject<? extends Remote> newInstance(ActivationID id,

12
src/java.rmi/share/classes/java/rmi/activation/ActivationMonitor.java
View file

@ -71,8 +71,8 @@ public interface ActivationMonitor extends Remote {
* results in re-activating the remote object. * results in re-activating the remote object.
* *
* @param id the object's activation identifier * @param id the object's activation identifier
* @exception UnknownObjectException if object is unknown * @throws UnknownObjectException if object is unknown
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @since 1.2 * @since 1.2
*/ */
public void inactiveObject(ActivationID id) public void inactiveObject(ActivationID id)
@ -86,8 +86,8 @@ public interface ActivationMonitor extends Remote {
* *
* @param id the active object's id * @param id the active object's id
* @param obj the marshalled form of the object's stub * @param obj the marshalled form of the object's stub
* @exception UnknownObjectException if object is unknown * @throws UnknownObjectException if object is unknown
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @since 1.2 * @since 1.2
*/ */
public void activeObject(ActivationID id, public void activeObject(ActivationID id,
@ -102,8 +102,8 @@ public interface ActivationMonitor extends Remote {
* *
* @param id the group's id * @param id the group's id
* @param incarnation the group's incarnation number * @param incarnation the group's incarnation number
* @exception UnknownGroupException if group is unknown * @throws UnknownGroupException if group is unknown
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @since 1.2 * @since 1.2
*/ */
public void inactiveGroup(ActivationGroupID id, public void inactiveGroup(ActivationGroupID id,

56
src/java.rmi/share/classes/java/rmi/activation/ActivationSystem.java
View file

@ -70,11 +70,11 @@ public interface ActivationSystem extends Remote {
* *
* @param desc the object's activation descriptor * @param desc the object's activation descriptor
* @return the activation id that can be used to activate the object * @return the activation id that can be used to activate the object
* @exception ActivationException if registration fails (e.g., database * @throws ActivationException if registration fails (e.g., database
* update failure, etc). * update failure, etc).
* @exception UnknownGroupException if group referred to in * @throws UnknownGroupException if group referred to in
* <code>desc</code> is not registered with this system * <code>desc</code> is not registered with this system
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @since 1.2 * @since 1.2
*/ */
public ActivationID registerObject(ActivationDesc desc) public ActivationID registerObject(ActivationDesc desc)
@ -86,10 +86,10 @@ public interface ActivationSystem extends Remote {
* can no longer be activated via the object's activation id. * can no longer be activated via the object's activation id.
* *
* @param id the object's activation id (from previous registration) * @param id the object's activation id (from previous registration)
* @exception ActivationException if unregister fails (e.g., database * @throws ActivationException if unregister fails (e.g., database
* update failure, etc). * update failure, etc).
* @exception UnknownObjectException if object is unknown (not registered) * @throws UnknownObjectException if object is unknown (not registered)
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @since 1.2 * @since 1.2
*/ */
public void unregisterObject(ActivationID id) public void unregisterObject(ActivationID id)
@ -102,8 +102,8 @@ public interface ActivationSystem extends Remote {
* *
* @param desc the group's descriptor * @param desc the group's descriptor
* @return an identifier for the group * @return an identifier for the group
* @exception ActivationException if group registration fails * @throws ActivationException if group registration fails
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @since 1.2 * @since 1.2
*/ */
public ActivationGroupID registerGroup(ActivationGroupDesc desc) public ActivationGroupID registerGroup(ActivationGroupDesc desc)
@ -120,12 +120,12 @@ public interface ActivationSystem extends Remote {
* @param group the group's instantiator * @param group the group's instantiator
* @param incarnation the group's incarnation number * @param incarnation the group's incarnation number
* @return monitor for activation group * @return monitor for activation group
* @exception UnknownGroupException if group is not registered * @throws UnknownGroupException if group is not registered
* @exception ActivationException if a group for the specified * @throws ActivationException if a group for the specified
* <code>id</code> is already active and that group is not equal * <code>id</code> is already active and that group is not equal
* to the specified <code>group</code> or that group has a different * to the specified <code>group</code> or that group has a different
* <code>incarnation</code> than the specified <code>group</code> * <code>incarnation</code> than the specified <code>group</code>
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @since 1.2 * @since 1.2
*/ */
public ActivationMonitor activeGroup(ActivationGroupID id, public ActivationMonitor activeGroup(ActivationGroupID id,
@ -141,10 +141,10 @@ public interface ActivationSystem extends Remote {
* group and its associated objects is removed from the system. * group and its associated objects is removed from the system.
* *
* @param id the activation group's identifier * @param id the activation group's identifier
* @exception ActivationException if unregister fails (e.g., database * @throws ActivationException if unregister fails (e.g., database
* update failure, etc). * update failure, etc).
* @exception UnknownGroupException if group is not registered * @throws UnknownGroupException if group is not registered
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @since 1.2 * @since 1.2
*/ */
public void unregisterGroup(ActivationGroupID id) public void unregisterGroup(ActivationGroupID id)
@ -153,7 +153,7 @@ public interface ActivationSystem extends Remote {
/** /**
* Shutdown the activation system. Destroys all groups spawned by * Shutdown the activation system. Destroys all groups spawned by
* the activation daemon and exits the activation daemon. * the activation daemon and exits the activation daemon.
* @exception RemoteException if failed to contact/shutdown the activation * @throws RemoteException if failed to contact/shutdown the activation
* daemon * daemon
* @since 1.2 * @since 1.2
*/ */
@ -166,13 +166,13 @@ public interface ActivationSystem extends Remote {
* *
* @param id the activation identifier for the activatable object * @param id the activation identifier for the activatable object
* @param desc the activation descriptor for the activatable object * @param desc the activation descriptor for the activatable object
* @exception UnknownGroupException the group associated with * @throws UnknownGroupException the group associated with
* <code>desc</code> is not a registered group * <code>desc</code> is not a registered group
* @exception UnknownObjectException the activation <code>id</code> * @throws UnknownObjectException the activation <code>id</code>
* is not registered * is not registered
* @exception ActivationException for general failure (e.g., unable * @throws ActivationException for general failure (e.g., unable
* to update log) * to update log)
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @return the previous value of the activation descriptor * @return the previous value of the activation descriptor
* @see #getActivationDesc * @see #getActivationDesc
* @since 1.2 * @since 1.2
@ -189,11 +189,11 @@ public interface ActivationSystem extends Remote {
* *
* @param id the activation group identifier for the activation group * @param id the activation group identifier for the activation group
* @param desc the activation group descriptor for the activation group * @param desc the activation group descriptor for the activation group
* @exception UnknownGroupException the group associated with * @throws UnknownGroupException the group associated with
* <code>id</code> is not a registered group * <code>id</code> is not a registered group
* @exception ActivationException for general failure (e.g., unable * @throws ActivationException for general failure (e.g., unable
* to update log) * to update log)
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @return the previous value of the activation group descriptor * @return the previous value of the activation group descriptor
* @see #getActivationGroupDesc * @see #getActivationGroupDesc
* @since 1.2 * @since 1.2
@ -207,9 +207,9 @@ public interface ActivationSystem extends Remote {
* identifier, <code>id</code>. * identifier, <code>id</code>.
* *
* @param id the activation identifier for the activatable object * @param id the activation identifier for the activatable object
* @exception UnknownObjectException if <code>id</code> is not registered * @throws UnknownObjectException if <code>id</code> is not registered
* @exception ActivationException for general failure * @throws ActivationException for general failure
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @return the activation descriptor * @return the activation descriptor
* @see #setActivationDesc * @see #setActivationDesc
* @since 1.2 * @since 1.2
@ -222,9 +222,9 @@ public interface ActivationSystem extends Remote {
* with the activation group identifier, <code>id</code>. * with the activation group identifier, <code>id</code>.
* *
* @param id the activation group identifier for the group * @param id the activation group identifier for the group
* @exception UnknownGroupException if <code>id</code> is not registered * @throws UnknownGroupException if <code>id</code> is not registered
* @exception ActivationException for general failure * @throws ActivationException for general failure
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @return the activation group descriptor * @return the activation group descriptor
* @see #setActivationGroupDesc * @see #setActivationGroupDesc
* @since 1.2 * @since 1.2

6
src/java.rmi/share/classes/java/rmi/activation/Activator.java
View file

@ -107,9 +107,9 @@ public interface Activator extends Remote {
* the remote object's reference; if false, returning the cached value * the remote object's reference; if false, returning the cached value
* is allowed. * is allowed.
* @return the remote object (a stub) in a marshalled form * @return the remote object (a stub) in a marshalled form
* @exception ActivationException if object activation fails * @throws ActivationException if object activation fails
* @exception UnknownObjectException if object is unknown (not registered) * @throws UnknownObjectException if object is unknown (not registered)
* @exception RemoteException if remote call fails * @throws RemoteException if remote call fails
* @since 1.2 * @since 1.2
*/ */
public MarshalledObject<? extends Remote> activate(ActivationID id, public MarshalledObject<? extends Remote> activate(ActivationID id,

16
src/java.rmi/share/classes/java/rmi/registry/LocateRegistry.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2003, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -66,7 +66,7 @@ public final class LocateRegistry {
* the local host on the default registry port of 1099. * the local host on the default registry port of 1099.
* *
* @return reference (a stub) to the remote object registry * @return reference (a stub) to the remote object registry
* @exception RemoteException if the reference could not be created * @throws RemoteException if the reference could not be created
* @since 1.1 * @since 1.1
*/ */
public static Registry getRegistry() public static Registry getRegistry()
@ -81,7 +81,7 @@ public final class LocateRegistry {
* *
* @param port port on which the registry accepts requests * @param port port on which the registry accepts requests
* @return reference (a stub) to the remote object registry * @return reference (a stub) to the remote object registry
* @exception RemoteException if the reference could not be created * @throws RemoteException if the reference could not be created
* @since 1.1 * @since 1.1
*/ */
public static Registry getRegistry(int port) public static Registry getRegistry(int port)
@ -97,7 +97,7 @@ public final class LocateRegistry {
* *
* @param host host for the remote registry * @param host host for the remote registry
* @return reference (a stub) to the remote object registry * @return reference (a stub) to the remote object registry
* @exception RemoteException if the reference could not be created * @throws RemoteException if the reference could not be created
* @since 1.1 * @since 1.1
*/ */
public static Registry getRegistry(String host) public static Registry getRegistry(String host)
@ -114,7 +114,7 @@ public final class LocateRegistry {
* @param host host for the remote registry * @param host host for the remote registry
* @param port port on which the registry accepts requests * @param port port on which the registry accepts requests
* @return reference (a stub) to the remote object registry * @return reference (a stub) to the remote object registry
* @exception RemoteException if the reference could not be created * @throws RemoteException if the reference could not be created
* @since 1.1 * @since 1.1
*/ */
public static Registry getRegistry(String host, int port) public static Registry getRegistry(String host, int port)
@ -138,7 +138,7 @@ public final class LocateRegistry {
* is null, then the default client-side <code>Socket</code> * is null, then the default client-side <code>Socket</code>
* factory will be used in the registry stub. * factory will be used in the registry stub.
* @return reference (a stub) to the remote registry * @return reference (a stub) to the remote registry
* @exception RemoteException if the reference could not be created * @throws RemoteException if the reference could not be created
* @since 1.2 * @since 1.2
*/ */
public static Registry getRegistry(String host, int port, public static Registry getRegistry(String host, int port,
@ -196,7 +196,7 @@ public final class LocateRegistry {
* *
* @param port the port on which the registry accepts requests * @param port the port on which the registry accepts requests
* @return the registry * @return the registry
* @exception RemoteException if the registry could not be exported * @throws RemoteException if the registry could not be exported
* @since 1.1 * @since 1.1
**/ **/
public static Registry createRegistry(int port) throws RemoteException { public static Registry createRegistry(int port) throws RemoteException {
@ -228,7 +228,7 @@ public final class LocateRegistry {
* @param ssf server-side <code>ServerSocket</code> factory * @param ssf server-side <code>ServerSocket</code> factory
* used to accept connections to the registry * used to accept connections to the registry
* @return the registry * @return the registry
* @exception RemoteException if the registry could not be exported * @throws RemoteException if the registry could not be exported
* @since 1.2 * @since 1.2
**/ **/
public static Registry createRegistry(int port, public static Registry createRegistry(int port,

10
src/java.rmi/share/classes/java/rmi/server/LoaderHandler.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2004, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -50,10 +50,10 @@ public interface LoaderHandler {
* *
* @param name the name of the class to load * @param name the name of the class to load
* @return the <code>Class</code> object representing the loaded class * @return the <code>Class</code> object representing the loaded class
* @exception MalformedURLException * @throws MalformedURLException
* if the system property <b>java.rmi.server.codebase</b> * if the system property <b>java.rmi.server.codebase</b>
* contains an invalid URL * contains an invalid URL
* @exception ClassNotFoundException * @throws ClassNotFoundException
* if a definition for the class could not * if a definition for the class could not
* be found at the codebase location. * be found at the codebase location.
* @since 1.1 * @since 1.1
@ -69,10 +69,10 @@ public interface LoaderHandler {
* @param codebase the URL from which to load the class * @param codebase the URL from which to load the class
* @param name the name of the class to load * @param name the name of the class to load
* @return the <code>Class</code> object representing the loaded class * @return the <code>Class</code> object representing the loaded class
* @exception MalformedURLException * @throws MalformedURLException
* if the <code>codebase</code> paramater * if the <code>codebase</code> paramater
* contains an invalid URL * contains an invalid URL
* @exception ClassNotFoundException * @throws ClassNotFoundException
* if a definition for the class could not * if a definition for the class could not
* be found at the specified URL * be found at the specified URL
* @since 1.1 * @since 1.1

4
src/java.rmi/share/classes/java/rmi/server/RMIClientSocketFactory.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2001, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -66,7 +66,7 @@ public interface RMIClientSocketFactory {
* @param host the host name * @param host the host name
* @param port the port number * @param port the port number
* @return a socket connected to the specified host and port. * @return a socket connected to the specified host and port.
* @exception IOException if an I/O error occurs during socket creation * @throws IOException if an I/O error occurs during socket creation
* @since 1.2 * @since 1.2
*/ */
public Socket createSocket(String host, int port) public Socket createSocket(String host, int port)

4
src/java.rmi/share/classes/java/rmi/server/RMIServerSocketFactory.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2001, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -65,7 +65,7 @@ public interface RMIServerSocketFactory {
* an anonymous port). * an anonymous port).
* @param port the port number * @param port the port number
* @return the server socket on the specified port * @return the server socket on the specified port
* @exception IOException if an I/O error occurs during server socket * @throws IOException if an I/O error occurs during server socket
* creation * creation
* @since 1.2 * @since 1.2
*/ */

10
src/java.rmi/share/classes/java/rmi/server/RMISocketFactory.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -98,7 +98,7 @@ public abstract class RMISocketFactory
* @param host the host name * @param host the host name
* @param port the port number * @param port the port number
* @return a socket connected to the specified host and port. * @return a socket connected to the specified host and port.
* @exception IOException if an I/O error occurs during socket creation * @throws IOException if an I/O error occurs during socket creation
* @since 1.1 * @since 1.1
*/ */
public abstract Socket createSocket(String host, int port) public abstract Socket createSocket(String host, int port)
@ -109,7 +109,7 @@ public abstract class RMISocketFactory
* an anonymous port). * an anonymous port).
* @param port the port number * @param port the port number
* @return the server socket on the specified port * @return the server socket on the specified port
* @exception IOException if an I/O error occurs during server socket * @throws IOException if an I/O error occurs during server socket
* creation * creation
* @since 1.1 * @since 1.1
*/ */
@ -124,8 +124,8 @@ public abstract class RMISocketFactory
* setting a socket factory; if disallowed, a SecurityException will be * setting a socket factory; if disallowed, a SecurityException will be
* thrown. * thrown.
* @param fac the socket factory * @param fac the socket factory
* @exception IOException if the RMI socket factory is already set * @throws IOException if the RMI socket factory is already set
* @exception SecurityException if a security manager exists and its * @throws SecurityException if a security manager exists and its
* <code>checkSetFactory</code> method doesn't allow the operation. * <code>checkSetFactory</code> method doesn't allow the operation.
* @see #getSocketFactory * @see #getSocketFactory
* @see java.lang.SecurityManager#checkSetFactory() * @see java.lang.SecurityManager#checkSetFactory()

18
src/java.rmi/share/classes/java/rmi/server/RemoteCall.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -51,7 +51,7 @@ public interface RemoteCall {
* into. * into.
* *
* @return output stream for arguments/results * @return output stream for arguments/results
* @exception java.io.IOException if an I/O error occurs. * @throws java.io.IOException if an I/O error occurs.
* @since 1.1 * @since 1.1
* @deprecated no replacement * @deprecated no replacement
*/ */
@ -62,7 +62,7 @@ public interface RemoteCall {
* Release the output stream; in some transports this would release * Release the output stream; in some transports this would release
* the stream. * the stream.
* *
* @exception java.io.IOException if an I/O error occurs. * @throws java.io.IOException if an I/O error occurs.
* @since 1.1 * @since 1.1
* @deprecated no replacement * @deprecated no replacement
*/ */
@ -74,7 +74,7 @@ public interface RemoteCall {
* results/arguments from. * results/arguments from.
* *
* @return input stream for reading arguments/results * @return input stream for reading arguments/results
* @exception java.io.IOException if an I/O error occurs. * @throws java.io.IOException if an I/O error occurs.
* @since 1.1 * @since 1.1
* @deprecated no replacement * @deprecated no replacement
*/ */
@ -86,7 +86,7 @@ public interface RemoteCall {
* Release the input stream. This would allow some transports to release * Release the input stream. This would allow some transports to release
* the channel early. * the channel early.
* *
* @exception java.io.IOException if an I/O error occurs. * @throws java.io.IOException if an I/O error occurs.
* @since 1.1 * @since 1.1
* @deprecated no replacement * @deprecated no replacement
*/ */
@ -101,8 +101,8 @@ public interface RemoteCall {
* @param success If true, indicates normal return, else indicates * @param success If true, indicates normal return, else indicates
* exceptional return. * exceptional return.
* @return output stream for writing call result * @return output stream for writing call result
* @exception java.io.IOException if an I/O error occurs. * @throws java.io.IOException if an I/O error occurs.
* @exception java.io.StreamCorruptedException If already been called. * @throws java.io.StreamCorruptedException If already been called.
* @since 1.1 * @since 1.1
* @deprecated no replacement * @deprecated no replacement
*/ */
@ -113,7 +113,7 @@ public interface RemoteCall {
/** /**
* Do whatever it takes to execute the call. * Do whatever it takes to execute the call.
* *
* @exception java.lang.Exception if a general exception occurs. * @throws java.lang.Exception if a general exception occurs.
* @since 1.1 * @since 1.1
* @deprecated no replacement * @deprecated no replacement
*/ */
@ -123,7 +123,7 @@ public interface RemoteCall {
/** /**
* Allow cleanup after the remote call has completed. * Allow cleanup after the remote call has completed.
* *
* @exception java.io.IOException if an I/O error occurs. * @throws java.io.IOException if an I/O error occurs.
* @since 1.1 * @since 1.1
* @deprecated no replacement * @deprecated no replacement
*/ */

4
src/java.rmi/share/classes/java/rmi/server/RemoteObject.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2014, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -92,7 +92,7 @@ public abstract class RemoteObject implements Remote, java.io.Serializable {
* the object has been exported. * the object has been exported.
* @param obj the remote object whose stub is needed * @param obj the remote object whose stub is needed
* @return the stub for the remote object, <code>obj</code>. * @return the stub for the remote object, <code>obj</code>.
* @exception NoSuchObjectException if the stub for the * @throws NoSuchObjectException if the stub for the
* remote object could not be found. * remote object could not be found.
* @since 1.2 * @since 1.2
*/ */

4
src/java.rmi/share/classes/java/rmi/server/RemoteRef.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2018, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -73,7 +73,7 @@ public interface RemoteRef extends java.io.Externalizable {
* @param params the parameter list * @param params the parameter list
* @param opnum a hash that may be used to represent the method * @param opnum a hash that may be used to represent the method
* @return result of remote method invocation * @return result of remote method invocation
* @exception Exception if any exception occurs during remote method * @throws Exception if any exception occurs during remote method
* invocation * invocation
* @since 1.2 * @since 1.2
*/ */

6
src/java.rmi/share/classes/java/rmi/server/ServerRef.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2018, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -54,7 +54,7 @@ public interface ServerRef extends RemoteRef {
* @param obj the remote object implementation * @param obj the remote object implementation
* @param data information necessary to export the object * @param data information necessary to export the object
* @return the stub for the remote object * @return the stub for the remote object
* @exception RemoteException if an exception occurs attempting * @throws RemoteException if an exception occurs attempting
* to export the object (e.g., stub class could not be found) * to export the object (e.g., stub class could not be found)
* @since 1.1 * @since 1.1
*/ */
@ -66,7 +66,7 @@ public interface ServerRef extends RemoteRef {
* thread actively handling a remote method invocation the * thread actively handling a remote method invocation the
* hostname of the client is returned. * hostname of the client is returned.
* @return the client's host name * @return the client's host name
* @exception ServerNotActiveException if called outside of servicing * @throws ServerNotActiveException if called outside of servicing
* a remote method invocation * a remote method invocation
* @since 1.1 * @since 1.1
*/ */

2
src/java.rmi/share/classes/java/rmi/server/Skeleton.java
View file

@ -49,7 +49,7 @@ public interface Skeleton {
* @param theCall object representing remote call * @param theCall object representing remote call
* @param opnum operation number * @param opnum operation number
* @param hash stub/skeleton interface hash * @param hash stub/skeleton interface hash
* @exception java.lang.Exception if a general exception occurs. * @throws java.lang.Exception if a general exception occurs.
* @since 1.1 * @since 1.1
* @deprecated no replacement * @deprecated no replacement
*/ */

14
src/java.rmi/share/classes/java/rmi/server/UnicastRemoteObject.java
View file

@ -279,7 +279,7 @@ public class UnicastRemoteObject extends RemoteServer {
* Returns a clone of the remote object that is distinct from * Returns a clone of the remote object that is distinct from
* the original. * the original.
* *
* @exception CloneNotSupportedException if clone failed due to * @throws CloneNotSupportedException if clone failed due to
* a RemoteException. * a RemoteException.
* @return the new remote object * @return the new remote object
* @since 1.1 * @since 1.1
@ -319,7 +319,7 @@ public class UnicastRemoteObject extends RemoteServer {
* *
* @param obj the remote object to be exported * @param obj the remote object to be exported
* @return remote object stub * @return remote object stub
* @exception RemoteException if export fails * @throws RemoteException if export fails
* @since 1.1 * @since 1.1
* @deprecated This method is deprecated because it supports only static stubs. * @deprecated This method is deprecated because it supports only static stubs.
* Use {@link #exportObject(Remote, int) exportObject(Remote, port)} or * Use {@link #exportObject(Remote, int) exportObject(Remote, port)} or
@ -351,7 +351,7 @@ public class UnicastRemoteObject extends RemoteServer {
* @param obj the remote object to be exported * @param obj the remote object to be exported
* @param port the port to export the object on * @param port the port to export the object on
* @return remote object stub * @return remote object stub
* @exception RemoteException if export fails * @throws RemoteException if export fails
* @since 1.2 * @since 1.2
*/ */
public static Remote exportObject(Remote obj, int port) public static Remote exportObject(Remote obj, int port)
@ -374,7 +374,7 @@ public class UnicastRemoteObject extends RemoteServer {
* remote object * remote object
* @param ssf the server-side socket factory for receiving remote calls * @param ssf the server-side socket factory for receiving remote calls
* @return remote object stub * @return remote object stub
* @exception RemoteException if export fails * @throws RemoteException if export fails
* @since 1.2 * @since 1.2
*/ */
public static Remote exportObject(Remote obj, int port, public static Remote exportObject(Remote obj, int port,
@ -399,7 +399,7 @@ public class UnicastRemoteObject extends RemoteServer {
* @param filter an ObjectInputFilter applied when deserializing invocation arguments; * @param filter an ObjectInputFilter applied when deserializing invocation arguments;
* may be {@code null} * may be {@code null}
* @return remote object stub * @return remote object stub
* @exception RemoteException if export fails * @throws RemoteException if export fails
* @since 9 * @since 9
*/ */
public static Remote exportObject(Remote obj, int port, public static Remote exportObject(Remote obj, int port,
@ -426,7 +426,7 @@ public class UnicastRemoteObject extends RemoteServer {
* @param filter an ObjectInputFilter applied when deserializing invocation arguments; * @param filter an ObjectInputFilter applied when deserializing invocation arguments;
* may be {@code null} * may be {@code null}
* @return remote object stub * @return remote object stub
* @exception RemoteException if export fails * @throws RemoteException if export fails
* @since 9 * @since 9
*/ */
public static Remote exportObject(Remote obj, int port, public static Remote exportObject(Remote obj, int port,
@ -452,7 +452,7 @@ public class UnicastRemoteObject extends RemoteServer {
* pending or in-progress calls; if false, only unexports the object * pending or in-progress calls; if false, only unexports the object
* if there are no pending or in-progress calls * if there are no pending or in-progress calls
* @return true if operation is successful, false otherwise * @return true if operation is successful, false otherwise
* @exception NoSuchObjectException if the remote object is not * @throws NoSuchObjectException if the remote object is not
* currently exported * currently exported
* @since 1.2 * @since 1.2
*/ */

44
src/java.sql/share/classes/java/sql/Array.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -80,9 +80,9 @@ public interface Array {
* @return a <code>String</code> that is the database-specific * @return a <code>String</code> that is the database-specific
* name for a built-in base type; or the fully-qualified SQL type * name for a built-in base type; or the fully-qualified SQL type
* name for a base type that is a UDT * name for a base type that is a UDT
* @exception SQLException if an error occurs while attempting * @throws SQLException if an error occurs while attempting
* to access the type name * to access the type name
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -95,9 +95,9 @@ public interface Array {
* @return a constant from the class {@link java.sql.Types} that is * @return a constant from the class {@link java.sql.Types} that is
* the type code for the elements in the array designated by this * the type code for the elements in the array designated by this
* <code>Array</code> object * <code>Array</code> object
* @exception SQLException if an error occurs while attempting * @throws SQLException if an error occurs while attempting
* to access the base type * to access the base type
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -119,9 +119,9 @@ public interface Array {
* @return an array in the Java programming language that contains * @return an array in the Java programming language that contains
* the ordered elements of the SQL <code>ARRAY</code> value * the ordered elements of the SQL <code>ARRAY</code> value
* designated by this <code>Array</code> object * designated by this <code>Array</code> object
* @exception SQLException if an error occurs while attempting to * @throws SQLException if an error occurs while attempting to
* access the array * access the array
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -147,9 +147,9 @@ public interface Array {
* of SQL type names to classes in the Java programming language * of SQL type names to classes in the Java programming language
* @return an array in the Java programming language that contains the ordered * @return an array in the Java programming language that contains the ordered
* elements of the SQL array designated by this object * elements of the SQL array designated by this object
* @exception SQLException if an error occurs while attempting to * @throws SQLException if an error occurs while attempting to
* access the array * access the array
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -172,9 +172,9 @@ public interface Array {
* @param count the number of successive SQL array elements to retrieve * @param count the number of successive SQL array elements to retrieve
* @return an array containing up to <code>count</code> consecutive elements * @return an array containing up to <code>count</code> consecutive elements
* of the SQL array, beginning with element <code>index</code> * of the SQL array, beginning with element <code>index</code>
* @exception SQLException if an error occurs while attempting to * @throws SQLException if an error occurs while attempting to
* access the array * access the array
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -210,9 +210,9 @@ public interface Array {
* consecutive elements of the SQL <code>ARRAY</code> value designated by this * consecutive elements of the SQL <code>ARRAY</code> value designated by this
* <code>Array</code> object, beginning with element * <code>Array</code> object, beginning with element
* <code>index</code> * <code>index</code>
* @exception SQLException if an error occurs while attempting to * @throws SQLException if an error occurs while attempting to
* access the array * access the array
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -236,9 +236,9 @@ public interface Array {
* @return a {@link ResultSet} object containing one row for each * @return a {@link ResultSet} object containing one row for each
* of the elements in the array designated by this <code>Array</code> * of the elements in the array designated by this <code>Array</code>
* object, with the rows in ascending order based on the indices. * object, with the rows in ascending order based on the indices.
* @exception SQLException if an error occurs while attempting to * @throws SQLException if an error occurs while attempting to
* access the array * access the array
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -267,9 +267,9 @@ public interface Array {
* @return a <code>ResultSet</code> object containing one row for each * @return a <code>ResultSet</code> object containing one row for each
* of the elements in the array designated by this <code>Array</code> * of the elements in the array designated by this <code>Array</code>
* object, with the rows in ascending order based on the indices. * object, with the rows in ascending order based on the indices.
* @exception SQLException if an error occurs while attempting to * @throws SQLException if an error occurs while attempting to
* access the array * access the array
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -298,9 +298,9 @@ public interface Array {
* <code>count</code> consecutive elements of the SQL array * <code>count</code> consecutive elements of the SQL array
* designated by this <code>Array</code> object, starting at * designated by this <code>Array</code> object, starting at
* index <code>index</code>. * index <code>index</code>.
* @exception SQLException if an error occurs while attempting to * @throws SQLException if an error occurs while attempting to
* access the array * access the array
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -335,9 +335,9 @@ public interface Array {
* <code>count</code> consecutive elements of the SQL array * <code>count</code> consecutive elements of the SQL array
* designated by this <code>Array</code> object, starting at * designated by this <code>Array</code> object, starting at
* index <code>index</code>. * index <code>index</code>.
* @exception SQLException if an error occurs while attempting to * @throws SQLException if an error occurs while attempting to
* access the array * access the array
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -356,7 +356,7 @@ public interface Array {
* *
* @throws SQLException if an error occurs releasing * @throws SQLException if an error occurs releasing
* the Array's resources * the Array's resources
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */

42
src/java.sql/share/classes/java/sql/Blob.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -63,9 +63,9 @@ public interface Blob {
* designated by this {@code Blob} object. * designated by this {@code Blob} object.
* *
* @return length of the {@code BLOB} in bytes * @return length of the {@code BLOB} in bytes
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* length of the {@code BLOB} * length of the {@code BLOB}
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.2 * @since 1.2
*/ */
@ -86,10 +86,10 @@ public interface Blob {
* consecutive bytes from the {@code BLOB} value designated * consecutive bytes from the {@code BLOB} value designated
* by this {@code Blob} object, starting with the * by this {@code Blob} object, starting with the
* byte at position {@code pos} * byte at position {@code pos}
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code BLOB} value; if pos is less than 1 or length is * {@code BLOB} value; if pos is less than 1 or length is
* less than 0 * less than 0
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @see #setBytes * @see #setBytes
* @since 1.2 * @since 1.2
@ -101,9 +101,9 @@ public interface Blob {
* {@code Blob} instance as a stream. * {@code Blob} instance as a stream.
* *
* @return a stream containing the {@code BLOB} data * @return a stream containing the {@code BLOB} data
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code BLOB} value * {@code BLOB} value
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @see #setBinaryStream * @see #setBinaryStream
* @since 1.2 * @since 1.2
@ -121,9 +121,9 @@ public interface Blob {
* @param start the position at which to begin searching; the * @param start the position at which to begin searching; the
* first position is 1 * first position is 1
* @return the position at which the pattern appears, else -1 * @return the position at which the pattern appears, else -1
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code BLOB} or if start is less than 1 * {@code BLOB} or if start is less than 1
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.2 * @since 1.2
*/ */
@ -140,9 +140,9 @@ public interface Blob {
* @param start the position in the {@code BLOB} value * @param start the position in the {@code BLOB} value
* at which to begin searching; the first position is 1 * at which to begin searching; the first position is 1
* @return the position at which the pattern begins, else -1 * @return the position at which the pattern begins, else -1
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code BLOB} value or if start is less than 1 * {@code BLOB} value or if start is less than 1
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.2 * @since 1.2
*/ */
@ -171,9 +171,9 @@ public interface Blob {
* @param bytes the array of bytes to be written to the {@code BLOB} * @param bytes the array of bytes to be written to the {@code BLOB}
* value that this {@code Blob} object represents * value that this {@code Blob} object represents
* @return the number of bytes written * @return the number of bytes written
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code BLOB} value or if pos is less than 1 * {@code BLOB} value or if pos is less than 1
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @see #getBytes * @see #getBytes
* @since 1.4 * @since 1.4
@ -207,9 +207,9 @@ public interface Blob {
* @param len the number of bytes to be written to the {@code BLOB} * @param len the number of bytes to be written to the {@code BLOB}
* value from the array of bytes {@code bytes} * value from the array of bytes {@code bytes}
* @return the number of bytes written * @return the number of bytes written
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code BLOB} value or if pos is less than 1 * {@code BLOB} value or if pos is less than 1
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @see #getBytes * @see #getBytes
* @since 1.4 * @since 1.4
@ -236,9 +236,9 @@ public interface Blob {
* to start writing; the first position is 1 * to start writing; the first position is 1
* @return a {@code java.io.OutputStream} object to which data can * @return a {@code java.io.OutputStream} object to which data can
* be written * be written
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code BLOB} value or if pos is less than 1 * {@code BLOB} value or if pos is less than 1
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @see #getBinaryStream * @see #getBinaryStream
* @since 1.4 * @since 1.4
@ -257,9 +257,9 @@ public interface Blob {
* *
* @param len the length, in bytes, to which the {@code BLOB} value * @param len the length, in bytes, to which the {@code BLOB} value
* that this {@code Blob} object represents should be truncated * that this {@code Blob} object represents should be truncated
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code BLOB} value or if len is less than 0 * {@code BLOB} value or if len is less than 0
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.4 * @since 1.4
*/ */
@ -277,7 +277,7 @@ public interface Blob {
* *
* @throws SQLException if an error occurs releasing * @throws SQLException if an error occurs releasing
* the Blob's resources * the Blob's resources
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.6 * @since 1.6
*/ */
@ -298,7 +298,7 @@ public interface Blob {
* pos + length is greater than the number of bytes * pos + length is greater than the number of bytes
* in the {@code Blob} * in the {@code Blob}
* *
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.6 * @since 1.6
*/ */

650
src/java.sql/share/classes/java/sql/CallableStatement.java
View file

File diff suppressed because it is too large Load diff

50
src/java.sql/share/classes/java/sql/Clob.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2014, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -63,9 +63,9 @@ public interface Clob {
* designated by this {@code Clob} object. * designated by this {@code Clob} object.
* *
* @return length of the {@code CLOB} in characters * @return length of the {@code CLOB} in characters
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* length of the {@code CLOB} value * length of the {@code CLOB} value
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.2 * @since 1.2
*/ */
@ -85,10 +85,10 @@ public interface Clob {
* the value for length must be 0 or greater * the value for length must be 0 or greater
* @return a {@code String} that is the specified substring in * @return a {@code String} that is the specified substring in
* the {@code CLOB} value designated by this {@code Clob} object * the {@code CLOB} value designated by this {@code Clob} object
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code CLOB} value; if pos is less than 1 or length is * {@code CLOB} value; if pos is less than 1 or length is
* less than 0 * less than 0
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.2 * @since 1.2
*/ */
@ -101,9 +101,9 @@ public interface Clob {
* *
* @return a {@code java.io.Reader} object containing the * @return a {@code java.io.Reader} object containing the
* {@code CLOB} data * {@code CLOB} data
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code CLOB} value * {@code CLOB} value
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @see #setCharacterStream * @see #setCharacterStream
* @since 1.2 * @since 1.2
@ -116,9 +116,9 @@ public interface Clob {
* *
* @return a {@code java.io.InputStream} object containing the * @return a {@code java.io.InputStream} object containing the
* {@code CLOB} data * {@code CLOB} data
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code CLOB} value * {@code CLOB} value
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @see #setAsciiStream * @see #setAsciiStream
* @since 1.2 * @since 1.2
@ -136,9 +136,9 @@ public interface Clob {
* the first position is 1 * the first position is 1
* @return the position at which the substring appears or -1 if it is not * @return the position at which the substring appears or -1 if it is not
* present; the first position is 1 * present; the first position is 1
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code CLOB} value or if pos is less than 1 * {@code CLOB} value or if pos is less than 1
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.2 * @since 1.2
*/ */
@ -155,9 +155,9 @@ public interface Clob {
* position is 1 * position is 1
* @return the position at which the {@code Clob} object appears * @return the position at which the {@code Clob} object appears
* or -1 if it is not present; the first position is 1 * or -1 if it is not present; the first position is 1
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code CLOB} value or if start is less than 1 * {@code CLOB} value or if start is less than 1
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.2 * @since 1.2
*/ */
@ -186,10 +186,10 @@ public interface Clob {
* @param str the string to be written to the {@code CLOB} * @param str the string to be written to the {@code CLOB}
* value that this {@code Clob} designates * value that this {@code Clob} designates
* @return the number of characters written * @return the number of characters written
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code CLOB} value or if pos is less than 1 * {@code CLOB} value or if pos is less than 1
* *
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.4 * @since 1.4
*/ */
@ -219,10 +219,10 @@ public interface Clob {
* the characters to be written * the characters to be written
* @param len the number of characters to be written * @param len the number of characters to be written
* @return the number of characters written * @return the number of characters written
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code CLOB} value or if pos is less than 1 * {@code CLOB} value or if pos is less than 1
* *
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.4 * @since 1.4
*/ */
@ -247,9 +247,9 @@ public interface Clob {
* @param pos the position at which to start writing to this * @param pos the position at which to start writing to this
* {@code CLOB} object; The first position is 1 * {@code CLOB} object; The first position is 1
* @return the stream to which ASCII encoded characters can be written * @return the stream to which ASCII encoded characters can be written
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code CLOB} value or if pos is less than 1 * {@code CLOB} value or if pos is less than 1
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @see #getAsciiStream * @see #getAsciiStream
* *
@ -277,9 +277,9 @@ public interface Clob {
* {@code CLOB} value; The first position is 1 * {@code CLOB} value; The first position is 1
* *
* @return a stream to which Unicode encoded characters can be written * @return a stream to which Unicode encoded characters can be written
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code CLOB} value or if pos is less than 1 * {@code CLOB} value or if pos is less than 1
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @see #getCharacterStream * @see #getCharacterStream
* *
@ -300,10 +300,10 @@ public interface Clob {
* *
* @param len the length, in characters, to which the {@code CLOB} value * @param len the length, in characters, to which the {@code CLOB} value
* should be truncated * should be truncated
* @exception SQLException if there is an error accessing the * @throws SQLException if there is an error accessing the
* {@code CLOB} value or if len is less than 0 * {@code CLOB} value or if len is less than 0
* *
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.4 * @since 1.4
*/ */
@ -322,7 +322,7 @@ public interface Clob {
* @throws SQLException if an error occurs releasing * @throws SQLException if an error occurs releasing
* the Clob's resources * the Clob's resources
* *
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.6 * @since 1.6
*/ */
@ -344,7 +344,7 @@ public interface Clob {
* or if pos + length is greater than the number of * or if pos + length is greater than the number of
* characters in the {@code Clob} * characters in the {@code Clob}
* *
* @exception SQLFeatureNotSupportedException if the JDBC driver * @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method * does not support this method
* @since 1.6 * @since 1.6
*/ */

152
src/java.sql/share/classes/java/sql/Connection.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -99,7 +99,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* calling {@link #getHoldability}. * calling {@link #getHoldability}.
* *
* @return a new default <code>Statement</code> object * @return a new default <code>Statement</code> object
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
*/ */
Statement createStatement() throws SQLException; Statement createStatement() throws SQLException;
@ -133,7 +133,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* parameter placeholders * parameter placeholders
* @return a new default <code>PreparedStatement</code> object containing the * @return a new default <code>PreparedStatement</code> object containing the
* pre-compiled SQL statement * pre-compiled SQL statement
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
*/ */
PreparedStatement prepareStatement(String sql) PreparedStatement prepareStatement(String sql)
@ -166,7 +166,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* call escape syntax. * call escape syntax.
* @return a new default <code>CallableStatement</code> object containing the * @return a new default <code>CallableStatement</code> object containing the
* pre-compiled SQL statement * pre-compiled SQL statement
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
*/ */
CallableStatement prepareCall(String sql) throws SQLException; CallableStatement prepareCall(String sql) throws SQLException;
@ -180,7 +180,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* @param sql an SQL statement that may contain one or more '?' * @param sql an SQL statement that may contain one or more '?'
* parameter placeholders * parameter placeholders
* @return the native form of this statement * @return the native form of this statement
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
*/ */
String nativeSQL(String sql) throws SQLException; String nativeSQL(String sql) throws SQLException;
@ -215,7 +215,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* *
* @param autoCommit <code>true</code> to enable auto-commit mode; * @param autoCommit <code>true</code> to enable auto-commit mode;
* <code>false</code> to disable it * <code>false</code> to disable it
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* setAutoCommit(true) is called while participating in a distributed transaction, * setAutoCommit(true) is called while participating in a distributed transaction,
* or this method is called on a closed connection * or this method is called on a closed connection
* @see #getAutoCommit * @see #getAutoCommit
@ -228,7 +228,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* *
* @return the current state of this <code>Connection</code> object's * @return the current state of this <code>Connection</code> object's
* auto-commit mode * auto-commit mode
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
* @see #setAutoCommit * @see #setAutoCommit
*/ */
@ -241,10 +241,10 @@ public interface Connection extends Wrapper, AutoCloseable {
* This method should be * This method should be
* used only when auto-commit mode has been disabled. * used only when auto-commit mode has been disabled.
* *
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called while participating in a distributed transaction, * this method is called while participating in a distributed transaction,
* if this method is called on a closed connection or this * if this method is called on a closed connection or this
* <code>Connection</code> object is in auto-commit mode * {@code Connection} object is in auto-commit mode
* @see #setAutoCommit * @see #setAutoCommit
*/ */
void commit() throws SQLException; void commit() throws SQLException;
@ -255,10 +255,10 @@ public interface Connection extends Wrapper, AutoCloseable {
* by this <code>Connection</code> object. This method should be * by this <code>Connection</code> object. This method should be
* used only when auto-commit mode has been disabled. * used only when auto-commit mode has been disabled.
* *
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called while participating in a distributed transaction, * this method is called while participating in a distributed transaction,
* this method is called on a closed connection or this * this method is called on a closed connection or this
* <code>Connection</code> object is in auto-commit mode * {@code Connection} object is in auto-commit mode
* @see #setAutoCommit * @see #setAutoCommit
*/ */
void rollback() throws SQLException; void rollback() throws SQLException;
@ -275,7 +275,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* <code>close</code> method. If the <code>close</code> method is called * <code>close</code> method. If the <code>close</code> method is called
* and there is an active transaction, the results are implementation-defined. * and there is an active transaction, the results are implementation-defined.
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void close() throws SQLException; void close() throws SQLException;
@ -294,7 +294,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* *
* @return <code>true</code> if this <code>Connection</code> object * @return <code>true</code> if this <code>Connection</code> object
* is closed; <code>false</code> if it is still open * is closed; <code>false</code> if it is still open
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
boolean isClosed() throws SQLException; boolean isClosed() throws SQLException;
@ -311,7 +311,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* *
* @return a <code>DatabaseMetaData</code> object for this * @return a <code>DatabaseMetaData</code> object for this
* <code>Connection</code> object * <code>Connection</code> object
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
*/ */
DatabaseMetaData getMetaData() throws SQLException; DatabaseMetaData getMetaData() throws SQLException;
@ -324,7 +324,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* *
* @param readOnly <code>true</code> enables read-only mode; * @param readOnly <code>true</code> enables read-only mode;
* <code>false</code> disables it * <code>false</code> disables it
* @exception SQLException if a database access error occurs, this * @throws SQLException if a database access error occurs, this
* method is called on a closed connection or this * method is called on a closed connection or this
* method is called during a transaction * method is called during a transaction
*/ */
@ -336,7 +336,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* *
* @return <code>true</code> if this <code>Connection</code> object * @return <code>true</code> if this <code>Connection</code> object
* is read-only; <code>false</code> otherwise * is read-only; <code>false</code> otherwise
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
*/ */
boolean isReadOnly() throws SQLException; boolean isReadOnly() throws SQLException;
@ -358,7 +358,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* *
* @param catalog the name of a catalog (subspace in this * @param catalog the name of a catalog (subspace in this
* <code>Connection</code> object's database) in which to work * <code>Connection</code> object's database) in which to work
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
* @see #getCatalog * @see #getCatalog
*/ */
@ -368,7 +368,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* Retrieves this <code>Connection</code> object's current catalog name. * Retrieves this <code>Connection</code> object's current catalog name.
* *
* @return the current catalog name or <code>null</code> if there is none * @return the current catalog name or <code>null</code> if there is none
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
* @see #setCatalog * @see #setCatalog
*/ */
@ -438,9 +438,9 @@ public interface Connection extends Wrapper, AutoCloseable {
* <code>Connection.TRANSACTION_SERIALIZABLE</code>. * <code>Connection.TRANSACTION_SERIALIZABLE</code>.
* (Note that <code>Connection.TRANSACTION_NONE</code> cannot be used * (Note that <code>Connection.TRANSACTION_NONE</code> cannot be used
* because it specifies that transactions are not supported.) * because it specifies that transactions are not supported.)
* @exception SQLException if a database access error occurs, this * @throws SQLException if a database access error occurs, this
* method is called on a closed connection * method is called on a closed connection
* or the given parameter is not one of the <code>Connection</code> * or the given parameter is not one of the {@code Connection}
* constants * constants
* @see DatabaseMetaData#supportsTransactionIsolationLevel * @see DatabaseMetaData#supportsTransactionIsolationLevel
* @see #getTransactionIsolation * @see #getTransactionIsolation
@ -458,7 +458,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* <code>Connection.TRANSACTION_REPEATABLE_READ</code>, * <code>Connection.TRANSACTION_REPEATABLE_READ</code>,
* <code>Connection.TRANSACTION_SERIALIZABLE</code>, or * <code>Connection.TRANSACTION_SERIALIZABLE</code>, or
* <code>Connection.TRANSACTION_NONE</code>. * <code>Connection.TRANSACTION_NONE</code>.
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
* @see #setTransactionIsolation * @see #setTransactionIsolation
*/ */
@ -481,7 +481,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* *
* @return the first <code>SQLWarning</code> object or <code>null</code> * @return the first <code>SQLWarning</code> object or <code>null</code>
* if there are none * if there are none
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed connection * this method is called on a closed connection
* @see SQLWarning * @see SQLWarning
*/ */
@ -493,7 +493,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* returns <code>null</code> until a new warning is * returns <code>null</code> until a new warning is
* reported for this <code>Connection</code> object. * reported for this <code>Connection</code> object.
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
*/ */
void clearWarnings() throws SQLException; void clearWarnings() throws SQLException;
@ -520,11 +520,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* @return a new <code>Statement</code> object that will generate * @return a new <code>Statement</code> object that will generate
* <code>ResultSet</code> objects with the given type and * <code>ResultSet</code> objects with the given type and
* concurrency * concurrency
* @exception SQLException if a database access error occurs, this * @throws SQLException if a database access error occurs, this
* method is called on a closed connection * method is called on a closed connection
* or the given parameters are not <code>ResultSet</code> * or the given parameters are not {@code ResultSet}
* constants indicating type and concurrency * constants indicating type and concurrency
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method or this method is not supported for the specified result * this method or this method is not supported for the specified result
* set type and result set concurrency. * set type and result set concurrency.
* @since 1.2 * @since 1.2
@ -555,11 +555,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* @return a new PreparedStatement object containing the * @return a new PreparedStatement object containing the
* pre-compiled SQL statement that will produce <code>ResultSet</code> * pre-compiled SQL statement that will produce <code>ResultSet</code>
* objects with the given type and concurrency * objects with the given type and concurrency
* @exception SQLException if a database access error occurs, this * @throws SQLException if a database access error occurs, this
* method is called on a closed connection * method is called on a closed connection
* or the given parameters are not <code>ResultSet</code> * or the given parameters are not {@code ResultSet}
* constants indicating type and concurrency * constants indicating type and concurrency
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method or this method is not supported for the specified result * this method or this method is not supported for the specified result
* set type and result set concurrency. * set type and result set concurrency.
* @since 1.2 * @since 1.2
@ -589,11 +589,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* @return a new <code>CallableStatement</code> object containing the * @return a new <code>CallableStatement</code> object containing the
* pre-compiled SQL statement that will produce <code>ResultSet</code> * pre-compiled SQL statement that will produce <code>ResultSet</code>
* objects with the given type and concurrency * objects with the given type and concurrency
* @exception SQLException if a database access error occurs, this method * @throws SQLException if a database access error occurs, this method
* is called on a closed connection * is called on a closed connection
* or the given parameters are not <code>ResultSet</code> * or the given parameters are not {@code ResultSet}
* constants indicating type and concurrency * constants indicating type and concurrency
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method or this method is not supported for the specified result * this method or this method is not supported for the specified result
* set type and result set concurrency. * set type and result set concurrency.
* @since 1.2 * @since 1.2
@ -619,9 +619,9 @@ public interface Connection extends Wrapper, AutoCloseable {
* </pre> * </pre>
* @return the <code>java.util.Map</code> object associated * @return the <code>java.util.Map</code> object associated
* with this <code>Connection</code> object * with this <code>Connection</code> object
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
* @see #setTypeMap * @see #setTypeMap
@ -645,11 +645,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* @param map the <code>java.util.Map</code> object to install * @param map the <code>java.util.Map</code> object to install
* as the replacement for this <code>Connection</code> * as the replacement for this <code>Connection</code>
* object's default type map * object's default type map
* @exception SQLException if a database access error occurs, this * @throws SQLException if a database access error occurs, this
* method is called on a closed connection or * method is called on a closed connection or
* the given parameter is not a <code>java.util.Map</code> * the given parameter is not a {@code java.util.Map}
* object * object
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
* @see #getTypeMap * @see #getTypeMap
@ -672,7 +672,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* @throws SQLException if a database access occurs, this method is called * @throws SQLException if a database access occurs, this method is called
* on a closed connection, or the given parameter * on a closed connection, or the given parameter
* is not a <code>ResultSet</code> constant indicating holdability * is not a <code>ResultSet</code> constant indicating holdability
* @exception SQLFeatureNotSupportedException if the given holdability is not supported * @throws SQLFeatureNotSupportedException if the given holdability is not supported
* @see #getHoldability * @see #getHoldability
* @see DatabaseMetaData#getResultSetHoldability * @see DatabaseMetaData#getResultSetHoldability
* @see ResultSet * @see ResultSet
@ -704,12 +704,12 @@ public interface Connection extends Wrapper, AutoCloseable {
*savepoint. *savepoint.
* *
* @return the new <code>Savepoint</code> object * @return the new <code>Savepoint</code> object
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called while participating in a distributed transaction, * this method is called while participating in a distributed transaction,
* this method is called on a closed connection * this method is called on a closed connection
* or this <code>Connection</code> object is currently in * or this {@code Connection} object is currently in
* auto-commit mode * auto-commit mode
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see Savepoint * @see Savepoint
* @since 1.4 * @since 1.4
@ -725,12 +725,12 @@ public interface Connection extends Wrapper, AutoCloseable {
* *
* @param name a <code>String</code> containing the name of the savepoint * @param name a <code>String</code> containing the name of the savepoint
* @return the new <code>Savepoint</code> object * @return the new <code>Savepoint</code> object
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called while participating in a distributed transaction, * this method is called while participating in a distributed transaction,
* this method is called on a closed connection * this method is called on a closed connection
* or this <code>Connection</code> object is currently in * or this {@code Connection} object is currently in
* auto-commit mode * auto-commit mode
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see Savepoint * @see Savepoint
* @since 1.4 * @since 1.4
@ -744,13 +744,13 @@ public interface Connection extends Wrapper, AutoCloseable {
* This method should be used only when auto-commit has been disabled. * This method should be used only when auto-commit has been disabled.
* *
* @param savepoint the <code>Savepoint</code> object to roll back to * @param savepoint the <code>Savepoint</code> object to roll back to
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called while participating in a distributed transaction, * this method is called while participating in a distributed transaction,
* this method is called on a closed connection, * this method is called on a closed connection,
* the <code>Savepoint</code> object is no longer valid, * the {@code Savepoint} object is no longer valid,
* or this <code>Connection</code> object is currently in * or this {@code Connection} object is currently in
* auto-commit mode * auto-commit mode
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see Savepoint * @see Savepoint
* @see #rollback * @see #rollback
@ -764,11 +764,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* will cause an <code>SQLException</code> to be thrown. * will cause an <code>SQLException</code> to be thrown.
* *
* @param savepoint the <code>Savepoint</code> object to be removed * @param savepoint the <code>Savepoint</code> object to be removed
* @exception SQLException if a database access error occurs, this * @throws SQLException if a database access error occurs, this
* method is called on a closed connection or * method is called on a closed connection or
* the given <code>Savepoint</code> object is not a valid * the given {@code Savepoint} object is not a valid
* savepoint in the current transaction * savepoint in the current transaction
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */
@ -798,11 +798,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* @return a new <code>Statement</code> object that will generate * @return a new <code>Statement</code> object that will generate
* <code>ResultSet</code> objects with the given type, * <code>ResultSet</code> objects with the given type,
* concurrency, and holdability * concurrency, and holdability
* @exception SQLException if a database access error occurs, this * @throws SQLException if a database access error occurs, this
* method is called on a closed connection * method is called on a closed connection
* or the given parameters are not <code>ResultSet</code> * or the given parameters are not {@code ResultSet}
* constants indicating type, concurrency, and holdability * constants indicating type, concurrency, and holdability
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method or this method is not supported for the specified result * this method or this method is not supported for the specified result
* set type, result set holdability and result set concurrency. * set type, result set holdability and result set concurrency.
* @see ResultSet * @see ResultSet
@ -840,11 +840,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* pre-compiled SQL statement, that will generate * pre-compiled SQL statement, that will generate
* <code>ResultSet</code> objects with the given type, * <code>ResultSet</code> objects with the given type,
* concurrency, and holdability * concurrency, and holdability
* @exception SQLException if a database access error occurs, this * @throws SQLException if a database access error occurs, this
* method is called on a closed connection * method is called on a closed connection
* or the given parameters are not <code>ResultSet</code> * or the given parameters are not {@code ResultSet}
* constants indicating type, concurrency, and holdability * constants indicating type, concurrency, and holdability
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method or this method is not supported for the specified result * this method or this method is not supported for the specified result
* set type, result set holdability and result set concurrency. * set type, result set holdability and result set concurrency.
* @see ResultSet * @see ResultSet
@ -880,11 +880,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* pre-compiled SQL statement, that will generate * pre-compiled SQL statement, that will generate
* <code>ResultSet</code> objects with the given type, * <code>ResultSet</code> objects with the given type,
* concurrency, and holdability * concurrency, and holdability
* @exception SQLException if a database access error occurs, this * @throws SQLException if a database access error occurs, this
* method is called on a closed connection * method is called on a closed connection
* or the given parameters are not <code>ResultSet</code> * or the given parameters are not {@code ResultSet}
* constants indicating type, concurrency, and holdability * constants indicating type, concurrency, and holdability
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method or this method is not supported for the specified result * this method or this method is not supported for the specified result
* set type, result set holdability and result set concurrency. * set type, result set holdability and result set concurrency.
* @see ResultSet * @see ResultSet
@ -928,12 +928,12 @@ public interface Connection extends Wrapper, AutoCloseable {
* @return a new <code>PreparedStatement</code> object, containing the * @return a new <code>PreparedStatement</code> object, containing the
* pre-compiled SQL statement, that will have the capability of * pre-compiled SQL statement, that will have the capability of
* returning auto-generated keys * returning auto-generated keys
* @exception SQLException if a database access error occurs, this * @throws SQLException if a database access error occurs, this
* method is called on a closed connection * method is called on a closed connection
* or the given parameter is not a <code>Statement</code> * or the given parameter is not a {@code Statement}
* constant indicating whether auto-generated keys should be * constant indicating whether auto-generated keys should be
* returned * returned
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method with a constant of Statement.RETURN_GENERATED_KEYS * this method with a constant of Statement.RETURN_GENERATED_KEYS
* @since 1.4 * @since 1.4
*/ */
@ -978,9 +978,9 @@ public interface Connection extends Wrapper, AutoCloseable {
* pre-compiled statement, that is capable of returning the * pre-compiled statement, that is capable of returning the
* auto-generated keys designated by the given array of column * auto-generated keys designated by the given array of column
* indexes * indexes
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* *
* @since 1.4 * @since 1.4
@ -1026,9 +1026,9 @@ public interface Connection extends Wrapper, AutoCloseable {
* pre-compiled statement, that is capable of returning the * pre-compiled statement, that is capable of returning the
* auto-generated keys designated by the given array of column * auto-generated keys designated by the given array of column
* names * names
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* *
* @since 1.4 * @since 1.4
@ -1045,7 +1045,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* @throws SQLException if an object that implements the * @throws SQLException if an object that implements the
* <code>Clob</code> interface can not be constructed, this method is * <code>Clob</code> interface can not be constructed, this method is
* called on a closed connection or a database access error occurs. * called on a closed connection or a database access error occurs.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this data type * this data type
* *
* @since 1.6 * @since 1.6
@ -1061,7 +1061,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* @throws SQLException if an object that implements the * @throws SQLException if an object that implements the
* <code>Blob</code> interface can not be constructed, this method is * <code>Blob</code> interface can not be constructed, this method is
* called on a closed connection or a database access error occurs. * called on a closed connection or a database access error occurs.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this data type * this data type
* *
* @since 1.6 * @since 1.6
@ -1077,7 +1077,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* @throws SQLException if an object that implements the * @throws SQLException if an object that implements the
* <code>NClob</code> interface can not be constructed, this method is * <code>NClob</code> interface can not be constructed, this method is
* called on a closed connection or a database access error occurs. * called on a closed connection or a database access error occurs.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this data type * this data type
* *
* @since 1.6 * @since 1.6
@ -1093,7 +1093,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* @throws SQLException if an object that implements the <code>SQLXML</code> interface can not * @throws SQLException if an object that implements the <code>SQLXML</code> interface can not
* be constructed, this method is * be constructed, this method is
* called on a closed connection or a database access error occurs. * called on a closed connection or a database access error occurs.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this data type * this data type
* @since 1.6 * @since 1.6
*/ */
@ -1116,7 +1116,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* database operation. * database operation.
* *
* @return true if the connection is valid, false otherwise * @return true if the connection is valid, false otherwise
* @exception SQLException if the value supplied for <code>timeout</code> * @throws SQLException if the value supplied for {@code timeout}
* is less than 0 * is less than 0
* @since 1.6 * @since 1.6
* *
@ -1318,7 +1318,7 @@ throws SQLException;
* {@code Statement} is created or prepared. * {@code Statement} is created or prepared.
* *
* @param schema the name of a schema in which to work * @param schema the name of a schema in which to work
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
* @see #getSchema * @see #getSchema
* @since 1.7 * @since 1.7
@ -1329,7 +1329,7 @@ throws SQLException;
* Retrieves this <code>Connection</code> object's current schema name. * Retrieves this <code>Connection</code> object's current schema name.
* *
* @return the current schema name or <code>null</code> if there is none * @return the current schema name or <code>null</code> if there is none
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* or this method is called on a closed connection * or this method is called on a closed connection
* @see #setSchema * @see #setSchema
* @since 1.7 * @since 1.7
@ -1455,7 +1455,7 @@ throws SQLException;
* @throws java.lang.SecurityException if a security manager exists and its * @throws java.lang.SecurityException if a security manager exists and its
* <code>checkPermission</code> method denies calling * <code>checkPermission</code> method denies calling
* <code>setNetworkTimeout</code>. * <code>setNetworkTimeout</code>.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see SecurityManager#checkPermission * @see SecurityManager#checkPermission
* @see Statement#setQueryTimeout * @see Statement#setQueryTimeout
@ -1477,7 +1477,7 @@ throws SQLException;
* no limit * no limit
* @throws SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Connection</code> * this method is called on a closed <code>Connection</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #setNetworkTimeout * @see #setNetworkTimeout
* @since 1.7 * @since 1.7

340
src/java.sql/share/classes/java/sql/DatabaseMetaData.java
View file

File diff suppressed because it is too large Load diff

18
src/java.sql/share/classes/java/sql/Date.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -194,7 +194,7 @@ public class Date extends java.util.Date {
* values do not have a time component. * values do not have a time component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this method is invoked * @throws java.lang.IllegalArgumentException if this method is invoked
* @see #setHours * @see #setHours
*/ */
@Deprecated(since="1.2") @Deprecated(since="1.2")
@ -207,7 +207,7 @@ public class Date extends java.util.Date {
* values do not have a time component. * values do not have a time component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this method is invoked * @throws java.lang.IllegalArgumentException if this method is invoked
* @see #setMinutes * @see #setMinutes
*/ */
@Deprecated(since="1.2") @Deprecated(since="1.2")
@ -220,7 +220,7 @@ public class Date extends java.util.Date {
* values do not have a time component. * values do not have a time component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this method is invoked * @throws java.lang.IllegalArgumentException if this method is invoked
* @see #setSeconds * @see #setSeconds
*/ */
@Deprecated(since="1.2") @Deprecated(since="1.2")
@ -233,7 +233,7 @@ public class Date extends java.util.Date {
* values do not have a time component. * values do not have a time component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this method is invoked * @throws java.lang.IllegalArgumentException if this method is invoked
* @see #getHours * @see #getHours
*/ */
@Deprecated(since="1.2") @Deprecated(since="1.2")
@ -246,7 +246,7 @@ public class Date extends java.util.Date {
* values do not have a time component. * values do not have a time component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this method is invoked * @throws java.lang.IllegalArgumentException if this method is invoked
* @see #getMinutes * @see #getMinutes
*/ */
@Deprecated(since="1.2") @Deprecated(since="1.2")
@ -259,7 +259,7 @@ public class Date extends java.util.Date {
* values do not have a time component. * values do not have a time component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this method is invoked * @throws java.lang.IllegalArgumentException if this method is invoked
* @see #getSeconds * @see #getSeconds
*/ */
@Deprecated(since="1.2") @Deprecated(since="1.2")
@ -283,7 +283,7 @@ public class Date extends java.util.Date {
* *
* @param date a {@code LocalDate} to convert * @param date a {@code LocalDate} to convert
* @return a {@code Date} object * @return a {@code Date} object
* @exception NullPointerException if {@code date} is null * @throws NullPointerException if {@code date} is null
* @since 1.8 * @since 1.8
*/ */
@SuppressWarnings("deprecation") @SuppressWarnings("deprecation")
@ -309,7 +309,7 @@ public class Date extends java.util.Date {
* not be used because SQL {@code Date} values do not have a time * not be used because SQL {@code Date} values do not have a time
* component. * component.
* *
* @exception java.lang.UnsupportedOperationException if this method is invoked * @throws java.lang.UnsupportedOperationException if this method is invoked
*/ */
@Override @Override
public Instant toInstant() { public Instant toInstant() {

8
src/java.sql/share/classes/java/sql/Driver.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -85,7 +85,7 @@ public interface Driver {
* "password" property should be included. * "password" property should be included.
* @return a <code>Connection</code> object that represents a * @return a <code>Connection</code> object that represents a
* connection to the URL * connection to the URL
* @exception SQLException if a database access error occurs or the url is * @throws SQLException if a database access error occurs or the url is
* {@code null} * {@code null}
*/ */
Connection connect(String url, java.util.Properties info) Connection connect(String url, java.util.Properties info)
@ -100,7 +100,7 @@ public interface Driver {
* @param url the URL of the database * @param url the URL of the database
* @return <code>true</code> if this driver understands the given URL; * @return <code>true</code> if this driver understands the given URL;
* <code>false</code> otherwise * <code>false</code> otherwise
* @exception SQLException if a database access error occurs or the url is * @throws SQLException if a database access error occurs or the url is
* {@code null} * {@code null}
*/ */
boolean acceptsURL(String url) throws SQLException; boolean acceptsURL(String url) throws SQLException;
@ -123,7 +123,7 @@ public interface Driver {
* @return an array of <code>DriverPropertyInfo</code> objects describing * @return an array of <code>DriverPropertyInfo</code> objects describing
* possible properties. This array may be an empty array if * possible properties. This array may be an empty array if
* no properties are required. * no properties are required.
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
DriverPropertyInfo[] getPropertyInfo(String url, java.util.Properties info) DriverPropertyInfo[] getPropertyInfo(String url, java.util.Properties info)
throws SQLException; throws SQLException;

18
src/java.sql/share/classes/java/sql/DriverManager.java
View file

@ -175,7 +175,7 @@ public class DriverManager {
* connection arguments; normally at least a "user" and * connection arguments; normally at least a "user" and
* "password" property should be included * "password" property should be included
* @return a Connection to the URL * @return a Connection to the URL
* @exception SQLException if a database access error occurs or the url is * @throws SQLException if a database access error occurs or the url is
* {@code null} * {@code null}
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value specified by the {@code setLoginTimeout} method * timeout value specified by the {@code setLoginTimeout} method
@ -206,7 +206,7 @@ public class DriverManager {
* made * made
* @param password the user's password * @param password the user's password
* @return a connection to the URL * @return a connection to the URL
* @exception SQLException if a database access error occurs or the url is * @throws SQLException if a database access error occurs or the url is
* {@code null} * {@code null}
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value specified by the {@code setLoginTimeout} method * timeout value specified by the {@code setLoginTimeout} method
@ -236,7 +236,7 @@ public class DriverManager {
* @param url a database url of the form * @param url a database url of the form
* <code> jdbc:<em>subprotocol</em>:<em>subname</em></code> * <code> jdbc:<em>subprotocol</em>:<em>subname</em></code>
* @return a connection to the URL * @return a connection to the URL
* @exception SQLException if a database access error occurs or the url is * @throws SQLException if a database access error occurs or the url is
* {@code null} * {@code null}
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value specified by the {@code setLoginTimeout} method * timeout value specified by the {@code setLoginTimeout} method
@ -260,7 +260,7 @@ public class DriverManager {
* <code>jdbc:<em>subprotocol</em>:<em>subname</em></code> * <code>jdbc:<em>subprotocol</em>:<em>subname</em></code>
* @return a <code>Driver</code> object representing a driver * @return a <code>Driver</code> object representing a driver
* that can connect to the given URL * that can connect to the given URL
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
@CallerSensitive @CallerSensitive
public static Driver getDriver(String url) public static Driver getDriver(String url)
@ -308,8 +308,8 @@ public class DriverManager {
* *
* @param driver the new JDBC Driver that is to be registered with the * @param driver the new JDBC Driver that is to be registered with the
* {@code DriverManager} * {@code DriverManager}
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception NullPointerException if {@code driver} is null * @throws NullPointerException if {@code driver} is null
*/ */
public static void registerDriver(java.sql.Driver driver) public static void registerDriver(java.sql.Driver driver)
throws SQLException { throws SQLException {
@ -328,8 +328,8 @@ public class DriverManager {
* {@code DriverManager} * {@code DriverManager}
* @param da the {@code DriverAction} implementation to be used when * @param da the {@code DriverAction} implementation to be used when
* {@code DriverManager#deregisterDriver} is called * {@code DriverManager#deregisterDriver} is called
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception NullPointerException if {@code driver} is null * @throws NullPointerException if {@code driver} is null
* @since 1.8 * @since 1.8
*/ */
public static void registerDriver(java.sql.Driver driver, public static void registerDriver(java.sql.Driver driver,
@ -368,7 +368,7 @@ public class DriverManager {
* prior to the driver being removed from the list of registered drivers. * prior to the driver being removed from the list of registered drivers.
* *
* @param driver the JDBC Driver to remove * @param driver the JDBC Driver to remove
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @throws SecurityException if a security manager exists and its * @throws SecurityException if a security manager exists and its
* {@code checkPermission} method denies permission to deregister a driver. * {@code checkPermission} method denies permission to deregister a driver.
* *

20
src/java.sql/share/classes/java/sql/ParameterMetaData.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -48,7 +48,7 @@ public interface ParameterMetaData extends Wrapper {
* information. * information.
* *
* @return the number of parameters * @return the number of parameters
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @since 1.4 * @since 1.4
*/ */
int getParameterCount() throws SQLException; int getParameterCount() throws SQLException;
@ -61,7 +61,7 @@ public interface ParameterMetaData extends Wrapper {
* <code>ParameterMetaData.parameterNoNulls</code>, * <code>ParameterMetaData.parameterNoNulls</code>,
* <code>ParameterMetaData.parameterNullable</code>, or * <code>ParameterMetaData.parameterNullable</code>, or
* <code>ParameterMetaData.parameterNullableUnknown</code> * <code>ParameterMetaData.parameterNullableUnknown</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @since 1.4 * @since 1.4
*/ */
int isNullable(int param) throws SQLException; int isNullable(int param) throws SQLException;
@ -89,7 +89,7 @@ public interface ParameterMetaData extends Wrapper {
* *
* @param param the first parameter is 1, the second is 2, ... * @param param the first parameter is 1, the second is 2, ...
* @return <code>true</code> if so; <code>false</code> otherwise * @return <code>true</code> if so; <code>false</code> otherwise
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @since 1.4 * @since 1.4
*/ */
boolean isSigned(int param) throws SQLException; boolean isSigned(int param) throws SQLException;
@ -106,7 +106,7 @@ public interface ParameterMetaData extends Wrapper {
* *
* @param param the first parameter is 1, the second is 2, ... * @param param the first parameter is 1, the second is 2, ...
* @return precision * @return precision
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @since 1.4 * @since 1.4
*/ */
int getPrecision(int param) throws SQLException; int getPrecision(int param) throws SQLException;
@ -117,7 +117,7 @@ public interface ParameterMetaData extends Wrapper {
* *
* @param param the first parameter is 1, the second is 2, ... * @param param the first parameter is 1, the second is 2, ...
* @return scale * @return scale
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @since 1.4 * @since 1.4
*/ */
int getScale(int param) throws SQLException; int getScale(int param) throws SQLException;
@ -127,7 +127,7 @@ public interface ParameterMetaData extends Wrapper {
* *
* @param param the first parameter is 1, the second is 2, ... * @param param the first parameter is 1, the second is 2, ...
* @return SQL type from <code>java.sql.Types</code> * @return SQL type from <code>java.sql.Types</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @since 1.4 * @since 1.4
* @see Types * @see Types
*/ */
@ -139,7 +139,7 @@ public interface ParameterMetaData extends Wrapper {
* @param param the first parameter is 1, the second is 2, ... * @param param the first parameter is 1, the second is 2, ...
* @return type the name used by the database. If the parameter type is * @return type the name used by the database. If the parameter type is
* a user-defined type, then a fully-qualified type name is returned. * a user-defined type, then a fully-qualified type name is returned.
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @since 1.4 * @since 1.4
*/ */
String getParameterTypeName(int param) throws SQLException; String getParameterTypeName(int param) throws SQLException;
@ -155,7 +155,7 @@ public interface ParameterMetaData extends Wrapper {
* <code>PreparedStatement.setObject</code> to set the value * <code>PreparedStatement.setObject</code> to set the value
* in the specified parameter. This is the class name used * in the specified parameter. This is the class name used
* for custom mapping. * for custom mapping.
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @since 1.4 * @since 1.4
*/ */
String getParameterClassName(int param) throws SQLException; String getParameterClassName(int param) throws SQLException;
@ -189,7 +189,7 @@ public interface ParameterMetaData extends Wrapper {
* <code>ParameterMetaData.parameterModeOut</code>, or * <code>ParameterMetaData.parameterModeOut</code>, or
* <code>ParameterMetaData.parameterModeInOut</code> * <code>ParameterMetaData.parameterModeInOut</code>
* <code>ParameterMetaData.parameterModeUnknown</code>. * <code>ParameterMetaData.parameterModeUnknown</code>.
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @since 1.4 * @since 1.4
*/ */
int getParameterMode(int param) throws SQLException; int getParameterMode(int param) throws SQLException;

222
src/java.sql/share/classes/java/sql/PreparedStatement.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -68,9 +68,9 @@ public interface PreparedStatement extends Statement {
* *
* @return a <code>ResultSet</code> object that contains the data produced by the * @return a <code>ResultSet</code> object that contains the data produced by the
* query; never <code>null</code> * query; never <code>null</code>
* @exception SQLException if a database access error occurs; * @throws SQLException if a database access error occurs;
* this method is called on a closed <code>PreparedStatement</code> or the SQL * this method is called on a closed {@code PreparedStatement} or the SQL
* statement does not return a <code>ResultSet</code> object * statement does not return a {@code ResultSet} object
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
* method has been exceeded and has at least attempted to cancel * method has been exceeded and has at least attempted to cancel
@ -86,9 +86,9 @@ public interface PreparedStatement extends Statement {
* *
* @return either (1) the row count for SQL Data Manipulation Language (DML) statements * @return either (1) the row count for SQL Data Manipulation Language (DML) statements
* or (2) 0 for SQL statements that return nothing * or (2) 0 for SQL statements that return nothing
* @exception SQLException if a database access error occurs; * @throws SQLException if a database access error occurs;
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* or the SQL statement returns a <code>ResultSet</code> object * or the SQL statement returns a {@code ResultSet} object
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
* method has been exceeded and has at least attempted to cancel * method has been exceeded and has at least attempted to cancel
@ -103,15 +103,15 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param sqlType the SQL type code defined in <code>java.sql.Types</code> * @param sqlType the SQL type code defined in <code>java.sql.Types</code>
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @exception SQLFeatureNotSupportedException if <code>sqlType</code> is * @throws SQLFeatureNotSupportedException if {@code sqlType} is
* a <code>ARRAY</code>, <code>BLOB</code>, <code>CLOB</code>, * a {@code ARRAY}, {@code BLOB}, {@code CLOB},
* <code>DATALINK</code>, <code>JAVA_OBJECT</code>, <code>NCHAR</code>, * {@code DATALINK}, {@code JAVA_OBJECT}, {@code NCHAR},
* <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>, * {@code NCLOB}, {@code NVARCHAR}, {@code LONGNVARCHAR},
* <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code> * {@code REF}, {@code ROWID}, {@code SQLXML}
* or <code>STRUCT</code> data type and the JDBC driver does not support * or {@code STRUCT} data type and the JDBC driver does not support
* this data type * this data type
*/ */
void setNull(int parameterIndex, int sqlType) throws SQLException; void setNull(int parameterIndex, int sqlType) throws SQLException;
@ -123,10 +123,10 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; * marker in the SQL statement;
* if a database access error occurs or * if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setBoolean(int parameterIndex, boolean x) throws SQLException; void setBoolean(int parameterIndex, boolean x) throws SQLException;
@ -137,9 +137,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setByte(int parameterIndex, byte x) throws SQLException; void setByte(int parameterIndex, byte x) throws SQLException;
@ -150,9 +150,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setShort(int parameterIndex, short x) throws SQLException; void setShort(int parameterIndex, short x) throws SQLException;
@ -163,9 +163,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setInt(int parameterIndex, int x) throws SQLException; void setInt(int parameterIndex, int x) throws SQLException;
@ -176,9 +176,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setLong(int parameterIndex, long x) throws SQLException; void setLong(int parameterIndex, long x) throws SQLException;
@ -189,9 +189,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setFloat(int parameterIndex, float x) throws SQLException; void setFloat(int parameterIndex, float x) throws SQLException;
@ -202,9 +202,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setDouble(int parameterIndex, double x) throws SQLException; void setDouble(int parameterIndex, double x) throws SQLException;
@ -215,9 +215,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException; void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException;
@ -231,9 +231,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setString(int parameterIndex, String x) throws SQLException; void setString(int parameterIndex, String x) throws SQLException;
@ -245,9 +245,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setBytes(int parameterIndex, byte x[]) throws SQLException; void setBytes(int parameterIndex, byte x[]) throws SQLException;
@ -260,9 +260,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setDate(int parameterIndex, java.sql.Date x) void setDate(int parameterIndex, java.sql.Date x)
throws SQLException; throws SQLException;
@ -274,9 +274,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setTime(int parameterIndex, java.sql.Time x) void setTime(int parameterIndex, java.sql.Time x)
throws SQLException; throws SQLException;
@ -289,9 +289,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> */ * this method is called on a closed {@code PreparedStatement} */
void setTimestamp(int parameterIndex, java.sql.Timestamp x) void setTimestamp(int parameterIndex, java.sql.Timestamp x)
throws SQLException; throws SQLException;
@ -311,9 +311,9 @@ public interface PreparedStatement extends Statement {
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the Java input stream that contains the ASCII parameter value * @param x the Java input stream that contains the ASCII parameter value
* @param length the number of bytes in the stream * @param length the number of bytes in the stream
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setAsciiStream(int parameterIndex, java.io.InputStream x, int length) void setAsciiStream(int parameterIndex, java.io.InputStream x, int length)
throws SQLException; throws SQLException;
@ -339,10 +339,10 @@ public interface PreparedStatement extends Statement {
* @param x a <code>java.io.InputStream</code> object that contains the * @param x a <code>java.io.InputStream</code> object that contains the
* Unicode parameter value * Unicode parameter value
* @param length the number of bytes in the stream * @param length the number of bytes in the stream
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @deprecated Use {@code setCharacterStream} * @deprecated Use {@code setCharacterStream}
*/ */
@ -365,9 +365,9 @@ public interface PreparedStatement extends Statement {
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the java input stream which contains the binary parameter value * @param x the java input stream which contains the binary parameter value
* @param length the number of bytes in the stream * @param length the number of bytes in the stream
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void setBinaryStream(int parameterIndex, java.io.InputStream x, void setBinaryStream(int parameterIndex, java.io.InputStream x,
int length) throws SQLException; int length) throws SQLException;
@ -380,8 +380,8 @@ public interface PreparedStatement extends Statement {
* release the resources used by the current parameter values; this can * release the resources used by the current parameter values; this can
* be done by calling the method <code>clearParameters</code>. * be done by calling the method <code>clearParameters</code>.
* *
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
*/ */
void clearParameters() throws SQLException; void clearParameters() throws SQLException;
@ -399,10 +399,10 @@ public interface PreparedStatement extends Statement {
* @param x the object containing the input parameter value * @param x the object containing the input parameter value
* @param targetSqlType the SQL type (as defined in java.sql.Types) to be * @param targetSqlType the SQL type (as defined in java.sql.Types) to be
* sent to the database * sent to the database
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or this * marker in the SQL statement; if a database access error occurs or this
* method is called on a closed PreparedStatement * method is called on a closed PreparedStatement
* @exception SQLFeatureNotSupportedException if * @throws SQLFeatureNotSupportedException if
* the JDBC driver does not support the specified targetSqlType * the JDBC driver does not support the specified targetSqlType
* @see Types * @see Types
*/ */
@ -441,9 +441,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the object containing the input parameter value * @param x the object containing the input parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs; * marker in the SQL statement; if a database access error occurs;
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* or the type of the given object is ambiguous * or the type of the given object is ambiguous
*/ */
void setObject(int parameterIndex, Object x) throws SQLException; void setObject(int parameterIndex, Object x) throws SQLException;
@ -465,8 +465,8 @@ public interface PreparedStatement extends Statement {
* @return <code>true</code> if the first result is a <code>ResultSet</code> * @return <code>true</code> if the first result is a <code>ResultSet</code>
* object; <code>false</code> if the first result is an update * object; <code>false</code> if the first result is an update
* count or there is no result * count or there is no result
* @exception SQLException if a database access error occurs; * @throws SQLException if a database access error occurs;
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* or an argument is supplied to this method * or an argument is supplied to this method
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
@ -486,8 +486,8 @@ public interface PreparedStatement extends Statement {
* Adds a set of parameters to this <code>PreparedStatement</code> * Adds a set of parameters to this <code>PreparedStatement</code>
* object's batch of commands. * object's batch of commands.
* *
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @see Statement#addBatch * @see Statement#addBatch
* @since 1.2 * @since 1.2
*/ */
@ -510,9 +510,9 @@ public interface PreparedStatement extends Statement {
* @param reader the <code>java.io.Reader</code> object that contains the * @param reader the <code>java.io.Reader</code> object that contains the
* Unicode data * Unicode data
* @param length the number of characters in the stream * @param length the number of characters in the stream
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @since 1.2 * @since 1.2
*/ */
void setCharacterStream(int parameterIndex, void setCharacterStream(int parameterIndex,
@ -527,9 +527,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x an SQL <code>REF</code> value * @param x an SQL <code>REF</code> value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.2 * @since 1.2
*/ */
@ -542,9 +542,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x a <code>Blob</code> object that maps an SQL <code>BLOB</code> value * @param x a <code>Blob</code> object that maps an SQL <code>BLOB</code> value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.2 * @since 1.2
*/ */
@ -557,9 +557,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x a <code>Clob</code> object that maps an SQL <code>CLOB</code> value * @param x a <code>Clob</code> object that maps an SQL <code>CLOB</code> value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.2 * @since 1.2
*/ */
@ -572,9 +572,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x an <code>Array</code> object that maps an SQL <code>ARRAY</code> value * @param x an <code>Array</code> object that maps an SQL <code>ARRAY</code> value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.2 * @since 1.2
*/ */
@ -600,9 +600,9 @@ public interface PreparedStatement extends Statement {
* @return the description of a <code>ResultSet</code> object's columns or * @return the description of a <code>ResultSet</code> object's columns or
* <code>null</code> if the driver cannot return a * <code>null</code> if the driver cannot return a
* <code>ResultSetMetaData</code> object * <code>ResultSetMetaData</code> object
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -622,9 +622,9 @@ public interface PreparedStatement extends Statement {
* @param x the parameter value * @param x the parameter value
* @param cal the <code>Calendar</code> object the driver will use * @param cal the <code>Calendar</code> object the driver will use
* to construct the date * to construct the date
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @since 1.2 * @since 1.2
*/ */
void setDate(int parameterIndex, java.sql.Date x, Calendar cal) void setDate(int parameterIndex, java.sql.Date x, Calendar cal)
@ -644,9 +644,9 @@ public interface PreparedStatement extends Statement {
* @param x the parameter value * @param x the parameter value
* @param cal the <code>Calendar</code> object the driver will use * @param cal the <code>Calendar</code> object the driver will use
* to construct the time * to construct the time
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @since 1.2 * @since 1.2
*/ */
void setTime(int parameterIndex, java.sql.Time x, Calendar cal) void setTime(int parameterIndex, java.sql.Time x, Calendar cal)
@ -666,9 +666,9 @@ public interface PreparedStatement extends Statement {
* @param x the parameter value * @param x the parameter value
* @param cal the <code>Calendar</code> object the driver will use * @param cal the <code>Calendar</code> object the driver will use
* to construct the timestamp * to construct the timestamp
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @since 1.2 * @since 1.2
*/ */
void setTimestamp(int parameterIndex, java.sql.Timestamp x, Calendar cal) void setTimestamp(int parameterIndex, java.sql.Timestamp x, Calendar cal)
@ -699,15 +699,15 @@ public interface PreparedStatement extends Statement {
* @param sqlType a value from <code>java.sql.Types</code> * @param sqlType a value from <code>java.sql.Types</code>
* @param typeName the fully-qualified name of an SQL user-defined type; * @param typeName the fully-qualified name of an SQL user-defined type;
* ignored if the parameter is not a user-defined type or REF * ignored if the parameter is not a user-defined type or REF
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @exception SQLFeatureNotSupportedException if <code>sqlType</code> is * @throws SQLFeatureNotSupportedException if {@code sqlType} is
* a <code>ARRAY</code>, <code>BLOB</code>, <code>CLOB</code>, * a {@code ARRAY}, {@code BLOB}, {@code CLOB},
* <code>DATALINK</code>, <code>JAVA_OBJECT</code>, <code>NCHAR</code>, * {@code DATALINK}, {@code JAVA_OBJECT}, {@code NCHAR},
* <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>, * {@code NCLOB}, {@code NVARCHAR}, {@code LONGNVARCHAR},
* <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code> * {@code REF}, {@code ROWID}, {@code SQLXML}
* or <code>STRUCT</code> data type and the JDBC driver does not support * or {@code STRUCT} data type and the JDBC driver does not support
* this data type or if the JDBC driver does not support this method * this data type or if the JDBC driver does not support this method
* @since 1.2 * @since 1.2
*/ */
@ -723,9 +723,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the <code>java.net.URL</code> object to be set * @param x the <code>java.net.URL</code> object to be set
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.4 * @since 1.4
*/ */
@ -738,8 +738,8 @@ public interface PreparedStatement extends Statement {
* @return a <code>ParameterMetaData</code> object that contains information * @return a <code>ParameterMetaData</code> object that contains information
* about the number, types and properties for each * about the number, types and properties for each
* parameter marker of this <code>PreparedStatement</code> object * parameter marker of this <code>PreparedStatement</code> object
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @see ParameterMetaData * @see ParameterMetaData
* @since 1.4 * @since 1.4
*/ */
@ -946,13 +946,13 @@ public interface PreparedStatement extends Statement {
* this is the length * this is the length
* of the data in the stream or reader. For all other types, * of the data in the stream or reader. For all other types,
* this value will be ignored. * this value will be ignored.
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs; * marker in the SQL statement; if a database access error occurs;
* this method is called on a closed <code>PreparedStatement</code> or * this method is called on a closed {@code PreparedStatement} or
* if the Java Object specified by x is an InputStream * if the Java Object specified by x is an InputStream
* or Reader object and the value of the scale parameter is less * or Reader object and the value of the scale parameter is less
* than zero * than zero
* @exception SQLFeatureNotSupportedException if * @throws SQLFeatureNotSupportedException if
* the JDBC driver does not support the specified targetSqlType * the JDBC driver does not support the specified targetSqlType
* @see Types * @see Types
* *
@ -975,9 +975,9 @@ public interface PreparedStatement extends Statement {
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the Java input stream that contains the ASCII parameter value * @param x the Java input stream that contains the ASCII parameter value
* @param length the number of bytes in the stream * @param length the number of bytes in the stream
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @since 1.6 * @since 1.6
*/ */
void setAsciiStream(int parameterIndex, java.io.InputStream x, long length) void setAsciiStream(int parameterIndex, java.io.InputStream x, long length)
@ -997,9 +997,9 @@ public interface PreparedStatement extends Statement {
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the java input stream which contains the binary parameter value * @param x the java input stream which contains the binary parameter value
* @param length the number of bytes in the stream * @param length the number of bytes in the stream
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @since 1.6 * @since 1.6
*/ */
void setBinaryStream(int parameterIndex, java.io.InputStream x, void setBinaryStream(int parameterIndex, java.io.InputStream x,
@ -1021,9 +1021,9 @@ public interface PreparedStatement extends Statement {
* @param reader the <code>java.io.Reader</code> object that contains the * @param reader the <code>java.io.Reader</code> object that contains the
* Unicode data * Unicode data
* @param length the number of characters in the stream * @param length the number of characters in the stream
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @since 1.6 * @since 1.6
*/ */
void setCharacterStream(int parameterIndex, void setCharacterStream(int parameterIndex,
@ -1047,9 +1047,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the Java input stream that contains the ASCII parameter value * @param x the Java input stream that contains the ASCII parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6 * @since 1.6
*/ */
@ -1071,9 +1071,9 @@ public interface PreparedStatement extends Statement {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the java input stream which contains the binary parameter value * @param x the java input stream which contains the binary parameter value
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6 * @since 1.6
*/ */
@ -1098,9 +1098,9 @@ public interface PreparedStatement extends Statement {
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param reader the <code>java.io.Reader</code> object that contains the * @param reader the <code>java.io.Reader</code> object that contains the
* Unicode data * Unicode data
* @exception SQLException if parameterIndex does not correspond to a parameter * @throws SQLException if parameterIndex does not correspond to a parameter
* marker in the SQL statement; if a database access error occurs or * marker in the SQL statement; if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6 * @since 1.6
*/ */
@ -1250,13 +1250,13 @@ public interface PreparedStatement extends Statement {
* this is the length * this is the length
* of the data in the stream or reader. For all other types, * of the data in the stream or reader. For all other types,
* this value will be ignored. * this value will be ignored.
* @exception SQLException if parameterIndex does not correspond to a * @throws SQLException if parameterIndex does not correspond to a
* parameter marker in the SQL statement; if a database access error occurs * parameter marker in the SQL statement; if a database access error occurs
* or this method is called on a closed {@code PreparedStatement} or * or this method is called on a closed {@code PreparedStatement} or
* if the Java Object specified by x is an InputStream * if the Java Object specified by x is an InputStream
* or Reader object and the value of the scale parameter is less * or Reader object and the value of the scale parameter is less
* than zero * than zero
* @exception SQLFeatureNotSupportedException if * @throws SQLFeatureNotSupportedException if
* the JDBC driver does not support the specified targetSqlType * the JDBC driver does not support the specified targetSqlType
* @see JDBCType * @see JDBCType
* @see SQLType * @see SQLType
@ -1279,10 +1279,10 @@ public interface PreparedStatement extends Statement {
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the object containing the input parameter value * @param x the object containing the input parameter value
* @param targetSqlType the SQL type to be sent to the database * @param targetSqlType the SQL type to be sent to the database
* @exception SQLException if parameterIndex does not correspond to a * @throws SQLException if parameterIndex does not correspond to a
* parameter marker in the SQL statement; if a database access error occurs * parameter marker in the SQL statement; if a database access error occurs
* or this method is called on a closed {@code PreparedStatement} * or this method is called on a closed {@code PreparedStatement}
* @exception SQLFeatureNotSupportedException if * @throws SQLFeatureNotSupportedException if
* the JDBC driver does not support the specified targetSqlType * the JDBC driver does not support the specified targetSqlType
* @see JDBCType * @see JDBCType
* @see SQLType * @see SQLType
@ -1307,9 +1307,9 @@ public interface PreparedStatement extends Statement {
* *
* @return either (1) the row count for SQL Data Manipulation Language * @return either (1) the row count for SQL Data Manipulation Language
* (DML) statements or (2) 0 for SQL statements that return nothing * (DML) statements or (2) 0 for SQL statements that return nothing
* @exception SQLException if a database access error occurs; * @throws SQLException if a database access error occurs;
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* or the SQL statement returns a <code>ResultSet</code> object * or the SQL statement returns a {@code ResultSet} object
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
* method has been exceeded and has at least attempted to cancel * method has been exceeded and has at least attempted to cancel

18
src/java.sql/share/classes/java/sql/Ref.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -58,8 +58,8 @@ public interface Ref {
* this <code>Ref</code> object references. * this <code>Ref</code> object references.
* *
* @return the fully-qualified SQL name of the referenced SQL structured type * @return the fully-qualified SQL name of the referenced SQL structured type
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -77,8 +77,8 @@ public interface Ref {
* @return a Java <code>Object</code> that is the custom mapping for * @return a Java <code>Object</code> that is the custom mapping for
* the SQL structured type to which this <code>Ref</code> * the SQL structured type to which this <code>Ref</code>
* object refers * object refers
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
* @see #setObject * @see #setObject
@ -96,8 +96,8 @@ public interface Ref {
* @return a Java <code>Object</code> that is the mapping for * @return a Java <code>Object</code> that is the mapping for
* the SQL structured type to which this <code>Ref</code> * the SQL structured type to which this <code>Ref</code>
* object refers * object refers
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
* @see #setObject * @see #setObject
@ -113,8 +113,8 @@ public interface Ref {
* @param value an <code>Object</code> representing the SQL * @param value an <code>Object</code> representing the SQL
* structured type instance that this * structured type instance that this
* <code>Ref</code> object will reference * <code>Ref</code> object will reference
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
* @see #getObject() * @see #getObject()

800
src/java.sql/share/classes/java/sql/ResultSet.java
View file

File diff suppressed because it is too large Load diff

44
src/java.sql/share/classes/java/sql/ResultSetMetaData.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2005, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -50,7 +50,7 @@ public interface ResultSetMetaData extends Wrapper {
* Returns the number of columns in this <code>ResultSet</code> object. * Returns the number of columns in this <code>ResultSet</code> object.
* *
* @return the number of columns * @return the number of columns
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
int getColumnCount() throws SQLException; int getColumnCount() throws SQLException;
@ -59,7 +59,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return <code>true</code> if so; <code>false</code> otherwise * @return <code>true</code> if so; <code>false</code> otherwise
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
boolean isAutoIncrement(int column) throws SQLException; boolean isAutoIncrement(int column) throws SQLException;
@ -68,7 +68,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return <code>true</code> if so; <code>false</code> otherwise * @return <code>true</code> if so; <code>false</code> otherwise
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
boolean isCaseSensitive(int column) throws SQLException; boolean isCaseSensitive(int column) throws SQLException;
@ -77,7 +77,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return <code>true</code> if so; <code>false</code> otherwise * @return <code>true</code> if so; <code>false</code> otherwise
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
boolean isSearchable(int column) throws SQLException; boolean isSearchable(int column) throws SQLException;
@ -86,7 +86,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return <code>true</code> if so; <code>false</code> otherwise * @return <code>true</code> if so; <code>false</code> otherwise
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
boolean isCurrency(int column) throws SQLException; boolean isCurrency(int column) throws SQLException;
@ -96,7 +96,7 @@ public interface ResultSetMetaData extends Wrapper {
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return the nullability status of the given column; one of <code>columnNoNulls</code>, * @return the nullability status of the given column; one of <code>columnNoNulls</code>,
* <code>columnNullable</code> or <code>columnNullableUnknown</code> * <code>columnNullable</code> or <code>columnNullableUnknown</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
int isNullable(int column) throws SQLException; int isNullable(int column) throws SQLException;
@ -123,7 +123,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return <code>true</code> if so; <code>false</code> otherwise * @return <code>true</code> if so; <code>false</code> otherwise
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
boolean isSigned(int column) throws SQLException; boolean isSigned(int column) throws SQLException;
@ -133,7 +133,7 @@ public interface ResultSetMetaData extends Wrapper {
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return the normal maximum number of characters allowed as the width * @return the normal maximum number of characters allowed as the width
* of the designated column * of the designated column
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
int getColumnDisplaySize(int column) throws SQLException; int getColumnDisplaySize(int column) throws SQLException;
@ -146,7 +146,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return the suggested column title * @return the suggested column title
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
String getColumnLabel(int column) throws SQLException; String getColumnLabel(int column) throws SQLException;
@ -155,7 +155,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return column name * @return column name
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
String getColumnName(int column) throws SQLException; String getColumnName(int column) throws SQLException;
@ -164,7 +164,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return schema name or "" if not applicable * @return schema name or "" if not applicable
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
String getSchemaName(int column) throws SQLException; String getSchemaName(int column) throws SQLException;
@ -178,7 +178,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return precision * @return precision
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
int getPrecision(int column) throws SQLException; int getPrecision(int column) throws SQLException;
@ -188,7 +188,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return scale * @return scale
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
int getScale(int column) throws SQLException; int getScale(int column) throws SQLException;
@ -197,7 +197,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return table name or "" if not applicable * @return table name or "" if not applicable
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
String getTableName(int column) throws SQLException; String getTableName(int column) throws SQLException;
@ -207,7 +207,7 @@ public interface ResultSetMetaData extends Wrapper {
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return the name of the catalog for the table in which the given column * @return the name of the catalog for the table in which the given column
* appears or "" if not applicable * appears or "" if not applicable
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
String getCatalogName(int column) throws SQLException; String getCatalogName(int column) throws SQLException;
@ -216,7 +216,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return SQL type from java.sql.Types * @return SQL type from java.sql.Types
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see Types * @see Types
*/ */
int getColumnType(int column) throws SQLException; int getColumnType(int column) throws SQLException;
@ -227,7 +227,7 @@ public interface ResultSetMetaData extends Wrapper {
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return type name used by the database. If the column type is * @return type name used by the database. If the column type is
* a user-defined type, then a fully-qualified type name is returned. * a user-defined type, then a fully-qualified type name is returned.
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
String getColumnTypeName(int column) throws SQLException; String getColumnTypeName(int column) throws SQLException;
@ -236,7 +236,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return <code>true</code> if so; <code>false</code> otherwise * @return <code>true</code> if so; <code>false</code> otherwise
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
boolean isReadOnly(int column) throws SQLException; boolean isReadOnly(int column) throws SQLException;
@ -245,7 +245,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return <code>true</code> if so; <code>false</code> otherwise * @return <code>true</code> if so; <code>false</code> otherwise
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
boolean isWritable(int column) throws SQLException; boolean isWritable(int column) throws SQLException;
@ -254,7 +254,7 @@ public interface ResultSetMetaData extends Wrapper {
* *
* @param column the first column is 1, the second is 2, ... * @param column the first column is 1, the second is 2, ...
* @return <code>true</code> if so; <code>false</code> otherwise * @return <code>true</code> if so; <code>false</code> otherwise
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
boolean isDefinitelyWritable(int column) throws SQLException; boolean isDefinitelyWritable(int column) throws SQLException;
@ -272,7 +272,7 @@ public interface ResultSetMetaData extends Wrapper {
* language that would be used by the method * language that would be used by the method
* <code>ResultSet.getObject</code> to retrieve the value in the specified * <code>ResultSet.getObject</code> to retrieve the value in the specified
* column. This is the class name used for custom mapping. * column. This is the class name used for custom mapping.
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @since 1.2 * @since 1.2
*/ */
String getColumnClassName(int column) throws SQLException; String getColumnClassName(int column) throws SQLException;

14
src/java.sql/share/classes/java/sql/SQLData.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2006, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -72,8 +72,8 @@ public interface SQLData {
* *
* @return the type name that was passed to the method <code>readSQL</code> * @return the type name that was passed to the method <code>readSQL</code>
* when this object was constructed and populated * when this object was constructed and populated
* @exception SQLException if there is a database access error * @throws SQLException if there is a database access error
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -104,8 +104,8 @@ public interface SQLData {
* @param stream the <code>SQLInput</code> object from which to read the data for * @param stream the <code>SQLInput</code> object from which to read the data for
* the value that is being custom mapped * the value that is being custom mapped
* @param typeName the SQL type name of the value on the data stream * @param typeName the SQL type name of the value on the data stream
* @exception SQLException if there is a database access error * @throws SQLException if there is a database access error
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see SQLInput * @see SQLInput
* @since 1.2 * @since 1.2
@ -127,8 +127,8 @@ public interface SQLData {
* *
* @param stream the <code>SQLOutput</code> object to which to write the data for * @param stream the <code>SQLOutput</code> object to which to write the data for
* the value that was custom mapped * the value that was custom mapped
* @exception SQLException if there is a database access error * @throws SQLException if there is a database access error
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see SQLOutput * @see SQLOutput
* @since 1.2 * @since 1.2

114
src/java.sql/share/classes/java/sql/SQLInput.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -67,8 +67,8 @@ public interface SQLInput {
* in the Java programming language. * in the Java programming language.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -79,8 +79,8 @@ public interface SQLInput {
* in the Java programming language. * in the Java programming language.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>false</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>false</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -91,8 +91,8 @@ public interface SQLInput {
* in the Java programming language. * in the Java programming language.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -103,8 +103,8 @@ public interface SQLInput {
* in the Java programming language. * in the Java programming language.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -115,8 +115,8 @@ public interface SQLInput {
* in the Java programming language. * in the Java programming language.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -127,8 +127,8 @@ public interface SQLInput {
* in the Java programming language. * in the Java programming language.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -139,8 +139,8 @@ public interface SQLInput {
* in the Java programming language. * in the Java programming language.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -151,8 +151,8 @@ public interface SQLInput {
* in the Java programming language. * in the Java programming language.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -163,8 +163,8 @@ public interface SQLInput {
* object in the Java programming language. * object in the Java programming language.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -175,8 +175,8 @@ public interface SQLInput {
* in the Java programming language. * in the Java programming language.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -186,8 +186,8 @@ public interface SQLInput {
* Reads the next attribute in the stream and returns it as a <code>java.sql.Date</code> object. * Reads the next attribute in the stream and returns it as a <code>java.sql.Date</code> object.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -197,8 +197,8 @@ public interface SQLInput {
* Reads the next attribute in the stream and returns it as a <code>java.sql.Time</code> object. * Reads the next attribute in the stream and returns it as a <code>java.sql.Time</code> object.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -208,8 +208,8 @@ public interface SQLInput {
* Reads the next attribute in the stream and returns it as a <code>java.sql.Timestamp</code> object. * Reads the next attribute in the stream and returns it as a <code>java.sql.Timestamp</code> object.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -219,8 +219,8 @@ public interface SQLInput {
* Reads the next attribute in the stream and returns it as a stream of Unicode characters. * Reads the next attribute in the stream and returns it as a stream of Unicode characters.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -230,8 +230,8 @@ public interface SQLInput {
* Reads the next attribute in the stream and returns it as a stream of ASCII characters. * Reads the next attribute in the stream and returns it as a stream of ASCII characters.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -242,8 +242,8 @@ public interface SQLInput {
* bytes. * bytes.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -272,8 +272,8 @@ public interface SQLInput {
* *
* @return the datum at the head of the stream as an <code>Object</code> in the * @return the datum at the head of the stream as an <code>Object</code> in the
* Java programming language;<code>null</code> if the datum is SQL <code>NULL</code> * Java programming language;<code>null</code> if the datum is SQL <code>NULL</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -286,8 +286,8 @@ public interface SQLInput {
* @return a <code>Ref</code> object representing the SQL <code>REF</code> value * @return a <code>Ref</code> object representing the SQL <code>REF</code> value
* at the head of the stream; <code>null</code> if the value read is * at the head of the stream; <code>null</code> if the value read is
* SQL <code>NULL</code> * SQL <code>NULL</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -300,8 +300,8 @@ public interface SQLInput {
* @return a <code>Blob</code> object representing data of the SQL <code>BLOB</code> value * @return a <code>Blob</code> object representing data of the SQL <code>BLOB</code> value
* at the head of the stream; <code>null</code> if the value read is * at the head of the stream; <code>null</code> if the value read is
* SQL <code>NULL</code> * SQL <code>NULL</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -314,8 +314,8 @@ public interface SQLInput {
* @return a <code>Clob</code> object representing data of the SQL <code>CLOB</code> value * @return a <code>Clob</code> object representing data of the SQL <code>CLOB</code> value
* at the head of the stream; <code>null</code> if the value read is * at the head of the stream; <code>null</code> if the value read is
* SQL <code>NULL</code> * SQL <code>NULL</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -328,8 +328,8 @@ public interface SQLInput {
* @return an <code>Array</code> object representing data of the SQL * @return an <code>Array</code> object representing data of the SQL
* <code>ARRAY</code> value at the head of the stream; <code>null</code> * <code>ARRAY</code> value at the head of the stream; <code>null</code>
* if the value read is SQL <code>NULL</code> * if the value read is SQL <code>NULL</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -340,9 +340,9 @@ public interface SQLInput {
* *
* @return <code>true</code> if the most recently read SQL value was SQL * @return <code>true</code> if the most recently read SQL value was SQL
* <code>NULL</code>; <code>false</code> otherwise * <code>NULL</code>; <code>false</code> otherwise
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* *
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -355,9 +355,9 @@ public interface SQLInput {
* <code>java.net.URL</code> object in the Java programming language. * <code>java.net.URL</code> object in the Java programming language.
* *
* @return a <code>java.net.URL</code> object. * @return a <code>java.net.URL</code> object.
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* or if a URL is malformed * or if a URL is malformed
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */
@ -372,8 +372,8 @@ public interface SQLInput {
* @return a <code>NClob</code> object representing data of the SQL <code>NCLOB</code> value * @return a <code>NClob</code> object representing data of the SQL <code>NCLOB</code> value
* at the head of the stream; <code>null</code> if the value read is * at the head of the stream; <code>null</code> if the value read is
* SQL <code>NULL</code> * SQL <code>NULL</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -386,8 +386,8 @@ public interface SQLInput {
* and <code>LONGNVARCHAR</code> columns. * and <code>LONGNVARCHAR</code> columns.
* *
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code> * @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -400,8 +400,8 @@ public interface SQLInput {
* @return a <code>SQLXML</code> object representing data of the SQL <code>XML</code> value * @return a <code>SQLXML</code> object representing data of the SQL <code>XML</code> value
* at the head of the stream; <code>null</code> if the value read is * at the head of the stream; <code>null</code> if the value read is
* SQL <code>NULL</code> * SQL <code>NULL</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -414,8 +414,8 @@ public interface SQLInput {
* @return a <code>RowId</code> object representing data of the SQL <code>ROWID</code> value * @return a <code>RowId</code> object representing data of the SQL <code>ROWID</code> value
* at the head of the stream; <code>null</code> if the value read is * at the head of the stream; <code>null</code> if the value read is
* SQL <code>NULL</code> * SQL <code>NULL</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -448,8 +448,8 @@ public interface SQLInput {
* @param type Class representing the Java data type to convert the attribute to. * @param type Class representing the Java data type to convert the attribute to.
* @return the attribute at the head of the stream as an {@code Object} in the * @return the attribute at the head of the stream as an {@code Object} in the
* Java programming language;{@code null} if the attribute is SQL {@code NULL} * Java programming language;{@code null} if the attribute is SQL {@code NULL}
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.8 * @since 1.8
*/ */

112
src/java.sql/share/classes/java/sql/SQLOutput.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -59,8 +59,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -72,8 +72,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -85,8 +85,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -98,8 +98,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -111,8 +111,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -124,8 +124,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -137,8 +137,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -150,8 +150,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -163,8 +163,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -176,8 +176,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -189,8 +189,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -202,8 +202,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -215,8 +215,8 @@ package java.sql;
* in the Java programming language. * in the Java programming language.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -226,8 +226,8 @@ package java.sql;
* Writes the next attribute to the stream as a stream of Unicode characters. * Writes the next attribute to the stream as a stream of Unicode characters.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -237,8 +237,8 @@ package java.sql;
* Writes the next attribute to the stream as a stream of ASCII characters. * Writes the next attribute to the stream as a stream of ASCII characters.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -249,8 +249,8 @@ package java.sql;
* bytes. * bytes.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -282,8 +282,8 @@ package java.sql;
* *
* @param x the object representing data of an SQL structured or * @param x the object representing data of an SQL structured or
* distinct type * distinct type
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -294,8 +294,8 @@ package java.sql;
* *
* @param x a <code>Ref</code> object representing data of an SQL * @param x a <code>Ref</code> object representing data of an SQL
* <code>REF</code> value * <code>REF</code> value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -307,8 +307,8 @@ package java.sql;
* @param x a <code>Blob</code> object representing data of an SQL * @param x a <code>Blob</code> object representing data of an SQL
* <code>BLOB</code> value * <code>BLOB</code> value
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -320,8 +320,8 @@ package java.sql;
* @param x a <code>Clob</code> object representing data of an SQL * @param x a <code>Clob</code> object representing data of an SQL
* <code>CLOB</code> value * <code>CLOB</code> value
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -333,8 +333,8 @@ package java.sql;
* @param x a <code>Struct</code> object representing data of an SQL * @param x a <code>Struct</code> object representing data of an SQL
* structured type * structured type
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -346,8 +346,8 @@ package java.sql;
* @param x an <code>Array</code> object representing data of an SQL * @param x an <code>Array</code> object representing data of an SQL
* <code>ARRAY</code> type * <code>ARRAY</code> type
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -361,8 +361,8 @@ package java.sql;
* @param x a <code>java.net.URL</code> object representing the data * @param x a <code>java.net.URL</code> object representing the data
* of SQL DATALINK type * of SQL DATALINK type
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */
@ -380,8 +380,8 @@ package java.sql;
* when it sends it to the stream. * when it sends it to the stream.
* *
* @param x the value to pass to the database * @param x the value to pass to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -393,8 +393,8 @@ package java.sql;
* @param x a <code>NClob</code> object representing data of an SQL * @param x a <code>NClob</code> object representing data of an SQL
* <code>NCLOB</code> value * <code>NCLOB</code> value
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -407,8 +407,8 @@ package java.sql;
* @param x a <code>RowId</code> object representing data of an SQL * @param x a <code>RowId</code> object representing data of an SQL
* <code>ROWID</code> value * <code>ROWID</code> value
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -427,7 +427,7 @@ package java.sql;
* if there is an error processing the XML value. The <code>getCause</code> method * if there is an error processing the XML value. The <code>getCause</code> method
* of the exception may provide a more detailed exception, for example, if the * of the exception may provide a more detailed exception, for example, if the
* stream does not contain valid XML. * stream does not contain valid XML.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -457,11 +457,11 @@ package java.sql;
* *
* @param x the object containing the input parameter value * @param x the object containing the input parameter value
* @param targetSqlType the SQL type to be sent to the database. * @param targetSqlType the SQL type to be sent to the database.
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* if the Java Object specified by x is an InputStream * if the Java Object specified by x is an InputStream
* or Reader object and the value of the scale parameter is less * or Reader object and the value of the scale parameter is less
* than zero * than zero
* @exception SQLFeatureNotSupportedException if * @throws SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type * the JDBC driver does not support this data type
* @see JDBCType * @see JDBCType
* @see SQLType * @see SQLType

20
src/java.sql/share/classes/java/sql/SQLXML.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2005, 2014, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2005, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -200,7 +200,7 @@ public interface SQLXML
* being thrown. If <code>free</code> is called multiple times, the subsequent * being thrown. If <code>free</code> is called multiple times, the subsequent
* calls to <code>free</code> are treated as a no-op. * calls to <code>free</code> are treated as a no-op.
* @throws SQLException if there is an error freeing the XML value. * @throws SQLException if there is an error freeing the XML value.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -218,7 +218,7 @@ public interface SQLXML
* @return a stream containing the XML data. * @return a stream containing the XML data.
* @throws SQLException if there is an error processing the XML value. * @throws SQLException if there is an error processing the XML value.
* An exception is thrown if the state is not readable. * An exception is thrown if the state is not readable.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -237,7 +237,7 @@ public interface SQLXML
* @return a stream to which data can be written. * @return a stream to which data can be written.
* @throws SQLException if there is an error processing the XML value. * @throws SQLException if there is an error processing the XML value.
* An exception is thrown if the state is not writable. * An exception is thrown if the state is not writable.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -261,7 +261,7 @@ public interface SQLXML
* The getCause() method of the exception may provide a more detailed exception, for example, * The getCause() method of the exception may provide a more detailed exception, for example,
* if the stream does not contain valid characters. * if the stream does not contain valid characters.
* An exception is thrown if the state is not readable. * An exception is thrown if the state is not readable.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -285,7 +285,7 @@ public interface SQLXML
* The getCause() method of the exception may provide a more detailed exception, for example, * The getCause() method of the exception may provide a more detailed exception, for example,
* if the stream does not contain valid characters. * if the stream does not contain valid characters.
* An exception is thrown if the state is not writable. * An exception is thrown if the state is not writable.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -309,7 +309,7 @@ public interface SQLXML
* The getCause() method of the exception may provide a more detailed exception, for example, * The getCause() method of the exception may provide a more detailed exception, for example,
* if the stream does not contain valid characters. * if the stream does not contain valid characters.
* An exception is thrown if the state is not readable. * An exception is thrown if the state is not readable.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -333,7 +333,7 @@ public interface SQLXML
* The getCause() method of the exception may provide a more detailed exception, for example, * The getCause() method of the exception may provide a more detailed exception, for example,
* if the stream does not contain valid characters. * if the stream does not contain valid characters.
* An exception is thrown if the state is not writable. * An exception is thrown if the state is not writable.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -376,7 +376,7 @@ public interface SQLXML
* The getCause() method of the exception may provide a more detailed exception, for example, * The getCause() method of the exception may provide a more detailed exception, for example,
* if an XML parser exception occurs. * if an XML parser exception occurs.
* An exception is thrown if the state is not readable. * An exception is thrown if the state is not readable.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -418,7 +418,7 @@ public interface SQLXML
* The getCause() method of the exception may provide a more detailed exception, for example, * The getCause() method of the exception may provide a more detailed exception, for example,
* if an XML parser exception occurs. * if an XML parser exception occurs.
* An exception is thrown if the state is not writable. * An exception is thrown if the state is not writable.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */

6
src/java.sql/share/classes/java/sql/Savepoint.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -44,7 +44,7 @@ public interface Savepoint {
* Retrieves the generated ID for the savepoint that this * Retrieves the generated ID for the savepoint that this
* <code>Savepoint</code> object represents. * <code>Savepoint</code> object represents.
* @return the numeric ID of this savepoint * @return the numeric ID of this savepoint
* @exception SQLException if this is a named savepoint * @throws SQLException if this is a named savepoint
* @since 1.4 * @since 1.4
*/ */
int getSavepointId() throws SQLException; int getSavepointId() throws SQLException;
@ -53,7 +53,7 @@ public interface Savepoint {
* Retrieves the name of the savepoint that this <code>Savepoint</code> * Retrieves the name of the savepoint that this <code>Savepoint</code>
* object represents. * object represents.
* @return the name of this savepoint * @return the name of this savepoint
* @exception SQLException if this is an un-named savepoint * @throws SQLException if this is an un-named savepoint
* @since 1.4 * @since 1.4
*/ */
String getSavepointName() throws SQLException; String getSavepointName() throws SQLException;

274
src/java.sql/share/classes/java/sql/Statement.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -56,11 +56,11 @@ public interface Statement extends Wrapper, AutoCloseable {
* static SQL <code>SELECT</code> statement * static SQL <code>SELECT</code> statement
* @return a <code>ResultSet</code> object that contains the data produced * @return a <code>ResultSet</code> object that contains the data produced
* by the given query; never <code>null</code> * by the given query; never <code>null</code>
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the given * this method is called on a closed {@code Statement}, the given
* SQL statement produces anything other than a single * SQL statement produces anything other than a single
* <code>ResultSet</code> object, the method is called on a * {@code ResultSet} object, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
* method has been exceeded and has at least attempted to cancel * method has been exceeded and has at least attempted to cancel
@ -82,10 +82,10 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return either (1) the row count for SQL Data Manipulation Language (DML) statements * @return either (1) the row count for SQL Data Manipulation Language (DML) statements
* or (2) 0 for SQL statements that return nothing * or (2) 0 for SQL statements that return nothing
* *
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the given * this method is called on a closed {@code Statement}, the given
* SQL statement produces a <code>ResultSet</code> object, the method is called on a * SQL statement produces a {@code ResultSet} object, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
* method has been exceeded and has at least attempted to cancel * method has been exceeded and has at least attempted to cancel
@ -108,7 +108,7 @@ public interface Statement extends Wrapper, AutoCloseable {
* closed, its current <code>ResultSet</code> object, if one exists, is * closed, its current <code>ResultSet</code> object, if one exists, is
* also closed. * also closed.
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void close() throws SQLException; void close() throws SQLException;
@ -126,8 +126,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @return the current column size limit for columns storing character and * @return the current column size limit for columns storing character and
* binary values; zero means there is no limit * binary values; zero means there is no limit
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @see #setMaxFieldSize * @see #setMaxFieldSize
*/ */
int getMaxFieldSize() throws SQLException; int getMaxFieldSize() throws SQLException;
@ -146,8 +146,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* greater than 256. * greater than 256.
* *
* @param max the new column size limit in bytes; zero means there is no limit * @param max the new column size limit in bytes; zero means there is no limit
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* or the condition {@code max >= 0} is not satisfied * or the condition {@code max >= 0} is not satisfied
* @see #getMaxFieldSize * @see #getMaxFieldSize
*/ */
@ -162,8 +162,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return the current maximum number of rows for a <code>ResultSet</code> * @return the current maximum number of rows for a <code>ResultSet</code>
* object produced by this <code>Statement</code> object; * object produced by this <code>Statement</code> object;
* zero means there is no limit * zero means there is no limit
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @see #setMaxRows * @see #setMaxRows
*/ */
int getMaxRows() throws SQLException; int getMaxRows() throws SQLException;
@ -176,8 +176,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* rows are silently dropped. * rows are silently dropped.
* *
* @param max the new max rows limit; zero means there is no limit * @param max the new max rows limit; zero means there is no limit
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* or the condition {@code max >= 0} is not satisfied * or the condition {@code max >= 0} is not satisfied
* @see #getMaxRows * @see #getMaxRows
*/ */
@ -202,8 +202,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @param enable <code>true</code> to enable escape processing; * @param enable <code>true</code> to enable escape processing;
* <code>false</code> to disable it * <code>false</code> to disable it
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
*/ */
void setEscapeProcessing(boolean enable) throws SQLException; void setEscapeProcessing(boolean enable) throws SQLException;
@ -215,8 +215,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @return the current query timeout limit in seconds; zero means there is * @return the current query timeout limit in seconds; zero means there is
* no limit * no limit
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @see #setQueryTimeout * @see #setQueryTimeout
*/ */
int getQueryTimeout() throws SQLException; int getQueryTimeout() throws SQLException;
@ -242,8 +242,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @param seconds the new query timeout limit in seconds; zero means * @param seconds the new query timeout limit in seconds; zero means
* there is no limit * there is no limit
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* or the condition {@code seconds >= 0} is not satisfied * or the condition {@code seconds >= 0} is not satisfied
* @see #getQueryTimeout * @see #getQueryTimeout
*/ */
@ -255,9 +255,9 @@ public interface Statement extends Wrapper, AutoCloseable {
* This method can be used by one thread to cancel a statement that * This method can be used by one thread to cancel a statement that
* is being executed by another thread. * is being executed by another thread.
* *
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
*/ */
void cancel() throws SQLException; void cancel() throws SQLException;
@ -279,8 +279,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @return the first <code>SQLWarning</code> object or <code>null</code> * @return the first <code>SQLWarning</code> object or <code>null</code>
* if there are no warnings * if there are no warnings
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
*/ */
SQLWarning getWarnings() throws SQLException; SQLWarning getWarnings() throws SQLException;
@ -291,8 +291,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* <code>null</code> until a new warning is reported for this * <code>null</code> until a new warning is reported for this
* <code>Statement</code> object. * <code>Statement</code> object.
* *
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
*/ */
void clearWarnings() throws SQLException; void clearWarnings() throws SQLException;
@ -315,8 +315,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @param name the new cursor name, which must be unique within * @param name the new cursor name, which must be unique within
* a connection * a connection
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
*/ */
void setCursorName(String name) throws SQLException; void setCursorName(String name) throws SQLException;
@ -343,10 +343,10 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return <code>true</code> if the first result is a <code>ResultSet</code> * @return <code>true</code> if the first result is a <code>ResultSet</code>
* object; <code>false</code> if it is an update count or there are * object; <code>false</code> if it is an update count or there are
* no results * no results
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, * this method is called on a closed {@code Statement},
* the method is called on a * the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
* method has been exceeded and has at least attempted to cancel * method has been exceeded and has at least attempted to cancel
@ -363,8 +363,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @return the current result as a <code>ResultSet</code> object or * @return the current result as a <code>ResultSet</code> object or
* <code>null</code> if the result is an update count or there are no more results * <code>null</code> if the result is an update count or there are no more results
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @see #execute * @see #execute
*/ */
ResultSet getResultSet() throws SQLException; ResultSet getResultSet() throws SQLException;
@ -376,8 +376,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @return the current result as an update count; -1 if the current result is a * @return the current result as an update count; -1 if the current result is a
* <code>ResultSet</code> object or there are no more results * <code>ResultSet</code> object or there are no more results
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @see #execute * @see #execute
*/ */
int getUpdateCount() throws SQLException; int getUpdateCount() throws SQLException;
@ -397,8 +397,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return <code>true</code> if the next result is a <code>ResultSet</code> * @return <code>true</code> if the next result is a <code>ResultSet</code>
* object; <code>false</code> if it is an update count or there are * object; <code>false</code> if it is an update count or there are
* no more results * no more results
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @see #execute * @see #execute
*/ */
boolean getMoreResults() throws SQLException; boolean getMoreResults() throws SQLException;
@ -419,11 +419,11 @@ public interface Statement extends Wrapper, AutoCloseable {
* its own fetch direction. * its own fetch direction.
* *
* @param direction the initial direction for processing rows * @param direction the initial direction for processing rows
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* or the given direction * or the given direction
* is not one of <code>ResultSet.FETCH_FORWARD</code>, * is not one of {@code ResultSet.FETCH_FORWARD},
* <code>ResultSet.FETCH_REVERSE</code>, or <code>ResultSet.FETCH_UNKNOWN</code> * {@code ResultSet.FETCH_REVERSE}, or {@code ResultSet.FETCH_UNKNOWN}
* @since 1.2 * @since 1.2
* @see #getFetchDirection * @see #getFetchDirection
*/ */
@ -439,8 +439,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @return the default fetch direction for result sets generated * @return the default fetch direction for result sets generated
* from this <code>Statement</code> object * from this <code>Statement</code> object
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @since 1.2 * @since 1.2
* @see #setFetchDirection * @see #setFetchDirection
*/ */
@ -454,8 +454,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* The default value is zero. * The default value is zero.
* *
* @param rows the number of rows to fetch * @param rows the number of rows to fetch
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> or the * this method is called on a closed {@code Statement} or the
* condition {@code rows >= 0} is not satisfied. * condition {@code rows >= 0} is not satisfied.
* @since 1.2 * @since 1.2
* @see #getFetchSize * @see #getFetchSize
@ -472,8 +472,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @return the default fetch size for result sets generated * @return the default fetch size for result sets generated
* from this <code>Statement</code> object * from this <code>Statement</code> object
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @since 1.2 * @since 1.2
* @see #setFetchSize * @see #setFetchSize
*/ */
@ -485,8 +485,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @return either <code>ResultSet.CONCUR_READ_ONLY</code> or * @return either <code>ResultSet.CONCUR_READ_ONLY</code> or
* <code>ResultSet.CONCUR_UPDATABLE</code> * <code>ResultSet.CONCUR_UPDATABLE</code>
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @since 1.2 * @since 1.2
*/ */
int getResultSetConcurrency() throws SQLException; int getResultSetConcurrency() throws SQLException;
@ -498,8 +498,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return one of <code>ResultSet.TYPE_FORWARD_ONLY</code>, * @return one of <code>ResultSet.TYPE_FORWARD_ONLY</code>,
* <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or * <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or
* <code>ResultSet.TYPE_SCROLL_SENSITIVE</code> * <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @since 1.2 * @since 1.2
*/ */
int getResultSetType() throws SQLException; int getResultSetType() throws SQLException;
@ -513,10 +513,10 @@ public interface Statement extends Wrapper, AutoCloseable {
* <code>PreparedStatement</code> or <code>CallableStatement</code>. * <code>PreparedStatement</code> or <code>CallableStatement</code>.
* @param sql typically this is a SQL <code>INSERT</code> or * @param sql typically this is a SQL <code>INSERT</code> or
* <code>UPDATE</code> statement * <code>UPDATE</code> statement
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the * this method is called on a closed {@code Statement}, the
* driver does not support batch updates, the method is called on a * driver does not support batch updates, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @see #executeBatch * @see #executeBatch
* @see DatabaseMetaData#supportsBatchUpdates * @see DatabaseMetaData#supportsBatchUpdates
* @since 1.2 * @since 1.2
@ -527,8 +527,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* Empties this <code>Statement</code> object's current list of * Empties this <code>Statement</code> object's current list of
* SQL commands. * SQL commands.
* *
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> or the * this method is called on a closed {@code Statement} or the
* driver does not support batch updates * driver does not support batch updates
* @see #addBatch * @see #addBatch
* @see DatabaseMetaData#supportsBatchUpdates * @see DatabaseMetaData#supportsBatchUpdates
@ -577,10 +577,10 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return an array of update counts containing one element for each * @return an array of update counts containing one element for each
* command in the batch. The elements of the array are ordered according * command in the batch. The elements of the array are ordered according
* to the order in which commands were added to the batch. * to the order in which commands were added to the batch.
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> or the * this method is called on a closed {@code Statement} or the
* driver does not support batch statements. Throws {@link BatchUpdateException} * driver does not support batch statements. Throws {@link BatchUpdateException}
* (a subclass of <code>SQLException</code>) if one of the commands sent to the * (a subclass of {@code SQLException}) if one of the commands sent to the
* database fails to execute properly or attempts to return a result set. * database fails to execute properly or attempts to return a result set.
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
@ -597,8 +597,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* Retrieves the <code>Connection</code> object * Retrieves the <code>Connection</code> object
* that produced this <code>Statement</code> object. * that produced this <code>Statement</code> object.
* @return the connection that produced this statement * @return the connection that produced this statement
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @since 1.2 * @since 1.2
*/ */
Connection getConnection() throws SQLException; Connection getConnection() throws SQLException;
@ -684,17 +684,17 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return <code>true</code> if the next result is a <code>ResultSet</code> * @return <code>true</code> if the next result is a <code>ResultSet</code>
* object; <code>false</code> if it is an update count or there are no * object; <code>false</code> if it is an update count or there are no
* more results * more results
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> or the argument * this method is called on a closed {@code Statement} or the argument
* supplied is not one of the following: * supplied is not one of the following:
* <code>Statement.CLOSE_CURRENT_RESULT</code>, * {@code Statement.CLOSE_CURRENT_RESULT},
* <code>Statement.KEEP_CURRENT_RESULT</code> or * {@code Statement.KEEP_CURRENT_RESULT} or
* <code>Statement.CLOSE_ALL_RESULTS</code> * {@code Statement.CLOSE_ALL_RESULTS}
*@exception SQLFeatureNotSupportedException if *@throws SQLFeatureNotSupportedException if
* <code>DatabaseMetaData.supportsMultipleOpenResults</code> returns * {@code DatabaseMetaData.supportsMultipleOpenResults} returns
* <code>false</code> and either * {@code false} and either
* <code>Statement.KEEP_CURRENT_RESULT</code> or * {@code Statement.KEEP_CURRENT_RESULT} or
* <code>Statement.CLOSE_ALL_RESULTS</code> are supplied as * {@code Statement.CLOSE_ALL_RESULTS} are supplied as
* the argument. * the argument.
* @since 1.4 * @since 1.4
* @see #execute * @see #execute
@ -712,8 +712,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @return a <code>ResultSet</code> object containing the auto-generated key(s) * @return a <code>ResultSet</code> object containing the auto-generated key(s)
* generated by the execution of this <code>Statement</code> object * generated by the execution of this <code>Statement</code> object
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.4 * @since 1.4
*/ */
@ -742,12 +742,12 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return either (1) the row count for SQL Data Manipulation Language (DML) statements * @return either (1) the row count for SQL Data Manipulation Language (DML) statements
* or (2) 0 for SQL statements that return nothing * or (2) 0 for SQL statements that return nothing
* *
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the given * this method is called on a closed {@code Statement}, the given
* SQL statement returns a <code>ResultSet</code> object, * SQL statement returns a {@code ResultSet} object,
* the given constant is not one of those allowed, the method is called on a * the given constant is not one of those allowed, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method with a constant of Statement.RETURN_GENERATED_KEYS * this method with a constant of Statement.RETURN_GENERATED_KEYS
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
@ -777,12 +777,12 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return either (1) the row count for SQL Data Manipulation Language (DML) statements * @return either (1) the row count for SQL Data Manipulation Language (DML) statements
* or (2) 0 for SQL statements that return nothing * or (2) 0 for SQL statements that return nothing
* *
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the SQL * this method is called on a closed {@code Statement}, the SQL
* statement returns a <code>ResultSet</code> object,the second argument * statement returns a {@code ResultSet} object,the second argument
* supplied to this method is not an * supplied to this method is not an
* <code>int</code> array whose elements are valid column indexes, the method is called on a * {@code int} array whose elements are valid column indexes, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
@ -811,12 +811,12 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return either the row count for <code>INSERT</code>, <code>UPDATE</code>, * @return either the row count for <code>INSERT</code>, <code>UPDATE</code>,
* or <code>DELETE</code> statements, or 0 for SQL statements * or <code>DELETE</code> statements, or 0 for SQL statements
* that return nothing * that return nothing
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the SQL * this method is called on a closed {@code Statement}, the SQL
* statement returns a <code>ResultSet</code> object, the * statement returns a {@code ResultSet} object, the
* second argument supplied to this method is not a <code>String</code> array * second argument supplied to this method is not a {@code String} array
* whose elements are valid column names, the method is called on a * whose elements are valid column names, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
@ -857,14 +857,14 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return <code>true</code> if the first result is a <code>ResultSet</code> * @return <code>true</code> if the first result is a <code>ResultSet</code>
* object; <code>false</code> if it is an update count or there are * object; <code>false</code> if it is an update count or there are
* no results * no results
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the second * this method is called on a closed {@code Statement}, the second
* parameter supplied to this method is not * parameter supplied to this method is not
* <code>Statement.RETURN_GENERATED_KEYS</code> or * {@code Statement.RETURN_GENERATED_KEYS} or
* <code>Statement.NO_GENERATED_KEYS</code>, * {@code Statement.NO_GENERATED_KEYS},
* the method is called on a * the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method with a constant of Statement.RETURN_GENERATED_KEYS * this method with a constant of Statement.RETURN_GENERATED_KEYS
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
@ -910,11 +910,11 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return <code>true</code> if the first result is a <code>ResultSet</code> * @return <code>true</code> if the first result is a <code>ResultSet</code>
* object; <code>false</code> if it is an update count or there * object; <code>false</code> if it is an update count or there
* are no results * are no results
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the * this method is called on a closed {@code Statement}, the
* elements in the <code>int</code> array passed to this method * elements in the {@code int} array passed to this method
* are not valid column indexes, the method is called on a * are not valid column indexes, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
@ -959,11 +959,11 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return <code>true</code> if the next result is a <code>ResultSet</code> * @return <code>true</code> if the next result is a <code>ResultSet</code>
* object; <code>false</code> if it is an update count or there * object; <code>false</code> if it is an update count or there
* are no more results * are no more results
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>,the * this method is called on a closed {@code Statement},the
* elements of the <code>String</code> array passed to this * elements of the {@code String} array passed to this
* method are not valid column names, the method is called on a * method are not valid column names, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
@ -984,8 +984,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @return either <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code> or * @return either <code>ResultSet.HOLD_CURSORS_OVER_COMMIT</code> or
* <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code> * <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* *
* @since 1.4 * @since 1.4
*/ */
@ -1087,8 +1087,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* *
* @return the current result as an update count; -1 if the current result * @return the current result as an update count; -1 if the current result
* is a <code>ResultSet</code> object or there are no more results * is a <code>ResultSet</code> object or there are no more results
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @see #execute * @see #execute
* @since 1.8 * @since 1.8
*/ */
@ -1109,8 +1109,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* The default implementation will throw {@code UnsupportedOperationException} * The default implementation will throw {@code UnsupportedOperationException}
* *
* @param max the new max rows limit; zero means there is no limit * @param max the new max rows limit; zero means there is no limit
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* or the condition {@code max >= 0} is not satisfied * or the condition {@code max >= 0} is not satisfied
* @see #getMaxRows * @see #getMaxRows
* @since 1.8 * @since 1.8
@ -1133,8 +1133,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return the current maximum number of rows for a <code>ResultSet</code> * @return the current maximum number of rows for a <code>ResultSet</code>
* object produced by this <code>Statement</code> object; * object produced by this <code>Statement</code> object;
* zero means there is no limit * zero means there is no limit
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code> * this method is called on a closed {@code Statement}
* @see #setMaxRows * @see #setMaxRows
* @since 1.8 * @since 1.8
*/ */
@ -1183,10 +1183,10 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return an array of update counts containing one element for each * @return an array of update counts containing one element for each
* command in the batch. The elements of the array are ordered according * command in the batch. The elements of the array are ordered according
* to the order in which commands were added to the batch. * to the order in which commands were added to the batch.
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> or the * this method is called on a closed {@code Statement} or the
* driver does not support batch statements. Throws {@link BatchUpdateException} * driver does not support batch statements. Throws {@link BatchUpdateException}
* (a subclass of <code>SQLException</code>) if one of the commands sent to the * (a subclass of {@code SQLException}) if one of the commands sent to the
* database fails to execute properly or attempts to return a result set. * database fails to execute properly or attempts to return a result set.
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
@ -1222,10 +1222,10 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return either (1) the row count for SQL Data Manipulation Language * @return either (1) the row count for SQL Data Manipulation Language
* (DML) statements or (2) 0 for SQL statements that return nothing * (DML) statements or (2) 0 for SQL statements that return nothing
* *
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the given * this method is called on a closed {@code Statement}, the given
* SQL statement produces a <code>ResultSet</code> object, the method is called on a * SQL statement produces a {@code ResultSet} object, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
* method has been exceeded and has at least attempted to cancel * method has been exceeded and has at least attempted to cancel
@ -1266,12 +1266,12 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return either (1) the row count for SQL Data Manipulation Language (DML) statements * @return either (1) the row count for SQL Data Manipulation Language (DML) statements
* or (2) 0 for SQL statements that return nothing * or (2) 0 for SQL statements that return nothing
* *
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the given * this method is called on a closed {@code Statement}, the given
* SQL statement returns a <code>ResultSet</code> object, * SQL statement returns a {@code ResultSet} object,
* the given constant is not one of those allowed, the method is called on a * the given constant is not one of those allowed, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method with a constant of Statement.RETURN_GENERATED_KEYS * this method with a constant of Statement.RETURN_GENERATED_KEYS
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
@ -1311,12 +1311,12 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return either (1) the row count for SQL Data Manipulation Language (DML) statements * @return either (1) the row count for SQL Data Manipulation Language (DML) statements
* or (2) 0 for SQL statements that return nothing * or (2) 0 for SQL statements that return nothing
* *
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the SQL * this method is called on a closed {@code Statement}, the SQL
* statement returns a <code>ResultSet</code> object,the second argument * statement returns a {@code ResultSet} object,the second argument
* supplied to this method is not an * supplied to this method is not an
* <code>int</code> array whose elements are valid column indexes, the method is called on a * {@code int} array whose elements are valid column indexes, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}
@ -1354,12 +1354,12 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return either the row count for <code>INSERT</code>, <code>UPDATE</code>, * @return either the row count for <code>INSERT</code>, <code>UPDATE</code>,
* or <code>DELETE</code> statements, or 0 for SQL statements * or <code>DELETE</code> statements, or 0 for SQL statements
* that return nothing * that return nothing
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the SQL * this method is called on a closed {@code Statement}, the SQL
* statement returns a <code>ResultSet</code> object, the * statement returns a {@code ResultSet} object, the
* second argument supplied to this method is not a <code>String</code> array * second argument supplied to this method is not a {@code String} array
* whose elements are valid column names, the method is called on a * whose elements are valid column names, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code> * {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout} * timeout value that was specified by the {@code setQueryTimeout}

14
src/java.sql/share/classes/java/sql/Struct.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1998, 2013, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1998, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -47,8 +47,8 @@ public interface Struct {
* @return the fully-qualified type name of the SQL structured * @return the fully-qualified type name of the SQL structured
* type for which this <code>Struct</code> object * type for which this <code>Struct</code> object
* is the generic representation * is the generic representation
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -71,8 +71,8 @@ public interface Struct {
* the result. * the result.
* *
* @return an array containing the ordered attribute values * @return an array containing the ordered attribute values
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */
@ -96,8 +96,8 @@ public interface Struct {
* *
* @param map a mapping of SQL type names to Java classes * @param map a mapping of SQL type names to Java classes
* @return an array containing the ordered attribute values * @return an array containing the ordered attribute values
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.2 * @since 1.2
*/ */

20
src/java.sql/share/classes/java/sql/Time.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -140,7 +140,7 @@ public class Time extends java.util.Date {
* values do not have a year component. * values do not have a year component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this * @throws java.lang.IllegalArgumentException if this
* method is invoked * method is invoked
* @see #setYear * @see #setYear
*/ */
@ -154,7 +154,7 @@ public class Time extends java.util.Date {
* values do not have a month component. * values do not have a month component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this * @throws java.lang.IllegalArgumentException if this
* method is invoked * method is invoked
* @see #setMonth * @see #setMonth
*/ */
@ -168,7 +168,7 @@ public class Time extends java.util.Date {
* values do not have a day component. * values do not have a day component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this * @throws java.lang.IllegalArgumentException if this
* method is invoked * method is invoked
*/ */
@Deprecated(since="1.2") @Deprecated(since="1.2")
@ -181,7 +181,7 @@ public class Time extends java.util.Date {
* values do not have a date component. * values do not have a date component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this * @throws java.lang.IllegalArgumentException if this
* method is invoked * method is invoked
* @see #setDate * @see #setDate
*/ */
@ -195,7 +195,7 @@ public class Time extends java.util.Date {
* values do not have a year component. * values do not have a year component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this * @throws java.lang.IllegalArgumentException if this
* method is invoked * method is invoked
* @see #getYear * @see #getYear
*/ */
@ -209,7 +209,7 @@ public class Time extends java.util.Date {
* values do not have a month component. * values do not have a month component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this * @throws java.lang.IllegalArgumentException if this
* method is invoked * method is invoked
* @see #getMonth * @see #getMonth
*/ */
@ -223,7 +223,7 @@ public class Time extends java.util.Date {
* values do not have a date component. * values do not have a date component.
* *
* @deprecated * @deprecated
* @exception java.lang.IllegalArgumentException if this * @throws java.lang.IllegalArgumentException if this
* method is invoked * method is invoked
* @see #getDate * @see #getDate
*/ */
@ -246,7 +246,7 @@ public class Time extends java.util.Date {
* *
* @param time a {@code LocalTime} to convert * @param time a {@code LocalTime} to convert
* @return a {@code Time} object * @return a {@code Time} object
* @exception NullPointerException if {@code time} is null * @throws NullPointerException if {@code time} is null
* @since 1.8 * @since 1.8
*/ */
@SuppressWarnings("deprecation") @SuppressWarnings("deprecation")
@ -274,7 +274,7 @@ public class Time extends java.util.Date {
* not be used because SQL {@code Time} values do not have a date * not be used because SQL {@code Time} values do not have a date
* component. * component.
* *
* @exception java.lang.UnsupportedOperationException if this method is invoked * @throws java.lang.UnsupportedOperationException if this method is invoked
*/ */
@Override @Override
public Instant toInstant() { public Instant toInstant() {

14
src/java.sql/share/classes/java/sql/Timestamp.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 1996, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 1996, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -84,7 +84,7 @@ public class Timestamp extends java.util.Date {
* @param second 0 to 59 * @param second 0 to 59
* @param nano 0 to 999,999,999 * @param nano 0 to 999,999,999
* @deprecated instead use the constructor {@code Timestamp(long millis)} * @deprecated instead use the constructor {@code Timestamp(long millis)}
* @exception IllegalArgumentException if the nano argument is out of bounds * @throws IllegalArgumentException if the nano argument is out of bounds
*/ */
@Deprecated(since="1.2") @Deprecated(since="1.2")
public Timestamp(int year, int month, int date, public Timestamp(int year, int month, int date,
@ -163,7 +163,7 @@ public class Timestamp extends java.util.Date {
* and {@code dd} may also be omitted. * and {@code dd} may also be omitted.
* *
* @return corresponding {@code Timestamp} value * @return corresponding {@code Timestamp} value
* @exception java.lang.IllegalArgumentException if the given argument * @throws java.lang.IllegalArgumentException if the given argument
* does not have the format {@code yyyy-[m]m-[d]d hh:mm:ss[.f...]} * does not have the format {@code yyyy-[m]m-[d]d hh:mm:ss[.f...]}
*/ */
public static Timestamp valueOf(String s) { public static Timestamp valueOf(String s) {
@ -327,7 +327,7 @@ public class Timestamp extends java.util.Date {
* to the given value. * to the given value.
* *
* @param n the new fractional seconds component * @param n the new fractional seconds component
* @exception java.lang.IllegalArgumentException if the given argument * @throws java.lang.IllegalArgumentException if the given argument
* is greater than 999999999 or less than 0 * is greater than 999999999 or less than 0
* @see #getNanos * @see #getNanos
*/ */
@ -490,7 +490,7 @@ public class Timestamp extends java.util.Date {
* *
* @param dateTime a {@code LocalDateTime} to convert * @param dateTime a {@code LocalDateTime} to convert
* @return a {@code Timestamp} object * @return a {@code Timestamp} object
* @exception NullPointerException if {@code dateTime} is null. * @throws NullPointerException if {@code dateTime} is null.
* @since 1.8 * @since 1.8
*/ */
@SuppressWarnings("deprecation") @SuppressWarnings("deprecation")
@ -535,8 +535,8 @@ public class Timestamp extends java.util.Date {
* @param instant the instant to convert * @param instant the instant to convert
* @return an {@code Timestamp} representing the same point on the time-line as * @return an {@code Timestamp} representing the same point on the time-line as
* the provided instant * the provided instant
* @exception NullPointerException if {@code instant} is null. * @throws NullPointerException if {@code instant} is null.
* @exception IllegalArgumentException if the instant is too large to * @throws IllegalArgumentException if the instant is too large to
* represent as a {@code Timestamp} * represent as a {@code Timestamp}
* @since 1.8 * @since 1.8
*/ */

10
src/java.sql/share/classes/javax/sql/CommonDataSource.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2005, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2005, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -55,7 +55,7 @@ public interface CommonDataSource {
* *
* @return the log writer for this data source or null if * @return the log writer for this data source or null if
* logging is disabled * logging is disabled
* @exception java.sql.SQLException if a database access error occurs * @throws java.sql.SQLException if a database access error occurs
* @see #setLogWriter * @see #setLogWriter
*/ */
java.io.PrintWriter getLogWriter() throws SQLException; java.io.PrintWriter getLogWriter() throws SQLException;
@ -76,7 +76,7 @@ public interface CommonDataSource {
* disabled. * disabled.
* *
* @param out the new log writer; to disable logging, set to null * @param out the new log writer; to disable logging, set to null
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #getLogWriter * @see #getLogWriter
*/ */
void setLogWriter(java.io.PrintWriter out) throws SQLException; void setLogWriter(java.io.PrintWriter out) throws SQLException;
@ -90,7 +90,7 @@ public interface CommonDataSource {
* initially zero. * initially zero.
* *
* @param seconds the data source login time limit * @param seconds the data source login time limit
* @exception SQLException if a database access error occurs. * @throws SQLException if a database access error occurs.
* @see #getLoginTimeout * @see #getLoginTimeout
*/ */
void setLoginTimeout(int seconds) throws SQLException; void setLoginTimeout(int seconds) throws SQLException;
@ -104,7 +104,7 @@ public interface CommonDataSource {
* initially zero. * initially zero.
* *
* @return the data source login time limit * @return the data source login time limit
* @exception SQLException if a database access error occurs. * @throws SQLException if a database access error occurs.
* @see #setLoginTimeout * @see #setLoginTimeout
*/ */
int getLoginTimeout() throws SQLException; int getLoginTimeout() throws SQLException;

10
src/java.sql/share/classes/javax/sql/ConnectionPoolDataSource.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -48,8 +48,8 @@ public interface ConnectionPoolDataSource extends CommonDataSource {
* @return a <code>PooledConnection</code> object that is a physical * @return a <code>PooledConnection</code> object that is a physical
* connection to the database that this * connection to the database that this
* <code>ConnectionPoolDataSource</code> object represents * <code>ConnectionPoolDataSource</code> object represents
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support * @throws java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */
@ -64,8 +64,8 @@ public interface ConnectionPoolDataSource extends CommonDataSource {
* @return a <code>PooledConnection</code> object that is a physical * @return a <code>PooledConnection</code> object that is a physical
* connection to the database that this * connection to the database that this
* <code>ConnectionPoolDataSource</code> object represents * <code>ConnectionPoolDataSource</code> object represents
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support * @throws java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */

6
src/java.sql/share/classes/javax/sql/DataSource.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -83,7 +83,7 @@ public interface DataSource extends CommonDataSource, Wrapper {
* this {@code DataSource} object represents. * this {@code DataSource} object represents.
* *
* @return a connection to the data source * @return a connection to the data source
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @throws java.sql.SQLTimeoutException when the driver has determined that the * @throws java.sql.SQLTimeoutException when the driver has determined that the
* timeout value specified by the {@code setLoginTimeout} method * timeout value specified by the {@code setLoginTimeout} method
* has been exceeded and has at least tried to cancel the * has been exceeded and has at least tried to cancel the
@ -99,7 +99,7 @@ public interface DataSource extends CommonDataSource, Wrapper {
* being made * being made
* @param password the user's password * @param password the user's password
* @return a connection to the data source * @return a connection to the data source
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @throws java.sql.SQLTimeoutException when the driver has determined that the * @throws java.sql.SQLTimeoutException when the driver has determined that the
* timeout value specified by the {@code setLoginTimeout} method * timeout value specified by the {@code setLoginTimeout} method
* has been exceeded and has at least tried to cancel the * has been exceeded and has at least tried to cancel the

10
src/java.sql/share/classes/javax/sql/PooledConnection.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -110,8 +110,8 @@ public interface PooledConnection {
* *
* @return a <code>Connection</code> object that is a handle to * @return a <code>Connection</code> object that is a handle to
* this <code>PooledConnection</code> object * this <code>PooledConnection</code> object
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support * @throws java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */
@ -125,8 +125,8 @@ public interface PooledConnection {
* See the {@link PooledConnection interface description} for more * See the {@link PooledConnection interface description} for more
* information. * information.
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support * @throws java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */

314
src/java.sql/share/classes/javax/sql/RowSet.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2014, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -101,7 +101,7 @@ public interface RowSet extends ResultSet {
* The default value is <code>null</code>. * The default value is <code>null</code>.
* *
* @return a string url * @return a string url
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #setUrl * @see #setUrl
*/ */
String getUrl() throws SQLException; String getUrl() throws SQLException;
@ -118,7 +118,7 @@ public interface RowSet extends ResultSet {
* connection, whichever was set to non null value most recently. * connection, whichever was set to non null value most recently.
* *
* @param url a string value; may be <code>null</code> * @param url a string value; may be <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #getUrl * @see #getUrl
*/ */
void setUrl(String url) throws SQLException; void setUrl(String url) throws SQLException;
@ -144,7 +144,7 @@ public interface RowSet extends ResultSet {
* *
* @param name the logical name of the data source for this <code>RowSet</code> * @param name the logical name of the data source for this <code>RowSet</code>
* object; may be <code>null</code> * object; may be <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #getDataSourceName * @see #getDataSourceName
*/ */
void setDataSourceName(String name) throws SQLException; void setDataSourceName(String name) throws SQLException;
@ -166,7 +166,7 @@ public interface RowSet extends ResultSet {
* given <code>String</code>. * given <code>String</code>.
* *
* @param name a user name * @param name a user name
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #getUsername * @see #getUsername
*/ */
void setUsername(String name) throws SQLException; void setUsername(String name) throws SQLException;
@ -187,7 +187,7 @@ public interface RowSet extends ResultSet {
* the given <code>String</code>. * the given <code>String</code>.
* *
* @param password the password string * @param password the password string
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #getPassword * @see #getPassword
*/ */
void setPassword(String password) throws SQLException; void setPassword(String password) throws SQLException;
@ -213,7 +213,7 @@ public interface RowSet extends ResultSet {
* <code>Connection.TRANSACTION_READ_COMMITTED</code>, * <code>Connection.TRANSACTION_READ_COMMITTED</code>,
* <code>Connection.TRANSACTION_REPEATABLE_READ</code>, or * <code>Connection.TRANSACTION_REPEATABLE_READ</code>, or
* <code>Connection.TRANSACTION_SERIALIZABLE</code> * <code>Connection.TRANSACTION_SERIALIZABLE</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #getTransactionIsolation * @see #getTransactionIsolation
*/ */
void setTransactionIsolation(int level) throws SQLException; void setTransactionIsolation(int level) throws SQLException;
@ -228,7 +228,7 @@ public interface RowSet extends ResultSet {
* SQL user-defined types and the Java classes to which they are * SQL user-defined types and the Java classes to which they are
* to be mapped * to be mapped
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #setTypeMap * @see #setTypeMap
*/ */
java.util.Map<String,Class<?>> getTypeMap() throws SQLException; java.util.Map<String,Class<?>> getTypeMap() throws SQLException;
@ -241,7 +241,7 @@ public interface RowSet extends ResultSet {
* @param map a <code>java.util.Map</code> object containing the names of * @param map a <code>java.util.Map</code> object containing the names of
* SQL user-defined types and the Java classes to which they are * SQL user-defined types and the Java classes to which they are
* to be mapped * to be mapped
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #getTypeMap * @see #getTypeMap
*/ */
void setTypeMap(java.util.Map<String,Class<?>> map) throws SQLException; void setTypeMap(java.util.Map<String,Class<?>> map) throws SQLException;
@ -272,7 +272,7 @@ public interface RowSet extends ResultSet {
* *
* @param cmd the SQL query that will be used to get the data for this * @param cmd the SQL query that will be used to get the data for this
* <code>RowSet</code> object; may be <code>null</code> * <code>RowSet</code> object; may be <code>null</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #getCommand * @see #getCommand
*/ */
void setCommand(String cmd) throws SQLException; void setCommand(String cmd) throws SQLException;
@ -297,7 +297,7 @@ public interface RowSet extends ResultSet {
* *
* @param value <code>true</code> if read-only; <code>false</code> if * @param value <code>true</code> if read-only; <code>false</code> if
* updatable * updatable
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #isReadOnly * @see #isReadOnly
*/ */
void setReadOnly(boolean value) throws SQLException; void setReadOnly(boolean value) throws SQLException;
@ -313,7 +313,7 @@ public interface RowSet extends ResultSet {
* *
* @return the current maximum column size limit; zero means that there * @return the current maximum column size limit; zero means that there
* is no limit * is no limit
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #setMaxFieldSize * @see #setMaxFieldSize
*/ */
int getMaxFieldSize() throws SQLException; int getMaxFieldSize() throws SQLException;
@ -329,7 +329,7 @@ public interface RowSet extends ResultSet {
* For maximum portability, use values greater than 256. * For maximum portability, use values greater than 256.
* *
* @param max the new max column size limit in bytes; zero means unlimited * @param max the new max column size limit in bytes; zero means unlimited
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #getMaxFieldSize * @see #getMaxFieldSize
*/ */
void setMaxFieldSize(int max) throws SQLException; void setMaxFieldSize(int max) throws SQLException;
@ -341,7 +341,7 @@ public interface RowSet extends ResultSet {
* *
* @return the current maximum number of rows that this <code>RowSet</code> * @return the current maximum number of rows that this <code>RowSet</code>
* object can contain; zero means unlimited * object can contain; zero means unlimited
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #setMaxRows * @see #setMaxRows
*/ */
int getMaxRows() throws SQLException; int getMaxRows() throws SQLException;
@ -352,7 +352,7 @@ public interface RowSet extends ResultSet {
* If the limit is exceeded, the excess rows are silently dropped. * If the limit is exceeded, the excess rows are silently dropped.
* *
* @param max the new maximum number of rows; zero means unlimited * @param max the new maximum number of rows; zero means unlimited
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #getMaxRows * @see #getMaxRows
*/ */
void setMaxRows(int max) throws SQLException; void setMaxRows(int max) throws SQLException;
@ -365,7 +365,7 @@ public interface RowSet extends ResultSet {
* *
* @return <code>true</code> if escape processing is enabled; * @return <code>true</code> if escape processing is enabled;
* <code>false</code> if it is disabled * <code>false</code> if it is disabled
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #setEscapeProcessing * @see #setEscapeProcessing
*/ */
boolean getEscapeProcessing() throws SQLException; boolean getEscapeProcessing() throws SQLException;
@ -377,7 +377,7 @@ public interface RowSet extends ResultSet {
* *
* @param enable <code>true</code> to enable escape processing; * @param enable <code>true</code> to enable escape processing;
* <code>false</code> to disable it * <code>false</code> to disable it
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #getEscapeProcessing * @see #getEscapeProcessing
*/ */
void setEscapeProcessing(boolean enable) throws SQLException; void setEscapeProcessing(boolean enable) throws SQLException;
@ -389,7 +389,7 @@ public interface RowSet extends ResultSet {
* *
* @return the current query timeout limit in seconds; zero means * @return the current query timeout limit in seconds; zero means
* unlimited * unlimited
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #setQueryTimeout * @see #setQueryTimeout
*/ */
int getQueryTimeout() throws SQLException; int getQueryTimeout() throws SQLException;
@ -401,7 +401,7 @@ public interface RowSet extends ResultSet {
* *
* @param seconds the new query timeout limit in seconds; zero means * @param seconds the new query timeout limit in seconds; zero means
* that there is no limit * that there is no limit
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see #getQueryTimeout * @see #getQueryTimeout
*/ */
void setQueryTimeout(int seconds) throws SQLException; void setQueryTimeout(int seconds) throws SQLException;
@ -415,7 +415,7 @@ public interface RowSet extends ResultSet {
* <code>ResultSet.TYPE_FORWARD_ONLY</code>, * <code>ResultSet.TYPE_FORWARD_ONLY</code>,
* <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or * <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or
* <code>ResultSet.TYPE_SCROLL_SENSITIVE</code> * <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see java.sql.ResultSet#getType * @see java.sql.ResultSet#getType
*/ */
void setType(int type) throws SQLException; void setType(int type) throws SQLException;
@ -428,7 +428,7 @@ public interface RowSet extends ResultSet {
* @param concurrency one of the <code>ResultSet</code> constants specifying a * @param concurrency one of the <code>ResultSet</code> constants specifying a
* concurrency level: <code>ResultSet.CONCUR_READ_ONLY</code> or * concurrency level: <code>ResultSet.CONCUR_READ_ONLY</code> or
* <code>ResultSet.CONCUR_UPDATABLE</code> * <code>ResultSet.CONCUR_UPDATABLE</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see ResultSet#getConcurrency * @see ResultSet#getConcurrency
*/ */
void setConcurrency(int concurrency) throws SQLException; void setConcurrency(int concurrency) throws SQLException;
@ -451,7 +451,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param sqlType a SQL type code defined by <code>java.sql.Types</code> * @param sqlType a SQL type code defined by <code>java.sql.Types</code>
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setNull(int parameterIndex, int sqlType) throws SQLException; void setNull(int parameterIndex, int sqlType) throws SQLException;
@ -462,9 +462,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param sqlType the SQL type code defined in <code>java.sql.Types</code> * @param sqlType the SQL type code defined in <code>java.sql.Types</code>
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */
@ -496,7 +496,7 @@ public interface RowSet extends ResultSet {
* @param typeName the fully qualified name of an SQL UDT or the type * @param typeName the fully qualified name of an SQL UDT or the type
* name of the SQL structured type being referenced by a <code>REF</code> * name of the SQL structured type being referenced by a <code>REF</code>
* type; ignored if the parameter is not a UDT or <code>REF</code> type * type; ignored if the parameter is not a UDT or <code>REF</code> type
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setNull (int paramIndex, int sqlType, String typeName) void setNull (int paramIndex, int sqlType, String typeName)
throws SQLException; throws SQLException;
@ -527,9 +527,9 @@ public interface RowSet extends ResultSet {
* @param typeName the fully-qualified name of an SQL user-defined type; * @param typeName the fully-qualified name of an SQL user-defined type;
* ignored if the parameter is not a user-defined type or * ignored if the parameter is not a user-defined type or
* SQL <code>REF</code> value * SQL <code>REF</code> value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */
@ -543,7 +543,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setBoolean(int parameterIndex, boolean x) throws SQLException; void setBoolean(int parameterIndex, boolean x) throws SQLException;
@ -554,10 +554,10 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @see #getBoolean * @see #getBoolean
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */
@ -570,7 +570,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setByte(int parameterIndex, byte x) throws SQLException; void setByte(int parameterIndex, byte x) throws SQLException;
@ -581,9 +581,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getByte * @see #getByte
* @since 1.4 * @since 1.4
@ -597,7 +597,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setShort(int parameterIndex, short x) throws SQLException; void setShort(int parameterIndex, short x) throws SQLException;
@ -608,9 +608,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getShort * @see #getShort
* @since 1.4 * @since 1.4
@ -624,7 +624,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setInt(int parameterIndex, int x) throws SQLException; void setInt(int parameterIndex, int x) throws SQLException;
@ -635,9 +635,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getInt * @see #getInt
* @since 1.4 * @since 1.4
@ -651,7 +651,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setLong(int parameterIndex, long x) throws SQLException; void setLong(int parameterIndex, long x) throws SQLException;
@ -662,9 +662,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getLong * @see #getLong
* @since 1.4 * @since 1.4
@ -678,7 +678,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setFloat(int parameterIndex, float x) throws SQLException; void setFloat(int parameterIndex, float x) throws SQLException;
@ -689,9 +689,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getFloat * @see #getFloat
* @since 1.4 * @since 1.4
@ -705,7 +705,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setDouble(int parameterIndex, double x) throws SQLException; void setDouble(int parameterIndex, double x) throws SQLException;
@ -716,9 +716,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getDouble * @see #getDouble
* @since 1.4 * @since 1.4
@ -733,7 +733,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException; void setBigDecimal(int parameterIndex, BigDecimal x) throws SQLException;
@ -745,9 +745,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getBigDecimal * @see #getBigDecimal
* @since 1.4 * @since 1.4
@ -763,7 +763,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setString(int parameterIndex, String x) throws SQLException; void setString(int parameterIndex, String x) throws SQLException;
@ -777,9 +777,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getString * @see #getString
* @since 1.4 * @since 1.4
@ -795,7 +795,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setBytes(int parameterIndex, byte x[]) throws SQLException; void setBytes(int parameterIndex, byte x[]) throws SQLException;
@ -808,9 +808,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getBytes * @see #getBytes
* @since 1.4 * @since 1.4
@ -825,7 +825,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setDate(int parameterIndex, java.sql.Date x) throws SQLException; void setDate(int parameterIndex, java.sql.Date x) throws SQLException;
@ -837,7 +837,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setTime(int parameterIndex, java.sql.Time x) throws SQLException; void setTime(int parameterIndex, java.sql.Time x) throws SQLException;
@ -849,7 +849,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setTimestamp(int parameterIndex, java.sql.Timestamp x) void setTimestamp(int parameterIndex, java.sql.Timestamp x)
throws SQLException; throws SQLException;
@ -862,9 +862,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getTimestamp * @see #getTimestamp
* @since 1.4 * @since 1.4
@ -887,7 +887,7 @@ public interface RowSet extends ResultSet {
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the Java input stream that contains the ASCII parameter value * @param x the Java input stream that contains the ASCII parameter value
* @param length the number of bytes in the stream * @param length the number of bytes in the stream
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setAsciiStream(int parameterIndex, java.io.InputStream x, int length) void setAsciiStream(int parameterIndex, java.io.InputStream x, int length)
throws SQLException; throws SQLException;
@ -908,9 +908,9 @@ public interface RowSet extends ResultSet {
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the Java input stream that contains the ASCII parameter value * @param x the Java input stream that contains the ASCII parameter value
* @param length the number of bytes in the stream * @param length the number of bytes in the stream
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */
@ -932,7 +932,7 @@ public interface RowSet extends ResultSet {
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the java input stream which contains the binary parameter value * @param x the java input stream which contains the binary parameter value
* @param length the number of bytes in the stream * @param length the number of bytes in the stream
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setBinaryStream(int parameterIndex, java.io.InputStream x, void setBinaryStream(int parameterIndex, java.io.InputStream x,
int length) throws SQLException; int length) throws SQLException;
@ -952,9 +952,9 @@ public interface RowSet extends ResultSet {
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the java input stream which contains the binary parameter value * @param x the java input stream which contains the binary parameter value
* @param length the number of bytes in the stream * @param length the number of bytes in the stream
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */
@ -977,7 +977,7 @@ public interface RowSet extends ResultSet {
* @param reader the {@code Reader} object that contains the UNICODE data * @param reader the {@code Reader} object that contains the UNICODE data
* to be set * to be set
* @param length the number of characters in the stream * @param length the number of characters in the stream
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setCharacterStream(int parameterIndex, void setCharacterStream(int parameterIndex,
Reader reader, Reader reader,
@ -1000,9 +1000,9 @@ public interface RowSet extends ResultSet {
* @param reader the <code>java.io.Reader</code> object that * @param reader the <code>java.io.Reader</code> object that
* contains the UNICODE data used as the designated parameter * contains the UNICODE data used as the designated parameter
* @param length the number of characters in the stream * @param length the number of characters in the stream
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.4 * @since 1.4
*/ */
@ -1028,8 +1028,8 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the Java input stream that contains the ASCII parameter value * @param x the Java input stream that contains the ASCII parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6 * @since 1.6
*/ */
@ -1053,8 +1053,8 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the Java input stream that contains the ASCII parameter value * @param x the Java input stream that contains the ASCII parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6 * @since 1.6
*/ */
@ -1078,8 +1078,8 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the java input stream which contains the binary parameter value * @param x the java input stream which contains the binary parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6 * @since 1.6
*/ */
@ -1102,8 +1102,8 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the java input stream which contains the binary parameter value * @param x the java input stream which contains the binary parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6 * @since 1.6
*/ */
@ -1130,8 +1130,8 @@ public interface RowSet extends ResultSet {
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param reader the <code>java.io.Reader</code> object that contains the * @param reader the <code>java.io.Reader</code> object that contains the
* Unicode data * Unicode data
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6 * @since 1.6
*/ */
@ -1157,8 +1157,8 @@ public interface RowSet extends ResultSet {
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param reader the <code>java.io.Reader</code> object that contains the * @param reader the <code>java.io.Reader</code> object that contains the
* Unicode data * Unicode data
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6 * @since 1.6
*/ */
@ -1232,7 +1232,7 @@ public interface RowSet extends ResultSet {
* this is the length * this is the length
* of the data in the stream or {@code Reader}. For all other types, * of the data in the stream or {@code Reader}. For all other types,
* this value will be ignored. * this value will be ignored.
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see java.sql.Types * @see java.sql.Types
*/ */
void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength) void setObject(int parameterIndex, Object x, int targetSqlType, int scaleOrLength)
@ -1266,14 +1266,14 @@ public interface RowSet extends ResultSet {
* @param scale for java.sql.Types.DECIMAL or java.sql.Types.NUMERIC types, * @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 * this is the number of digits after the decimal point. For all other
* types, this value will be ignored. * types, this value will be ignored.
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if <code>targetSqlType</code> is * @throws SQLFeatureNotSupportedException if {@code targetSqlType} is
* a <code>ARRAY</code>, <code>BLOB</code>, <code>CLOB</code>, * a {@code ARRAY}, {@code BLOB}, {@code CLOB},
* <code>DATALINK</code>, <code>JAVA_OBJECT</code>, <code>NCHAR</code>, * {@code DATALINK}, {@code JAVA_OBJECT}, {@code NCHAR},
* <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>, * {@code NCLOB}, {@code NVARCHAR}, {@code LONGNVARCHAR},
* <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code> * {@code REF}, {@code ROWID}, {@code SQLXML}
* or <code>STRUCT</code> data type and the JDBC driver does not support * or {@code STRUCT} data type and the JDBC driver does not support
* this data type * this data type
* @see Types * @see Types
* @see #getObject * @see #getObject
@ -1297,7 +1297,7 @@ public interface RowSet extends ResultSet {
* @param x the object containing the input parameter value * @param x the object containing the input parameter value
* @param targetSqlType the SQL type (as defined in <code>java.sql.Types</code>) * @param targetSqlType the SQL type (as defined in <code>java.sql.Types</code>)
* to be sent to the database * to be sent to the database
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setObject(int parameterIndex, Object x, void setObject(int parameterIndex, Object x,
int targetSqlType) throws SQLException; int targetSqlType) throws SQLException;
@ -1311,14 +1311,14 @@ public interface RowSet extends ResultSet {
* @param x the object containing the input parameter value * @param x the object containing the input parameter value
* @param targetSqlType the SQL type (as defined in java.sql.Types) to be * @param targetSqlType the SQL type (as defined in java.sql.Types) to be
* sent to the database * sent to the database
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if <code>targetSqlType</code> is * @throws SQLFeatureNotSupportedException if {@code targetSqlType} is
* a <code>ARRAY</code>, <code>BLOB</code>, <code>CLOB</code>, * a {@code ARRAY}, {@code BLOB}, {@code CLOB},
* <code>DATALINK</code>, <code>JAVA_OBJECT</code>, <code>NCHAR</code>, * {@code DATALINK}, {@code JAVA_OBJECT}, {@code NCHAR},
* <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>, * {@code NCLOB}, {@code NVARCHAR}, {@code LONGNVARCHAR},
* <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code> * {@code REF}, {@code ROWID}, {@code SQLXML}
* or <code>STRUCT</code> data type and the JDBC driver does not support * or {@code STRUCT} data type and the JDBC driver does not support
* this data type * this data type
* @see #getObject * @see #getObject
* @since 1.4 * @since 1.4
@ -1354,10 +1354,10 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the object containing the input parameter value * @param x the object containing the input parameter value
* @exception SQLException if a database access error occurs, * @throws SQLException if a database access error occurs,
* this method is called on a closed <code>CallableStatement</code> or if the given * this method is called on a closed {@code CallableStatement} or if the given
* <code>Object</code> parameter is ambiguous * {@code Object} parameter is ambiguous
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getObject * @see #getObject
* @since 1.4 * @since 1.4
@ -1392,7 +1392,7 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex The first parameter is 1, the second is 2, ... * @param parameterIndex The first parameter is 1, the second is 2, ...
* @param x The object containing the input parameter value * @param x The object containing the input parameter value
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setObject(int parameterIndex, Object x) throws SQLException; void setObject(int parameterIndex, Object x) throws SQLException;
@ -1404,7 +1404,7 @@ public interface RowSet extends ResultSet {
* *
* @param i the first parameter is 1, the second is 2, ... * @param i the first parameter is 1, the second is 2, ...
* @param x an object representing data of an SQL <code>REF</code> type * @param x an object representing data of an SQL <code>REF</code> type
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setRef (int i, Ref x) throws SQLException; void setRef (int i, Ref x) throws SQLException;
@ -1416,7 +1416,7 @@ public interface RowSet extends ResultSet {
* *
* @param i the first parameter is 1, the second is 2, ... * @param i the first parameter is 1, the second is 2, ...
* @param x an object representing a BLOB * @param x an object representing a BLOB
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setBlob (int i, Blob x) throws SQLException; void setBlob (int i, Blob x) throws SQLException;
@ -1497,7 +1497,7 @@ public interface RowSet extends ResultSet {
* is less than zero; if the number of bytes in the <code>InputStream</code> does not match * is less than zero; if the number of bytes in the <code>InputStream</code> does not match
* the specified length; if a database access error occurs or * the specified length; if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* *
* @since 1.6 * @since 1.6
@ -1512,9 +1512,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x a <code>Blob</code> object that maps an SQL <code>BLOB</code> value * @param x a <code>Blob</code> object that maps an SQL <code>BLOB</code> value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -1552,7 +1552,7 @@ public interface RowSet extends ResultSet {
* *
* @param i the first parameter is 1, the second is 2, ... * @param i the first parameter is 1, the second is 2, ...
* @param x an object representing a CLOB * @param x an object representing a CLOB
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setClob (int i, Clob x) throws SQLException; void setClob (int i, Clob x) throws SQLException;
@ -1620,7 +1620,7 @@ public interface RowSet extends ResultSet {
* marker in the SQL statement; if the length specified is less than zero; * marker in the SQL statement; if the length specified is less than zero;
* a database access error occurs or * a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* *
* @since 1.6 * @since 1.6
@ -1635,9 +1635,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x a <code>Clob</code> object that maps an SQL <code>CLOB</code> value * @param x a <code>Clob</code> object that maps an SQL <code>CLOB</code> value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -1674,7 +1674,7 @@ public interface RowSet extends ResultSet {
* *
* @param i the first parameter is 1, the second is 2, ... * @param i the first parameter is 1, the second is 2, ...
* @param x an object representing an SQL array * @param x an object representing an SQL array
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setArray (int i, Array x) throws SQLException; void setArray (int i, Array x) throws SQLException;
@ -1687,7 +1687,7 @@ public interface RowSet extends ResultSet {
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @param cal the <code>java.util.Calendar</code> object to use for calculating the date * @param cal the <code>java.util.Calendar</code> object to use for calculating the date
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setDate(int parameterIndex, java.sql.Date x, Calendar cal) void setDate(int parameterIndex, java.sql.Date x, Calendar cal)
throws SQLException; throws SQLException;
@ -1701,9 +1701,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getDate * @see #getDate
* @since 1.4 * @since 1.4
@ -1725,9 +1725,9 @@ public interface RowSet extends ResultSet {
* @param x the parameter value * @param x the parameter value
* @param cal the <code>Calendar</code> object the driver will use * @param cal the <code>Calendar</code> object the driver will use
* to construct the date * to construct the date
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getDate * @see #getDate
* @since 1.4 * @since 1.4
@ -1744,7 +1744,7 @@ public interface RowSet extends ResultSet {
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value * @param x the parameter value
* @param cal the <code>java.util.Calendar</code> object to use for calculating the time * @param cal the <code>java.util.Calendar</code> object to use for calculating the time
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setTime(int parameterIndex, java.sql.Time x, Calendar cal) void setTime(int parameterIndex, java.sql.Time x, Calendar cal)
throws SQLException; throws SQLException;
@ -1756,9 +1756,9 @@ public interface RowSet extends ResultSet {
* *
* @param parameterName the name of the parameter * @param parameterName the name of the parameter
* @param x the parameter value * @param x the parameter value
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getTime * @see #getTime
* @since 1.4 * @since 1.4
@ -1780,9 +1780,9 @@ public interface RowSet extends ResultSet {
* @param x the parameter value * @param x the parameter value
* @param cal the <code>Calendar</code> object the driver will use * @param cal the <code>Calendar</code> object the driver will use
* to construct the time * to construct the time
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getTime * @see #getTime
* @since 1.4 * @since 1.4
@ -1801,7 +1801,7 @@ public interface RowSet extends ResultSet {
* @param x the parameter value * @param x the parameter value
* @param cal the <code>java.util.Calendar</code> object to use for calculating the * @param cal the <code>java.util.Calendar</code> object to use for calculating the
* timestamp * timestamp
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setTimestamp(int parameterIndex, java.sql.Timestamp x, Calendar cal) void setTimestamp(int parameterIndex, java.sql.Timestamp x, Calendar cal)
throws SQLException; throws SQLException;
@ -1820,9 +1820,9 @@ public interface RowSet extends ResultSet {
* @param x the parameter value * @param x the parameter value
* @param cal the <code>Calendar</code> object the driver will use * @param cal the <code>Calendar</code> object the driver will use
* to construct the timestamp * to construct the timestamp
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed {@code CallableStatement}
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @see #getTimestamp * @see #getTimestamp
* @since 1.4 * @since 1.4
@ -1838,7 +1838,7 @@ public interface RowSet extends ResultSet {
* release the resources used by the current parameter values, which can * release the resources used by the current parameter values, which can
* be done by calling the method <code>clearParameters</code>. * be done by calling the method <code>clearParameters</code>.
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void clearParameters() throws SQLException; void clearParameters() throws SQLException;
@ -1870,7 +1870,7 @@ public interface RowSet extends ResultSet {
* <code>execute</code> will call on the {@code Reader}'s <code>readData</code> * <code>execute</code> will call on the {@code Reader}'s <code>readData</code>
* method as part of its implementation. * method as part of its implementation.
* *
* @exception SQLException if a database access error occurs or any of the * @throws SQLException if a database access error occurs or any of the
* properties necessary for making a connection and creating * properties necessary for making a connection and creating
* a statement have not been set * a statement have not been set
*/ */
@ -2079,7 +2079,7 @@ public interface RowSet extends ResultSet {
* character sets; if the driver can detect that a data conversion * character sets; if the driver can detect that a data conversion
* error could occur; if a database access error occurs or * error could occur; if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code> * this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @since 1.6 * @since 1.6
*/ */
@ -2181,8 +2181,8 @@ public interface RowSet extends ResultSet {
* *
* @param parameterIndex the first parameter is 1, the second is 2, ... * @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the <code>java.net.URL</code> object to be set * @param x the <code>java.net.URL</code> object to be set
* @exception SQLException if a database access error occurs or * @throws SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code> * this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method * @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.4 * @since 1.4
*/ */

12
src/java.sql/share/classes/javax/sql/RowSetInternal.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2001, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -45,7 +45,7 @@ public interface RowSetInternal {
* *
* @return an array of the current parameter values for this <code>RowSet</code> * @return an array of the current parameter values for this <code>RowSet</code>
* object's command * object's command
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
Object[] getParams() throws SQLException; Object[] getParams() throws SQLException;
@ -55,7 +55,7 @@ public interface RowSetInternal {
* *
* @return the <code>Connection</code> object passed to the rowset * @return the <code>Connection</code> object passed to the rowset
* or <code>null</code> if none was passed * or <code>null</code> if none was passed
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
Connection getConnection() throws SQLException; Connection getConnection() throws SQLException;
@ -69,7 +69,7 @@ public interface RowSetInternal {
* @param md the <code>RowSetMetaData</code> object that will be set with * @param md the <code>RowSetMetaData</code> object that will be set with
* information about the rowset's columns * information about the rowset's columns
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setMetaData(RowSetMetaData md) throws SQLException; void setMetaData(RowSetMetaData md) throws SQLException;
@ -82,7 +82,7 @@ public interface RowSetInternal {
* <code>getOriginal</code> are said to have an original value. * <code>getOriginal</code> are said to have an original value.
* *
* @return the original value of the rowset * @return the original value of the rowset
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
public ResultSet getOriginal() throws SQLException; public ResultSet getOriginal() throws SQLException;
@ -94,7 +94,7 @@ public interface RowSetInternal {
* *
* @return the original value of the current row as a <code>ResultSet</code> * @return the original value of the current row as a <code>ResultSet</code>
* object * object
* @exception SQLException if a database access error occurs or this method * @throws SQLException if a database access error occurs or this method
* is called while the cursor is on the insert row, before the * is called while the cursor is on the insert row, before the
* first row, or after the last row * first row, or after the last row
*/ */

36
src/java.sql/share/classes/javax/sql/RowSetMetaData.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2005, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -51,7 +51,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* the given number. * the given number.
* *
* @param columnCount the number of columns in the <code>RowSet</code> object * @param columnCount the number of columns in the <code>RowSet</code> object
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setColumnCount(int columnCount) throws SQLException; void setColumnCount(int columnCount) throws SQLException;
@ -64,7 +64,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* @param property <code>true</code> if the column is automatically * @param property <code>true</code> if the column is automatically
* numbered; <code>false</code> if it is not * numbered; <code>false</code> if it is not
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setAutoIncrement(int columnIndex, boolean property) throws SQLException; void setAutoIncrement(int columnIndex, boolean property) throws SQLException;
@ -76,7 +76,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* @param property <code>true</code> if the column is case sensitive; * @param property <code>true</code> if the column is case sensitive;
* <code>false</code> if it is not * <code>false</code> if it is not
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setCaseSensitive(int columnIndex, boolean property) throws SQLException; void setCaseSensitive(int columnIndex, boolean property) throws SQLException;
@ -88,7 +88,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* @param property <code>true</code> if the column can be used in a * @param property <code>true</code> if the column can be used in a
* <code>WHERE</code> clause; <code>false</code> if it cannot * <code>WHERE</code> clause; <code>false</code> if it cannot
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setSearchable(int columnIndex, boolean property) throws SQLException; void setSearchable(int columnIndex, boolean property) throws SQLException;
@ -100,7 +100,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* @param property <code>true</code> if the column is a cash value; * @param property <code>true</code> if the column is a cash value;
* <code>false</code> if it is not * <code>false</code> if it is not
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setCurrency(int columnIndex, boolean property) throws SQLException; void setCurrency(int columnIndex, boolean property) throws SQLException;
@ -115,7 +115,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* <code>ResultSetMetaData.columnNullable</code>, or * <code>ResultSetMetaData.columnNullable</code>, or
* <code>ResultSetMetaData.columnNullableUnknown</code> * <code>ResultSetMetaData.columnNullableUnknown</code>
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setNullable(int columnIndex, int property) throws SQLException; void setNullable(int columnIndex, int property) throws SQLException;
@ -127,7 +127,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* @param property <code>true</code> if the column is a signed number; * @param property <code>true</code> if the column is a signed number;
* <code>false</code> if it is not * <code>false</code> if it is not
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setSigned(int columnIndex, boolean property) throws SQLException; void setSigned(int columnIndex, boolean property) throws SQLException;
@ -139,7 +139,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* @param size the normal maximum number of characters for * @param size the normal maximum number of characters for
* the designated column * the designated column
* *
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setColumnDisplaySize(int columnIndex, int size) throws SQLException; void setColumnDisplaySize(int columnIndex, int size) throws SQLException;
@ -149,7 +149,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* *
* @param columnIndex the first column is 1, the second is 2, ... * @param columnIndex the first column is 1, the second is 2, ...
* @param label the column title * @param label the column title
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setColumnLabel(int columnIndex, String label) throws SQLException; void setColumnLabel(int columnIndex, String label) throws SQLException;
@ -158,7 +158,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* *
* @param columnIndex the first column is 1, the second is 2, ... * @param columnIndex the first column is 1, the second is 2, ...
* @param columnName the designated column's name * @param columnName the designated column's name
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setColumnName(int columnIndex, String columnName) throws SQLException; void setColumnName(int columnIndex, String columnName) throws SQLException;
@ -168,7 +168,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* *
* @param columnIndex the first column is 1, the second is 2, ... * @param columnIndex the first column is 1, the second is 2, ...
* @param schemaName the schema name * @param schemaName the schema name
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setSchemaName(int columnIndex, String schemaName) throws SQLException; void setSchemaName(int columnIndex, String schemaName) throws SQLException;
@ -178,7 +178,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* *
* @param columnIndex the first column is 1, the second is 2, ... * @param columnIndex the first column is 1, the second is 2, ...
* @param precision the total number of decimal digits * @param precision the total number of decimal digits
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setPrecision(int columnIndex, int precision) throws SQLException; void setPrecision(int columnIndex, int precision) throws SQLException;
@ -188,7 +188,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* *
* @param columnIndex the first column is 1, the second is 2, ... * @param columnIndex the first column is 1, the second is 2, ...
* @param scale the number of digits to right of decimal point * @param scale the number of digits to right of decimal point
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setScale(int columnIndex, int scale) throws SQLException; void setScale(int columnIndex, int scale) throws SQLException;
@ -198,7 +198,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* *
* @param columnIndex the first column is 1, the second is 2, ... * @param columnIndex the first column is 1, the second is 2, ...
* @param tableName the column's table name * @param tableName the column's table name
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setTableName(int columnIndex, String tableName) throws SQLException; void setTableName(int columnIndex, String tableName) throws SQLException;
@ -208,7 +208,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* *
* @param columnIndex the first column is 1, the second is 2, ... * @param columnIndex the first column is 1, the second is 2, ...
* @param catalogName the column's catalog name * @param catalogName the column's catalog name
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setCatalogName(int columnIndex, String catalogName) throws SQLException; void setCatalogName(int columnIndex, String catalogName) throws SQLException;
@ -217,7 +217,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* *
* @param columnIndex the first column is 1, the second is 2, ... * @param columnIndex the first column is 1, the second is 2, ...
* @param SQLType the column's SQL type * @param SQLType the column's SQL type
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @see Types * @see Types
*/ */
void setColumnType(int columnIndex, int SQLType) throws SQLException; void setColumnType(int columnIndex, int SQLType) throws SQLException;
@ -228,7 +228,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* *
* @param columnIndex the first column is 1, the second is 2, ... * @param columnIndex the first column is 1, the second is 2, ...
* @param typeName data source specific type name. * @param typeName data source specific type name.
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
void setColumnTypeName(int columnIndex, String typeName) throws SQLException; void setColumnTypeName(int columnIndex, String typeName) throws SQLException;

6
src/java.sql/share/classes/javax/sql/RowSetReader.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2001, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -65,8 +65,8 @@ public interface RowSetReader {
* @param caller the <code>RowSet</code> object (1) that has implemented the * @param caller the <code>RowSet</code> object (1) that has implemented the
* <code>RowSetInternal</code> interface, (2) with which this reader is * <code>RowSetInternal</code> interface, (2) with which this reader is
* registered, and (3) whose <code>execute</code> method called this reader * registered, and (3) whose <code>execute</code> method called this reader
* @exception SQLException if a database access error occurs or this method * @throws SQLException if a database access error occurs or this method
* invokes the <code>RowSet.execute</code> method * invokes the {@code RowSet.execute} method
*/ */
void readData(RowSetInternal caller) throws SQLException; void readData(RowSetInternal caller) throws SQLException;

4
src/java.sql/share/classes/javax/sql/RowSetWriter.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2001, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -57,7 +57,7 @@ public interface RowSetWriter {
* registered, and (3) that called this method internally * registered, and (3) that called this method internally
* @return <code>true</code> if the modified data was written; <code>false</code> * @return <code>true</code> if the modified data was written; <code>false</code>
* if not, which will be the case if there is a conflict * if not, which will be the case if there is a conflict
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
*/ */
boolean writeData(RowSetInternal caller) throws SQLException; boolean writeData(RowSetInternal caller) throws SQLException;

6
src/java.sql/share/classes/javax/sql/XAConnection.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -46,8 +46,8 @@ public interface XAConnection extends PooledConnection {
* in a distributed transaction. * in a distributed transaction.
* *
* @return the {@code XAResource} object * @return the {@code XAResource} object
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not * @throws SQLFeatureNotSupportedException if the JDBC driver does not
* support this method * support this method
* @since 1.4 * @since 1.4
*/ */

10
src/java.sql/share/classes/javax/sql/XADataSource.java
View file

@ -1,5 +1,5 @@
/* /*
* Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved. * Copyright (c) 2000, 2020, Oracle and/or its affiliates. All rights reserved.
* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
* *
* This code is free software; you can redistribute it and/or modify it * This code is free software; you can redistribute it and/or modify it
@ -48,8 +48,8 @@ public interface XADataSource extends CommonDataSource {
* @return an {@code XAConnection} object, which represents a * @return an {@code XAConnection} object, which represents a
* physical connection to a data source, that can be used in * physical connection to a data source, that can be used in
* a distributed transaction * a distributed transaction
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value specified by the {@code setLoginTimeout} method * timeout value specified by the {@code setLoginTimeout} method
@ -69,8 +69,8 @@ public interface XADataSource extends CommonDataSource {
* @return an {@code XAConnection} object, which represents a * @return an {@code XAConnection} object, which represents a
* physical connection to a data source, that can be used in * physical connection to a data source, that can be used in
* a distributed transaction * a distributed transaction
* @exception SQLException if a database access error occurs * @throws SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support * @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method * this method
* @throws SQLTimeoutException when the driver has determined that the * @throws SQLTimeoutException when the driver has determined that the
* timeout value specified by the {@code setLoginTimeout} method * timeout value specified by the {@code setLoginTimeout} method