--- old/src/share/classes/javax/sql/PooledConnection.java 2014-04-09 04:40:17.363231779 -0700
+++ new/src/share/classes/javax/sql/PooledConnection.java 2014-04-09 04:40:17.217230812 -0700
@@ -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 PreparedStatement
s 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);
--- old/src/share/classes/javax/sql/StatementEvent.java 2014-04-09 04:40:17.806234711 -0700
+++ new/src/share/classes/javax/sql/StatementEvent.java 2014-04-09 04:40:17.663233764 -0700
@@ -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
* PreparedStatement
is 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() { --- old/src/share/classes/javax/sql/StatementEventListener.java 2014-04-09 04:40:18.282237862 -0700 +++ new/src/share/classes/javax/sql/StatementEventListener.java 2014-04-09 04:40:18.129236849 -0700 @@ -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);
--- old/src/share/classes/javax/sql/package.html 2014-04-09 04:40:18.767241072 -0700
+++ new/src/share/classes/javax/sql/package.html 2014-04-09 04:40:18.618240085 -0700
@@ -36,10 +36,9 @@
the JavaTM programming language.
This package supplements the java.sql
package and, as of the version 1.4 release, is included in the
-Java Platform, Standard Edition
-(Java SETM).
+Java Platform, Standard Edition (Java SE™).
It remains an essential part of the Java Platform, Enterprise Edition
-(Java EETM).
+(Java EE™).
The javax.sql
package provides for the following:
PreparedStatement
is closed or there is an error, the connection
pool manager (being a listener)
gets a notification that includes a StatementEvent
object.
-
RowSetEvent
RowSet
object
creates an instance of RowSetEvent
and passes it to the listener.
The listener can use this RowSetEvent
object to find out which rowset
had the event.
-
RowSetMetaData
execute
, the RowSet
object will contain
a new set of rows, and its RowSetMetaData
object will have been
internally updated to contain information about the new columns.
-
RowSet
object that implements the RowSetInternal
@@ -248,7 +243,7 @@
(2) the connection that was passed to it, if any. A rowset uses the
RowSetInternal
methods behind the scenes to get access to
this information. An application does not normally invoke these methods directly.
-+
RowSetReader
RowSet
object that has implemented the
RowSetInternal
interface can call on its reader (the
@@ -269,7 +264,6 @@
back to the underlying data source. Implementations may vary widely, but
generally, a writer will do the following:
-