使用 Spring Boot 连接到平凯数据库

平凯数据库是一个兼容 MySQL 的数据库。Spring 是当前比较流行的开源 Java 容器框架，本文选择 Spring Boot 作为使用 Spring 的方式。

本文档将展示如何使用平凯数据库和 Spring Data JPA 及 Hibernate 作为 JPA 提供者来完成以下任务：

配置你的环境。
使用 Spring Data JPA 与 Hibernate 连接到平凯数据库集群。
构建并运行你的应用程序。你也可以参考示例代码片段，完成基本的 CRUD 操作。

前置需求

推荐 Java Development Kit (JDK) 17 及以上版本。你可以根据公司及个人需求，自行选择 OpenJDK 或 Oracle JDK。
Maven 3.8 及以上版本。
Git。
平凯数据库集群。

如果你还没有平凯数据库集群，可以按如下方式创建一个：

在本地快速部署平凯数据库测试集群
部署平凯数据库正式生产集群，创建一个本地集群

运行代码并连接到平凯数据库

本小节演示如何运行示例应用程序的代码，并连接到 TiDB。

第 1 步：克隆示例代码仓库到本地

运行以下命令，将示例代码仓库克隆到本地：

git clone https://github.com/tidb-samples/tidb-java-springboot-jpa-quickstart.git
cd tidb-java-springboot-jpa-quickstart

第 2 步：配置连接信息

运行以下命令，将 env.sh.example 复制并重命名为 env.sh：
```
cp env.sh.example env.sh
```
复制并粘贴对应 TiDB 的连接字符串至 env.sh 中。需更改部分示例结果如下：
```
export TIDB_HOST='{host}'
export TIDB_PORT='4000'
export TIDB_USER='root'  # e.g. xxxxxx.root
export TIDB_PASSWORD='{password}'
export TIDB_DB_NAME='test'
export USE_SSL='false'
```
注意替换 {} 中的占位符为你的 TiDB 对应的值，并设置 USE_SSL 为 false。如果你在本机运行 TiDB，默认 Host 地址为 127.0.0.1，密码为空。
保存 env.sh 文件。

第 3 步：运行代码并查看结果

运行下述命令，启动示例代码编写的服务：
```
make
```
打开另一个终端，开启请求脚本：
```
make request
```
查看 Expected-Output.txt，并与你的服务程序输出进行比较。结果近似即为连接成功。

示例代码片段

你可参考以下关键代码片段，完成自己的应用开发。

完整代码及其运行方式，见代码仓库 tidb-java-springboot-jpa-quickstart。

连接到平凯数据库

编写配置文件 application.yml：

spring:
  datasource:
    url: ${TIDB_JDBC_URL:jdbc:mysql://localhost:4000/test}
    username: ${TIDB_USER:root}
    password: ${TIDB_PASSWORD:}
    driver-class-name: com.mysql.cj.jdbc.Driver
  jpa:
    show-sql: true
    database-platform: org.hibernate.dialect.TiDBDialect
    hibernate:
      ddl-auto: create-drop

请在配置后将环境变量 TIDB_JDBC_URL、TIDB_USER 和 TIDB_PASSWORD 设置为你的 TiDB 集群的实际值。此配置文件带有环境变量默认配置，即在不配置环境变量时，变量的值为：

TIDB_JDBC_URL: "jdbc:mysql://localhost:4000/test"
TIDB_USER: "root"
TIDB_PASSWORD: ""

数据管理

Spring Data JPA 通过 @Entity 注册数据实体，并绑定数据库的表。

@Entity
@Table(name = "player_jpa")
public class PlayerBean {
}

PlayerRepository 通过继承 JpaRepository 接口，由 JpaRepositoryFactoryBean 为其自动注册对应的 Repository Bean。同时，JpaRepository 接口的默认实现类 SimpleJpaRepository 提供了增删改查函数的具体实现。

@Repository
public interface PlayerRepository extends JpaRepository<PlayerBean, Long> {
}

随后，在需要使用 PlayerRepository 的类中，你可以通过 @Autowired 自动装配，这样就可以直接使用增删改查函数了。示例代码如下：

@Autowired
private PlayerRepository playerRepository;

插入或更新数据

playerRepository.save(player);

更多信息参考插入数据和更新数据。

查询数据

PlayerBean player = playerRepository.findById(id).orElse(null);

更多信息参考查询数据。

删除数据

playerRepository.deleteById(id);

更多信息参考删除数据。

下一步

关于本文使用到的第三方库及框架，可以参考各自官方文档：
你可以继续阅读开发者文档，以获取更多关于 TiDB 应用开发的最佳实践。例如：插入数据、更新数据、删除数据、单表读取、事务、SQL 性能优化等。
如果你更倾向于参与课程进行学习，我们也提供专业的 TiDB 开发者课程支持，并在考试后提供相应的资格认证。
我们还额外提供针对 Java 开发者的课程：使用 Connector/J - TiDB v6 及在 TiDB 上开发应用的最佳实践 - TiDB v6。

需要帮助?

如果在开发的过程中遇到问题，可以在 AskTUG 上进行提问，寻求帮助。