mybatis-plus opengauss

### 关于 MyBatis-Plus 与 openGauss 数据库集成

#### 准备工作

为了使 MyBatis-Plus 能够成功连接并操作 openGauss 数据库，需先完成必要的准备工作：

1. **下载驱动程序**
确保已获取适用于 Java 应用程序的最新版 openGauss JDBC 驱动包。该文件通常是一个 `.jar` 文件。

2. **配置依赖项**

对于 Maven 用户，在项目的 `pom.xml` 文件中加入如下依赖声明以引入所需的组件：

<dependencies>
    <!-- OpenGauss JDBC Driver -->
    <dependency>
        <groupId>org.opengauss</groupId>
        <artifactId>opengauss-jdbc</artifactId>
        <version>x.x.x</version><!-- 替换成实际版本号 -->
    </dependency>

    <!-- MyBatis Plus Core Library -->
    <dependency>
        <groupId>com.baomidou</groupId>
        <artifactId>mybatis-plus-boot-starter</artifactId>
        <version>y.y.y</version><!-- 替换成实际版本号 -->
    </dependency>
</dependencies>

3. **设置数据源属性**

编辑 Spring Boot 的应用配置文件 (`application.yml`) 来指定数据库连接参数：

spring:
  datasource:
    url: jdbc:opengauss://localhost:5432/your_database_name?currentSchema=public&stringtype=unspecified
    username: your_username
    password: your_password
    driver-class-name: org.opengauss.Driver

请注意替换上述模板中的占位符为具体的值，如主机地址、端口号、数据库名称以及认证凭证等信息。

#### 创建实体类映射

定义一个简单的 POJO 类用于表示表结构，并利用 Lombok 插件简化 getter/setter 方法编写过程：

import com.baomidou.mybatisplus.annotation.TableField;
import com.baomidou.mybatisplus.annotation.TableName;

@Data
@TableName("example_table")
public class ExampleEntity {
    
    @TableField(value = "id", exist = true)
    private Long id;

    @TableField(value = "name", exist = true)
    private String name;

}

此处假设存在名为 `example_table` 的表格，其中包含两列——`id` 和 `name`；如果实际情况有所不同，则应相应调整字段名及其注解。

#### 编写 Mapper 接口

创建继承自 BaseMapper<T> 的接口作为持久层访问入口点：

import com.baomidou.mybatisplus.core.mapper.BaseMapper;

public interface ExampleMapper extends BaseMapper<ExampleEntity> {}

由于采用了约定优于配置的原则，默认情况下框架会自动识别到此接口并与之前定义好的 Entity 对象建立关联关系。

#### 测试验证功能正常与否

最后一步是在单元测试里调用 CRUD API 进行基本的功能检验：

@SpringBootTest
class ApplicationTests {

@Autowired
private ExampleMapper exampleMapper;

@Test
void testInsert() {
    ExampleEntity entity = new ExampleEntity();
    entity.setName("Test Entry");
    int result = exampleMapper.insert(entity);
    System.out.println(result > 0 ? "插入成功" : "插入失败");
}

// 更多测试方法...
}

以上即完成了基于 MyBatis-Plus 实现对 openGauss 数据库的支持[^1]。