Sharding-JDBC 开源项目启动与配置教程

1. 项目目录结构及介绍

Sharding-JDBC 是一个轻量级 Java 持久层框架，用于实现分库分表。以下是项目的目录结构及各目录的简要介绍：

sharding-jdbc-doc/
├── pom.xml           # Maven 项目配置文件
├── sharding-jdbc     # Sharding-JDBC 核心代码
│   ├── src           # 源代码目录
│   │   ├── main      # 主代码目录
│   │   │   ├── java  # Java 源代码
│   │   │   └── resources # 资源文件
│   │   └── test      # 测试代码目录
│   └── pom.xml       # Sharding-JDBC 子模块的 Maven 配置文件
└── sharding-jdbc-example # 示例代码目录

2. 项目的启动文件介绍

Sharding-JDBC 的启动主要通过 Maven 命令进行。以下是主要的启动文件及其说明：

• pom.xml：Maven 项目配置文件，包含了项目的依赖、构建配置等信息。通过此文件，可以使用 Maven 命令来构建和运行项目。

• sharding-jdbc-example：示例代码目录，包含了如何使用 Sharding-JDBC 的示例。通常情况下，你可以通过以下命令运行示例项目：

  mvn clean install -DskipTests
  cd sharding-jdbc-example
  mvn spring-boot:run
  

3. 项目的配置文件介绍

Sharding-JDBC 的配置文件主要用于定义数据源、分片策略等。以下是主要的配置文件及其说明：

• application.properties 或 application.yml：Spring Boot 应用的配置文件，可以在这里配置数据库连接信息、分片规则等。

以下是一个基本的配置文件示例：

# 数据源配置
spring.datasource.url=jdbc:mysql://localhost:3306/ds0?serverTimezone=UTC&useSSL=false
spring.datasource.username=root
spring.datasource.password=root
spring.datasource.driver-class-name=com.mysql.cj.jdbc.Driver

# 分片配置
spring.sharding.jdbc.datasource.names=ds0
spring.sharding.jdbc.config.sharding.default-database-strategy=inline
spring.sharding.jdbc.config.sharding.tables.t_order.actual-data-nodes=ds0.t_order_${0..1}
spring.sharding.jdbc.config.sharding.tables.t_order.table-strategy=standard
spring.sharding.jdbc.config.sharding.tables.t_order.table-strategy.inline.algorithm-expression=t_order_${table_suffix % 2}

在这个配置文件中，我们定义了数据源名称 ds0，以及一个名为 t_order 的表，它将被分片到两个表中 t_order_0 和 t_order_1。这里的分片策略是基于表后缀的取模运算。

通过以上配置，你可以快速搭建一个基于 Sharding-JDBC 的分库分表应用。