You are viewing a plain text version of this content. The canonical link for it is here.
Posted to notifications@shardingsphere.apache.org by zh...@apache.org on 2022/05/15 07:49:47 UTC

[shardingsphere] branch master updated: Add documentation for JDBC pool property names (#17658)

This is an automated email from the ASF dual-hosted git repository.

zhangliang pushed a commit to branch master
in repository https://gitbox.apache.org/repos/asf/shardingsphere.git


The following commit(s) were added to refs/heads/master by this push:
     new cd83c7de515 Add documentation for JDBC pool property names (#17658)
cd83c7de515 is described below

commit cd83c7de5156caa15c1fcaaf441ab505cd80bb46
Author: Ling Hengqian <li...@outlook.com>
AuthorDate: Sun May 15 15:49:41 2022 +0800

    Add documentation for JDBC pool property names (#17658)
    
    * Added documentation for JDBC pool property names.
    
    * Remove extra repeated text sections.
---
 .../content/user-manual/shardingsphere-jdbc/java-api/data-source.cn.md  | 2 +-
 .../content/user-manual/shardingsphere-jdbc/java-api/data-source.en.md  | 2 +-
 .../shardingsphere-jdbc/spring-boot-starter/data-source.cn.md           | 2 +-
 .../shardingsphere-jdbc/spring-boot-starter/data-source.en.md           | 2 +-
 .../user-manual/shardingsphere-jdbc/spring-namespace/data-source.cn.md  | 2 +-
 .../user-manual/shardingsphere-jdbc/spring-namespace/data-source.en.md  | 2 +-
 .../user-manual/shardingsphere-jdbc/yaml-config/data-source.cn.md       | 2 +-
 .../user-manual/shardingsphere-jdbc/yaml-config/data-source.en.md       | 2 +-
 8 files changed, 8 insertions(+), 8 deletions(-)

diff --git a/docs/document/content/user-manual/shardingsphere-jdbc/java-api/data-source.cn.md b/docs/document/content/user-manual/shardingsphere-jdbc/java-api/data-source.cn.md
index e27d47b50ba..019ff036fe9 100644
--- a/docs/document/content/user-manual/shardingsphere-jdbc/java-api/data-source.cn.md
+++ b/docs/document/content/user-manual/shardingsphere-jdbc/java-api/data-source.cn.md
@@ -8,7 +8,7 @@ ShardingSphere-JDBC 支持所有的数据库 JDBC 驱动和连接池。
 
 ## 配置示例
 
-示例的数据库驱动为 MySQL,连接池为 HikariCP,可以更换为其他数据库驱动和连接池。
+示例的数据库驱动为 MySQL,连接池为 HikariCP,可以更换为其他数据库驱动和连接池。当使用 ShardingSphere JDBC 时,JDBC 池的属性名取决于各自 JDBC 池自己的定义,并不由 ShardingSphere 硬定义,相关的处理可以参考类`org.apache.shardingsphere.infra.datasource.pool.creator.DataSourcePoolCreator`。
 
 ```java
 Map<String, DataSource> dataSourceMap = new HashMap<>();
diff --git a/docs/document/content/user-manual/shardingsphere-jdbc/java-api/data-source.en.md b/docs/document/content/user-manual/shardingsphere-jdbc/java-api/data-source.en.md
index dd8a7c30c32..f0d3900b1de 100644
--- a/docs/document/content/user-manual/shardingsphere-jdbc/java-api/data-source.en.md
+++ b/docs/document/content/user-manual/shardingsphere-jdbc/java-api/data-source.en.md
@@ -8,7 +8,7 @@ ShardingSphere-JDBC Supports all JDBC drivers and database connection pools.
 
 ## Example
 
-In this example, the database driver is MySQL, and connection pool is HikariCP, which can be replaced with other database drivers and connection pools.
+In this example, the database driver is MySQL, and connection pool is HikariCP, which can be replaced with other database drivers and connection pools. When using ShardingSphere JDBC, the property name of the JDBC pool depends on the definition of the respective JDBC pool, and is not defined by ShardingSphere. For related processing, please refer to the class `org.apache.shardingsphere.infra.datasource.pool.creator.DataSourcePoolCreator`.
 
 ```java
 Map<String, DataSource> dataSourceMap = new HashMap<>();
diff --git a/docs/document/content/user-manual/shardingsphere-jdbc/spring-boot-starter/data-source.cn.md b/docs/document/content/user-manual/shardingsphere-jdbc/spring-boot-starter/data-source.cn.md
index 8c5edb34f92..c8d16ed1c2e 100644
--- a/docs/document/content/user-manual/shardingsphere-jdbc/spring-boot-starter/data-source.cn.md
+++ b/docs/document/content/user-manual/shardingsphere-jdbc/spring-boot-starter/data-source.cn.md
@@ -22,7 +22,7 @@ spring.shardingsphere.datasource.<actual-data-source-name>.<xxx>= # ... 数据
 
 ### 配置示例
 
-示例的数据库驱动为 MySQL,连接池为 HikariCP,可以更换为其他数据库驱动和连接池。
+示例的数据库驱动为 MySQL,连接池为 HikariCP,可以更换为其他数据库驱动和连接池。当使用 ShardingSphere JDBC 时,JDBC 池的属性名取决于各自 JDBC 池自己的定义,并不由 ShardingSphere 硬定义,相关的处理可以参考类`org.apache.shardingsphere.infra.datasource.pool.creator.DataSourcePoolCreator`。例如对于 Alibaba Druid 1.2.9 而言,使用`url`代替如下示例中的`jdbc-url`是预期行为。
 
 ```properties
 # 配置真实数据源
diff --git a/docs/document/content/user-manual/shardingsphere-jdbc/spring-boot-starter/data-source.en.md b/docs/document/content/user-manual/shardingsphere-jdbc/spring-boot-starter/data-source.en.md
index 3778ab88675..ce1dc22872a 100644
--- a/docs/document/content/user-manual/shardingsphere-jdbc/spring-boot-starter/data-source.en.md
+++ b/docs/document/content/user-manual/shardingsphere-jdbc/spring-boot-starter/data-source.en.md
@@ -22,7 +22,7 @@ spring.shardingsphere.datasource.<actual-data-source-name>.<xxx>= # ... Other pr
 
 ### Example
 
-In this example, the database driver is MySQL, and connection pool is HikariCP, which can be replaced with other database drivers and connection pools.
+In this example, the database driver is MySQL, and connection pool is HikariCP, which can be replaced with other database drivers and connection pools. When using ShardingSphere JDBC, the property name of the JDBC pool depends on the definition of the respective JDBC pool, and is not defined by ShardingSphere. For related processing, please refer to the class `org.apache.shardingsphere.infra.datasource.pool.creator.DataSourcePoolCreator` . For example, with Alibaba Druid 1.2.9, using `ur [...]
 
 ```properties
 # Configure actual data sources
diff --git a/docs/document/content/user-manual/shardingsphere-jdbc/spring-namespace/data-source.cn.md b/docs/document/content/user-manual/shardingsphere-jdbc/spring-namespace/data-source.cn.md
index 2dadf9b2d5d..b832a37ae6f 100644
--- a/docs/document/content/user-manual/shardingsphere-jdbc/spring-namespace/data-source.cn.md
+++ b/docs/document/content/user-manual/shardingsphere-jdbc/spring-namespace/data-source.cn.md
@@ -8,7 +8,7 @@ chapter = true
 
 ## 配置示例
 
-示例的数据库驱动为 MySQL,连接池为 HikariCP,可以更换为其他数据库驱动和连接池。
+示例的数据库驱动为 MySQL,连接池为 HikariCP,可以更换为其他数据库驱动和连接池。当使用 ShardingSphere JDBC 时,JDBC 池的属性名取决于各自 JDBC 池自己的定义,并不由 ShardingSphere 硬定义,相关的处理可以参考类`org.apache.shardingsphere.infra.datasource.pool.creator.DataSourcePoolCreator`。例如对于 Alibaba Druid 1.2.9 而言,使用`url`代替如下示例中的`jdbcUrl`是预期行为。
 
 ```xml
 <beans xmlns="http://www.springframework.org/schema/beans"
diff --git a/docs/document/content/user-manual/shardingsphere-jdbc/spring-namespace/data-source.en.md b/docs/document/content/user-manual/shardingsphere-jdbc/spring-namespace/data-source.en.md
index 4b76d391427..9adac290031 100644
--- a/docs/document/content/user-manual/shardingsphere-jdbc/spring-namespace/data-source.en.md
+++ b/docs/document/content/user-manual/shardingsphere-jdbc/spring-namespace/data-source.en.md
@@ -8,7 +8,7 @@ Any data source configured as spring bean can be cooperated with spring namespac
 
 ## Example
 
-In this example, the database driver is MySQL, and connection pool is HikariCP, which can be replaced with other database drivers and connection pools.
+In this example, the database driver is MySQL, and connection pool is HikariCP, which can be replaced with other database drivers and connection pools. When using ShardingSphere JDBC, the property name of the JDBC pool depends on the definition of the respective JDBC pool, and is not defined by ShardingSphere. For related processing, please refer to the class `org.apache.shardingsphere.infra.datasource.pool.creator.DataSourcePoolCreator` . For example, with Alibaba Druid 1.2.9, using `ur [...]
 
 ```xml
 <beans xmlns="http://www.springframework.org/schema/beans"
diff --git a/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/data-source.cn.md b/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/data-source.cn.md
index f967d4bccfc..39d42b4d53e 100644
--- a/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/data-source.cn.md
+++ b/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/data-source.cn.md
@@ -6,7 +6,7 @@ chapter = true
 
 数据源配置分为单数据源配置和多数据源配置。ShardingSphere-JDBC 支持所有的数据库 JDBC 驱动和连接池。
 
-示例的数据库驱动为 MySQL,连接池为 HikariCP,可以更换为其他数据库驱动和连接池。
+示例的数据库驱动为 MySQL,连接池为 HikariCP,可以更换为其他数据库驱动和连接池。当使用 ShardingSphere JDBC 时,JDBC 池的属性名取决于各自 JDBC 池自己的定义,并不由 ShardingSphere 硬定义,相关的处理可以参考类`org.apache.shardingsphere.infra.datasource.pool.creator.DataSourcePoolCreator`。例如对于 Alibaba Druid 1.2.9 而言,使用`url`代替如下示例中的`jdbcUrl`是预期行为。
 
 ### 配置项说明
 
diff --git a/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/data-source.en.md b/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/data-source.en.md
index 7999a0db8d2..b6106cc7fd2 100644
--- a/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/data-source.en.md
+++ b/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/data-source.en.md
@@ -7,7 +7,7 @@ chapter = true
 It is divided into single data source configuration and multi data source configuration.
 ShardingSphere-JDBC Supports all JDBC drivers and database connection pools.
 
-In this example, the database driver is MySQL, and connection pool is HikariCP, which can be replaced with other database drivers and connection pools.
+In this example, the database driver is MySQL, and connection pool is HikariCP, which can be replaced with other database drivers and connection pools. When using ShardingSphere JDBC, the property name of the JDBC pool depends on the definition of the respective JDBC pool, and is not defined by ShardingSphere. For related processing, please refer to the class `org.apache.shardingsphere.infra.datasource.pool.creator.DataSourcePoolCreator` . For example, with Alibaba Druid 1.2.9, using `ur [...]
 
 ### Configuration Item Explanation