Skip to content

Commit 525837c

Browse files
committed
Mention Couchbase SDK 2 Migration Kit
Users who depend on the experimental Query DSL from SDK 2 can use source code from the migration kit to aid the migration process. The kit also has some bridge classes for building sub-document requests using the SDK 2 subdoc API, then executing with SDK 3. They also act as a reference for how to translate SDK 2 subdoc requests to SDK 3.
1 parent fafcad2 commit 525837c

File tree

1 file changed

+5
-0
lines changed

1 file changed

+5
-0
lines changed

modules/project-docs/pages/migrating-sdk-code-to-3.n.adoc

Lines changed: 5 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -372,6 +372,9 @@ include::example$MigratingSDKCodeTo3n.java[tag=subdoc_mutatein_store_semantics,i
372372
----
373373
====
374374

375+
TIP: The unofficial, unsupported https://github.com/couchbaselabs/couchbase-java-sdk2-migration-kit[Couchbase Java SDK 2 Migration Kit] has more Sub-Document API migration examples.
376+
It also has source code for temporary bridge classes that can assist with migrating Sub-Document requests from SDK 2 to SDK 3.
377+
375378
In addition, the datastructure APIs have been renamed and moved:
376379

377380
.Datastructure API Changes
@@ -529,6 +532,8 @@ For these reasons it is not amongst the features carried over to SDK 3.x.
529532

530533
In most cases, a simple string statement is the best replacement.
531534

535+
TIP: You can still use the Query DSL classes with SDK 3 if you want, but you'll need to add the source code to your project and maintain it yourself.
536+
A version of the source code modified to work with SDK 3 is available as part of the unofficial, unsupported https://github.com/couchbaselabs/couchbase-java-sdk2-migration-kit[Couchbase Java SDK 2 Migration Kit].
532537

533538
=== Analytics
534539

0 commit comments

Comments
 (0)