Loading...

XML

Word

Printable

Subcomponent:
java.sql
Compatibility Kind:

behavioral
Compatibility Risk:
low
Compatibility Risk Description:

Hide
The updates to the API should have minimal impact WRT compatibility but there are two changes to highlight:

1. The default implementation of Statement::enquoteIdentifier is changed so that it throws SQLException if DatabaseMetaData::getIdentifierQuoteString does not return a double quote(as defined in the SQLStandard)

2. The default implementation of Statement::isSimpleIdentifier is changed to return false if the String passed to the method is a SQL standard reserved word.

The two changed methods were added in JDK 9. These changes to the default implementation has no impact on JDBC drivers that have been updated since JDK 9 to override these methods.

Show
The updates to the API should have minimal impact WRT compatibility but there are two changes to highlight: 1. The default implementation of Statement::enquoteIdentifier is changed so that it throws SQLException if DatabaseMetaData::getIdentifierQuoteString does not return a double quote(as defined in the SQLStandard) 2. The default implementation of Statement::isSimpleIdentifier is changed to return false if the String passed to the method is a SQL standard reserved word. The two changed methods were added in JDK 9. These changes to the default implementation has no impact on JDBC drivers that have been updated since JDK 9 to override these methods.
Interface Kind:

Java API
Scope:
SE

Summary

Add support for JDBC 4.5, which is a maintenance release to the JDBC specification

Add a targeted set of features that were requested by several JDBC driver vendors

The JDBC 4.5 MR will provide the following updates to the JDBC specification:

Deprecate SQLPermission for removal
Enhance the Blob/Clob/Array/SQLXML/NClob interfaces to extend/support AutoClosable
Add the SQL types DECFLOAT, JSON to Types.Java and JDBCType.java
Add the quoted identifier methods that were added previously to the Statement interface in JDK 9 to the Connection interface
- The javadoc & default methods have been improved based on review feedback and was applied to the Statement interface
Clarify the Timestamp::hashCode method which incorrectly indicates that nanos are not used when calculating the hash

Please refer to the attached API diff of the javadocs which reflect the changes to the API

csr of

JDK-8369432 Add Support for JDBC 4.5 MR