src/share/classes/java/sql/Driver.java

Print this page




 127     DriverPropertyInfo[] getPropertyInfo(String url, java.util.Properties info)
 128                          throws SQLException;
 129 
 130 
 131     /**
 132      * Retrieves the driver's major version number. Initially this should be 1.
 133      *
 134      * @return this driver's major version number
 135      */
 136     int getMajorVersion();
 137 
 138     /**
 139      * Gets the driver's minor version number. Initially this should be 0.
 140      * @return this driver's minor version number
 141      */
 142     int getMinorVersion();
 143 
 144 
 145     /**
 146      * Reports whether this driver is a genuine JDBC
 147      * Compliant<sup><font size=-2>TM</font></sup> driver.
 148      * A driver may only report <code>true</code> here if it passes the JDBC
 149      * compliance tests; otherwise it is required to return <code>false</code>.
 150      * <P>
 151      * JDBC compliance requires full support for the JDBC API and full support
 152      * for SQL 92 Entry Level.  It is expected that JDBC compliant drivers will
 153      * be available for all the major commercial databases.
 154      * <P>
 155      * This method is not intended to encourage the development of non-JDBC
 156      * compliant drivers, but is a recognition of the fact that some vendors
 157      * are interested in using the JDBC API and framework for lightweight
 158      * databases that do not support full database functionality, or for
 159      * special databases such as document information retrieval where a SQL
 160      * implementation may not be feasible.
 161      * @return <code>true</code> if this driver is JDBC Compliant; <code>false</code>
 162      *         otherwise
 163      */
 164     boolean jdbcCompliant();
 165 
 166     //------------------------- JDBC 4.1 -----------------------------------
 167 
 168     /**
 169      * Return the parent Logger of all the Loggers used by this driver. This
 170      * should be the Logger farthest from the root Logger that is
 171      * still an ancestor of all of the Loggers used by this driver. Configuring
 172      * this Logger will affect all of the log messages generated by the driver.
 173      * In the worst case, this may be the root Logger.
 174      *
 175      * @return the parent Logger for this driver
 176      * @throws SQLFeatureNotSupportedException if the driver does not use <code>java.util.logging<code>.

 177      * @since 1.7
 178      */
 179     public Logger getParentLogger() throws SQLFeatureNotSupportedException;
 180 }


 127     DriverPropertyInfo[] getPropertyInfo(String url, java.util.Properties info)
 128                          throws SQLException;
 129 
 130 
 131     /**
 132      * Retrieves the driver's major version number. Initially this should be 1.
 133      *
 134      * @return this driver's major version number
 135      */
 136     int getMajorVersion();
 137 
 138     /**
 139      * Gets the driver's minor version number. Initially this should be 0.
 140      * @return this driver's minor version number
 141      */
 142     int getMinorVersion();
 143 
 144 
 145     /**
 146      * Reports whether this driver is a genuine JDBC
 147      * Compliant&trade; driver.
 148      * A driver may only report <code>true</code> here if it passes the JDBC
 149      * compliance tests; otherwise it is required to return <code>false</code>.
 150      * <P>
 151      * JDBC compliance requires full support for the JDBC API and full support
 152      * for SQL 92 Entry Level.  It is expected that JDBC compliant drivers will
 153      * be available for all the major commercial databases.
 154      * <P>
 155      * This method is not intended to encourage the development of non-JDBC
 156      * compliant drivers, but is a recognition of the fact that some vendors
 157      * are interested in using the JDBC API and framework for lightweight
 158      * databases that do not support full database functionality, or for
 159      * special databases such as document information retrieval where a SQL
 160      * implementation may not be feasible.
 161      * @return <code>true</code> if this driver is JDBC Compliant; <code>false</code>
 162      *         otherwise
 163      */
 164     boolean jdbcCompliant();
 165 
 166     //------------------------- JDBC 4.1 -----------------------------------
 167 
 168     /**
 169      * Return the parent Logger of all the Loggers used by this driver. This
 170      * should be the Logger farthest from the root Logger that is
 171      * still an ancestor of all of the Loggers used by this driver. Configuring
 172      * this Logger will affect all of the log messages generated by the driver.
 173      * In the worst case, this may be the root Logger.
 174      *
 175      * @return the parent Logger for this driver
 176      * @throws SQLFeatureNotSupportedException if the driver does not use
 177      * {@code java.util.logging}.
 178      * @since 1.7
 179      */
 180     public Logger getParentLogger() throws SQLFeatureNotSupportedException;
 181 }