JDBC and Java 2 nd edition p age 224 static public Time valueOf(String s); public Time(int hour, int minute, int second); public Time(long time); #public int getDate( ); #public int getDay( ); #public int getMonth( ); #public int getYear( ); #public int setDate(int i); #public int setMonth(int i); public void setTime(long time); #public void setYear(int i); public String toString( ); } Object Constructors Time( ) public Time(int hour, int minute, intsecond) public Time(long time) Description This constructor creates a new Time object. The first prototype constructs a Time for the hour, minute, and seconds specified. The second constructs one based on the number of seconds since January 1, 1970 12:00:00 GMT. Object Methods getDate( ), setDate( ), getDay( ), getMonth( ), setMonth( ), getYear( ), and setYear( ) public int getDate( ) public int getDay( ) public int getMonth( ) public int getYear( ) public int setDate(int i) public int setMonth(int i) public void setYear(int i) Description These attributes represent the individual segments of a Time object. setTime( ) public void setTime(long time) Description This method sets the Time object to the specified time as the number of seconds since January 1, 1970, 12:00:00 GMT. toString( ) public String toString( ) Description This method formats the Time into a String in the form of hh:mm:ss. JDBC and Java 2 nd edition p age 225 valueOf( ) static public Timestamp valueOf(String s) Description This method creates a new Time based on a String in the form of hh:mm:ss. Timestamp Synopsis Class Name: java.sql.Timestamp Superclass: java.util.Date Immediate Subclasses: None Interfaces Implemented: None Availability: JDK 1.1 Description This class serves as a SQL representation of the Java Date class specifically designed to serve as a SQL TIMESTAMP. It also provides the ability to hold nanoseconds as required by SQL TIMESTAMP values. You should keep in mind that this class uses the java.util.Date version of hashcode( ). This means that two timestamps that differ only by nanoseconds will have identical hashcode() return values. Class Summary public class Timestamp extends java.util.Date { static public Timestamp valueOf(String s); #public Timestamp(int year, int month, int date, int hour, int minute, int second, int nano); public Timestamp(long time); public boolean after(Timestamp t); public boolean before(Timestamp t); public boolean equals(Timestamp t); public int getNanos( ); public void setNanos(int n); public String toString( ); } Object Constructors Timestamp( ) public Timestamp(int year, int month, int date, int hour, int minute, int second, int nano) public Timestamp(long time) Description JDBC and Java 2 nd edition p age 22 6 This constructor creates a new Timestamp object. The first prototype constructs a Timestamp for the year, month, date, hour, minute, second, and nanosecond specified. The second prototype constructs one based on the number of seconds since January 1, 1970, 12:00:00 GMT. Object Methods after( ) public boolean after(Timestamp t) Description This method returns true if this Timestamp is later than the argument. before( ) public boolean before(Timestamp t) Description This method returns true if this Timestamp is earlier than the argument. equals( ) public boolean equals(Timestamp t) Description This method returns true if the two timestamps are equivalent. getNanos( ) and setNanos( ) public int getNanos( ) public void setNanos(int n) Description This attribute represents the number of nanoseconds for this Timestamp. toString( ) public String toString( ) Description This method formats the Timestamp into a String in the form of yyyy-mm-dd hh:mm:ss.fffffffff . valueOf( ) static public Timestamp valueOf(String s) Description This method creates a new Timestamp based on a String in the form of yyyy-mm-dd hh:mm:ss.fffffffff. Types JDBC and Java 2 nd edition p age 22 7 Synopsis Class Name: java.sql.Types Superclass: None Immediate Subclasses: None Interfaces Implemented: None Availability: JDK 1.1 Description This class holds static attributes representing SQL datatypes. These values are the actual constant values defined in the XOPEN specification. Class Summary public class Types { static public final int ARRAY; static public final int BIGINT; static public final int BINARY; static public final int BIT; static public final int BLOB; static public final int CHAR; static public final int CLOB; static public final int DATE; static public final int DECIMAL; static public final int DISTINCT; static public final int DOUBLE; static public final int FLOAT; static public final int INTEGER; static public final int JAVA_OBJECT; static public final int LONGVARBINARY; static public final int LONGVARCHAR; static public final int NULL; static public final int NUMERIC; static public final int OTHER; static public final int REAL; static public final int REF; static public final int SMALLINT; static public final int STRUCT; static public final int TIME; static public final int TIMESTAMP; static public final int TINYINT; static public final int VARBINARY; static public final int VARCHAR; } Chapter 12. The JDBC Optional Package Reference The JDBC Optional Package is a new extension to the JDBC API. Its purpose is to provide nonessential, but useful database access features without bogging down the core API. Because it is in the javax namespace, this package does not come with the JDK. Certain vendors may, of course, JDBC and Java 2 nd edition p age 228 choose to include this package with their virtual machines. If yours does not include the JDBC Optional Package, you can download it from http://java.sun.com/products/jdbc. You may notice that a number of the interfaces and classes in this reference section are not discussed anywhere else in the book. While the JDBC Optional Package does specify their existence, they are not used by application developers. They are instead used by driver implementors. Figure 12.1 shows all of the classes and interfaces in the JDBC Optional Package. Figure 12.1. All of the classes and interfaces in the JDBC Optional Package 12.1 Reference ConnectionEvent Synopsis Class Name: javax.sql.ConnectionEvent Superclass: java.util.EventObject Immediate Subclasses: None Interfaces Implemented: None Availability: New as of JDK 1.2 JDBC and Java 2 nd edition p age 229 Description This class is used by the connection pooling subsystem to provide information about connection events, including SQLException being thrown. Class Summary public class ConnectionEvent extends java.util.EventObject { public ConnectionEvent(PooledConnection conn); public ConnectionEvent(PooledConnection conn, java.sql.SQLException ex); public java.sql.SQLException getSQLException( ); } Object Constructors ConnectionEvent( ) public ConnectionEvent(PooledConnection conn); public ConnectionEvent(PooledConnection conn, java.sql.SQLException ex); Description This constructor creates a ConnectionEvent instance tied to the specified pooled connection having the specified SQLException. Object Methods getSQLException( ); public java.sql.SQLException getSQLException( ); Description This method provides the SQLException associated with this event. This value can be null. ConnectionEventListener Synopsis Interface Name: javax.sql.ConnectionEventListener Superclass: java.util.EventListener Immediate Subclasses: None Interfaces Implemented: None Availability: New as of JDK 1.2 JDBC and Java 2 nd edition p age 230 Description This interface is implemented by classes wishing to know about events happening to pooled connections. A JDBC driver vendor implements this interface to be notified when a given connection has closed or thrown an exception. Class Summary public interface ConnectionEventListener extends java.util.EventListener { void connectionClosed(ConnectionEvent evt); void connectionErrorOccurred(ConnectionEvent evt); } Object Methods connectionClosed( ) public void connectionClosed(ConnectionEvent evt); Description This method is called by a pooled connection when the close( ) method has been called. connectionErrorOccurred( ) public void connectionErrorOccurred(ConnectionEvent evt); Description This method is called by a pooled connection whenever a fatal error occurs during communications with a database. For example, if the server goes down, the connection needs to notify the pool to discard this connection from the pool and attempt a reconnect. ConnectionPoolDataSource Synopsis Interface Name: javax.sql.ConnectionPoolDataSource Superclass: None Immediate Subclasses: None Interfaces Implemented: None Availability: New as of JDK 1.2 Description Implementors of this interface act as factories for providing PooledConnection instances. As with the DataSource interface, this class is designed to be registered with a JNDI directory service for applications to look up by name. JDBC and Java 2 nd edition p age 231 Class Summary public interface ConnectionPoolDataSource { int getLoginTimeout( ) throws java.sql.SQLException; java.io.PrintWriter getLogWriter( ) throws java.sql.SQLException; PooledConnection getPooledConnection( ) throws java.sql.SQLException; PooledConnection getPooledConnection(String uid, String pw) throws java.sql.SQLException; void setLoginTimeout(int sec) throws java.sql.SQLException; void setLogWriter(java.io.PrintWriter lw) throws java.sql.SQLException; } Object Methods getLoginTimeout( ) and setLoginTimeout( ) public int getLoginTimeout( ) throws java.sql.SQLException; public void setLoginTimeout(int sec) throws java.sql.SQLException; Description This method gets and sets the interval that the system waits to establish a connection before giving up. This value is an interval in seconds. A value of zero directs the data source to depend on the default timeout for the underlying system. getLogWriter( )and setLogWriter( ) public java.io.PrintWriter getLogWriter( ) throws java.sql.SQLException; public void setLogWriter(java.io.PrintWriter pw) throws java.sql.SQLException; Description This method gets and sets the print writer for use in logging events. The character stream is used by all methods in this data source and all methods in objects constructucted by this data source. getPooledConnection( ) public PooledConnection getPooledConnection( ) throws java.sql.SQLException; public PooledConnection getPooledConnection(String uid, String pw) throws java.sql.SQLException; Description This is a factory method for creating a pooled connection to a database. DataSource JDBC and Java 2 nd edition p age 232 Synopsis Interface Name: javax.sql.DataSource Superclass: None Immediate Subclasses: None Interfaces Implemented: None Availability: New as of JDK 1.2 Description This class provides access to a database via JNDI. To get a JDBC connection, you can look up a data source in a JNDI naming or directory service and then grab a connection from that data source. Class Summary public interface DataSource { java.sql.Connection getConnection( ) throws java.sql.SQLException; java.sql.Connection getConnection(String uid, String pw) throws java.sql.SQLException; int getLoginTimeout( ) throws java.sql.SQLException; java.io.PrintWriter getLogWriter( ) throws java.sql.SQLException; void setLoginTimeout(int sec) throws java.sql.SQLException; void setLogWriter(java.io.PrintWriter pw) throws java.sql.SQLException; } Object Methods getConnection( ) public java.sql.Connection getConnection( ) throws java.sql.SQLException; public java.sql.Connection getConnection(String uid, String pw) throws java.sql.SQLException; Description These are factory methods for the allocation of a connection to a database from a connection pool. getLoginTimeout( ) and setLoginTimeout( ) public int getLoginTimeout( ) throws java.sql.SQLException; public void setLoginTimeout(int sec) throws java.sql.SQLException; Description These methods get and set a connection for the interval that the system waits to establish before giving up. This value is an interval in seconds. A value of zero directs the data source to depend on the default timeout for the underlying system. JDBC and Java 2 nd edition p age 233 getLogWriter( ) and setLogWriter( ) public java.io.PrintWriter getLogWriter( ) throws java.sql.SQLException; public void setLogWriter(java.io.PrintWriter pw) throws java.sql.SQLException; Description These methods get and set the print writer for use in logging events. The character stream is used by all methods in this data source and all methods in objects constructucted by this data source. PooledConnection Synopsis Interface Name: javax.sql.PooledConnection Superclass: None Immediate Subclasses: javax.sql.XAConnection Interfaces Implemented: None Availability: New as of JDK 1.2 Description A PooledConnection represents a physical connection to a data source. An application uses a PooledConnection to grab a specific JDBC connection object from the connection pool for use in talking to a database. Class Summary public interface PooledConnection { void addConnectionEventListener(ConnectionEventListener l) throws java.sql.SQLException; void close( ) throws java.sql.SQLException; java.sql.Connection getConnection( ) throws java.sql.SQLException; void removeConnectionEventListener(ConnectionEventListener l) throws java.sql.SQLException; } Object Methods addConnectionEventListener( ) and removeConnectionEventListener( ) public void addConnectionEventListener(ConnectionEventListener l) throws java.sql.SQLException; public void removeConnectionEventListener(ConnectionEventListener l) throws java.sql.SQLException; Description [...]... str) throws java. sql.SQLException; void setTime(int col, java. sql.Time t) throws java. sql.SQLException; void setTime(int col, java. sql.Time t, java. util.Calendar cal) throws java. sql.SQLException; void setTimestamp(int col, java. sql.Timestamp ts) throws java. sql.SQLException; void setTimestamp(int col, java. sql.Timestamp ts, page 235 JDBC and Java 2nd edition } java. util.Calendar cal) throws java. sql.SQLException;... page 240 JDBC and Java 2nd edition } java. sql.Connection getConnection( ) throws java. sql.SQLException; java. sql.ResultSet getOriginal( ) throws java. sql.SQLException; java. sql.ResultSet getOriginalRow( ) throws java. sql.SQLException; Object[] getParams( ) throws java. sql.SQLException; void setMetaData(RowSetMetaData rsmd) throws java. sql.SQLException; Object Methods getConnection( ) public java. sql.Connection... Database Programming with JDBC and Java, Second Edition is from the CMCD PhotoCD Collection The cover image was manipulated by Edie Freedman using Adobe Photoshop 3.0 and page 249 JDBC and Java 2nd edition Adobe Gallery Effects filters Emma Colby produced the cover layout with QuarkXPress 4.1 using the Bodoni Black font from URW Software and the BT Bodoni Bold Italic font from Bitstream Alicia Cech and. .. getLoginTimeout( ) throws java. sql.SQLException; java. io.PrintWriter getLogWriter( ) throws java. sql.SQLException; XAConnection getXAConnection( ) page 248 JDBC and Java 2nd edition } throws java. sql.SQLException; XAConnection getXAConnection(String uid, String pw) throws java. sql.SQLException; void setLoginTimeout(int sec) throws java. sql.SQLException; void setLogWriter (java. io.PrintWriter lw) throws java. sql.SQLException;... the rowset may be reused with new parameters execute( ) public void execute( ) throws java. sql.SQLException; Description This method executes the currently stored SQL command with the current set of bindings getCommand( ) and setCommand( ) public String getCommand( ); public void setCommand(String sql) throws java. sql.SQLException; Description These methods manage the SQL command used by this rowset... setArray(int col, java. sql.Array arr) throws java. sql.SQLException; void setAsciiStream(int col, java. io.InputStream is, int len) throws java. sql.SQLException; void setBigDecimal(int col, java. math.BigDecimal bd) throws java. sql.SQLException; void setBinaryStream(int col, java. io.InputStream is, int len) throws java. sql.SQLException; void setBlob(int col, java. sql.Blob bl) throws java. sql.SQLException;... personality and life into potentially dry subjects Ann Schirmer was the copyeditor and interior compositor for Database Programming with JDBC and Java, Second Edition Catherine Morris, Claire Cloutier, and Jane Ellin performed quality control reviews Mary Anne Weeks Mayo proofread the book Judy Hoer wrote the index Edie Freedman designed the cover of this book The image of a jacks game on the cover of Database. .. getEscapeProcessing( ) throws java. sql.SQLException; int getMaxFieldSize( ) throws java. sql.SQLException; int getMaxRows( ) throws java. sql.SQLException; String getPassword( ); page 234 JDBC and Java 2nd edition int getQueryTimeout( ) throws java. sql.SQLException; int getTransactionIsolation( ); java. util.Map getTypeMap( ) throws java. sql.SQLException; String getUrl( ) throws java. sql.SQLException; String... throws java. sql.SQLException; void setByte(int col, byte b) throws java. sql.SQLException; void setBytes(int col, byte[] b) throws java. sql.SQLException; void setCharacterStream(int col, Reader rdr, int len) throws java. sql.SQLException; void setClob(int col, java. sql.Clob cl) throws java. sql.SQLException; void setCommand(String sql) throws java. sql.SQLException; void setConcurrency(int cncr) throws java. sql.SQLException;... setString( ), setTime( ), and setTimestamp( ) public void setArray(int col, java. sql.Array arr) throws java. sql.SQLException public void setAsciiStream(int col, java. io.InputStream is, int length) throws java. sql.SQLException public void setBigDecimal(int col, java. math.BigDecimal d) throws java. sql.SQLException public void setBinaryStream(int col, java. io.InputStream is, int length) throws java. sql.SQLException; . RowSetInternal { JDBC and Java 2 nd edition p age 241 java. sql.Connection getConnection( ) throws java. sql.SQLException; java. sql.ResultSet getOriginal( ) throws java. sql.SQLException; java. sql.ResultSet. setTimestamp(int col, java. sql.Timestamp ts, JDBC and Java 2 nd edition p age 23 6 java. util.Calendar cal) throws java. sql.SQLException; void setTransactionIsolation(int ti) throws java. sql.SQLException;. throws java. sql.SQLException; Description This method executes the currently stored SQL command with the current set of bindings. getCommand( ) and setCommand( ) public String getCommand( );