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);
--- old/src/share/classes/javax/sql/StatementEvent.java 2014-04-08 09:48:48.369056456 -0700
+++ new/src/share/classes/javax/sql/StatementEvent.java 2014-04-08 09:48:48.195055307 -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
* 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() { --- old/src/share/classes/javax/sql/StatementEventListener.java 2014-04-08 09:48:48.873059784 -0700 +++ new/src/share/classes/javax/sql/StatementEventListener.java 2014-04-08 09:48:48.714058733 -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-08 09:48:49.395063230 -0700
+++ new/src/share/classes/javax/sql/package.html 2014-04-08 09:48:49.229062134 -0700
@@ -37,9 +37,9 @@
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 SETM).
It remains an essential part of the Java Platform, Enterprise Edition
-(Java EETM).
+(Java EETM).
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.
-
RowSetEventRowSet 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.
-
RowSetMetaDataexecute, 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 +244,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.
-+
RowSetReaderRowSet object that has implemented the
RowSetInternal interface can call on its reader (the
@@ -269,7 +265,6 @@
back to the underlying data source. Implementations may vary widely, but
generally, a writer will do the following:
-