This is an automated email from the ASF dual-hosted git repository.
jiangmaolin 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 77fe9ea866e Mark logback-classic in agent/core as provided (#37784)
77fe9ea866e is described below
commit 77fe9ea866ee69278e9e0a8f0622a6e6aee666e7
Author: Ling Hengqian <[email protected]>
AuthorDate: Sun Jan 25 17:26:41 2026 +0800
Mark logback-classic in agent/core as provided (#37784)
---
agent/core/pom.xml | 5 +++
.../jdbc-driver/spring-boot/_index.cn.md | 28 ++++++++--------
.../jdbc-driver/spring-boot/_index.en.md | 38 ++++++++++++----------
3 files changed, 40 insertions(+), 31 deletions(-)
diff --git a/agent/core/pom.xml b/agent/core/pom.xml
index fb9c2bae117..6cc051e1fc1 100644
--- a/agent/core/pom.xml
+++ b/agent/core/pom.xml
@@ -58,6 +58,11 @@
<artifactId>slf4j-api</artifactId>
<scope>provided</scope>
</dependency>
+ <dependency>
+ <groupId>ch.qos.logback</groupId>
+ <artifactId>logback-classic</artifactId>
+ <scope>provided</scope>
+ </dependency>
</dependencies>
<build>
diff --git
a/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/jdbc-driver/spring-boot/_index.cn.md
b/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/jdbc-driver/spring-boot/_index.cn.md
index da555007933..1e42de9daf4 100644
---
a/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/jdbc-driver/spring-boot/_index.cn.md
+++
b/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/jdbc-driver/spring-boot/_index.cn.md
@@ -35,12 +35,10 @@ spring.datasource.url=jdbc:shardingsphere:classpath:xxx.yaml
直接使用该数据源；或者将 ShardingSphereDataSource 配置在 JPA、Hibernate、MyBatis 等 ORM 框架中配合使用。
-## 针对 Spring Boot OSS 3 的处理
+## 针对 Spring Boot 3+ 的处理
-Spring Boot OSS 3 对 Jakarta EE 和 Java 17 进行了 “大爆炸” 升级，涉及大量复杂情况。
-
-ShardingSphere 的 XA 分布式事务尚未在 Spring Boot OSS 3 上就绪，此限制同样适用于其他基于 Jakarta EE 9+
的 Web Framework，如
-Quarkus 3，Micronaut Framework 4 和 Helidon 3。
+ShardingSphere 的 XA 分布式事务尚未在 Spring Boot 3+ 上就绪，此限制同样适用于其他基于 Jakarta EE 9+ 的
Web Framework，如
+Quarkus 3，Micronaut Framework 4 和 Helidon 3+。
用户仅需要配置如下。
@@ -56,24 +54,29 @@ Quarkus 3，Micronaut Framework 4 和 Helidon 3。
</project>
```
-## 针对低版本的 Spring Boot OSS 2 的特殊处理
+## 针对低版本的 Spring Boot 2 的特殊处理
-ShardingSphere 的所有特性均可在 Spring Boot OSS 2 上使用，但低版本的 Spring Boot OSS 可能需要手动指定
SnakeYAML 的版本为 2.2 。
+ShardingSphere JDBC 的所有特性均可在 Spring Boot 2 上使用，
+但低版本的 Spring Boot 可能需要手动指定 SnakeYAML 的版本为 `2.2` 。
这在 Maven 的 `pom.xml` 体现为如下内容。
```xml
<project>
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>org.yaml</groupId>
+ <artifactId>snakeyaml</artifactId>
+ <version>2.2</version>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
<dependencies>
<dependency>
<groupId>org.apache.shardingsphere</groupId>
<artifactId>shardingsphere-jdbc</artifactId>
<version>${shardingsphere.version}</version>
</dependency>
- <dependency>
- <groupId>org.yaml</groupId>
- <artifactId>snakeyaml</artifactId>
- <version>2.2</version>
- </dependency>
</dependencies>
</project>
```
@@ -85,7 +88,6 @@ ShardingSphere 的所有特性均可在 Spring Boot OSS 2 上使用，但低版
<properties>
<snakeyaml.version>2.2</snakeyaml.version>
</properties>
-
<dependencies>
<dependency>
<groupId>org.apache.shardingsphere</groupId>
diff --git
a/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/jdbc-driver/spring-boot/_index.en.md
b/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/jdbc-driver/spring-boot/_index.en.md
index f5ce4c440c2..c4640fc48bd 100644
---
a/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/jdbc-driver/spring-boot/_index.en.md
+++
b/docs/document/content/user-manual/shardingsphere-jdbc/yaml-config/jdbc-driver/spring-boot/_index.en.md
@@ -35,14 +35,13 @@ The YAML configuration file in 'spring.datasource.url'
currently support in mult
Use this data source directly; or configure ShardingSphereDataSource to be
used in conjunction with ORM frameworks such as JPA, Hibernate, and MyBatis.
-## Handling for Spring Boot OSS 3
+## Handling for Spring Boot 3+
-Spring Boot OSS 3 has made a "big bang" upgrade to Jakarta EE and Java 17,
with all complications involved.
+ShardingSphere's XA distributed transactions are not yet ready for Spring Boot
3+.
+This limitation also applies to other Jakarta EE 9+ based web frameworks,
+such as Quarkus 3, Micronaut Framework 4, and Helidon 3+.
-ShardingSphere's XA distributed transactions are not yet ready on Spring Boot
OSS 3. This limitation also applies to other
-Jakarta EE 9+ based Web Frameworks, such as Quarkus 3, Micronaut Framework 4
and Helidon 3.
-
-Users only need to configure as follows.
+Users only need to configure the following.
```xml
<project>
@@ -56,38 +55,41 @@ Users only need to configure as follows.
</project>
```
-## Special handling for earlier versions of Spring Boot OSS 2
+## Special Handling for Lower Versions of Spring Boot 2
-All features of ShardingSphere are available on Spring Boot OSS 2, but earlier
versions of Spring Boot OSS may require
-manually specifying version 2.2 for SnakeYAML.
-This is reflected in Maven's `pom.xml` as follows.
+All ShardingSphere JDBC features are available in Spring Boot 2.
+However, lower versions of Spring Boot may require manually specifying the
SnakeYAML version as `2.2`.
+This is reflected in the Maven `pom.xml` as follows.
```xml
<project>
+ <dependencyManagement>
+ <dependencies>
+ <dependency>
+ <groupId>org.yaml</groupId>
+ <artifactId>snakeyaml</artifactId>
+ <version>2.2</version>
+ </dependency>
+ </dependencies>
+ </dependencyManagement>
<dependencies>
<dependency>
<groupId>org.apache.shardingsphere</groupId>
<artifactId>shardingsphere-jdbc</artifactId>
<version>${shardingsphere.version}</version>
</dependency>
- <dependency>
- <groupId>org.yaml</groupId>
- <artifactId>snakeyaml</artifactId>
- <version>2.2</version>
- </dependency>
</dependencies>
</project>
```
-If the user created the Spring Boot project from https://start.spring.io/,
users can simplify configuration by
-following things.
+If a user created a Spring Boot project via https://start.spring.io/ ,
+the configuration can be simplified as follows.
```xml
<project>
<properties>
<snakeyaml.version>2.2</snakeyaml.version>
</properties>
-
<dependencies>
<dependency>
<groupId>org.apache.shardingsphere</groupId>
