Java: Reorganize section

Author: amotl

docs/connect/index.md

@@ -176,7 +176,7 @@ application
 :maxdepth: 1
 :hidden:
 
-java
+java/index
 javascript
 php
 python

docs/connect/java.md

@@ -0,0 +1,13 @@
+---
+orphan: true
+---
+:::{card}
+:link: https://github.com/crate/cratedb-examples/tree/main/by-language/java-jdbc
+:link-type: url
+:width: 50%
+{material-regular}`play_arrow;2em`
+Connect to CrateDB using JDBC
++++
+Demonstrates a basic example using both the vanilla PostgreSQL JDBC Driver
+and the CrateDB JDBC Driver.
+:::

docs/connect/java/_jdbc_example.md

@@ -0,0 +1,96 @@
+(crate-jdbc)=
+(cratedb-jdbc)=
+
+# CrateDB JDBC
+
+:::{rubric} Synopsis
+:::
+
+```java
+Properties properties = new Properties();
+properties.put("user", "admin");
+properties.put("password", "<PASSWORD>");
+properties.put("ssl", true);
+Connection conn = DriverManager.getConnection(
+    "jdbc:crate://<name-of-your-cluster>.cratedb.net:5432/",
+    properties
+);
+```
+
+:::{rubric} Maven
+:::
+
+```xml
+<dependencies>
+    <dependency>
+        <groupId>io.crate</groupId>
+        <artifactId>crate-jdbc</artifactId>
+        <version>2.7.0</version>
+    </dependency>
+</dependencies>
+```
+
+:::{rubric} Gradle
+:::
+
+```groovy
+repositories {
+    mavenCentral()
+}
+dependencies {
+    implementation 'io.crate:crate-jdbc:2.7.0'
+}
+```
+
+:::{rubric} Download
+:::
+
+:::{card}
+:link: https://cratedb.com/docs/jdbc/en/latest/getting-started.html#installation
+:link-type: url
+{material-regular}`download;2em`
+Download and install the CrateDB JDBC Driver
+:::
+
+:::{rubric} Full example
+:::
+
+:::{dropdown} `main.java`
+```java
+import java.sql.*;
+import java.util.Properties;
+
+public class Main {
+    public static void main(String[] args) {
+        try {
+            Properties properties = new Properties();
+            properties.put("user", "admin");
+            properties.put("password", "<PASSWORD>");
+            properties.put("ssl", true);
+            Connection conn = DriverManager.getConnection(
+                "jdbc:crate://<name-of-your-cluster>.cratedb.net:5432/",
+                properties
+            );
+
+            Statement statement = conn.createStatement();
+            ResultSet resultSet = statement.executeQuery("SELECT name FROM sys.cluster");
+            resultSet.next();
+            String name = resultSet.getString("name");
+
+            System.out.println(name);
+        } catch (SQLException e) {
+            e.printStackTrace();
+        }
+    }
+}
+```
+:::
+
+
+## JDBC example
+
+:::{include} _jdbc_example.md
+:::
+
+
+[![Java: JDBC, QA](https://github.com/crate/cratedb-examples/actions/workflows/lang-java-maven.yml/badge.svg)](https://github.com/crate/cratedb-examples/actions/workflows/lang-java-maven.yml)

docs/connect/java/cratedb-jdbc.md

@@ -0,0 +1,27 @@
+(jpa)=
+(hibernate)=
+(panache)=
+(quarkus)=
+
+# Hibernate / JPA
+
+:::{include} /_include/links.md
+:::
+
+:::{div}
+[Hibernate] is the top dog ORM for Java, supporting a range of databases,
+including PostgreSQL. [JPA], or Jakarta Persistence API (formerly Java
+Persistence API), is a Java specification that simplifies the process of
+mapping Java objects to relational databases.
+:::
+
+:::{card}
+:link: https://github.com/crate/cratedb-examples/tree/main/by-language/java-quarkus-panache
+:link-type: url
+:width: 50%
+{material-regular}`play_arrow;2em`
+Connect to CrateDB using JPA and Panache
++++
+How CrateDB can be utilized with Quarkus in a very intuitive way
+using the Hibernate ORM deriving from PostgreSQL.
+:::