Updated version to latest and gave reference in JDBC to server settings configuration

Author: chernser

docs/integrations/language-clients/java/client/_snippets/_v0_8.mdx

@@ -1,6 +1,11 @@
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 import WideTableWrapper from '@site/src/components/WideTableWrapper/WideTableWrapper';
+import TOCInline from '@theme/TOCInline';
+
+
+<TOCInline toc={toc} />
+
 
 Java client library to communicate with a DB server through its protocols. The current implementation only supports the [HTTP interface](/interfaces/http).
 The library provides its own API to send requests to a server. The library also provides tools to work with different binary data formats (RowBinary* & Native*).
@@ -14,11 +19,11 @@ The library provides its own API to send requests to a server. The library also
 <Tabs groupId="client-setup">
 <TabItem value="maven" label="Maven" >
 
-```xml 
+```xml
 <dependency>
     <groupId>com.clickhouse</groupId>
     <artifactId>client-v2</artifactId>
-    <version>0.9.1</version>
+    <version>0.9.3</version>
 </dependency>
 ```
 
@@ -27,14 +32,14 @@ The library provides its own API to send requests to a server. The library also
 
 ```kotlin
 // https://mvnrepository.com/artifact/com.clickhouse/client-v2
-implementation("com.clickhouse:client-v2:0.9.1")
+implementation("com.clickhouse:client-v2:0.9.3")
 ```
 </TabItem>
 <TabItem value="gradle" label="Gradle">
 
 ```groovy
 // https://mvnrepository.com/artifact/com.clickhouse/client-v2
-implementation 'com.clickhouse:client-v2:0.9.1'
+implementation 'com.clickhouse:client-v2:0.9.3'
 ```
 
 </TabItem>
@@ -110,7 +115,7 @@ Configuration is defined during client creation. See `com.clickhouse.client.api.
 |-----------------------|-----------------------------|:--------------------------------------------|
 | `addEndpoint(String endpoint)`          | - `endpoint` - URL formatted a server address.      | Adds a server endpoint to list of available servers. Currently only one endpoint is supported. <br/> <br/> Default: `none` <br/> Enum: `none` <br/> Key: `none`  |
 | `addEndpoint(Protocol protocol, String host, int port, boolean secure)` | - `protocol` - connection protocol `com.clickhouse.client.api.enums.Protocol#HTTP`.<br />- `host` - IP or hostname of a server.<br />- `secure` - if communication should use secure version of the protocol (HTTPS) | Adds a server endpoint to list of available servers. Currently only one endpoint is supported. <br/> <br/> Default: `none` <br/> Enum: `none` <br/> Key: `none` |
-| `setOption(String key, String value)`   | - `key` - String key of the client configuration option.<br /> - `value` - String value of the option | Sets raw value of client options. Useful when reading configuration from properties files. | 
+| `setOption(String key, String value)`   | - `key` - String key of the client configuration option.<br /> - `value` - String value of the option | Sets raw value of client options. Useful when reading configuration from properties files. |
 | `setUsername(String username)`          | - `username` - User's username to use while authentication | Sets username for an authentication method that is selected by further configuration <br/> <br/> Default: `default` <br/> Enum: `ClientConfigProperties.USER` <br/> Key: `user` |
 | `setPassword(String password)`          | - `password` - secret value for password authentication | Sets a secret for password authentication and effectively selects as authentication method <br/> <br/> Default: - <br/> Enum: `ClientConfigProperties.PASSWORD` <br/> Key: `password` |
 | `setAccessToken(String accessToken)`    | - `accessToken` - String representation of an access token | Sets an access token to authenticate with a sets corresponding authentication method <br/> <br/> Default: - <br/> Enum: `ClientConfigProperties.ACCESS_TOKEN` <br/> Key: `access_token` |
@@ -130,7 +135,7 @@ Configuration is defined during client creation. See `com.clickhouse.client.api.
 | `setSocketLinger(int secondsToWait)` | - `secondsToWait` - number of seconds. | Set linger time for every TCP socket created by the client. <br/> <br/> Default: - <br/> Enum: `ClientConfigProperties.SOCKET_LINGER_OPT` <br/> Key: `socket_linger`|
 | `compressServerResponse(boolean enabled)` | - `enabled` - flag that indicates if the option should be enabled | Sets if server should compress its responses. <br/> <br/> Default: `true` <br/> Enum: `ClientConfigProperties.COMPRESS_SERVER_RESPONSE` <br/> Key: `compress` |
 | `compressClientRequest(boolean enabled)` | - `enabled` - flag that indicates if the option should be enabled | Sets if client should compress its requests. <br/> <br/> Default: `false` <br/> Enum: `ClientConfigProperties.COMPRESS_CLIENT_REQUEST` <br/> Key: `decompress` |
-| `useHttpCompression(boolean enabled)` | - `enabled` - flag that indicates if the option should be enabled | Sets if HTTP compression should be used for client/server communications if corresponding options are enabled | 
+| `useHttpCompression(boolean enabled)` | - `enabled` - flag that indicates if the option should be enabled | Sets if HTTP compression should be used for client/server communications if corresponding options are enabled |
 | `appCompressedData(boolean enabled)` | - `enabled` - flag that indicates if the option should be enabled | Tell client that compression will be handled by application. <br/> <br/> Default: `false` <br/> Enum: `ClientConfigProperties.APP_COMPRESSED_DATA` <br/> Key: `app_compressed_data` |
 | `setLZ4UncompressedBufferSize(int size)` | - `size` - size in bytes | Sets size of a buffer that will receive uncompressed portion of a data stream. If buffer is underestimated - a new one will be created and corresponding warning will be present in logs. <br/> <br/> Default: `65536` <br/> Enum: `ClientConfigProperties.COMPRESSION_LZ4_UNCOMPRESSED_BUF_SIZE` <br/> Key: `compression.lz4.uncompressed_buffer_size`|
 | `disableNativeCompression` | - `disable` - flag that indicates if the option should be disabled | Disable native compression. If set to true then native compression will be disabled. <br/> <br/> Default: `false` <br/> Enum: `ClientConfigProperties.DISABLE_NATIVE_COMPRESSION` <br/> Key: `disable_native_compression` |
@@ -372,13 +377,13 @@ Future of `InsertResponse` type - the result of the operation and additional inf
 **Examples**
 
 ```java showLineNumbers
-// Important step (done once) - register class to pre-compile object serializer according to the table schema. 
+// Important step (done once) - register class to pre-compile object serializer according to the table schema.
 client.register(ArticleViewEvent.class, client.getTableSchema(TABLE_NAME));
 
 List<ArticleViewEvent> events = loadBatch();
 
 try (InsertResponse response = client.insert(TABLE_NAME, events).get()) {
-    // handle response, then it will be closed and connection that served request will be released. 
+    // handle response, then it will be closed and connection that served request will be released.
 }
 ```
 
@@ -419,7 +424,7 @@ Sends `sqlQuery` as is. Response format is set by query settings. `QueryResponse
 
 **Signatures**
 
-```java 
+```java
 CompletableFuture<QueryResponse> query(String sqlQuery, QuerySettings settings)
 CompletableFuture<QueryResponse> query(String sqlQuery)
 ```
@@ -436,7 +441,7 @@ Future of `QueryResponse` type - a result dataset and additional information lik
 
 **Examples**
 
-```java 
+```java
 final String sql = "select * from " + TABLE_NAME + " where title <> '' limit 10";
 
 // Default format is RowBinaryWithNamesAndTypesFormatReader so reader have all information about columns
@@ -453,21 +458,21 @@ try (QueryResponse response = client.query(sql).get(3, TimeUnit.SECONDS);) {
         String title = reader.getString("title");
         String url = reader.getString("url");
 
-        // collecting data 
+        // collecting data
     }
 } catch (Exception e) {
     log.error("Failed to read data", e);
 }
 
-// put business logic outside of the reading block to release http connection asap.  
+// put business logic outside of the reading block to release http connection asap.
 ```
 
 ### query(String sqlQuery, Map&lt;String, Object> queryParams, QuerySettings settings) {#querystring-sqlquery-mapltstring-object-queryparams-querysettings-settings}
 
 Sends `sqlQuery` as is. Additionally will send query parameters so the server can compile the SQL expression.
 
 **Signatures**
-```java 
+```java
 CompletableFuture<QueryResponse> query(String sqlQuery, Map<String, Object> queryParams, QuerySettings settings)
 ```
 
@@ -487,7 +492,7 @@ Future of `QueryResponse` type - a result dataset and additional information lik
 
 ```java showLineNumbers
 
-// define parameters. They will be sent to the server along with the request.   
+// define parameters. They will be sent to the server along with the request.
 Map<String, Object> queryParams = new HashMap<>();
 queryParams.put("param1", 2);
 
@@ -500,7 +505,7 @@ try (QueryResponse response =
     while (reader.hasNext()) {
         reader.next(); // Read the next record from stream and parse it
 
-        // reading data 
+        // reading data
     }
 
 } catch (Exception e) {
@@ -514,7 +519,7 @@ try (QueryResponse response =
 Queries a data in `RowBinaryWithNamesAndTypes` format. Returns the result as a collection. Read performance is the same as with the reader but more memory is required to hold the whole dataset.
 
 **Signatures**
-```java 
+```java
 List<GenericRecord> queryAll(String sqlQuery)
 ```
 
@@ -594,7 +599,7 @@ Fetches table schema for the `table`.
 
 **Signatures**
 
-```java 
+```java
 TableSchema getTableSchema(String table)
 TableSchema getTableSchema(String table, String database)
 ```
@@ -615,7 +620,7 @@ Fetches schema from a SQL statement.
 
 **Signatures**
 
-```java 
+```java
 TableSchema getTableSchemaFromQuery(String sql)
 ```
 
@@ -636,7 +641,7 @@ Column match is found by extracting its name from a method name. For example, `g
 
 **Signatures**
 
-```java 
+```java
 void register(Class<?> clazz, TableSchema schema)
 ```
 
@@ -648,7 +653,7 @@ void register(Class<?> clazz, TableSchema schema)
 
 **Examples**
 
-```java showLineNumbers 
+```java showLineNumbers
 client.register(ArticleViewEvent.class, client.getTableSchema(TABLE_NAME));
 ```
 

docs/integrations/language-clients/java/index.md

@@ -1,5 +1,6 @@
 ---
 title: 'Java'
+sidebar_position: 1
 keywords: ['clickhouse', 'java', 'jdbc', 'client', 'integrate', 'r2dbc']
 description: 'Options for connecting to ClickHouse from Java'
 slug: /integrations/java
@@ -20,7 +21,7 @@ import CodeBlock from '@theme/CodeBlock';
 
 Java client is a library implementing own API that abstracts details of network communications with ClickHouse server. Currently HTTP Interface is supported only. The library provide utilities to work with different ClickHouse formats and other related functions.
 
-Java Client was developed far back in 2015. Its codebase became very hard to maintain, API is confusing, it is hard to optimize it further. So we have refactored it in 2024 into a new component  `client-v2`. It has clear API, lighter codebase and more performance improvements, better ClickHouse formats support (RowBinary & Native mainly). JDBC will use this client in near feature.  
+Java Client was developed far back in 2015. Its codebase became very hard to maintain, API is confusing, it is hard to optimize it further. So we have refactored it in 2024 into a new component  `client-v2`. It has clear API, lighter codebase and more performance improvements, better ClickHouse formats support (RowBinary & Native mainly). JDBC will use this client in near feature.
 
 ### Supported data types {#supported-data-types}
 
@@ -83,7 +84,7 @@ Java Client was developed far back in 2015. Its codebase became very hard to mai
 - AggregatedFunction - :warning: does not support `SELECT * FROM table ...`
 - Decimal - `SET output_format_decimal_trailing_zeros=1` in 21.9+ for consistency
 - Enum - can be treated as both string and integer
-- UInt64 - mapped to `long` in client-v1 
+- UInt64 - mapped to `long` in client-v1
 :::
 
 ### Features {#features}
@@ -94,7 +95,8 @@ Table of features of the clients:
 |----------------------------------------------|:---------:|:---------:|:---------:|
 | Http Connection                              |✔       |✔      | |
 | Http Compression (LZ4)                       |✔       |✔      | |
-| Server Response Compression - LZ4            |✔       |✔      | | 
+| Application Controlled Compression           |✔       |✗      | |
+| Server Response Compression - LZ4            |✔       |✔      | |
 | Client Request Compression - LZ4             |✔       |✔      | |
 | HTTPS                                        |✔       |✔      | |
 | Client SSL Cert (mTLS)                       |✔       |✔      | |
@@ -109,6 +111,7 @@ Table of features of the clients:
 | Log Comment                                  |✔       |✔      | |
 | Session Roles                                |✔       |✔      | |
 | SSL Client Authentication                    |✔       |✔      | |
+| SNI Configuration                            |✔       |✗      | |
 | Session timezone                             |✔       |✔      | |
 
 JDBC Drive inherits same features as underlying client implementation. Other JDBC features are listed on its [page](/integrations/language-clients/java/jdbc).
@@ -122,7 +125,7 @@ JDBC Drive inherits same features as underlying client implementation. Other JDB
 
 ### Logging {#logging}
 
-Our Java language client uses [SLF4J](https://www.slf4j.org/) for logging. You can use any SLF4J-compatible logging framework, such as `Logback` or `Log4j`. 
+Our Java language client uses [SLF4J](https://www.slf4j.org/) for logging. You can use any SLF4J-compatible logging framework, such as `Logback` or `Log4j`.
 For example, if you are using Maven you could add the following dependency to your `pom.xml` file:
 
 ```xml title="pom.xml"

docs/integrations/language-clients/java/jdbc/_snippets/_v0_8.mdx

@@ -1,5 +1,9 @@
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
+import TOCInline from '@theme/TOCInline';
+
+
+<TOCInline toc={toc} />
 
 :::note
 `clickhouse-jdbc` implements the standard JDBC interface using the latest java client.
@@ -35,7 +39,7 @@ In 0.8 we tried to make the driver more strictly follow the JDBC specification,
         <dependency>
             <groupId>com.clickhouse</groupId>
             <artifactId>clickhouse-jdbc</artifactId>
-            <version>0.9.1</version>
+            <version>0.9.3</version>
             <classifier>shaded-all</classifier>
         </dependency>
         ```
@@ -45,14 +49,14 @@ In 0.8 we tried to make the driver more strictly follow the JDBC specification,
 
         ```kotlin
         // https://mvnrepository.com/artifact/com.clickhouse/clickhouse-jdbc
-        implementation("com.clickhouse:clickhouse-jdbc:0.9.1:shaded-all")
+        implementation("com.clickhouse:clickhouse-jdbc:0.9.3:shaded-all")
         ```
     </TabItem>
     <TabItem value="gradle" label="Gradle">
 
         ```groovy
         // https://mvnrepository.com/artifact/com.clickhouse/clickhouse-jdbc
-        implementation 'com.clickhouse:clickhouse-jdbc:0.9.1:shaded-all'
+        implementation 'com.clickhouse:clickhouse-jdbc:0.9.3:shaded-all'
         ```
 
     </TabItem>
@@ -67,9 +71,9 @@ In 0.8 we tried to make the driver more strictly follow the JDBC specification,
 - `jdbc:clickhouse:http://localhost:8123`
 - `jdbc:clickhouse:https://localhost:8443?ssl=true`
 
-**Connection Properties**:
+### Connection Properties:
 
-Beyond standard JDBC properties, the driver supports the ClickHouse-specific properties offered by the underlying [java client](/integrations/language-clients/java/client/client.mdx).
+Beyond standard JDBC properties, the driver supports the ClickHouse-specific properties offered by the underlying [java client](/integrations/language-clients/java/client#client-configuration).
 Where possible methods will return an `SQLFeatureNotSupportedException` if the feature is not supported. Other custom properties include:
 
 | Property                         | Default | Description                                                    |
@@ -81,6 +85,10 @@ Where possible methods will return an `SQLFeatureNotSupportedException` if the f
 | `jdbc_resultset_auto_close`      | `true`  | Automatically closes `ResultSet` when `Statement` is closed    |
 | `beta.row_binary_for_simple_insert` | `false` | Use `PreparedStatement` implementation based on `RowBinary` writer. Works only for `INSERT INTO ... VALUES` queries. |
 
+#### Server Settings
+
+All server settings should be prefixed with `clickhouse_setting_` (same as for the client [configuration](/integrations/language-clients/java/client#server-settings)).
+
 ## Supported data types {#supported-data-types}
 
 JDBC Driver supports the same data formats as the underlying [java client](/integrations/language-clients/java/client/client.mdx).