Testing/Java: Add section about io.crate:crate-testing package

[amotl]

About

The canonical documentation page has been erected in a haste, focused on Python and Testcontainers/Java, so it was natural it forgot to educate about the io.crate:crate-testing package.

• https://github.com/crate/crate-java-testing
• https://repo1.maven.org/maven2/io/crate/crate-testing/

Preview

https://cratedb-guide--178.org.readthedocs.build/integrate/testing.html

/cc @seut

[amotl]

Contrary to the other examples, this does not add a single link to a concise "usage description" resource yet.

a) We can easily link to this section in the README for a start:

@ClassRule
public static final CrateTestCluster TEST_CLUSTER =
    CrateTestCluster.fromVersion("3.3.2")
    .clusterName("with-builder")
    .numberOfNodes(3)
    .build();

b) Other than this, I would also like to link to a little but full working example program/project that users can use as a starting point to build upon, optimally slotted into cratedb-examples. It does not need to happen right now, but maybe you can already point out an almost-complete variant for a start.

[amotl]

I would also like to link to a little but full working example program/project that users can use as a starting point to build upon, optimally slotted into cratedb-examples.

Responding to myself:

The example java-qa uses crate-testing already.

-- by-language/java-qa/pom.xml

• via: [Java] Educate about io.crate:crate-testing package (crate-java-testing) cratedb-examples#342 (comment)

[amotl]

Other than this, I would also like to link to a little but full working example program/project

The example java-qa uses crate-testing already.

I just added a link to the example project.

We can easily link to this section in the README for a start.

On a subsequent iteration, we can give the page a complete rework, and present concise code snippets within corresponding "Synopsis" subsections.