You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: src/docs/asciidoc/release_notes.adoc
+6-2Lines changed: 6 additions & 2 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -37,6 +37,9 @@ For known issues, consult <<known-issues>>.
37
37
The following was fixed or changed after 6.0.0-beta-1:
38
38
39
39
* Improvement: stacktraces produced by `FbExceptionBuilder` no longer include `StackTraceElements` of the builder itself (https://github.com/FirebirdSQL/jaybird/issues/827[#827])
40
+
* Improvement: support for custom SocketFactory in connection string and data sources (https://github.com/FirebirdSQL/jaybird/issues/828[#828])
41
+
+
42
+
See also <<custom-socket-factory>>.
40
43
41
44
[#jaybird-6-0-0-beta-1-changelog]
42
45
=== Jaybird 6.0.0-beta-1
@@ -108,6 +111,7 @@ See <<native-plugin>> for more information.
108
111
* <<timestamp-localdate-localtime>>
109
112
* <<no-close-after-last>>
110
113
* <<scroll-rs-update-behavior>>
114
+
* <<custom-socket-factory>>
111
115
* ... and <<other-fixes-and-changes>>
112
116
113
117
Upgrading from Jaybird 5 should be straightforward, but please make sure to read <<compatibility-changes>> before using Jaybird 6.
@@ -1053,14 +1057,14 @@ If `socketFactory` is not specified, Jaybird will use `SocketFactory.getDefault(
1053
1057
1054
1058
The `SocketFactory` implementation must adhere to the following rules:
1055
1059
1056
-
- The class must have a public constructor accepting a `java.util.Properties` object, or a public no-arg constructor.
1060
+
- The class must have a public single-arg constructor accepting a `java.util.Properties` object, or a public no-arg constructor.
1057
1061
- The implementation of `SocketFactory#createSocket()` must return an unconnected socket;
1058
1062
the other `createSocket` methods are not called by Jaybird.
1059
1063
+
1060
1064
If you don't want to implement the other `createSocket` methods, we recommend throwing `java.lang.UnsupportedOperationException` with a clear message from those methods.
1061
1065
1062
1066
It is possible to pass custom connection properties to the socket factory if it has a public single-arg constructor accepting a `Properties` object.
1063
-
Jaybird will instantiate the socket factory with a `Properties` object containing _only_ the connection properties with the suffix `@socketFactory` and a non-``null`` values;
1067
+
Jaybird will instantiate the socket factory with a `Properties` object containing _only_ the connection properties with the suffix `@socketFactory` and non-``null`` values;
1064
1068
non-string values are converted to string.
1065
1069
In the future, we may also -- selectively -- pass other connection properties, but for now we only expose those properties that are explicitly set for the socket factory.
0 commit comments