Skip to content

Commit

Permalink
Update Jaybird 6 info
Browse files Browse the repository at this point in the history
  • Loading branch information
mrotteveel committed Aug 9, 2023
1 parent c464ea5 commit 30a91ec
Showing 1 changed file with 14 additions and 4 deletions.
18 changes: 14 additions & 4 deletions src/docs/asciidoc/appendices/jaybirdversions/jaybird6.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,16 @@ Currently, that means we support Java 17 and 20.

Jaybird 6 provides libraries for Java 17.

Jaybird 6 is not modularized, but all versions declare the automatic module name `org.firebirdsql.jaybird`.
Jaybird 6 is modularized, and provides the following modules:

`org.firebirdsql.jaybird`::
main Jaybird driver (artifact `org.firebirdsql.jdbc:jaybird`)

`org.firebirdsql.jaybird.chacha64`::
ChaCha64 wire encryption implementation (artifact `org.firebirdsql.jdbc:chacha64-plugin`)

`org.firebirdsql.jna`::
native and embedded protocol implementation using JNA (artifact `org.firebirdsql.jdbc:jaybird-native`)

[[jb6-firebird]]
==== Firebird support
Expand All @@ -28,7 +37,7 @@ Jaybird 6 will -- by default -- not connect to Firebird 2.5 or older.
To connect to earlier versions, unsupported protocols have to be enabled explicitly, see <<ref-enable-protocol>> for details.

Formal support for Firebird 2.5 has been dropped, and some things may no longer work (especially `DatabaseMetaData` methods), if features of Firebird 3.0 have been used.
The Type 2 and embedded server JDBC drivers require a separate artifact, `jaybird-native`, JNA to access the Firebird client or embedded library.
The Type 2 and embedded server JDBC drivers require a separate artifact, `jaybird-native`, and JNA to access the Firebird client or embedded library.

[[jb6-firebird3]]
===== Notes on Firebird 3.0 support
Expand Down Expand Up @@ -63,6 +72,7 @@ Jaybird 6 supports the following specifications:
[width="100%",cols="1,3",options="header",]
|===
|Specification |Details

|JDBC 4.3
|Jaybird supports most of JDBC 4.3, in as far the features are required or supported by Firebird.
It is not officially JDBC compliant, because we currently don't have access to the TCK.
Expand All @@ -77,7 +87,7 @@ It is not officially JDBC compliant, because we currently don't have access to t

Jaybird has no required runtime dependencies.

For native or embedded connections, the `jaybird-native` artifact and JNA 5.12.1 need to be on the classpath.
For native or embedded connections, the `jaybird-native` artifact and JNA 5.13.0 need to be on the classpath.

For ChaCha64 wire encryption, the `chacha64-plugin` artifact and `bcprov-jdk18on` (Bouncy Castle JCE provider) need to be on the classpath.

Expand Down Expand Up @@ -107,7 +117,7 @@ Provides only pure Java connections.
|Options dependency, support for native and embedded connections.
Requires `lib/jna-5.12.1.jar`.
|`lib/jna-5.12.1.jar`
|`lib/jna-5.13.0.jar`
|Optional dependency, required if you want to use Type 2 native, or embedded protocols (with `jaybird-native`)
|===
Expand Down

0 comments on commit 30a91ec

Please sign in to comment.