Skip to content

Commit 88bb244

Browse files
committed
Update JDBC support + misc copy editing
1 parent 6d91fce commit 88bb244

1 file changed

Lines changed: 11 additions & 30 deletions

File tree

src/docs/asciidoc/release_notes.adoc

Lines changed: 11 additions & 30 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@
1010
:sectnums:
1111
:bc-version: 1.83
1212
:jna-version: 5.18.1
13-
:jaybird-fbclient-version: 5.0.2.0
13+
:jaybird-fbclient-version: 5.0.3.0
1414
:firebird-java: https://groups.google.com/g/firebird-java
1515
:issues: https://github.com/FirebirdSQL/jaybird/issues
1616
:jaybird-repo: https://github.com/FirebirdSQL/jaybird
@@ -41,7 +41,7 @@ The following was fixed or changed since Jaybird 6.0.4:
4141
+
4242
Applications referencing this constant may need to be recompiled to function correctly with Jaybird 6.0.5 and higher.
4343
If you use Java 26 or higher, we recommend using `java.sql.Type.DECFLOAT` and `java.sql.JDBCType.DECFLOAT` instead.
44-
* JDBC 4.5 support: implemented methods `enquoteIdentifier`, `enquoteLiteral`, `enquoteNCharLiteral`, and `isSimpleIdentifier` on `FBConnection`, and added them to interface `FirebirdConnection` so for older Java versions (https://github.com/FirebirdSQL/jaybird/issues/908[#908])
44+
* JDBC 4.5 support: implemented methods `enquoteIdentifier`, `enquoteLiteral`, `enquoteNCharLiteral`, and `isSimpleIdentifier` on `FBConnection`, and added them to interface `FirebirdConnection` for access in older Java versions (https://github.com/FirebirdSQL/jaybird/issues/908[#908])
4545
+
4646
The methods of the same name in the `java.sql.Statement` implementations now call the methods on the connection.
4747
This results in two minor breaking changes:
@@ -51,16 +51,16 @@ This results in two minor breaking changes:
5151
* JDBC 4.5 support: implemented "`disable escape processing`" JDBC escape (`++{\...\}++`) (https://github.com/FirebirdSQL/jaybird/issues/909[#909])
5252
+
5353
See also <<jdbc-escape-disable-proc>>.
54-
* JDBC 4.5 support: `FBDatabaseMetaData.getJDBCMinorVersion()` should report 5 (for JDBC 4.5) on Java 25 and higher (https://github.com/FirebirdSQL/jaybird/issues/915[#915])
54+
* JDBC 4.5 support: `FBDatabaseMetaData.getJDBCMinorVersion()` should report 5 (for JDBC 4.5) on Java 26 and higher (https://github.com/FirebirdSQL/jaybird/issues/915[#915])
5555
* Fixed: JDBC escapes should not be parsed inside dialect 3 delimited identifiers or dialect 1 string literals (https://github.com/FirebirdSQL/jaybird/issues/921[#921])
5656
* Fixed: `IndexOutOfBoundsException` in `FBCachedBlob.getBytes(long, int)` for position or length beyond end of data (https://github.com/FirebirdSQL/jaybird/issues/923[#923])
5757
* Fixed: Using native client, password is limited to 255 bytes (https://github.com/FirebirdSQL/jaybird/issues/925[#925])
5858
* Fixed: Infinite loop in `FBPooledConnection#fireConnectionError(SQLException)` if the exception has a chained exception and neither is fatal (https://github.com/FirebirdSQL/jaybird/issues/927[#927])
5959

6060
=== Jaybird 6.0.4
6161

62-
This release is not fully compatible with the upcoming JDBC 4.5 Specification to be introduced with Java 26.
63-
See <<jdbc45-compat>> for more information.
62+
This release is not fully compatible with the JDBC 4.5 Specification.
63+
For JDBC 4.5 support, upgrade to Jaybird 6.0.5 or higher.
6464

6565
The following was fixed or changed since Jaybird 6.0.3:
6666

@@ -295,6 +295,9 @@ Jaybird supports the following specifications:
295295
|===
296296
|Specification |Notes
297297

298+
|JDBC 4.5
299+
|All JDBC 4.5 methods for features supported by Firebird.
300+
298301
|JDBC 4.4
299302
|If a security manager is available, the driver still performs `SQLPermission` checks.
300303

@@ -306,32 +309,10 @@ Jaybird supports the following specifications:
306309
|===
307310

308311
[discrete#jdbc45-compat]
309-
==== Incompatibilities with upcoming JDBC 4.5 Specification
310-
311-
// TODO Revise/rename with state for Jaybird 6.0.5 once https://github.com/FirebirdSQL/jaybird/issues/907 is complete
312-
313-
This section applies to Jaybird 6.0.4 and earlier.
314-
315-
Java 26 (expected in March 2026) will introduce https://jcp.org/aboutJava/communityprocess/maintenance/jsr221/index5.html[JDBC 4.5^] (link to draft).
316-
Jaybird is not yet compatible with some of the specified changes.
317-
318-
Specifically affected are:
319-
320-
* Introduction of `java.sql.JDBCType.DECFLOAT` and `java.sql.Types.DECFLOAT` (value `2015`).
321-
+
322-
At this time, Jaybird still uses its own constants in `JaybirdType.DECFLOAT` and `JaybirdTypeCodes.DECFLOAT` with value `-6001`.
323-
This value will be changed to match the JDBC specified value, and the constants deprecated, in a future maintenance release of Jaybird.
324-
+
325-
Addressed in Jaybird 6.0.5.
326-
* Introduction of new methods on `java.sql.Connection` -- `enquoteIdentifier`, `enquoteLiteral`, `enquoteNCharLiteral`, and `isSimpleIdentifier`
327-
+
328-
The default implementation provided is not sufficient for Firebird, especially not when connecting to a dialect 1 database.
329-
For the time being, we recommend using the equivalent JDBC 4.3 methods (with the same name) on a `java.sql.Statement` instance of the connection.
330-
+
331-
Addressed in Jaybird 6.0.5.
332-
* The JDBC escape to selectively disable escape processing ([.nowrap]`++{\ ... \}++`) is not yet implemented.
312+
==== Compatibility with the JDBC 4.5 Specification
333313

334-
We plan to address these issues in Jaybird 5 and Jaybird 6 maintenance releases _after_ the release of Java 26 (tracked by https://github.com/FirebirdSQL/jaybird/issues/907[#907]).
314+
Java 26 (March 2026) introduced https://jcp.org/aboutJava/communityprocess/maintenance/jsr221/index5.html[JDBC 4.5^] (link to draft).
315+
Since Jaybird 6.0.5 (and Jaybird 5.0.12), Jaybird is compatible with the specified changes.
335316

336317
[#support]
337318
== Support

0 commit comments

Comments
 (0)