archive/jdk
1
0
Fork 0
mirror of https://github.com/openjdk/jdk.git synced 2025-08-27 23:04:50 +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.
*
* 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;
* {@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
* 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.
*
* 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}
* 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
* {@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.
*
* 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;
* {@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
* ManagementPermission("control").
*/

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

@ -231,7 +231,7 @@ public class CompositeName implements Name {
* description.
*
* @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 {
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
* 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) {
if (!(obj instanceof CompositeName)) {
@ -380,7 +380,7 @@ public class CompositeName implements Name {
* @param posn The 0-based index of the component to retrieve.
* Must be in the range [0,size()).
* @return The non-null component at index posn.
* @exception ArrayIndexOutOfBoundsException if posn is outside the
* @throws ArrayIndexOutOfBoundsException if posn is outside the
* specified range.
*/
public String get(int posn) {
@ -396,7 +396,7 @@ public class CompositeName implements Name {
* Must be in the range [0,size()].
* @return A composite name consisting of the components at indexes in
* the range [0,posn).
* @exception ArrayIndexOutOfBoundsException
* @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range.
*/
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
* the range [posn,size()). If posn is equal to
* size(), an empty composite name is returned.
* @exception ArrayIndexOutOfBoundsException
* @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range.
*/
public Name getSuffix(int posn) {
@ -465,7 +465,7 @@ public class CompositeName implements Name {
*
* @param suffix The non-null components to add.
* @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)
throws InvalidNameException
@ -490,8 +490,8 @@ public class CompositeName implements Name {
* @param posn The index in this name at which to add the new
* components. Must be in the range [0,size()].
* @return The updated CompositeName, not a new one. Cannot be null.
* @exception InvalidNameException If n is not a composite name.
* @exception ArrayIndexOutOfBoundsException
* @throws InvalidNameException If n is not a composite name.
* @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range.
*/
public Name addAll(int posn, Name n)
@ -511,7 +511,7 @@ public class CompositeName implements Name {
*
* @param comp The non-null component to add.
* @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.
*/
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.
* Must be in the range [0,size()].
* @return The updated CompositeName, not a new one. Cannot be null.
* @exception ArrayIndexOutOfBoundsException
* @throws ArrayIndexOutOfBoundsException
* 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.
*/
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.
* Must be in the range [0,size()).
* @return The component removed (a String).
* @exception ArrayIndexOutOfBoundsException
* @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range (includes case where
* composite name is empty).
* @exception InvalidNameException If deleting the component
* @throws InvalidNameException If deleting the component
* would violate the name's syntax.
*/
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
* this compound name. See class description for
* contents of properties.
* @exception InvalidNameException If 'n' violates the syntax specified
* @throws InvalidNameException If 'n' violates the syntax specified
* by {@code syntax}.
*/
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.
* @return a negative integer, zero, or a positive integer as this Name
* 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)
*/
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.
* Must be in the range [0,size()).
* @return The component at index posn.
* @exception ArrayIndexOutOfBoundsException if posn is outside the
* @throws ArrayIndexOutOfBoundsException if posn is outside the
* specified range.
*/
public String get(int posn) {
@ -371,7 +371,7 @@ public class CompoundName implements Name {
* Must be in the range [0,size()].
* @return A compound name consisting of the components at indexes in
* the range [0,posn).
* @exception ArrayIndexOutOfBoundsException
* @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range.
*/
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
* the range [posn,size()). If posn is equal to
* size(), an empty compound name is returned.
* @exception ArrayIndexOutOfBoundsException
* @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range.
*/
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.
* @param suffix The non-null components to add.
* @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
* 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
* components. Must be in the range [0,size()].
* @return The updated CompoundName, not a new one. Cannot be null.
* @exception ArrayIndexOutOfBoundsException
* @throws ArrayIndexOutOfBoundsException
* 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
* 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.
* @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.
*/
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 posn The index at which to add the new component.
* Must be in the range [0,size()].
* @exception ArrayIndexOutOfBoundsException
* @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range.
* @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.
*/
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.
* Must be in the range [0,size()).
* @return The component removed (a String).
* @exception ArrayIndexOutOfBoundsException
* @throws ArrayIndexOutOfBoundsException
* If posn is outside the specified range (includes case where
* compound name is empty).
* @exception InvalidNameException If deleting the component
* @throws InvalidNameException If deleting the component
* would violate the compound name's syntax.
*/
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.
*
* 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.
* Set <code>gotDefault</code> so that we know we've tried this before.
* @return The non-null cached initial context.
* @exception NoInitialContextException If cannot find an initial context.
* @exception NamingException If a naming exception was encountered.
* @throws NoInitialContextException If cannot find an initial context.
* @throws NamingException If a naming exception was encountered.
*/
protected Context getDefaultInitCtx() throws NamingException{
if (!gotDefault) {
@ -323,8 +323,8 @@ public class InitialContext implements Context {
* @param name The non-null name for which to get the context.
* @return A URL context for <code>name</code> or the cached
* initial context. The result cannot be null.
* @exception NoInitialContextException If cannot find an initial context.
* @exception NamingException In a naming exception is encountered.
* @throws NoInitialContextException If cannot find an initial context.
* @throws NamingException In a naming exception is encountered.
* @see javax.naming.spi.NamingManager#getURLContext
*/
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.
* @return A URL context for <code>name</code> or the cached
* initial context. The result cannot be null.
* @exception NoInitialContextException If cannot find an initial context.
* @exception NamingException In a naming exception is encountered.
* @throws NoInitialContextException If cannot find an initial context.
* @throws NamingException In a naming exception is encountered.
*
* @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.
*
* 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.
*
* @return The non-null name of this link.
* @exception MalformedLinkException If a link name could not be extracted
* @exception NamingException If a naming exception was encountered.
* @throws MalformedLinkException If a link name could not be extracted
* @throws NamingException If a naming exception was encountered.
*/
public String getLinkName() throws NamingException {
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.
*
* 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.
* @return A non-null parsed form of the name using the naming convention
* of this parser.
* @exception InvalidNameException If name does not conform to
* @throws InvalidNameException If name does not conform to
* 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;
}

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.
*
* 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 (e.g. Attribute.getAll() returns an enumeration of
* 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
* 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
*/
public T next() throws NamingException;
@ -111,7 +111,7 @@ public interface NamingEnumeration<T> extends Enumeration<T> {
* by the application.
*
* @return true if there is more in the enumeration ; false otherwise.
* @exception NamingException
* @throws NamingException
* If a naming exception is encountered while attempting
* to determine whether there is another element
* in the enumeration. See NamingException
@ -139,7 +139,7 @@ public interface NamingEnumeration<T> extends Enumeration<T> {
* Implementations are encouraged to use appropriate algorithms to
* 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.
* @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.
*
* 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.
* @return The address at the 0-based index posn. It must be in the
* range [0,getAddressCount()).
* @exception ArrayIndexOutOfBoundsException If posn not in the specified
* @throws ArrayIndexOutOfBoundsException If posn not in the specified
* range.
*/
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 addr The non-null address to add.
* @exception ArrayIndexOutOfBoundsException If posn not in the specified
* @throws ArrayIndexOutOfBoundsException If posn not in the specified
* range.
*/
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.
* @return The address removed.
* @exception ArrayIndexOutOfBoundsException If posn not in the specified
* @throws ArrayIndexOutOfBoundsException If posn not in the specified
* range.
*/
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.
*
* 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.
*
* @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.
*/
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.
*
* 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.
*
* @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()}
* to continue processing referrals.
*/
@ -142,7 +142,7 @@ public abstract class ReferralException extends NamingException {
* referral context. If null, no environment properties will be used.
*
* @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()}
* 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.
*
* 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
* {@code SUBTREE_SCOPE}.
* @param l The nonnull listener.
* @exception NamingException If a problem was encountered while
* @throws NamingException If a problem was encountered while
* adding the listener.
* @see #removeNamingListener
*/
@ -211,7 +211,7 @@ public interface EventContext extends Context {
* @param scope One of {@code OBJECT_SCOPE}, {@code ONELEVEL_SCOPE}, or
* {@code SUBTREE_SCOPE}.
* @param l The nonnull listener.
* @exception NamingException If a problem was encountered while
* @throws NamingException If a problem was encountered while
* adding the listener.
* @see #removeNamingListener
*/
@ -231,7 +231,7 @@ public interface EventContext extends Context {
* this {@code EventContext} instance, this method does not do anything.
*
* @param l The nonnull listener.
* @exception NamingException If a problem was encountered while
* @throws NamingException If a problem was encountered while
* removing the listener.
* @see #addNamingListener
*/
@ -242,7 +242,7 @@ public interface EventContext extends Context {
* that does 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.
*/
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.
*
* 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
* search controls are used.
* @param l The nonnull listener.
* @exception NamingException If a problem was encountered while
* @throws NamingException If a problem was encountered while
* adding the listener.
* @see EventContext#removeNamingListener
* @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
* search controls is used.
* @param l The nonnull listener.
* @exception NamingException If a problem was encountered while
* @throws NamingException If a problem was encountered while
* adding the listener.
* @see EventContext#removeNamingListener
* @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
* search controls are used.
* @param l The nonnull listener.
* @exception NamingException If a problem was encountered while
* @throws NamingException If a problem was encountered while
* adding the listener.
* @see EventContext#removeNamingListener
* @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
* search controls is used.
* @param l The nonnull listener.
* @exception NamingException If a problem was encountered while
* @throws NamingException If a problem was encountered while
* adding the listener.
* @see EventContext#removeNamingListener
* @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.
*
* 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.
*
* @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
* 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.
@ -126,7 +126,7 @@ public abstract class ControlFactory {
* @return A control object created using {@code ctl}; or
* {@code ctl} if a control object cannot be created using
* 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.
* If one of the factories accessed throws an
* 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.
*
* 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
* contents of the LDAP {@code ExtendedRequest.requestValue}
* 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.
*/
public byte[] getEncodedValue();
@ -137,7 +137,7 @@ public interface ExtendedRequest extends java.io.Serializable {
* @param length The number of bytes in berValue to use.
*
* @return A non-null object.
* @exception NamingException if cannot create extended response
* @throws NamingException if cannot create extended response
* due to an error.
* @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.
*
* 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.
*
* @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.
* @see InitialLdapContext
*/
@ -239,7 +239,7 @@ public interface LdapContext extends DirContext {
* in the class description for implementation details.
* @param connCtls The possibly null controls to use. If null, no
* controls are used.
* @exception NamingException If an error occurred while reconnecting.
* @throws NamingException If an error occurred while reconnecting.
* @see #getConnectControls
* @see #newInstance
*/
@ -253,7 +253,7 @@ public interface LdapContext extends DirContext {
*
* @return A possibly-null array of controls. null means no connect controls
* 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.
*/
public Control[] getConnectControls() throws NamingException;
@ -279,7 +279,7 @@ public interface LdapContext extends DirContext {
* {@code getRequestControls()}.
* @param requestControls The possibly null controls to use. If null, no
* controls are used.
* @exception NamingException If an error occurred while setting the
* @throws NamingException If an error occurred while setting the
* request controls.
* @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.
*
* 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.
*
* @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()}
* to continue processing referrals.
*/
@ -109,7 +109,7 @@ public abstract class LdapReferralException extends ReferralException {
* referral context. If null, no environment properties will be used.
*
* @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()}
* 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
* properties.
* @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()}
* 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.
*
* 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.
* If false, then the server need not honor the
* 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.
*/
public PagedResultsControl(int pageSize, boolean criticality)
@ -158,7 +158,7 @@ final public class PagedResultsControl extends BasicControl {
* pageSize or refuse to perform the search.
* If false, then the server need not honor the
* 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.
*/
public PagedResultsControl(int pageSize, byte[] cookie,
@ -171,7 +171,7 @@ final public class PagedResultsControl extends BasicControl {
value = setEncodedValue(pageSize, cookie);
}
/*
/**
* 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
* 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.
* @return A possibly null byte array representing the ASN.1 BER encoded
* 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)
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.
*
* 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.
* It is not cloned - any changes to value
* 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.
*/
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.
* @return A negative integer, zero, or a positive integer as this Rdn
* 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) {
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.
*
* 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.
* If false, then the server need not honor the
* 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.
*/
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.
* If false, then the server need not honor the
* 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.
*/
public SortControl(String[] sortBy, boolean criticality)
@ -175,7 +175,7 @@ final public class SortControl extends BasicControl {
* requested or refuse to perform the search.
* If false, then the server need not honor the
* 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.
*/
public SortControl(SortKey[] sortBy, boolean criticality)
@ -185,7 +185,7 @@ final public class SortControl extends BasicControl {
super.value = setEncodedValue(sortBy);
}
/*
/**
* Encodes the sort control's value using ASN.1 BER.
* 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.
@ -193,7 +193,7 @@ final public class SortControl extends BasicControl {
* @param sortKeys A non-null list of keys to sort by.
* @return A possibly null byte array representing the ASN.1 BER encoded
* 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 {

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.
*
* 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.
* It is not cloned - any changes to value
* 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.
*/
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.
*
* 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
* is not expected to contain any response value.
* @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.
*/
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.
*
* 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}.
* The factory must not modify attrs.
* @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
* 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.
*
* 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
* and the corresponding
* 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
* 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.
*
* This code is free software; you can redistribute it and/or modify it
@ -80,7 +80,7 @@ public class DirectoryManager extends NamingManager {
* @param cpe
* The non-null exception that triggered this continuation.
* @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)
*/
@ -136,10 +136,10 @@ public class DirectoryManager extends NamingManager {
* @return An object created using {@code refInfo} and {@code attrs}; or
* {@code refInfo} if an object cannot be created by
* 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
* 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
* and instantiating the factory and object classes.
* 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.
* If no state factory returns a non-null answer, the result will contain
* 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.
* A factory should only throw an exception if it does not want
* 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.
*
* This code is free software; you can redistribute it and/or modify it
@ -65,7 +65,7 @@ public interface InitialContextFactory {
* of the initial context.
* @return A non-null initial context object that implements the Context
* interface.
* @exception NamingException If cannot create an initial context.
* @throws NamingException If cannot create an initial context.
*/
public Context getInitialContext(Hashtable<?,?> environment)
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.
*
* 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
* context implementation. Can be null.
* @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
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
* is installed.
* @exception SecurityException builder cannot be installed
* @throws SecurityException builder cannot be installed
* for security reasons.
* @exception NamingException builder cannot be installed for
* @throws NamingException builder cannot be installed for
* 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 ObjectFactory
* @see ObjectFactoryBuilder
@ -280,10 +280,10 @@ public class NamingManager {
* @return An object created using {@code refInfo}; or
* {@code refInfo} if an object cannot be created using
* 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
* 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
* and instantiating the factory and object classes.
* A factory should only throw an exception if it does not want
@ -547,7 +547,7 @@ public class NamingManager {
* scheme id {@code scheme};
* {@code null} if the factory for creating the
* context is not found.
* @exception NamingException If a naming exception occurs while creating
* @throws NamingException If a naming exception occurs while creating
* the context.
* @see #getObjectInstance
* @see ObjectFactory#getObjectInstance
@ -665,13 +665,13 @@ public class NamingManager {
* @param env The possibly null environment properties used when
* creating the context.
* @return A non-null initial context.
* @exception NoInitialContextException If the
* @throws NoInitialContextException If the
* {@code Context.INITIAL_CONTEXT_FACTORY} property
* is not found or names a nonexistent
* class or a class that cannot be instantiated,
* or if the initial context could not be created for some other
* 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.directory.InitialDirContext
*/
@ -766,11 +766,11 @@ public class NamingManager {
* be replaced.
* @param builder The initial context factory builder to install. If null,
* no builder is set.
* @exception SecurityException builder cannot be installed for security
* @throws SecurityException builder cannot be installed for security
* reasons.
* @exception NamingException builder cannot be installed for
* @throws NamingException builder cannot be installed for
* a non-security-related reason.
* @exception IllegalStateException If a builder was previous installed.
* @throws IllegalStateException If a builder was previous installed.
* @see #hasInitialContextFactoryBuilder
* @see java.lang.SecurityManager#checkSetFactory
*/
@ -841,7 +841,7 @@ public class NamingManager {
* @param cpe
* The non-null exception that triggered this continuation.
* @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")
public static Context getContinuationContext(CannotProceedException cpe)
@ -913,7 +913,7 @@ public class NamingManager {
* the object's state.
* @return The non-null object representing {@code obj}'s state for
* 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
* and instantiating the factory and object classes.
* 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.
*
* 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
* creating the object.
* @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
* 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.
*
* 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.
* Can be null.
* @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,

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.
*
* 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.
* @return The object's state for binding;
* 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
* 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
* <code>true</code> does not force an initial immediate activation of
* a newly registered object; initial activation is lazy.
* @exception ActivationException if object registration fails.
* @exception RemoteException if either of the following fails:
* @throws ActivationException if object registration fails.
* @throws RemoteException if either of the following fails:
* a) registering the object with the activation system or b) exporting
* 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.
* @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
* remote object
* @param ssf the server-side socket factory for receiving remote calls
* @exception ActivationException if object registration fails.
* @exception RemoteException if either of the following fails:
* @throws ActivationException if object registration fails.
* @throws RemoteException if either of the following fails:
* a) registering the object with the activation system or b) exporting
* 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.
* @since 1.2
**/
@ -182,9 +182,9 @@ public abstract class Activatable extends RemoteServer {
*
* @param id activation identifier for the object
* @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
* @exception UnsupportedOperationException if and only if activation is
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @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
* remote object
* @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
* @exception UnsupportedOperationException if and only if activation is
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @since 1.2
*/
@ -248,11 +248,11 @@ public abstract class Activatable extends RemoteServer {
*
* @param desc the object's descriptor
* @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
* @exception ActivationException if activation system is not running
* @exception RemoteException if remote call fails
* @exception UnsupportedOperationException if and only if activation is
* @throws ActivationException if activation system is not running
* @throws RemoteException if remote call fails
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @since 1.2
*/
@ -284,11 +284,11 @@ public abstract class Activatable extends RemoteServer {
* either already unexported or is currently exported and has no
* pending/executing calls); false is returned if the object has
* 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)
* @exception ActivationException if group is not active
* @exception RemoteException if call informing monitor fails
* @exception UnsupportedOperationException if and only if activation is
* @throws ActivationException if group is not active
* @throws RemoteException if call informing monitor fails
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @since 1.2
*/
@ -304,10 +304,10 @@ public abstract class Activatable extends RemoteServer {
* activated via that <code>id</code>.
*
* @param id the object's activation identifier
* @exception UnknownObjectException if object (<code>id</code>) is unknown
* @exception ActivationException if activation system is not running
* @exception RemoteException if remote call to activation system fails
* @exception UnsupportedOperationException if and only if activation is
* @throws UnknownObjectException if object (<code>id</code>) is unknown
* @throws ActivationException if activation system is not running
* @throws RemoteException if remote call to activation system fails
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @since 1.2
*/
@ -351,9 +351,9 @@ public abstract class Activatable extends RemoteServer {
* @return the activation identifier obtained from registering the
* descriptor, <code>desc</code>, with the activation system
* the wrong group
* @exception ActivationException if activation group is not active
* @exception RemoteException if object registration or export fails
* @exception UnsupportedOperationException if and only if activation is
* @throws ActivationException if activation group is not active
* @throws RemoteException if object registration or export fails
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @since 1.2
**/
@ -426,9 +426,9 @@ public abstract class Activatable extends RemoteServer {
* @param ssf the server-side socket factory for receiving remote calls
* @return the activation identifier obtained from registering the
* descriptor with the activation system
* @exception ActivationException if activation group is not active
* @exception RemoteException if object registration or export fails
* @exception UnsupportedOperationException if and only if activation is
* @throws ActivationException if activation group is not active
* @throws RemoteException if object registration or export fails
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @since 1.2
**/
@ -495,8 +495,8 @@ public abstract class Activatable extends RemoteServer {
* @param id the object's activation identifier
* @param port the port on which the object is exported (an anonymous
* port is used if port=0)
* @exception RemoteException if object export fails
* @exception UnsupportedOperationException if and only if activation is
* @throws RemoteException if object export fails
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @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
* remote object
* @param ssf the server-side socket factory for receiving remote calls
* @exception RemoteException if object export fails
* @exception UnsupportedOperationException if and only if activation is
* @throws RemoteException if object export fails
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @since 1.2
*/
@ -556,9 +556,9 @@ public abstract class Activatable extends RemoteServer {
* pending or in-progress calls; if false, only unexports the object
* if there are no pending or in-progress calls
* @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
* @exception UnsupportedOperationException if and only if activation is
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @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)
* @param data the object's initialization (activation) data contained
* in marshalled form.
* @exception ActivationException if the current group is nonexistent
* @exception UnsupportedOperationException if and only if activation is
* @throws ActivationException if the current group is nonexistent
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @since 1.2
*/
@ -148,8 +148,8 @@ public final class ActivationDesc implements Serializable {
* activated on demand. Specifying <code>restart</code> to be
* <code>true</code> does not force an initial immediate activation of
* a newly registered object; initial activation is lazy.
* @exception ActivationException if the current group is nonexistent
* @exception UnsupportedOperationException if and only if activation is
* @throws ActivationException if the current group is nonexistent
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @since 1.2
*/
@ -184,8 +184,8 @@ public final class ActivationDesc implements Serializable {
* loaded)
* @param data the object's initialization (activation) data contained
* in marshalled form.
* @exception IllegalArgumentException if <code>groupID</code> is null
* @exception UnsupportedOperationException if and only if activation is
* @throws IllegalArgumentException if <code>groupID</code> is null
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @since 1.2
*/
@ -218,8 +218,8 @@ public final class ActivationDesc implements Serializable {
* activated on demand. Specifying <code>restart</code> to be
* <code>true</code> does not force an initial immediate activation of
* a newly registered object; initial activation is lazy.
* @exception IllegalArgumentException if <code>groupID</code> is null
* @exception UnsupportedOperationException if and only if activation is
* @throws IllegalArgumentException if <code>groupID</code> is null
* @throws UnsupportedOperationException if and only if activation is
* not supported by this implementation
* @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
* @return true if the object was successfully deactivated; otherwise
* returns false.
* @exception UnknownObjectException if object is unknown (may already
* @throws UnknownObjectException if object is unknown (may already
* be inactive)
* @exception RemoteException if call informing monitor fails
* @exception ActivationException if group is inactive
* @throws RemoteException if call informing monitor fails
* @throws ActivationException if group is inactive
* @since 1.2
*/
public boolean inactiveObject(ActivationID id)
@ -207,9 +207,9 @@ public abstract class ActivationGroup
*
* @param id the object's identifier
* @param obj the remote object implementation
* @exception UnknownObjectException if object is not registered
* @exception RemoteException if call informing monitor fails
* @exception ActivationException if group is inactive
* @throws UnknownObjectException if object is not registered
* @throws RemoteException if call informing monitor fails
* @throws ActivationException if group is inactive
* @since 1.2
*/
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
* initial creation)
* @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
* @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
* <code>checkSetFactory</code>
* 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
* @see SecurityManager#checkSetFactory
* @since 1.2
@ -355,7 +355,7 @@ public abstract class ActivationGroup
/**
* Returns the current activation group's identifier. Returns null
* 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
* @return the activation group's identifier
* @since 1.2
@ -371,7 +371,7 @@ public abstract class ActivationGroup
* so if a group has already become active and deactivated.
*
* @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
* has already been created and deactivated.
*/
@ -401,12 +401,12 @@ public abstract class ActivationGroup
* This could result in a SecurityException.
*
* @param system remote reference to the <code>ActivationSystem</code>
* @exception ActivationException if activation system is already set
* @exception SecurityException if permission to set the activation system is denied.
* @throws ActivationException if activation system is already set
* @throws SecurityException if permission to set the activation system is denied.
* (Note: The default implementation of the security manager
* <code>checkSetFactory</code>
* 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
* @see #getSystem
* @see SecurityManager#checkSetFactory
@ -439,10 +439,10 @@ public abstract class ActivationGroup
* <code>java.rmi.activation.port</code>.
*
* @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
* (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
* @see #setSystem
* @since 1.2
@ -473,9 +473,9 @@ public abstract class ActivationGroup
*
* @param id the object's identifier
* @param mobj a marshalled object containing the remote object's stub
* @exception UnknownObjectException if object is not registered
* @exception RemoteException if call informing monitor fails
* @exception ActivationException if an activation error occurs
* @throws UnknownObjectException if object is not registered
* @throws RemoteException if call informing monitor fails
* @throws ActivationException if an activation error occurs
* @since 1.2
*/
protected void activeObject(ActivationID id,
@ -492,8 +492,8 @@ public abstract class ActivationGroup
* <code>ActivationMonitor</code>. Also, the current group
* for the VM is set to null.
*
* @exception UnknownGroupException if group is not registered
* @exception RemoteException if call informing monitor fails
* @throws UnknownGroupException if group is not registered
* @throws RemoteException if call informing monitor fails
* @since 1.2
*/
protected void inactiveGroup()
@ -529,7 +529,7 @@ public abstract class ActivationGroup
/**
* 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()
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);
* if false, returning a cached value is acceptable.
* @return the reference to the active remote object
* @exception ActivationException if activation fails
* @exception UnknownObjectException if the object is unknown
* @exception RemoteException if remote call fails
* @throws ActivationException if activation fails
* @throws UnknownObjectException if the object is unknown
* @throws RemoteException if remote call fails
* @since 1.2
*/
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
* @return a marshalled object containing the serialized
* representation of remote object's stub
* @exception ActivationException if object activation fails
* @exception RemoteException if remote call fails
* @throws ActivationException if object activation fails
* @throws RemoteException if remote call fails
* @since 1.2
*/
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.
*
* @param id the object's activation identifier
* @exception UnknownObjectException if object is unknown
* @exception RemoteException if remote call fails
* @throws UnknownObjectException if object is unknown
* @throws RemoteException if remote call fails
* @since 1.2
*/
public void inactiveObject(ActivationID id)
@ -86,8 +86,8 @@ public interface ActivationMonitor extends Remote {
*
* @param id the active object's id
* @param obj the marshalled form of the object's stub
* @exception UnknownObjectException if object is unknown
* @exception RemoteException if remote call fails
* @throws UnknownObjectException if object is unknown
* @throws RemoteException if remote call fails
* @since 1.2
*/
public void activeObject(ActivationID id,
@ -102,8 +102,8 @@ public interface ActivationMonitor extends Remote {
*
* @param id the group's id
* @param incarnation the group's incarnation number
* @exception UnknownGroupException if group is unknown
* @exception RemoteException if remote call fails
* @throws UnknownGroupException if group is unknown
* @throws RemoteException if remote call fails
* @since 1.2
*/
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
* @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).
* @exception UnknownGroupException if group referred to in
* @throws UnknownGroupException if group referred to in
* <code>desc</code> is not registered with this system
* @exception RemoteException if remote call fails
* @throws RemoteException if remote call fails
* @since 1.2
*/
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.
*
* @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).
* @exception UnknownObjectException if object is unknown (not registered)
* @exception RemoteException if remote call fails
* @throws UnknownObjectException if object is unknown (not registered)
* @throws RemoteException if remote call fails
* @since 1.2
*/
public void unregisterObject(ActivationID id)
@ -102,8 +102,8 @@ public interface ActivationSystem extends Remote {
*
* @param desc the group's descriptor
* @return an identifier for the group
* @exception ActivationException if group registration fails
* @exception RemoteException if remote call fails
* @throws ActivationException if group registration fails
* @throws RemoteException if remote call fails
* @since 1.2
*/
public ActivationGroupID registerGroup(ActivationGroupDesc desc)
@ -120,12 +120,12 @@ public interface ActivationSystem extends Remote {
* @param group the group's instantiator
* @param incarnation the group's incarnation number
* @return monitor for activation group
* @exception UnknownGroupException if group is not registered
* @exception ActivationException if a group for the specified
* @throws UnknownGroupException if group is not registered
* @throws ActivationException if a group for the specified
* <code>id</code> is already active and that group is not equal
* to the specified <code>group</code> or that group has a different
* <code>incarnation</code> than the specified <code>group</code>
* @exception RemoteException if remote call fails
* @throws RemoteException if remote call fails
* @since 1.2
*/
public ActivationMonitor activeGroup(ActivationGroupID id,
@ -141,10 +141,10 @@ public interface ActivationSystem extends Remote {
* group and its associated objects is removed from the system.
*
* @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).
* @exception UnknownGroupException if group is not registered
* @exception RemoteException if remote call fails
* @throws UnknownGroupException if group is not registered
* @throws RemoteException if remote call fails
* @since 1.2
*/
public void unregisterGroup(ActivationGroupID id)
@ -153,7 +153,7 @@ public interface ActivationSystem extends Remote {
/**
* Shutdown the activation system. Destroys all groups spawned by
* 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
* @since 1.2
*/
@ -166,13 +166,13 @@ public interface ActivationSystem extends Remote {
*
* @param id the activation identifier 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
* @exception UnknownObjectException the activation <code>id</code>
* @throws UnknownObjectException the activation <code>id</code>
* is not registered
* @exception ActivationException for general failure (e.g., unable
* @throws ActivationException for general failure (e.g., unable
* to update log)
* @exception RemoteException if remote call fails
* @throws RemoteException if remote call fails
* @return the previous value of the activation descriptor
* @see #getActivationDesc
* @since 1.2
@ -189,11 +189,11 @@ public interface ActivationSystem extends Remote {
*
* @param id the activation group identifier 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
* @exception ActivationException for general failure (e.g., unable
* @throws ActivationException for general failure (e.g., unable
* to update log)
* @exception RemoteException if remote call fails
* @throws RemoteException if remote call fails
* @return the previous value of the activation group descriptor
* @see #getActivationGroupDesc
* @since 1.2
@ -207,9 +207,9 @@ public interface ActivationSystem extends Remote {
* identifier, <code>id</code>.
*
* @param id the activation identifier for the activatable object
* @exception UnknownObjectException if <code>id</code> is not registered
* @exception ActivationException for general failure
* @exception RemoteException if remote call fails
* @throws UnknownObjectException if <code>id</code> is not registered
* @throws ActivationException for general failure
* @throws RemoteException if remote call fails
* @return the activation descriptor
* @see #setActivationDesc
* @since 1.2
@ -222,9 +222,9 @@ public interface ActivationSystem extends Remote {
* with the activation group identifier, <code>id</code>.
*
* @param id the activation group identifier for the group
* @exception UnknownGroupException if <code>id</code> is not registered
* @exception ActivationException for general failure
* @exception RemoteException if remote call fails
* @throws UnknownGroupException if <code>id</code> is not registered
* @throws ActivationException for general failure
* @throws RemoteException if remote call fails
* @return the activation group descriptor
* @see #setActivationGroupDesc
* @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
* is allowed.
* @return the remote object (a stub) in a marshalled form
* @exception ActivationException if object activation fails
* @exception UnknownObjectException if object is unknown (not registered)
* @exception RemoteException if remote call fails
* @throws ActivationException if object activation fails
* @throws UnknownObjectException if object is unknown (not registered)
* @throws RemoteException if remote call fails
* @since 1.2
*/
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.
*
* 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.
*
* @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
*/
public static Registry getRegistry()
@ -81,7 +81,7 @@ public final class LocateRegistry {
*
* @param port port on which the registry accepts requests
* @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
*/
public static Registry getRegistry(int port)
@ -97,7 +97,7 @@ public final class LocateRegistry {
*
* @param host host for the remote 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
*/
public static Registry getRegistry(String host)
@ -114,7 +114,7 @@ public final class LocateRegistry {
* @param host host for the remote registry
* @param port port on which the registry accepts requests
* @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
*/
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>
* factory will be used in the registry stub.
* @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
*/
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
* @return the registry
* @exception RemoteException if the registry could not be exported
* @throws RemoteException if the registry could not be exported
* @since 1.1
**/
public static Registry createRegistry(int port) throws RemoteException {
@ -228,7 +228,7 @@ public final class LocateRegistry {
* @param ssf server-side <code>ServerSocket</code> factory
* used to accept connections to 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
**/
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.
*
* 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
* @return the <code>Class</code> object representing the loaded class
* @exception MalformedURLException
* @throws MalformedURLException
* if the system property <b>java.rmi.server.codebase</b>
* contains an invalid URL
* @exception ClassNotFoundException
* @throws ClassNotFoundException
* if a definition for the class could not
* be found at the codebase location.
* @since 1.1
@ -69,10 +69,10 @@ public interface LoaderHandler {
* @param codebase the URL from which to load the class
* @param name the name of the class to load
* @return the <code>Class</code> object representing the loaded class
* @exception MalformedURLException
* @throws MalformedURLException
* if the <code>codebase</code> paramater
* contains an invalid URL
* @exception ClassNotFoundException
* @throws ClassNotFoundException
* if a definition for the class could not
* be found at the specified URL
* @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.
*
* 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 port the port number
* @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
*/
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.
*
* This code is free software; you can redistribute it and/or modify it
@ -65,7 +65,7 @@ public interface RMIServerSocketFactory {
* an anonymous port).
* @param port the port number
* @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
* @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.
*
* 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 port the port number
* @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
*/
public abstract Socket createSocket(String host, int port)
@ -109,7 +109,7 @@ public abstract class RMISocketFactory
* an anonymous port).
* @param port the port number
* @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
* @since 1.1
*/
@ -124,8 +124,8 @@ public abstract class RMISocketFactory
* setting a socket factory; if disallowed, a SecurityException will be
* thrown.
* @param fac the socket factory
* @exception IOException if the RMI socket factory is already set
* @exception SecurityException if a security manager exists and its
* @throws IOException if the RMI socket factory is already set
* @throws SecurityException if a security manager exists and its
* <code>checkSetFactory</code> method doesn't allow the operation.
* @see #getSocketFactory
* @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.
*
* This code is free software; you can redistribute it and/or modify it
@ -51,7 +51,7 @@ public interface RemoteCall {
* into.
*
* @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
* @deprecated no replacement
*/
@ -62,7 +62,7 @@ public interface RemoteCall {
* Release the output stream; in some transports this would release
* 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
* @deprecated no replacement
*/
@ -74,7 +74,7 @@ public interface RemoteCall {
* results/arguments from.
*
* @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
* @deprecated no replacement
*/
@ -86,7 +86,7 @@ public interface RemoteCall {
* Release the input stream. This would allow some transports to release
* 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
* @deprecated no replacement
*/
@ -101,8 +101,8 @@ public interface RemoteCall {
* @param success If true, indicates normal return, else indicates
* exceptional return.
* @return output stream for writing call result
* @exception java.io.IOException if an I/O error occurs.
* @exception java.io.StreamCorruptedException If already been called.
* @throws java.io.IOException if an I/O error occurs.
* @throws java.io.StreamCorruptedException If already been called.
* @since 1.1
* @deprecated no replacement
*/
@ -113,7 +113,7 @@ public interface RemoteCall {
/**
* 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
* @deprecated no replacement
*/
@ -123,7 +123,7 @@ public interface RemoteCall {
/**
* 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
* @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.
*
* 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.
* @param obj the remote object whose stub is needed
* @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.
* @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.
*
* 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 opnum a hash that may be used to represent the method
* @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
* @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.
*
* 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 data information necessary to export the 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)
* @since 1.1
*/
@ -66,7 +66,7 @@ public interface ServerRef extends RemoteRef {
* thread actively handling a remote method invocation the
* hostname of the client is returned.
* @return the client's host name
* @exception ServerNotActiveException if called outside of servicing
* @throws ServerNotActiveException if called outside of servicing
* a remote method invocation
* @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 opnum operation number
* @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
* @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
* the original.
*
* @exception CloneNotSupportedException if clone failed due to
* @throws CloneNotSupportedException if clone failed due to
* a RemoteException.
* @return the new remote object
* @since 1.1
@ -319,7 +319,7 @@ public class UnicastRemoteObject extends RemoteServer {
*
* @param obj the remote object to be exported
* @return remote object stub
* @exception RemoteException if export fails
* @throws RemoteException if export fails
* @since 1.1
* @deprecated This method is deprecated because it supports only static stubs.
* 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 port the port to export the object on
* @return remote object stub
* @exception RemoteException if export fails
* @throws RemoteException if export fails
* @since 1.2
*/
public static Remote exportObject(Remote obj, int port)
@ -374,7 +374,7 @@ public class UnicastRemoteObject extends RemoteServer {
* remote object
* @param ssf the server-side socket factory for receiving remote calls
* @return remote object stub
* @exception RemoteException if export fails
* @throws RemoteException if export fails
* @since 1.2
*/
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;
* may be {@code null}
* @return remote object stub
* @exception RemoteException if export fails
* @throws RemoteException if export fails
* @since 9
*/
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;
* may be {@code null}
* @return remote object stub
* @exception RemoteException if export fails
* @throws RemoteException if export fails
* @since 9
*/
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
* if there are no pending or in-progress calls
* @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
* @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.
*
* 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
* name for a built-in base type; or the fully-qualified SQL type
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -95,9 +95,9 @@ public interface Array {
* @return a constant from the class {@link java.sql.Types} that is
* the type code for the elements in the array designated by this
* <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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -119,9 +119,9 @@ public interface Array {
* @return an array in the Java programming language that contains
* the ordered elements of the SQL <code>ARRAY</code> value
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -147,9 +147,9 @@ public interface Array {
* of SQL type names to classes in the Java programming language
* @return an array in the Java programming language that contains the ordered
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -172,9 +172,9 @@ public interface Array {
* @param count the number of successive SQL array elements to retrieve
* @return an array containing up to <code>count</code> consecutive elements
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -210,9 +210,9 @@ public interface Array {
* consecutive elements of the SQL <code>ARRAY</code> value designated by this
* <code>Array</code> object, 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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -236,9 +236,9 @@ public interface Array {
* @return a {@link ResultSet} object containing one row for each
* of the elements in the array designated by this <code>Array</code>
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -267,9 +267,9 @@ public interface Array {
* @return a <code>ResultSet</code> object containing one row for each
* of the elements in the array designated by this <code>Array</code>
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -298,9 +298,9 @@ public interface Array {
* <code>count</code> consecutive elements of the SQL array
* designated by this <code>Array</code> object, starting at
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -335,9 +335,9 @@ public interface Array {
* <code>count</code> consecutive elements of the SQL array
* designated by this <code>Array</code> object, starting at
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -356,7 +356,7 @@ public interface Array {
*
* @throws SQLException if an error occurs releasing
* the Array's resources
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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.
*
* 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.
*
* @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}
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.2
*/
@ -86,10 +86,10 @@ public interface Blob {
* consecutive bytes from the {@code BLOB} value designated
* by this {@code Blob} object, starting with the
* 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
* less than 0
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @see #setBytes
* @since 1.2
@ -101,9 +101,9 @@ public interface Blob {
* {@code Blob} instance as a stream.
*
* @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
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @see #setBinaryStream
* @since 1.2
@ -121,9 +121,9 @@ public interface Blob {
* @param start the position at which to begin searching; the
* first position is 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
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.2
*/
@ -140,9 +140,9 @@ public interface Blob {
* @param start the position in the {@code BLOB} value
* at which to begin searching; the first position is 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
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.2
*/
@ -171,9 +171,9 @@ public interface Blob {
* @param bytes the array of bytes to be written to the {@code BLOB}
* value that this {@code Blob} object represents
* @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
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @see #getBytes
* @since 1.4
@ -207,9 +207,9 @@ public interface Blob {
* @param len the number of bytes to be written to the {@code BLOB}
* value from the array of bytes {@code bytes}
* @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
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @see #getBytes
* @since 1.4
@ -236,9 +236,9 @@ public interface Blob {
* to start writing; the first position is 1
* @return a {@code java.io.OutputStream} object to which data can
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @see #getBinaryStream
* @since 1.4
@ -257,9 +257,9 @@ public interface Blob {
*
* @param len the length, in bytes, to which the {@code BLOB} value
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.4
*/
@ -277,7 +277,7 @@ public interface Blob {
*
* @throws SQLException if an error occurs releasing
* the Blob's resources
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.6
*/
@ -298,7 +298,7 @@ public interface Blob {
* pos + length is greater than the number of bytes
* in the {@code Blob}
*
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @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.
*
* 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.
*
* @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
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.2
*/
@ -85,10 +85,10 @@ public interface Clob {
* the value for length must be 0 or greater
* @return a {@code String} that is the specified substring in
* 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
* less than 0
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.2
*/
@ -101,9 +101,9 @@ public interface Clob {
*
* @return a {@code java.io.Reader} object containing the
* {@code CLOB} data
* @exception SQLException if there is an error accessing the
* @throws SQLException if there is an error accessing the
* {@code CLOB} value
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @see #setCharacterStream
* @since 1.2
@ -116,9 +116,9 @@ public interface Clob {
*
* @return a {@code java.io.InputStream} object containing the
* {@code CLOB} data
* @exception SQLException if there is an error accessing the
* @throws SQLException if there is an error accessing the
* {@code CLOB} value
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @see #setAsciiStream
* @since 1.2
@ -136,9 +136,9 @@ public interface Clob {
* the first position is 1
* @return the position at which the substring appears 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 pos is less than 1
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.2
*/
@ -155,9 +155,9 @@ public interface Clob {
* position is 1
* @return the position at which the {@code Clob} object appears
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.2
*/
@ -186,10 +186,10 @@ public interface Clob {
* @param str the string to be written to the {@code CLOB}
* value that this {@code Clob} designates
* @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
*
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.4
*/
@ -219,10 +219,10 @@ public interface Clob {
* the characters to be written
* @param len the number of characters to be 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
*
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.4
*/
@ -247,9 +247,9 @@ public interface Clob {
* @param pos the position at which to start writing to this
* {@code CLOB} object; The first position is 1
* @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
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @see #getAsciiStream
*
@ -277,9 +277,9 @@ public interface Clob {
* {@code CLOB} value; The first position is 1
*
* @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
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @see #getCharacterStream
*
@ -300,10 +300,10 @@ public interface Clob {
*
* @param len the length, in characters, to which the {@code CLOB} value
* 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
*
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.4
*/
@ -322,7 +322,7 @@ public interface Clob {
* @throws SQLException if an error occurs releasing
* the Clob's resources
*
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @since 1.6
*/
@ -344,7 +344,7 @@ public interface Clob {
* or if pos + length is greater than the number of
* characters in the {@code Clob}
*
* @exception SQLFeatureNotSupportedException if the JDBC driver
* @throws SQLFeatureNotSupportedException if the JDBC driver
* does not support this method
* @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.
*
* 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}.
*
* @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
*/
Statement createStatement() throws SQLException;
@ -133,7 +133,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* parameter placeholders
* @return a new default <code>PreparedStatement</code> object containing the
* 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
*/
PreparedStatement prepareStatement(String sql)
@ -166,7 +166,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* call escape syntax.
* @return a new default <code>CallableStatement</code> object containing the
* 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
*/
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 '?'
* parameter placeholders
* @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
*/
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;
* <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,
* or this method is called on a closed connection
* @see #getAutoCommit
@ -228,7 +228,7 @@ public interface Connection extends Wrapper, AutoCloseable {
*
* @return the current state of this <code>Connection</code> object's
* 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
* @see #setAutoCommit
*/
@ -241,10 +241,10 @@ public interface Connection extends Wrapper, AutoCloseable {
* This method should be
* 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,
* 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
*/
void commit() throws SQLException;
@ -255,10 +255,10 @@ public interface Connection extends Wrapper, AutoCloseable {
* by this <code>Connection</code> object. This method should be
* 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 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
*/
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
* 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;
@ -294,7 +294,7 @@ public interface Connection extends Wrapper, AutoCloseable {
*
* @return <code>true</code> if this <code>Connection</code> object
* 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;
@ -311,7 +311,7 @@ public interface Connection extends Wrapper, AutoCloseable {
*
* @return a <code>DatabaseMetaData</code> object 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
*/
DatabaseMetaData getMetaData() throws SQLException;
@ -324,7 +324,7 @@ public interface Connection extends Wrapper, AutoCloseable {
*
* @param readOnly <code>true</code> enables read-only mode;
* <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 during a transaction
*/
@ -336,7 +336,7 @@ public interface Connection extends Wrapper, AutoCloseable {
*
* @return <code>true</code> if this <code>Connection</code> object
* 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
*/
boolean isReadOnly() throws SQLException;
@ -358,7 +358,7 @@ public interface Connection extends Wrapper, AutoCloseable {
*
* @param catalog the name of a catalog (subspace in this
* <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
* @see #getCatalog
*/
@ -368,7 +368,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* Retrieves this <code>Connection</code> object's current catalog name.
*
* @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
* @see #setCatalog
*/
@ -438,9 +438,9 @@ public interface Connection extends Wrapper, AutoCloseable {
* <code>Connection.TRANSACTION_SERIALIZABLE</code>.
* (Note that <code>Connection.TRANSACTION_NONE</code> cannot be used
* 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
* or the given parameter is not one of the <code>Connection</code>
* or the given parameter is not one of the {@code Connection}
* constants
* @see DatabaseMetaData#supportsTransactionIsolationLevel
* @see #getTransactionIsolation
@ -458,7 +458,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* <code>Connection.TRANSACTION_REPEATABLE_READ</code>,
* <code>Connection.TRANSACTION_SERIALIZABLE</code>, or
* <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
* @see #setTransactionIsolation
*/
@ -481,7 +481,7 @@ public interface Connection extends Wrapper, AutoCloseable {
*
* @return the first <code>SQLWarning</code> object or <code>null</code>
* 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
* @see SQLWarning
*/
@ -493,7 +493,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* returns <code>null</code> until a new warning is
* 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
*/
void clearWarnings() throws SQLException;
@ -520,11 +520,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* @return a new <code>Statement</code> object that will generate
* <code>ResultSet</code> 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
* or the given parameters are not <code>ResultSet</code>
* or the given parameters are not {@code ResultSet}
* 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
* set type and result set concurrency.
* @since 1.2
@ -555,11 +555,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* @return a new PreparedStatement object containing the
* pre-compiled SQL statement that will produce <code>ResultSet</code>
* 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
* or the given parameters are not <code>ResultSet</code>
* or the given parameters are not {@code ResultSet}
* 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
* set type and result set concurrency.
* @since 1.2
@ -589,11 +589,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* @return a new <code>CallableStatement</code> object containing the
* pre-compiled SQL statement that will produce <code>ResultSet</code>
* 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
* or the given parameters are not <code>ResultSet</code>
* or the given parameters are not {@code ResultSet}
* 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
* set type and result set concurrency.
* @since 1.2
@ -619,9 +619,9 @@ public interface Connection extends Wrapper, AutoCloseable {
* </pre>
* @return the <code>java.util.Map</code> object associated
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
* @see #setTypeMap
@ -645,11 +645,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* @param map the <code>java.util.Map</code> object to install
* as the replacement for this <code>Connection</code>
* 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
* the given parameter is not a <code>java.util.Map</code>
* the given parameter is not a {@code java.util.Map}
* object
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
* @see #getTypeMap
@ -672,7 +672,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* @throws SQLException if a database access occurs, this method is called
* on a closed connection, or the given parameter
* 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 DatabaseMetaData#getResultSetHoldability
* @see ResultSet
@ -704,12 +704,12 @@ public interface Connection extends Wrapper, AutoCloseable {
*savepoint.
*
* @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 on a closed connection
* or this <code>Connection</code> object is currently in
* or this {@code Connection} object is currently in
* auto-commit mode
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see Savepoint
* @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
* @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 on a closed connection
* or this <code>Connection</code> object is currently in
* or this {@code Connection} object is currently in
* auto-commit mode
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see Savepoint
* @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.
*
* @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 on a closed connection,
* the <code>Savepoint</code> object is no longer valid,
* or this <code>Connection</code> object is currently in
* the {@code Savepoint} object is no longer valid,
* or this {@code Connection} object is currently in
* auto-commit mode
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see Savepoint
* @see #rollback
@ -764,11 +764,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* will cause an <code>SQLException</code> to be thrown.
*
* @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
* the given <code>Savepoint</code> object is not a valid
* the given {@code Savepoint} object is not a valid
* 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
* @since 1.4
*/
@ -798,11 +798,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* @return a new <code>Statement</code> object that will generate
* <code>ResultSet</code> objects with the given type,
* 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
* or the given parameters are not <code>ResultSet</code>
* or the given parameters are not {@code ResultSet}
* 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
* set type, result set holdability and result set concurrency.
* @see ResultSet
@ -840,11 +840,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* pre-compiled SQL statement, that will generate
* <code>ResultSet</code> objects with the given type,
* 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
* or the given parameters are not <code>ResultSet</code>
* or the given parameters are not {@code ResultSet}
* 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
* set type, result set holdability and result set concurrency.
* @see ResultSet
@ -880,11 +880,11 @@ public interface Connection extends Wrapper, AutoCloseable {
* pre-compiled SQL statement, that will generate
* <code>ResultSet</code> objects with the given type,
* 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
* or the given parameters are not <code>ResultSet</code>
* or the given parameters are not {@code ResultSet}
* 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
* set type, result set holdability and result set concurrency.
* @see ResultSet
@ -928,12 +928,12 @@ public interface Connection extends Wrapper, AutoCloseable {
* @return a new <code>PreparedStatement</code> object, containing the
* pre-compiled SQL statement, that will have the capability of
* 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
* 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
* 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
* @since 1.4
*/
@ -978,9 +978,9 @@ public interface Connection extends Wrapper, AutoCloseable {
* pre-compiled statement, that is capable of returning the
* auto-generated keys designated by the given array of column
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
*
* @since 1.4
@ -1026,9 +1026,9 @@ public interface Connection extends Wrapper, AutoCloseable {
* pre-compiled statement, that is capable of returning the
* auto-generated keys designated by the given array of column
* 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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
*
* @since 1.4
@ -1045,7 +1045,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* @throws SQLException if an object that implements the
* <code>Clob</code> interface can not be constructed, this method is
* 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
*
* @since 1.6
@ -1061,7 +1061,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* @throws SQLException if an object that implements the
* <code>Blob</code> interface can not be constructed, this method is
* 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
*
* @since 1.6
@ -1077,7 +1077,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* @throws SQLException if an object that implements the
* <code>NClob</code> interface can not be constructed, this method is
* 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
*
* @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
* be constructed, this method is
* 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
* @since 1.6
*/
@ -1116,7 +1116,7 @@ public interface Connection extends Wrapper, AutoCloseable {
* database operation.
*
* @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
* @since 1.6
*
@ -1318,7 +1318,7 @@ throws SQLException;
* {@code Statement} is created or prepared.
*
* @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
* @see #getSchema
* @since 1.7
@ -1329,7 +1329,7 @@ throws SQLException;
* Retrieves this <code>Connection</code> object's current schema name.
*
* @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
* @see #setSchema
* @since 1.7
@ -1455,7 +1455,7 @@ throws SQLException;
* @throws java.lang.SecurityException if a security manager exists and its
* <code>checkPermission</code> method denies calling
* <code>setNetworkTimeout</code>.
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see SecurityManager#checkPermission
* @see Statement#setQueryTimeout
@ -1477,7 +1477,7 @@ throws SQLException;
* no limit
* @throws SQLException if a database access error occurs or
* 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
* @see #setNetworkTimeout
* @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.
*
* 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.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this method is invoked
* @throws java.lang.IllegalArgumentException if this method is invoked
* @see #setHours
*/
@Deprecated(since="1.2")
@ -207,7 +207,7 @@ public class Date extends java.util.Date {
* values do not have a time component.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this method is invoked
* @throws java.lang.IllegalArgumentException if this method is invoked
* @see #setMinutes
*/
@Deprecated(since="1.2")
@ -220,7 +220,7 @@ public class Date extends java.util.Date {
* values do not have a time component.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this method is invoked
* @throws java.lang.IllegalArgumentException if this method is invoked
* @see #setSeconds
*/
@Deprecated(since="1.2")
@ -233,7 +233,7 @@ public class Date extends java.util.Date {
* values do not have a time component.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this method is invoked
* @throws java.lang.IllegalArgumentException if this method is invoked
* @see #getHours
*/
@Deprecated(since="1.2")
@ -246,7 +246,7 @@ public class Date extends java.util.Date {
* values do not have a time component.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this method is invoked
* @throws java.lang.IllegalArgumentException if this method is invoked
* @see #getMinutes
*/
@Deprecated(since="1.2")
@ -259,7 +259,7 @@ public class Date extends java.util.Date {
* values do not have a time component.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this method is invoked
* @throws java.lang.IllegalArgumentException if this method is invoked
* @see #getSeconds
*/
@Deprecated(since="1.2")
@ -283,7 +283,7 @@ public class Date extends java.util.Date {
*
* @param date a {@code LocalDate} to convert
* @return a {@code Date} object
* @exception NullPointerException if {@code date} is null
* @throws NullPointerException if {@code date} is null
* @since 1.8
*/
@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
* component.
*
* @exception java.lang.UnsupportedOperationException if this method is invoked
* @throws java.lang.UnsupportedOperationException if this method is invoked
*/
@Override
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.
*
* 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.
* @return a <code>Connection</code> object that represents 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}
*/
Connection connect(String url, java.util.Properties info)
@ -100,7 +100,7 @@ public interface Driver {
* @param url the URL of the database
* @return <code>true</code> if this driver understands the given URL;
* <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}
*/
boolean acceptsURL(String url) throws SQLException;
@ -123,7 +123,7 @@ public interface Driver {
* @return an array of <code>DriverPropertyInfo</code> objects describing
* possible properties. This array may be an empty array if
* 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)
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
* "password" property should be included
* @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}
* @throws SQLTimeoutException when the driver has determined that the
* timeout value specified by the {@code setLoginTimeout} method
@ -206,7 +206,7 @@ public class DriverManager {
* made
* @param password the user's password
* @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}
* @throws SQLTimeoutException when the driver has determined that the
* timeout value specified by the {@code setLoginTimeout} method
@ -236,7 +236,7 @@ public class DriverManager {
* @param url a database url of the form
* <code> jdbc:<em>subprotocol</em>:<em>subname</em></code>
* @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}
* @throws SQLTimeoutException when the driver has determined that the
* timeout value specified by the {@code setLoginTimeout} method
@ -260,7 +260,7 @@ public class DriverManager {
* <code>jdbc:<em>subprotocol</em>:<em>subname</em></code>
* @return a <code>Driver</code> object representing a driver
* that can connect to the given URL
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
*/
@CallerSensitive
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
* {@code DriverManager}
* @exception SQLException if a database access error occurs
* @exception NullPointerException if {@code driver} is null
* @throws SQLException if a database access error occurs
* @throws NullPointerException if {@code driver} is null
*/
public static void registerDriver(java.sql.Driver driver)
throws SQLException {
@ -328,8 +328,8 @@ public class DriverManager {
* {@code DriverManager}
* @param da the {@code DriverAction} implementation to be used when
* {@code DriverManager#deregisterDriver} is called
* @exception SQLException if a database access error occurs
* @exception NullPointerException if {@code driver} is null
* @throws SQLException if a database access error occurs
* @throws NullPointerException if {@code driver} is null
* @since 1.8
*/
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.
*
* @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
* {@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.
*
* This code is free software; you can redistribute it and/or modify it
@ -48,7 +48,7 @@ public interface ParameterMetaData extends Wrapper {
* information.
*
* @return the number of parameters
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @since 1.4
*/
int getParameterCount() throws SQLException;
@ -61,7 +61,7 @@ public interface ParameterMetaData extends Wrapper {
* <code>ParameterMetaData.parameterNoNulls</code>,
* <code>ParameterMetaData.parameterNullable</code>, or
* <code>ParameterMetaData.parameterNullableUnknown</code>
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @since 1.4
*/
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, ...
* @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
*/
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, ...
* @return precision
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @since 1.4
*/
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, ...
* @return scale
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @since 1.4
*/
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, ...
* @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
* @see Types
*/
@ -139,7 +139,7 @@ public interface ParameterMetaData extends Wrapper {
* @param param the first parameter is 1, the second is 2, ...
* @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.
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @since 1.4
*/
String getParameterTypeName(int param) throws SQLException;
@ -155,7 +155,7 @@ public interface ParameterMetaData extends Wrapper {
* <code>PreparedStatement.setObject</code> to set the value
* in the specified parameter. 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.4
*/
String getParameterClassName(int param) throws SQLException;
@ -189,7 +189,7 @@ public interface ParameterMetaData extends Wrapper {
* <code>ParameterMetaData.parameterModeOut</code>, or
* <code>ParameterMetaData.parameterModeInOut</code>
* <code>ParameterMetaData.parameterModeUnknown</code>.
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @since 1.4
*/
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.
*
* 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
* query; never <code>null</code>
* @exception SQLException if a database access error occurs;
* this method is called on a closed <code>PreparedStatement</code> or the SQL
* statement does not return a <code>ResultSet</code> object
* @throws SQLException if a database access error occurs;
* this method is called on a closed {@code PreparedStatement} or the SQL
* statement does not return a {@code ResultSet} object
* @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout}
* 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
* or (2) 0 for SQL statements that return nothing
* @exception SQLException if a database access error occurs;
* this method is called on a closed <code>PreparedStatement</code>
* or the SQL statement returns a <code>ResultSet</code> object
* @throws SQLException if a database access error occurs;
* this method is called on a closed {@code PreparedStatement}
* or the SQL statement returns a {@code ResultSet} object
* @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout}
* 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 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
* this method is called on a closed <code>PreparedStatement</code>
* @exception SQLFeatureNotSupportedException if <code>sqlType</code> is
* a <code>ARRAY</code>, <code>BLOB</code>, <code>CLOB</code>,
* <code>DATALINK</code>, <code>JAVA_OBJECT</code>, <code>NCHAR</code>,
* <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>,
* <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code>
* or <code>STRUCT</code> data type and the JDBC driver does not support
* this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if {@code sqlType} is
* a {@code ARRAY}, {@code BLOB}, {@code CLOB},
* {@code DATALINK}, {@code JAVA_OBJECT}, {@code NCHAR},
* {@code NCLOB}, {@code NVARCHAR}, {@code LONGNVARCHAR},
* {@code REF}, {@code ROWID}, {@code SQLXML}
* or {@code STRUCT} data type and the JDBC driver does not support
* this data type
*/
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 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
* 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;
@ -137,9 +137,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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;
@ -150,9 +150,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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;
@ -163,9 +163,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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;
@ -176,9 +176,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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;
@ -189,9 +189,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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;
@ -202,9 +202,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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;
@ -215,9 +215,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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;
@ -231,9 +231,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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;
@ -245,9 +245,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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;
@ -260,9 +260,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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)
throws SQLException;
@ -274,9 +274,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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)
throws SQLException;
@ -289,9 +289,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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)
throws SQLException;
@ -311,9 +311,9 @@ public interface PreparedStatement extends Statement {
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the Java input stream that contains the ASCII parameter value
* @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
* 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)
throws SQLException;
@ -339,10 +339,10 @@ public interface PreparedStatement extends Statement {
* @param x a <code>java.io.InputStream</code> object that contains the
* Unicode parameter value
* @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
* this method is called on a closed <code>PreparedStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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 x the java input stream which contains the binary parameter value
* @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
* 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,
int length) throws SQLException;
@ -380,8 +380,8 @@ public interface PreparedStatement extends Statement {
* release the resources used by the current parameter values; this can
* be done by calling the method <code>clearParameters</code>.
*
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code PreparedStatement}
*/
void clearParameters() throws SQLException;
@ -399,10 +399,10 @@ public interface PreparedStatement extends Statement {
* @param x the object containing the input parameter value
* @param targetSqlType the SQL type (as defined in java.sql.Types) to be
* 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
* method is called on a closed PreparedStatement
* @exception SQLFeatureNotSupportedException if
* @throws SQLFeatureNotSupportedException if
* the JDBC driver does not support the specified targetSqlType
* @see Types
*/
@ -441,9 +441,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
* 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
*/
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>
* object; <code>false</code> if the first result is an update
* count or there is no result
* @exception SQLException if a database access error occurs;
* this method is called on a closed <code>PreparedStatement</code>
* @throws SQLException if a database access error occurs;
* this method is called on a closed {@code PreparedStatement}
* or an argument is supplied to this method
* @throws SQLTimeoutException when the driver has determined that the
* 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>
* object's batch of commands.
*
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code PreparedStatement}
* @see Statement#addBatch
* @since 1.2
*/
@ -510,9 +510,9 @@ public interface PreparedStatement extends Statement {
* @param reader the <code>java.io.Reader</code> object that contains the
* Unicode data
* @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
* this method is called on a closed <code>PreparedStatement</code>
* this method is called on a closed {@code PreparedStatement}
* @since 1.2
*/
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 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
* 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
* @since 1.2
*/
@ -542,9 +542,9 @@ public interface PreparedStatement extends Statement {
*
* @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
* @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 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
* @since 1.2
*/
@ -557,9 +557,9 @@ public interface PreparedStatement extends Statement {
*
* @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
* @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 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
* @since 1.2
*/
@ -572,9 +572,9 @@ public interface PreparedStatement extends Statement {
*
* @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
* @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 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
* @since 1.2
*/
@ -600,9 +600,9 @@ public interface PreparedStatement extends Statement {
* @return the description of a <code>ResultSet</code> object's columns or
* <code>null</code> if the driver cannot return a
* <code>ResultSetMetaData</code> object
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -622,9 +622,9 @@ public interface PreparedStatement extends Statement {
* @param x the parameter value
* @param cal the <code>Calendar</code> object the driver will use
* 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
* this method is called on a closed <code>PreparedStatement</code>
* this method is called on a closed {@code PreparedStatement}
* @since 1.2
*/
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 cal the <code>Calendar</code> object the driver will use
* 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
* this method is called on a closed <code>PreparedStatement</code>
* this method is called on a closed {@code PreparedStatement}
* @since 1.2
*/
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 cal the <code>Calendar</code> object the driver will use
* 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
* this method is called on a closed <code>PreparedStatement</code>
* this method is called on a closed {@code PreparedStatement}
* @since 1.2
*/
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 typeName the fully-qualified name of an SQL user-defined type;
* 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
* this method is called on a closed <code>PreparedStatement</code>
* @exception SQLFeatureNotSupportedException if <code>sqlType</code> is
* a <code>ARRAY</code>, <code>BLOB</code>, <code>CLOB</code>,
* <code>DATALINK</code>, <code>JAVA_OBJECT</code>, <code>NCHAR</code>,
* <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>,
* <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code>
* or <code>STRUCT</code> data type and the JDBC driver does not support
* this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if {@code sqlType} is
* a {@code ARRAY}, {@code BLOB}, {@code CLOB},
* {@code DATALINK}, {@code JAVA_OBJECT}, {@code NCHAR},
* {@code NCLOB}, {@code NVARCHAR}, {@code LONGNVARCHAR},
* {@code REF}, {@code ROWID}, {@code SQLXML}
* 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
* @since 1.2
*/
@ -723,9 +723,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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
* @since 1.4
*/
@ -738,8 +738,8 @@ public interface PreparedStatement extends Statement {
* @return a <code>ParameterMetaData</code> object that contains information
* about the number, types and properties for each
* parameter marker of this <code>PreparedStatement</code> object
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code PreparedStatement}
* @see ParameterMetaData
* @since 1.4
*/
@ -946,13 +946,13 @@ public interface PreparedStatement extends Statement {
* this is the length
* of the data in the stream or reader. For all other types,
* 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;
* 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
* or Reader object and the value of the scale parameter is less
* than zero
* @exception SQLFeatureNotSupportedException if
* @throws SQLFeatureNotSupportedException if
* the JDBC driver does not support the specified targetSqlType
* @see Types
*
@ -975,9 +975,9 @@ public interface PreparedStatement extends Statement {
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the Java input stream that contains the ASCII parameter value
* @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
* this method is called on a closed <code>PreparedStatement</code>
* this method is called on a closed {@code PreparedStatement}
* @since 1.6
*/
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 x the java input stream which contains the binary parameter value
* @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
* this method is called on a closed <code>PreparedStatement</code>
* this method is called on a closed {@code PreparedStatement}
* @since 1.6
*/
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
* Unicode data
* @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
* this method is called on a closed <code>PreparedStatement</code>
* this method is called on a closed {@code PreparedStatement}
* @since 1.6
*/
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 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
* 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
* @since 1.6
*/
@ -1071,9 +1071,9 @@ public interface PreparedStatement extends Statement {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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
* 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
* @since 1.6
*/
@ -1098,9 +1098,9 @@ public interface PreparedStatement extends Statement {
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @param reader the <code>java.io.Reader</code> object that contains the
* 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
* 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
* @since 1.6
*/
@ -1250,13 +1250,13 @@ public interface PreparedStatement extends Statement {
* this is the length
* of the data in the stream or reader. For all other types,
* 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
* or this method is called on a closed {@code PreparedStatement} or
* if the Java Object specified by x is an InputStream
* or Reader object and the value of the scale parameter is less
* than zero
* @exception SQLFeatureNotSupportedException if
* @throws SQLFeatureNotSupportedException if
* the JDBC driver does not support the specified targetSqlType
* @see JDBCType
* @see SQLType
@ -1279,10 +1279,10 @@ public interface PreparedStatement extends Statement {
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the object containing the input parameter value
* @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
* 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
* @see JDBCType
* @see SQLType
@ -1307,9 +1307,9 @@ public interface PreparedStatement extends Statement {
*
* @return either (1) the row count for SQL Data Manipulation Language
* (DML) statements or (2) 0 for SQL statements that return nothing
* @exception SQLException if a database access error occurs;
* this method is called on a closed <code>PreparedStatement</code>
* or the SQL statement returns a <code>ResultSet</code> object
* @throws SQLException if a database access error occurs;
* this method is called on a closed {@code PreparedStatement}
* or the SQL statement returns a {@code ResultSet} object
* @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout}
* 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.
*
* 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.
*
* @return the fully-qualified SQL name of the referenced SQL structured type
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -77,8 +77,8 @@ public interface Ref {
* @return a Java <code>Object</code> that is the custom mapping for
* the SQL structured type to which this <code>Ref</code>
* object refers
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.4
* @see #setObject
@ -96,8 +96,8 @@ public interface Ref {
* @return a Java <code>Object</code> that is the mapping for
* the SQL structured type to which this <code>Ref</code>
* object refers
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.4
* @see #setObject
@ -113,8 +113,8 @@ public interface Ref {
* @param value an <code>Object</code> representing the SQL
* structured type instance that this
* <code>Ref</code> object will reference
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.4
* @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.
*
* 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.
*
* @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;
@ -59,7 +59,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @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;
@ -68,7 +68,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @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;
@ -77,7 +77,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @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;
@ -86,7 +86,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @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;
@ -96,7 +96,7 @@ public interface ResultSetMetaData extends Wrapper {
* @param column the first column is 1, the second is 2, ...
* @return the nullability status of the given column; one of <code>columnNoNulls</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;
@ -123,7 +123,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @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;
@ -133,7 +133,7 @@ public interface ResultSetMetaData extends Wrapper {
* @param column the first column is 1, the second is 2, ...
* @return the normal maximum number of characters allowed as the width
* 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;
@ -146,7 +146,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @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;
@ -155,7 +155,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @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;
@ -164,7 +164,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @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;
@ -178,7 +178,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @return precision
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
*/
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, ...
* @return scale
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
*/
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, ...
* @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;
@ -207,7 +207,7 @@ public interface ResultSetMetaData extends Wrapper {
* @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
* 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;
@ -216,7 +216,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @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
*/
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, ...
* @return type name used by the database. If the column type is
* 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;
@ -236,7 +236,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @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;
@ -245,7 +245,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @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;
@ -254,7 +254,7 @@ public interface ResultSetMetaData extends Wrapper {
*
* @param column the first column is 1, the second is 2, ...
* @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;
@ -272,7 +272,7 @@ public interface ResultSetMetaData extends Wrapper {
* language that would be used by the method
* <code>ResultSet.getObject</code> to retrieve the value in the specified
* 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
*/
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.
*
* 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>
* when this object was constructed and populated
* @exception SQLException if there is a database access error
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if there is a database access error
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -104,8 +104,8 @@ public interface SQLData {
* @param stream the <code>SQLInput</code> object from which to read the data for
* the value that is being custom mapped
* @param typeName the SQL type name of the value on the data stream
* @exception SQLException if there is a database access error
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if there is a database access error
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see SQLInput
* @since 1.2
@ -127,8 +127,8 @@ public interface SQLData {
*
* @param stream the <code>SQLOutput</code> object to which to write the data for
* the value that was custom mapped
* @exception SQLException if there is a database access error
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if there is a database access error
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see SQLOutput
* @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.
*
* 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.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -79,8 +79,8 @@ public interface SQLInput {
* in the Java programming language.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>false</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -91,8 +91,8 @@ public interface SQLInput {
* in the Java programming language.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -103,8 +103,8 @@ public interface SQLInput {
* in the Java programming language.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -115,8 +115,8 @@ public interface SQLInput {
* in the Java programming language.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -127,8 +127,8 @@ public interface SQLInput {
* in the Java programming language.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -139,8 +139,8 @@ public interface SQLInput {
* in the Java programming language.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -151,8 +151,8 @@ public interface SQLInput {
* in the Java programming language.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>0</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -163,8 +163,8 @@ public interface SQLInput {
* object in the Java programming language.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -175,8 +175,8 @@ public interface SQLInput {
* in the Java programming language.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -242,8 +242,8 @@ public interface SQLInput {
* bytes.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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
* Java programming language;<code>null</code> if the datum is SQL <code>NULL</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -286,8 +286,8 @@ public interface SQLInput {
* @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
* SQL <code>NULL</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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
* at the head of the stream; <code>null</code> if the value read is
* SQL <code>NULL</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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
* at the head of the stream; <code>null</code> if the value read is
* SQL <code>NULL</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -328,8 +328,8 @@ public interface SQLInput {
* @return an <code>Array</code> object representing data of the SQL
* <code>ARRAY</code> value at the head of the stream; <code>null</code>
* if the value read is SQL <code>NULL</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -340,9 +340,9 @@ public interface SQLInput {
*
* @return <code>true</code> if the most recently read SQL value was SQL
* <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
* @since 1.2
*/
@ -355,9 +355,9 @@ public interface SQLInput {
* <code>java.net.URL</code> object in the Java programming language.
*
* @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
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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
* at the head of the stream; <code>null</code> if the value read is
* SQL <code>NULL</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.6
*/
@ -386,8 +386,8 @@ public interface SQLInput {
* and <code>LONGNVARCHAR</code> columns.
*
* @return the attribute; if the value is SQL <code>NULL</code>, returns <code>null</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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
* at the head of the stream; <code>null</code> if the value read is
* SQL <code>NULL</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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
* at the head of the stream; <code>null</code> if the value read is
* SQL <code>NULL</code>
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.6
*/
@ -448,8 +448,8 @@ public interface SQLInput {
* @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
* Java programming language;{@code null} if the attribute is SQL {@code NULL}
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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.
*
* 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.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -72,8 +72,8 @@ package java.sql;
* in the Java programming language.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -85,8 +85,8 @@ package java.sql;
* in the Java programming language.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -98,8 +98,8 @@ package java.sql;
* in the Java programming language.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -111,8 +111,8 @@ package java.sql;
* in the Java programming language.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -124,8 +124,8 @@ package java.sql;
* in the Java programming language.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -137,8 +137,8 @@ package java.sql;
* in the Java programming language.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -150,8 +150,8 @@ package java.sql;
* in the Java programming language.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -163,8 +163,8 @@ package java.sql;
* in the Java programming language.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -176,8 +176,8 @@ package java.sql;
* in the Java programming language.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -189,8 +189,8 @@ package java.sql;
* in the Java programming language.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -202,8 +202,8 @@ package java.sql;
* in the Java programming language.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -215,8 +215,8 @@ package java.sql;
* in the Java programming language.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -226,8 +226,8 @@ package java.sql;
* Writes the next attribute to the stream as a stream of Unicode characters.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -237,8 +237,8 @@ package java.sql;
* Writes the next attribute to the stream as a stream of ASCII characters.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -249,8 +249,8 @@ package java.sql;
* bytes.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -282,8 +282,8 @@ package java.sql;
*
* @param x the object representing data of an SQL structured or
* distinct type
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -294,8 +294,8 @@ package java.sql;
*
* @param x a <code>Ref</code> object representing data of an SQL
* <code>REF</code> value
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -307,8 +307,8 @@ package java.sql;
* @param x a <code>Blob</code> object representing data of an SQL
* <code>BLOB</code> value
*
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -320,8 +320,8 @@ package java.sql;
* @param x a <code>Clob</code> object representing data of an SQL
* <code>CLOB</code> value
*
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -333,8 +333,8 @@ package java.sql;
* @param x a <code>Struct</code> object representing data of an SQL
* structured type
*
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -346,8 +346,8 @@ package java.sql;
* @param x an <code>Array</code> object representing data of an SQL
* <code>ARRAY</code> type
*
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -361,8 +361,8 @@ package java.sql;
* @param x a <code>java.net.URL</code> object representing the data
* of SQL DATALINK type
*
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.4
*/
@ -380,8 +380,8 @@ package java.sql;
* when it sends it to the stream.
*
* @param x the value to pass to the database
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.6
*/
@ -393,8 +393,8 @@ package java.sql;
* @param x a <code>NClob</code> object representing data of an SQL
* <code>NCLOB</code> value
*
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.6
*/
@ -407,8 +407,8 @@ package java.sql;
* @param x a <code>RowId</code> object representing data of an SQL
* <code>ROWID</code> value
*
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.6
*/
@ -427,7 +427,7 @@ package java.sql;
* 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
* 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
* @since 1.6
*/
@ -457,11 +457,11 @@ package java.sql;
*
* @param x the object containing the input parameter value
* @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
* or Reader object and the value of the scale parameter is less
* than zero
* @exception SQLFeatureNotSupportedException if
* @throws SQLFeatureNotSupportedException if
* the JDBC driver does not support this data type
* @see JDBCType
* @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.
*
* 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
* calls to <code>free</code> are treated as a no-op.
* @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
* @since 1.6
*/
@ -218,7 +218,7 @@ public interface SQLXML
* @return a stream containing the XML data.
* @throws SQLException if there is an error processing the XML value.
* 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
* @since 1.6
*/
@ -237,7 +237,7 @@ public interface SQLXML
* @return a stream to which data can be written.
* @throws SQLException if there is an error processing the XML value.
* 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
* @since 1.6
*/
@ -261,7 +261,7 @@ public interface SQLXML
* The getCause() method of the exception may provide a more detailed exception, for example,
* if the stream does not contain valid characters.
* 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
* @since 1.6
*/
@ -285,7 +285,7 @@ public interface SQLXML
* The getCause() method of the exception may provide a more detailed exception, for example,
* if the stream does not contain valid characters.
* 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
* @since 1.6
*/
@ -309,7 +309,7 @@ public interface SQLXML
* The getCause() method of the exception may provide a more detailed exception, for example,
* if the stream does not contain valid characters.
* 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
* @since 1.6
*/
@ -333,7 +333,7 @@ public interface SQLXML
* The getCause() method of the exception may provide a more detailed exception, for example,
* if the stream does not contain valid characters.
* 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
* @since 1.6
*/
@ -376,7 +376,7 @@ public interface SQLXML
* The getCause() method of the exception may provide a more detailed exception, for example,
* if an XML parser exception occurs.
* 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
* @since 1.6
*/
@ -418,7 +418,7 @@ public interface SQLXML
* The getCause() method of the exception may provide a more detailed exception, for example,
* if an XML parser exception occurs.
* 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
* @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.
*
* 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
* <code>Savepoint</code> object represents.
* @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
*/
int getSavepointId() throws SQLException;
@ -53,7 +53,7 @@ public interface Savepoint {
* Retrieves the name of the savepoint that this <code>Savepoint</code>
* object represents.
* @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
*/
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.
*
* 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
* @return a <code>ResultSet</code> object that contains the data produced
* by the given query; never <code>null</code>
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the given
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}, the given
* SQL statement produces anything other than a single
* <code>ResultSet</code> object, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code>
* {@code ResultSet} object, the method is called on a
* {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout}
* 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
* or (2) 0 for SQL statements that return nothing
*
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the given
* SQL statement produces a <code>ResultSet</code> object, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code>
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}, the given
* SQL statement produces a {@code ResultSet} object, the method is called on a
* {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout}
* 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
* also closed.
*
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
*/
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
* binary values; zero means there is no limit
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @see #setMaxFieldSize
*/
int getMaxFieldSize() throws SQLException;
@ -146,8 +146,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* greater than 256.
*
* @param max the new column size limit in bytes; zero means there is no limit
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}
* or the condition {@code max >= 0} is not satisfied
* @see #getMaxFieldSize
*/
@ -162,8 +162,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return the current maximum number of rows for a <code>ResultSet</code>
* object produced by this <code>Statement</code> object;
* zero means there is no limit
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @see #setMaxRows
*/
int getMaxRows() throws SQLException;
@ -176,8 +176,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* rows are silently dropped.
*
* @param max the new max rows limit; zero means there is no limit
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}
* or the condition {@code max >= 0} is not satisfied
* @see #getMaxRows
*/
@ -202,8 +202,8 @@ public interface Statement extends Wrapper, AutoCloseable {
*
* @param enable <code>true</code> to enable escape processing;
* <code>false</code> to disable it
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
*/
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
* no limit
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @see #setQueryTimeout
*/
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
* there is no limit
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}
* or the condition {@code seconds >= 0} is not satisfied
* @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
* is being executed by another thread.
*
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
*/
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>
* if there are no warnings
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
*/
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>Statement</code> object.
*
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
*/
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
* a connection
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
*/
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>
* object; <code>false</code> if it is an update count or there are
* no results
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>,
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement},
* 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
* timeout value that was specified by the {@code setQueryTimeout}
* 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
* <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
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @see #execute
*/
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
* <code>ResultSet</code> object or there are no more results
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @see #execute
*/
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>
* object; <code>false</code> if it is an update count or there are
* no more results
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @see #execute
*/
boolean getMoreResults() throws SQLException;
@ -419,11 +419,11 @@ public interface Statement extends Wrapper, AutoCloseable {
* its own fetch direction.
*
* @param direction the initial direction for processing rows
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}
* or the given direction
* is not one of <code>ResultSet.FETCH_FORWARD</code>,
* <code>ResultSet.FETCH_REVERSE</code>, or <code>ResultSet.FETCH_UNKNOWN</code>
* is not one of {@code ResultSet.FETCH_FORWARD},
* {@code ResultSet.FETCH_REVERSE}, or {@code ResultSet.FETCH_UNKNOWN}
* @since 1.2
* @see #getFetchDirection
*/
@ -439,8 +439,8 @@ public interface Statement extends Wrapper, AutoCloseable {
*
* @return the default fetch direction for result sets generated
* from this <code>Statement</code> object
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @since 1.2
* @see #setFetchDirection
*/
@ -454,8 +454,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* The default value is zero.
*
* @param rows the number of rows to fetch
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> or the
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement} or the
* condition {@code rows >= 0} is not satisfied.
* @since 1.2
* @see #getFetchSize
@ -472,8 +472,8 @@ public interface Statement extends Wrapper, AutoCloseable {
*
* @return the default fetch size for result sets generated
* from this <code>Statement</code> object
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @since 1.2
* @see #setFetchSize
*/
@ -485,8 +485,8 @@ public interface Statement extends Wrapper, AutoCloseable {
*
* @return either <code>ResultSet.CONCUR_READ_ONLY</code> or
* <code>ResultSet.CONCUR_UPDATABLE</code>
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @since 1.2
*/
int getResultSetConcurrency() throws SQLException;
@ -498,8 +498,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return one of <code>ResultSet.TYPE_FORWARD_ONLY</code>,
* <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or
* <code>ResultSet.TYPE_SCROLL_SENSITIVE</code>
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @since 1.2
*/
int getResultSetType() throws SQLException;
@ -513,10 +513,10 @@ public interface Statement extends Wrapper, AutoCloseable {
* <code>PreparedStatement</code> or <code>CallableStatement</code>.
* @param sql typically this is a SQL <code>INSERT</code> or
* <code>UPDATE</code> statement
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}, the
* 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 DatabaseMetaData#supportsBatchUpdates
* @since 1.2
@ -527,8 +527,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* Empties this <code>Statement</code> object's current list of
* SQL commands.
*
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> or the
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement} or the
* driver does not support batch updates
* @see #addBatch
* @see DatabaseMetaData#supportsBatchUpdates
@ -577,10 +577,10 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return an array of update counts containing one element for each
* command in the batch. The elements of the array are ordered according
* to the order in which commands were added to the batch.
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> or the
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement} or the
* 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.
* @throws SQLTimeoutException when the driver has determined that the
* 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
* that produced this <code>Statement</code> object.
* @return the connection that produced this statement
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @since 1.2
*/
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>
* object; <code>false</code> if it is an update count or there are no
* more results
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> or the argument
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement} or the argument
* supplied is not one of the following:
* <code>Statement.CLOSE_CURRENT_RESULT</code>,
* <code>Statement.KEEP_CURRENT_RESULT</code> or
* <code>Statement.CLOSE_ALL_RESULTS</code>
*@exception SQLFeatureNotSupportedException if
* <code>DatabaseMetaData.supportsMultipleOpenResults</code> returns
* <code>false</code> and either
* <code>Statement.KEEP_CURRENT_RESULT</code> or
* <code>Statement.CLOSE_ALL_RESULTS</code> are supplied as
* {@code Statement.CLOSE_CURRENT_RESULT},
* {@code Statement.KEEP_CURRENT_RESULT} or
* {@code Statement.CLOSE_ALL_RESULTS}
*@throws SQLFeatureNotSupportedException if
* {@code DatabaseMetaData.supportsMultipleOpenResults} returns
* {@code false} and either
* {@code Statement.KEEP_CURRENT_RESULT} or
* {@code Statement.CLOSE_ALL_RESULTS} are supplied as
* the argument.
* @since 1.4
* @see #execute
@ -712,8 +712,8 @@ public interface Statement extends Wrapper, AutoCloseable {
*
* @return a <code>ResultSet</code> object containing the auto-generated key(s)
* generated by the execution of this <code>Statement</code> object
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @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
* or (2) 0 for SQL statements that return nothing
*
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the given
* SQL statement returns a <code>ResultSet</code> object,
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}, the given
* SQL statement returns a {@code ResultSet} object,
* the given constant is not one of those allowed, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method with a constant of Statement.RETURN_GENERATED_KEYS
* @throws SQLTimeoutException when the driver has determined that the
* 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
* or (2) 0 for SQL statements that return nothing
*
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the SQL
* statement returns a <code>ResultSet</code> object,the second argument
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}, the SQL
* statement returns a {@code ResultSet} object,the second argument
* supplied to this method is not an
* <code>int</code> array whose elements are valid column indexes, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code>
* {@code int} array whose elements are valid column indexes, the method is called on a
* {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @throws SQLTimeoutException when the driver has determined that the
* 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>,
* or <code>DELETE</code> statements, or 0 for SQL statements
* that return nothing
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the SQL
* statement returns a <code>ResultSet</code> object, the
* second argument supplied to this method is not a <code>String</code> array
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}, the SQL
* statement returns a {@code ResultSet} object, the
* second argument supplied to this method is not a {@code String} array
* 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 SQLTimeoutException when the driver has determined that the
* 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>
* object; <code>false</code> if it is an update count or there are
* no results
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the second
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}, the second
* parameter supplied to this method is not
* <code>Statement.RETURN_GENERATED_KEYS</code> or
* <code>Statement.NO_GENERATED_KEYS</code>,
* {@code Statement.RETURN_GENERATED_KEYS} or
* {@code Statement.NO_GENERATED_KEYS},
* the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method with a constant of Statement.RETURN_GENERATED_KEYS
* @throws SQLTimeoutException when the driver has determined that the
* 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>
* object; <code>false</code> if it is an update count or there
* are no results
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the
* elements in the <code>int</code> array passed to this method
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}, the
* elements in the {@code int} array passed to this method
* 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 SQLTimeoutException when the driver has determined that the
* 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>
* object; <code>false</code> if it is an update count or there
* are no more results
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>,the
* elements of the <code>String</code> array passed to this
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement},the
* elements of the {@code String} array passed to this
* 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 SQLTimeoutException when the driver has determined that the
* 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
* <code>ResultSet.CLOSE_CURSORS_AT_COMMIT</code>
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
*
* @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
* is a <code>ResultSet</code> object or there are no more results
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @see #execute
* @since 1.8
*/
@ -1109,8 +1109,8 @@ public interface Statement extends Wrapper, AutoCloseable {
* The default implementation will throw {@code UnsupportedOperationException}
*
* @param max the new max rows limit; zero means there is no limit
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}
* or the condition {@code max >= 0} is not satisfied
* @see #getMaxRows
* @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>
* object produced by this <code>Statement</code> object;
* zero means there is no limit
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>Statement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code Statement}
* @see #setMaxRows
* @since 1.8
*/
@ -1183,10 +1183,10 @@ public interface Statement extends Wrapper, AutoCloseable {
* @return an array of update counts containing one element for each
* command in the batch. The elements of the array are ordered according
* to the order in which commands were added to the batch.
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code> or the
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement} or the
* 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.
* @throws SQLTimeoutException when the driver has determined that the
* 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
* (DML) statements or (2) 0 for SQL statements that return nothing
*
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the given
* SQL statement produces a <code>ResultSet</code> object, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code>
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}, the given
* SQL statement produces a {@code ResultSet} object, the method is called on a
* {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLTimeoutException when the driver has determined that the
* timeout value that was specified by the {@code setQueryTimeout}
* 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
* or (2) 0 for SQL statements that return nothing
*
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the given
* SQL statement returns a <code>ResultSet</code> object,
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}, the given
* SQL statement returns a {@code ResultSet} object,
* the given constant is not one of those allowed, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method with a constant of Statement.RETURN_GENERATED_KEYS
* @throws SQLTimeoutException when the driver has determined that the
* 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
* or (2) 0 for SQL statements that return nothing
*
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the SQL
* statement returns a <code>ResultSet</code> object,the second argument
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}, the SQL
* statement returns a {@code ResultSet} object,the second argument
* supplied to this method is not an
* <code>int</code> array whose elements are valid column indexes, the method is called on a
* <code>PreparedStatement</code> or <code>CallableStatement</code>
* {@code int} array whose elements are valid column indexes, the method is called on a
* {@code PreparedStatement} or {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @throws SQLTimeoutException when the driver has determined that the
* 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>,
* or <code>DELETE</code> statements, or 0 for SQL statements
* that return nothing
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>Statement</code>, the SQL
* statement returns a <code>ResultSet</code> object, the
* second argument supplied to this method is not a <code>String</code> array
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code Statement}, the SQL
* statement returns a {@code ResultSet} object, the
* second argument supplied to this method is not a {@code String} array
* 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 SQLTimeoutException when the driver has determined that the
* 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.
*
* 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
* type for which this <code>Struct</code> object
* is the generic representation
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -71,8 +71,8 @@ public interface Struct {
* the result.
*
* @return an array containing the ordered attribute values
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.2
*/
@ -96,8 +96,8 @@ public interface Struct {
*
* @param map a mapping of SQL type names to Java classes
* @return an array containing the ordered attribute values
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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.
*
* 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.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this
* @throws java.lang.IllegalArgumentException if this
* method is invoked
* @see #setYear
*/
@ -154,7 +154,7 @@ public class Time extends java.util.Date {
* values do not have a month component.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this
* @throws java.lang.IllegalArgumentException if this
* method is invoked
* @see #setMonth
*/
@ -168,7 +168,7 @@ public class Time extends java.util.Date {
* values do not have a day component.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this
* @throws java.lang.IllegalArgumentException if this
* method is invoked
*/
@Deprecated(since="1.2")
@ -181,7 +181,7 @@ public class Time extends java.util.Date {
* values do not have a date component.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this
* @throws java.lang.IllegalArgumentException if this
* method is invoked
* @see #setDate
*/
@ -195,7 +195,7 @@ public class Time extends java.util.Date {
* values do not have a year component.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this
* @throws java.lang.IllegalArgumentException if this
* method is invoked
* @see #getYear
*/
@ -209,7 +209,7 @@ public class Time extends java.util.Date {
* values do not have a month component.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this
* @throws java.lang.IllegalArgumentException if this
* method is invoked
* @see #getMonth
*/
@ -223,7 +223,7 @@ public class Time extends java.util.Date {
* values do not have a date component.
*
* @deprecated
* @exception java.lang.IllegalArgumentException if this
* @throws java.lang.IllegalArgumentException if this
* method is invoked
* @see #getDate
*/
@ -246,7 +246,7 @@ public class Time extends java.util.Date {
*
* @param time a {@code LocalTime} to convert
* @return a {@code Time} object
* @exception NullPointerException if {@code time} is null
* @throws NullPointerException if {@code time} is null
* @since 1.8
*/
@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
* component.
*
* @exception java.lang.UnsupportedOperationException if this method is invoked
* @throws java.lang.UnsupportedOperationException if this method is invoked
*/
@Override
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.
*
* 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 nano 0 to 999,999,999
* @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")
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.
*
* @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...]}
*/
public static Timestamp valueOf(String s) {
@ -327,7 +327,7 @@ public class Timestamp extends java.util.Date {
* to the given value.
*
* @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
* @see #getNanos
*/
@ -490,7 +490,7 @@ public class Timestamp extends java.util.Date {
*
* @param dateTime a {@code LocalDateTime} to convert
* @return a {@code Timestamp} object
* @exception NullPointerException if {@code dateTime} is null.
* @throws NullPointerException if {@code dateTime} is null.
* @since 1.8
*/
@SuppressWarnings("deprecation")
@ -535,8 +535,8 @@ public class Timestamp extends java.util.Date {
* @param instant the instant to convert
* @return an {@code Timestamp} representing the same point on the time-line as
* the provided instant
* @exception NullPointerException if {@code instant} is null.
* @exception IllegalArgumentException if the instant is too large to
* @throws NullPointerException if {@code instant} is null.
* @throws IllegalArgumentException if the instant is too large to
* represent as a {@code Timestamp}
* @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.
*
* 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
* 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
*/
java.io.PrintWriter getLogWriter() throws SQLException;
@ -76,7 +76,7 @@ public interface CommonDataSource {
* disabled.
*
* @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
*/
void setLogWriter(java.io.PrintWriter out) throws SQLException;
@ -90,7 +90,7 @@ public interface CommonDataSource {
* initially zero.
*
* @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
*/
void setLoginTimeout(int seconds) throws SQLException;
@ -104,7 +104,7 @@ public interface CommonDataSource {
* initially zero.
*
* @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
*/
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.
*
* 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
* connection to the database that this
* <code>ConnectionPoolDataSource</code> object represents
* @exception SQLException if a database access error occurs
* @exception java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.4
*/
@ -64,8 +64,8 @@ public interface ConnectionPoolDataSource extends CommonDataSource {
* @return a <code>PooledConnection</code> object that is a physical
* connection to the database that this
* <code>ConnectionPoolDataSource</code> object represents
* @exception SQLException if a database access error occurs
* @exception java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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.
*
* 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.
*
* @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
* timeout value specified by the {@code setLoginTimeout} method
* has been exceeded and has at least tried to cancel the
@ -99,7 +99,7 @@ public interface DataSource extends CommonDataSource, Wrapper {
* being made
* @param password the user's password
* @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
* timeout value specified by the {@code setLoginTimeout} method
* 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.
*
* 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
* this <code>PooledConnection</code> object
* @exception SQLException if a database access error occurs
* @exception java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.4
*/
@ -125,8 +125,8 @@ public interface PooledConnection {
* See the {@link PooledConnection interface description} for more
* information.
*
* @exception SQLException if a database access error occurs
* @exception java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws java.sql.SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @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.
*
* 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>.
*
* @return a string url
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #setUrl
*/
String getUrl() throws SQLException;
@ -118,7 +118,7 @@ public interface RowSet extends ResultSet {
* connection, whichever was set to non null value most recently.
*
* @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
*/
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>
* object; may be <code>null</code>
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #getDataSourceName
*/
void setDataSourceName(String name) throws SQLException;
@ -166,7 +166,7 @@ public interface RowSet extends ResultSet {
* given <code>String</code>.
*
* @param name a user name
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #getUsername
*/
void setUsername(String name) throws SQLException;
@ -187,7 +187,7 @@ public interface RowSet extends ResultSet {
* the given <code>String</code>.
*
* @param password the password string
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #getPassword
*/
void setPassword(String password) throws SQLException;
@ -213,7 +213,7 @@ public interface RowSet extends ResultSet {
* <code>Connection.TRANSACTION_READ_COMMITTED</code>,
* <code>Connection.TRANSACTION_REPEATABLE_READ</code>, or
* <code>Connection.TRANSACTION_SERIALIZABLE</code>
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #getTransactionIsolation
*/
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
* to be mapped
*
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #setTypeMap
*/
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
* SQL user-defined types and the Java classes to which they are
* to be mapped
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #getTypeMap
*/
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
* <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
*/
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
* updatable
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #isReadOnly
*/
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
* is no limit
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #setMaxFieldSize
*/
int getMaxFieldSize() throws SQLException;
@ -329,7 +329,7 @@ public interface RowSet extends ResultSet {
* For maximum portability, use values greater than 256.
*
* @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
*/
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>
* object can contain; zero means unlimited
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #setMaxRows
*/
int getMaxRows() throws SQLException;
@ -352,7 +352,7 @@ public interface RowSet extends ResultSet {
* If the limit is exceeded, the excess rows are silently dropped.
*
* @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
*/
void setMaxRows(int max) throws SQLException;
@ -365,7 +365,7 @@ public interface RowSet extends ResultSet {
*
* @return <code>true</code> if escape processing is enabled;
* <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
*/
boolean getEscapeProcessing() throws SQLException;
@ -377,7 +377,7 @@ public interface RowSet extends ResultSet {
*
* @param enable <code>true</code> to enable escape processing;
* <code>false</code> to disable it
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #getEscapeProcessing
*/
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
* unlimited
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #setQueryTimeout
*/
int getQueryTimeout() throws SQLException;
@ -401,7 +401,7 @@ public interface RowSet extends ResultSet {
*
* @param seconds the new query timeout limit in seconds; zero means
* that there is no limit
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see #getQueryTimeout
*/
void setQueryTimeout(int seconds) throws SQLException;
@ -415,7 +415,7 @@ public interface RowSet extends ResultSet {
* <code>ResultSet.TYPE_FORWARD_ONLY</code>,
* <code>ResultSet.TYPE_SCROLL_INSENSITIVE</code>, or
* <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
*/
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
* concurrency level: <code>ResultSet.CONCUR_READ_ONLY</code> or
* <code>ResultSet.CONCUR_UPDATABLE</code>
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
* @see ResultSet#getConcurrency
*/
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 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;
@ -462,9 +462,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param sqlType the SQL type code defined in <code>java.sql.Types</code>
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.4
*/
@ -496,7 +496,7 @@ public interface RowSet extends ResultSet {
* @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>
* 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)
throws SQLException;
@ -527,9 +527,9 @@ public interface RowSet extends ResultSet {
* @param typeName the fully-qualified name of an SQL user-defined type;
* ignored if the parameter is not a user-defined type or
* SQL <code>REF</code> value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.4
*/
@ -543,7 +543,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
@ -554,10 +554,10 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @see #getBoolean
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.4
*/
@ -570,7 +570,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
@ -581,9 +581,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getByte
* @since 1.4
@ -597,7 +597,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
@ -608,9 +608,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getShort
* @since 1.4
@ -624,7 +624,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
@ -635,9 +635,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getInt
* @since 1.4
@ -651,7 +651,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
@ -662,9 +662,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getLong
* @since 1.4
@ -678,7 +678,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
@ -689,9 +689,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getFloat
* @since 1.4
@ -705,7 +705,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
@ -716,9 +716,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getDouble
* @since 1.4
@ -733,7 +733,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
@ -745,9 +745,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getBigDecimal
* @since 1.4
@ -763,7 +763,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
@ -777,9 +777,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getString
* @since 1.4
@ -795,7 +795,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
@ -808,9 +808,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getBytes
* @since 1.4
@ -825,7 +825,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
@ -837,7 +837,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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;
@ -849,7 +849,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @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)
throws SQLException;
@ -862,9 +862,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getTimestamp
* @since 1.4
@ -887,7 +887,7 @@ public interface RowSet extends ResultSet {
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the Java input stream that contains the ASCII parameter value
* @param length the number of bytes in the stream
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
*/
void setAsciiStream(int parameterIndex, java.io.InputStream x, int length)
throws SQLException;
@ -908,9 +908,9 @@ public interface RowSet extends ResultSet {
* @param parameterName the name of the parameter
* @param x the Java input stream that contains the ASCII parameter value
* @param length the number of bytes in the stream
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.4
*/
@ -932,7 +932,7 @@ public interface RowSet extends ResultSet {
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the java input stream which contains the binary parameter value
* @param length the number of bytes in the stream
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
*/
void setBinaryStream(int parameterIndex, java.io.InputStream x,
int length) throws SQLException;
@ -952,9 +952,9 @@ public interface RowSet extends ResultSet {
* @param parameterName the name of the parameter
* @param x the java input stream which contains the binary parameter value
* @param length the number of bytes in the stream
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.4
*/
@ -977,7 +977,7 @@ public interface RowSet extends ResultSet {
* @param reader the {@code Reader} object that contains the UNICODE data
* to be set
* @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,
Reader reader,
@ -1000,9 +1000,9 @@ public interface RowSet extends ResultSet {
* @param reader the <code>java.io.Reader</code> object that
* contains the UNICODE data used as the designated parameter
* @param length the number of characters in the stream
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.4
*/
@ -1028,8 +1028,8 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the Java input stream that contains the ASCII parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6
*/
@ -1053,8 +1053,8 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the Java input stream that contains the ASCII parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6
*/
@ -1078,8 +1078,8 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the java input stream which contains the binary parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6
*/
@ -1102,8 +1102,8 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the java input stream which contains the binary parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6
*/
@ -1130,8 +1130,8 @@ public interface RowSet extends ResultSet {
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @param reader the <code>java.io.Reader</code> object that contains the
* Unicode data
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6
*/
@ -1157,8 +1157,8 @@ public interface RowSet extends ResultSet {
* @param parameterName the name of the parameter
* @param reader the <code>java.io.Reader</code> object that contains the
* Unicode data
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.6
*/
@ -1232,7 +1232,7 @@ public interface RowSet extends ResultSet {
* this is the length
* of the data in the stream or {@code Reader}. For all other types,
* 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
*/
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,
* this is the number of digits after the decimal point. For all other
* types, this value will be ignored.
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if <code>targetSqlType</code> is
* a <code>ARRAY</code>, <code>BLOB</code>, <code>CLOB</code>,
* <code>DATALINK</code>, <code>JAVA_OBJECT</code>, <code>NCHAR</code>,
* <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>,
* <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code>
* or <code>STRUCT</code> data type and the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if {@code targetSqlType} is
* a {@code ARRAY}, {@code BLOB}, {@code CLOB},
* {@code DATALINK}, {@code JAVA_OBJECT}, {@code NCHAR},
* {@code NCLOB}, {@code NVARCHAR}, {@code LONGNVARCHAR},
* {@code REF}, {@code ROWID}, {@code SQLXML}
* or {@code STRUCT} data type and the JDBC driver does not support
* this data type
* @see Types
* @see #getObject
@ -1297,7 +1297,7 @@ public interface RowSet extends ResultSet {
* @param x the object containing the input parameter value
* @param targetSqlType the SQL type (as defined in <code>java.sql.Types</code>)
* 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,
int targetSqlType) throws SQLException;
@ -1311,14 +1311,14 @@ public interface RowSet extends ResultSet {
* @param x the object containing the input parameter value
* @param targetSqlType the SQL type (as defined in java.sql.Types) to be
* sent to the database
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if <code>targetSqlType</code> is
* a <code>ARRAY</code>, <code>BLOB</code>, <code>CLOB</code>,
* <code>DATALINK</code>, <code>JAVA_OBJECT</code>, <code>NCHAR</code>,
* <code>NCLOB</code>, <code>NVARCHAR</code>, <code>LONGNVARCHAR</code>,
* <code>REF</code>, <code>ROWID</code>, <code>SQLXML</code>
* or <code>STRUCT</code> data type and the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if {@code targetSqlType} is
* a {@code ARRAY}, {@code BLOB}, {@code CLOB},
* {@code DATALINK}, {@code JAVA_OBJECT}, {@code NCHAR},
* {@code NCLOB}, {@code NVARCHAR}, {@code LONGNVARCHAR},
* {@code REF}, {@code ROWID}, {@code SQLXML}
* or {@code STRUCT} data type and the JDBC driver does not support
* this data type
* @see #getObject
* @since 1.4
@ -1354,10 +1354,10 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the object containing the input parameter value
* @exception SQLException if a database access error occurs,
* this method is called on a closed <code>CallableStatement</code> or if the given
* <code>Object</code> parameter is ambiguous
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs,
* this method is called on a closed {@code CallableStatement} or if the given
* {@code Object} parameter is ambiguous
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getObject
* @since 1.4
@ -1392,7 +1392,7 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex The first parameter is 1, the second is 2, ...
* @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;
@ -1404,7 +1404,7 @@ public interface RowSet extends ResultSet {
*
* @param i the first parameter is 1, the second is 2, ...
* @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;
@ -1416,7 +1416,7 @@ public interface RowSet extends ResultSet {
*
* @param i the first parameter is 1, the second is 2, ...
* @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;
@ -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
* the specified length; if a database access error occurs or
* 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
*
* @since 1.6
@ -1512,9 +1512,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x a <code>Blob</code> object that maps an SQL <code>BLOB</code> value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.6
*/
@ -1552,7 +1552,7 @@ public interface RowSet extends ResultSet {
*
* @param i the first parameter is 1, the second is 2, ...
* @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;
@ -1620,7 +1620,7 @@ public interface RowSet extends ResultSet {
* marker in the SQL statement; if the length specified is less than zero;
* a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
*
* @since 1.6
@ -1635,9 +1635,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x a <code>Clob</code> object that maps an SQL <code>CLOB</code> value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @since 1.6
*/
@ -1674,7 +1674,7 @@ public interface RowSet extends ResultSet {
*
* @param i the first parameter is 1, the second is 2, ...
* @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;
@ -1687,7 +1687,7 @@ public interface RowSet extends ResultSet {
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value
* @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)
throws SQLException;
@ -1701,9 +1701,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getDate
* @since 1.4
@ -1725,9 +1725,9 @@ public interface RowSet extends ResultSet {
* @param x the parameter value
* @param cal the <code>Calendar</code> object the driver will use
* to construct the date
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getDate
* @since 1.4
@ -1744,7 +1744,7 @@ public interface RowSet extends ResultSet {
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the parameter value
* @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)
throws SQLException;
@ -1756,9 +1756,9 @@ public interface RowSet extends ResultSet {
*
* @param parameterName the name of the parameter
* @param x the parameter value
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getTime
* @since 1.4
@ -1780,9 +1780,9 @@ public interface RowSet extends ResultSet {
* @param x the parameter value
* @param cal the <code>Calendar</code> object the driver will use
* to construct the time
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getTime
* @since 1.4
@ -1801,7 +1801,7 @@ public interface RowSet extends ResultSet {
* @param x the parameter value
* @param cal the <code>java.util.Calendar</code> object to use for calculating the
* 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)
throws SQLException;
@ -1820,9 +1820,9 @@ public interface RowSet extends ResultSet {
* @param x the parameter value
* @param cal the <code>Calendar</code> object the driver will use
* to construct the timestamp
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>CallableStatement</code>
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code CallableStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @see #getTimestamp
* @since 1.4
@ -1838,7 +1838,7 @@ public interface RowSet extends ResultSet {
* release the resources used by the current parameter values, which can
* 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;
@ -1870,7 +1870,7 @@ public interface RowSet extends ResultSet {
* <code>execute</code> will call on the {@code Reader}'s <code>readData</code>
* 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
* 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
* error could occur; if a database access error occurs or
* 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
* @since 1.6
*/
@ -2181,8 +2181,8 @@ public interface RowSet extends ResultSet {
*
* @param parameterIndex the first parameter is 1, the second is 2, ...
* @param x the <code>java.net.URL</code> object to be set
* @exception SQLException if a database access error occurs or
* this method is called on a closed <code>PreparedStatement</code>
* @throws SQLException if a database access error occurs or
* this method is called on a closed {@code PreparedStatement}
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support this method
* @since 1.4
*/

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.
*
* 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>
* object's command
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
*/
Object[] getParams() throws SQLException;
@ -55,7 +55,7 @@ public interface RowSetInternal {
*
* @return the <code>Connection</code> object passed to the rowset
* 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;
@ -69,7 +69,7 @@ public interface RowSetInternal {
* @param md the <code>RowSetMetaData</code> object that will be set with
* 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;
@ -82,7 +82,7 @@ public interface RowSetInternal {
* <code>getOriginal</code> are said to have an original value.
*
* @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;
@ -94,7 +94,7 @@ public interface RowSetInternal {
*
* @return the original value of the current row as a <code>ResultSet</code>
* 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
* 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.
*
* 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.
*
* @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;
@ -64,7 +64,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* @param property <code>true</code> if the column is automatically
* 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;
@ -76,7 +76,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* @param property <code>true</code> if the column is case sensitive;
* <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;
@ -88,7 +88,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* @param property <code>true</code> if the column can be used in a
* <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;
@ -100,7 +100,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* @param property <code>true</code> if the column is a cash value;
* <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;
@ -115,7 +115,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* <code>ResultSetMetaData.columnNullable</code>, or
* <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;
@ -127,7 +127,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* @param property <code>true</code> if the column is a signed number;
* <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;
@ -139,7 +139,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
* @param size the normal maximum number of characters for
* 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;
@ -149,7 +149,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
*
* @param columnIndex the first column is 1, the second is 2, ...
* @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;
@ -158,7 +158,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
*
* @param columnIndex the first column is 1, the second is 2, ...
* @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;
@ -168,7 +168,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
*
* @param columnIndex the first column is 1, the second is 2, ...
* @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;
@ -178,7 +178,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
*
* @param columnIndex the first column is 1, the second is 2, ...
* @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;
@ -188,7 +188,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
*
* @param columnIndex the first column is 1, the second is 2, ...
* @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;
@ -198,7 +198,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
*
* @param columnIndex the first column is 1, the second is 2, ...
* @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;
@ -208,7 +208,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
*
* @param columnIndex the first column is 1, the second is 2, ...
* @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;
@ -217,7 +217,7 @@ public interface RowSetMetaData extends ResultSetMetaData {
*
* @param columnIndex the first column is 1, the second is 2, ...
* @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
*/
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 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;

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.
*
* 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
* <code>RowSetInternal</code> interface, (2) with which this reader is
* registered, and (3) whose <code>execute</code> method called this reader
* @exception SQLException if a database access error occurs or this method
* invokes the <code>RowSet.execute</code> method
* @throws SQLException if a database access error occurs or this method
* invokes the {@code RowSet.execute} method
*/
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.
*
* 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
* @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
* @exception SQLException if a database access error occurs
* @throws SQLException if a database access error occurs
*/
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.
*
* 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.
*
* @return the {@code XAResource} object
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not
* support this method
* @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.
*
* 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
* physical connection to a data source, that can be used in
* a distributed transaction
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @throws SQLTimeoutException when the driver has determined that the
* 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
* physical connection to a data source, that can be used in
* a distributed transaction
* @exception SQLException if a database access error occurs
* @exception SQLFeatureNotSupportedException if the JDBC driver does not support
* @throws SQLException if a database access error occurs
* @throws SQLFeatureNotSupportedException if the JDBC driver does not support
* this method
* @throws SQLTimeoutException when the driver has determined that the
* timeout value specified by the {@code setLoginTimeout} method