# HG changeset patch # User yan # Date 1398856424 -14400 # Node ID a5c2cff81e253d47dc4e246ba5614eeb9911d426 # Parent 61c9885d76e2b57b4fb1f4658be1d1f72f22db6d 8039488: Tidy warnings cleanup for javax.sql Reviewed-by: lancea Contributed-by: Alexander Stepanov diff -r 61c9885d76e2 -r a5c2cff81e25 jdk/src/share/classes/javax/sql/PooledConnection.java --- a/jdk/src/share/classes/javax/sql/PooledConnection.java Wed Apr 30 15:02:24 2014 +0400 +++ b/jdk/src/share/classes/javax/sql/PooledConnection.java Wed Apr 30 15:13:44 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2000, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2000, 2014, 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,6 @@ * ConnectionPool method addStatementEventListener. * Thus, when an application closes its PreparedStatement, * the underlying prepared statement is recycled rather than being closed. - *

* * @since 1.4 */ @@ -154,10 +153,10 @@ * wish to be notified when PreparedStatements created by the * connection are closed or are detected to be invalid may use this method * to register a StatementEventListener with this PooledConnection object. - *

+ * * @param listener an component which implements the StatementEventListener * interface that is to be registered with this PooledConnection object - *

+ * * @since 1.6 */ public void addStatementEventListener(StatementEventListener listener); @@ -166,11 +165,11 @@ * Removes the specified StatementEventListener from the list of * components that will be notified when the driver detects that a * PreparedStatement has been closed or is invalid. - *

+ * * @param listener the component which implements the * StatementEventListener interface that was previously * registered with this PooledConnection object - *

+ * * @since 1.6 */ public void removeStatementEventListener(StatementEventListener listener); diff -r 61c9885d76e2 -r a5c2cff81e25 jdk/src/share/classes/javax/sql/StatementEvent.java --- a/jdk/src/share/classes/javax/sql/StatementEvent.java Wed Apr 30 15:02:24 2014 +0400 +++ b/jdk/src/share/classes/javax/sql/StatementEvent.java Wed Apr 30 15:13:44 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, 2013, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2014, 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 @@ -37,7 +37,7 @@ * registered with a PooledConnection. This occurs when the driver determines that a * PreparedStatement that is associated with the PooledConnection has been closed or the driver determines * is invalid. - *

+ * * @since 1.6 */ public class StatementEvent extends EventObject { @@ -50,11 +50,11 @@ * Constructs a StatementEvent with the specified PooledConnection and * PreparedStatement. The SQLException contained in the event defaults to * null. - *

+ * * @param con The PooledConnection that the closed or invalid * PreparedStatementis associated with. * @param statement The PreparedStatement that is being closed or is invalid - *

+ * * @throws IllegalArgumentException if con is null. * * @since 1.6 @@ -71,7 +71,7 @@ /** * Constructs a StatementEvent with the specified PooledConnection, * PreparedStatement and SQLException - *

+ * * @param con The PooledConnection that the closed or invalid PreparedStatement * is associated with. * @param statement The PreparedStatement that is being closed or is invalid @@ -79,7 +79,7 @@ * the application * * @throws IllegalArgumentException if con is null. - *

+ * * @since 1.6 */ public StatementEvent(PooledConnection con, @@ -94,9 +94,9 @@ /** * Returns the PreparedStatement that is being closed or is invalid - *

+ * * @return The PreparedStatement that is being closed or is invalid - *

+ * * @since 1.6 */ public PreparedStatement getStatement() { @@ -106,9 +106,9 @@ /** * Returns the SQLException the driver is about to throw - *

+ * * @return The SQLException the driver is about to throw - *

+ * * @since 1.6 */ public SQLException getSQLException() { diff -r 61c9885d76e2 -r a5c2cff81e25 jdk/src/share/classes/javax/sql/StatementEventListener.java --- a/jdk/src/share/classes/javax/sql/StatementEventListener.java Wed Apr 30 15:02:24 2014 +0400 +++ b/jdk/src/share/classes/javax/sql/StatementEventListener.java Wed Apr 30 15:13:44 2014 +0400 @@ -1,5 +1,5 @@ /* - * Copyright (c) 2005, Oracle and/or its affiliates. All rights reserved. + * Copyright (c) 2005, 2014, 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 @@ -52,7 +52,7 @@ *

* Methods which allow a component to register a StatementEventListener with a * PooledConnection have been added to the PooledConnection interface. - *

+ * * @since 1.6 */ public interface StatementEventListener extends java.util.EventListener{ @@ -72,13 +72,13 @@ * PreparedStatement is invalid. The driver calls this method * just before it throws the SQLException, * contained in the given event, to the application. - *

- * @param event an event object describing the source of the event, - * the statement that is invalid and the exception the - * driver is about to throw. The source of the event is - * the PooledConnection which the invalid PreparedStatement - * is associated with. - *

+ * + * @param event an event object describing the source of the event, + * the statement that is invalid and the exception the + * driver is about to throw. The source of the event is + * the PooledConnection which the invalid PreparedStatement + * is associated with. + * * @since 1.6 */ void statementErrorOccurred(StatementEvent event); diff -r 61c9885d76e2 -r a5c2cff81e25 jdk/src/share/classes/javax/sql/package.html --- a/jdk/src/share/classes/javax/sql/package.html Wed Apr 30 15:02:24 2014 +0400 +++ b/jdk/src/share/classes/javax/sql/package.html Wed Apr 30 15:13:44 2014 +0400 @@ -2,7 +2,7 @@ javax.sql.rowset.spi - + @@ -46,7 +46,7 @@ it with the SyncFactory singleton. (See the class comment for SyncProvider for a full explanation of the registration process and the naming convention to be used.) -

+

Table of Contents

-

1.0 Package Specification

+

1.0 Package Specification

The following classes and interfaces make up the javax.sql.rowset.spi package: @@ -155,7 +155,7 @@ using locks; rather, it checks to see if there is a conflict before trying to synchronize the RowSet object and the data source. If there is a conflict, it does nothing, meaning that - changes to the RowSet object are not persisted to the data + changes to the RowSet object are not persisted to the data source.

  • RIXMLProvider
    A synchronization provider that can be used with a @@ -201,10 +201,8 @@ synchronization mechanisms. A vendor can make its implementation available by registering the fully qualified class name with Oracle Corporation at jdbc@sun.com. This process is discussed in further detail below. -

    -

    2.0 Service Provider Interface Architecture

    -

    These policies are explored in more detail in the SyncFactory class. - -

  • 3.0 SyncProvider Implementer's Guide

    -
    -

    4.0 Resolving Synchronization Conflicts

    +

    4.0 Resolving Synchronization Conflicts

    The interface SyncResolver provides a way for an application to decide manually what to do when a conflict occurs. When the CachedRowSet @@ -491,18 +487,18 @@

    The comment for the SyncResolver interface has more detail. -

    5.0 Related Specifications

    +

    5.0 Related Specifications

    -

    6.0 Related Documentation

    +

    6.0 Related Documentation