达梦数据库与Spring Boot整合实战

达梦数据库（DM Database）是中国自主研发的高性能关系型数据库管理系统，广泛应用于金融、政府、能源等领域。将达梦数据库与Spring Boot整合可以充分利用Spring Boot的快速开发能力和达梦数据库的高性能特性。本文将详细讲解如何在Spring Boot项目中整合达梦数据库，并提供实际操作步骤和代码示例。

1. 准备工作

1.1 环境搭建

• 操作系统：Windows/Linux/MacOS
• JDK版本：建议使用JDK 8或更高版本。
• Spring Boot版本：2.5.x 或更高版本。
• 达梦数据库版本：8.x 或更高版本。
• 开发工具：IntelliJ IDEA 或 Eclipse。

1.2 下载达梦驱动

达梦数据库提供了官方的JDBC驱动程序。可以从达梦官网下载对应版本的dmjdbc.jar文件，并将其添加到项目的依赖中。

2. Spring Boot项目配置

2.1 创建Spring Boot项目

通过Spring Initializr创建一个基础的Spring Boot项目，确保包含以下依赖：

• Spring Web
• Spring Data JPA
• Spring Boot DevTools

2.2 添加达梦数据库驱动

将下载的dmjdbc.jar文件添加到项目的lib目录下，或者直接通过Maven本地仓库引入。

如果使用Maven构建项目，可以在pom.xml中添加如下依赖（需手动安装驱动到本地仓库）：

<dependency>
    <groupId>com.dameng</groupId>
    <artifactId>dmjdbc</artifactId>
    <version>8.0</version>
    <scope>system</scope>
    <systemPath>${project.basedir}/lib/dmjdbc.jar</systemPath>
</dependency>

2.3 配置application.yml

在application.yml中配置达梦数据库连接信息：

spring:
  datasource:
    url: jdbc:dm://localhost:5236/TESTDB
    username: SYSDBA
    password: manager
    driver-class-name: dm.jdbc.driver.DmDriver
  jpa:
    hibernate:
      ddl-auto: update
    show-sql: true
    properties:
      hibernate:
        dialect: org.hibernate.dialect.DM8Dialect

• url：达梦数据库的连接地址。
• username 和 password：数据库用户名和密码。
• driver-class-name：达梦数据库的JDBC驱动类。
• hibernate.dialect：指定Hibernate使用的方言。

3. 实体类与Repository定义

3.1 创建实体类

假设我们需要操作一个用户表USER_INFO，定义对应的实体类：

import jakarta.persistence.Entity;
import jakarta.persistence.GeneratedValue;
import jakarta.persistence.GenerationType;
import jakarta.persistence.Id;

@Entity
public class UserInfo {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;
    private String name;
    private String email;

    // Getters and Setters
}

3.2 创建Repository接口

使用Spring Data JPA简化数据访问逻辑：

import org.springframework.data.jpa.repository.JpaRepository;

public interface UserInfoRepository extends JpaRepository<UserInfo, Long> {
}

4. 控制器与服务层

4.1 创建服务层

定义一个简单的服务类来处理业务逻辑：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Service;

import java.util.List;

@Service
public class UserService {
    @Autowired
    private UserInfoRepository userInfoRepository;

    public List<UserInfo> getAllUsers() {
        return userInfoRepository.findAll();
    }

    public UserInfo saveUser(UserInfo user) {
        return userInfoRepository.save(user);
    }
}

4.2 创建控制器

暴露RESTful接口供客户端调用：

import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

@RestController
@RequestMapping("/users")
public class UserController {
    @Autowired
    private UserService userService;

    @GetMapping
    public List<UserInfo> getAllUsers() {
        return userService.getAllUsers();
    }

    @PostMapping
    public UserInfo createUser(@RequestBody UserInfo user) {
        return userService.saveUser(user);
    }
}

5. 数据库初始化脚本

为了方便测试，可以在resources目录下创建SQL脚本文件schema.sql，用于初始化表结构：

CREATE TABLE USER_INFO (
    ID BIGINT PRIMARY KEY AUTO_INCREMENT,
    NAME VARCHAR(255) NOT NULL,
    EMAIL VARCHAR(255) NOT NULL
);

6. 运行与测试

启动Spring Boot应用后，可以通过Postman或其他工具测试API接口：

• GET /users：获取所有用户。
• POST /users：新增用户。

例如，发送以下JSON数据到POST /users接口：

{
    "name": "John Doe",
    "email": "john.doe@example.com"
}

7. 常见问题及解决方法

7.1 连接失败

• 原因：可能是数据库URL、用户名或密码错误。
• 解决：检查application.yml中的配置是否正确。

7.2 Hibernate方言不匹配

• 原因：未正确设置hibernate.dialect。
• 解决：确保使用org.hibernate.dialect.DM8Dialect。

7.3 驱动未加载

• 原因：dmjdbc.jar未正确添加到项目中。
• 解决：确认驱动已添加到lib目录并正确引用。