基于达梦数据库开发-Java篇

news2024/11/18 6:32:18

文章目录

前言
一、示例展示
- 1.环境准备
- 2.采用基础的jdbc调用
- 3.采用扩展的mybatis调用
二、注意事项
- 1.使用路径注解
- 2.数据库对象的准确引用
三、可能异常
- 1.无效的表或视图名
- 2.无效的表或视图名
- 3.网络通信异常
总结

前言

达梦提供了JDBC方式的驱动以便进行Java开发。默认情况下相关Jar包可在部署的数据库安装目录 /dmdbms/drivers/jdbc中获取，一般情况下在JDK8环境下采用DmJdbcDriver18.jar 进行相关的达梦数据库开发。本文讲述基于IDEA开发工具，使用SpringBoot框架进行简单的达梦开发示例，并讨论可能遇到的问题。

一、示例展示

1.环境准备

搭建一个达梦数据库，并建立相关账户及数据库对象（本例建立用户TESTDM，并在该用户下建立表TEST_BLOCK_T）
在安装目录 /dmdbms/drivers/jdbc中复制文件DmJdbcDriver18.jar到本地
在IDEA中搭建SpringBoot工程并引入文件DmJdbcDriver18.jar（本例工程中建立lib文件夹，并在文件夹中引入文件DmJdbcDriver18.jar）

2.采用基础的jdbc调用

使用jdbc方式调用达梦数据库的核心操作包含以下几步：

在pom文件配置相关jar包信息，其中达梦包引用本地路径

        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-jdbc</artifactId>
        </dependency>
        <dependency>
            <groupId>com.dm</groupId>
            <artifactId>Dm8JdbcDriver</artifactId>
            <version>1.8</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/lib/DmJdbcDriver18.jar</systemPath>
        </dependency>

配置application.properties

spring.datasource.driverClassName=dm.jdbc.driver.DmDriver
spring.datasource.url=jdbc:dm://10.1.29.113:5236
spring.datasource.username=TESTDM
spring.datasource.password=123456

添加控制类文件DbController.java

@RestController
public class DbController {
    @Autowired
    private JdbcTemplate jdbcTemplate;

    @GetMapping("/queryDbVersion")
    public List queryDbVersion() {
        System.out.println("test ok111");
        return jdbcTemplate.queryForList(
                "SELECT block_id,block_name  FROM TEST_BLOCK_T");
    }
}

运行后正常情况下在浏览器输入 http://localhost:8080/queryDbVersion 会展示如下结果
在这里插入图片描述

3.采用扩展的mybatis调用

使用扩展的mybatis方式调用达梦数据库的核心操作包含以下几步：

在pom文件配置相关jar包信息，其中达梦包引用本地路径

        <dependency>
            <groupId>com.baomidou</groupId>
            <artifactId>mybatis-plus-boot-starter</artifactId>
            <version>3.4.1</version>
        </dependency>
        <dependency>
            <groupId>com.dm</groupId>
            <artifactId>Dm8JdbcDriver</artifactId>
            <version>1.8</version>
            <scope>system</scope>
            <systemPath>${project.basedir}/lib/DmJdbcDriver18.jar</systemPath>
        </dependency>

配置application.properties（与jdbc调用的配置方式相同）
添加实体类文件Block.java

@TableName(value = "TEST_BLOCK_T")
public class Block {
    private static final long serialVersionUID = 1L;

    @TableId
    private String blockId;

    private String blockName;

    public String getBlockId() {
        return blockId;
    }

    public void setBlockId(String blockId) {
        this.blockId = blockId;
    }

    public String getBlockName() {
        return blockName;
    }

    public void setBlockName(String blockName) {
        this.blockName = blockName;
    }

}

添加映射接口文件BlockMapper.java

@Mapper
public interface BlockMapper extends BaseMapper<Block> {
}

添加控制类文件BlockController.java

@RestController
@RequestMapping("/hello")
public class BlockController {
    @Autowired
    private BlockMapper blockMapper;


    @GetMapping("/list")
    @ResponseBody
    public List index() {

        //直接调用BaseMapper封装好的CRUD方法，就可实现无条件查询数据
        List<Block> list = blockMapper.selectList(null);

        //循环获取用户数据
        for (Block block:list){
            //获取用户名称
            System.out.println(block.getBlockName());
        }
        return list;

运行后正常情况下在浏览器输入 http://localhost:8080/queryDbVersion 会展示与jdbc调用相同的结果

二、注意事项

1.使用路径注解

示例讲述的工程是以标准路径方式建立的，其文件结构如下所示
在这里插入图片描述
有时候因特殊情况，我们建立的工程可能并不是规范的路径，例如工程路径如下所示

在这里插入图片描述

这时候需要在相关的启动文件中添加@ComponentScan与@MapperScan注解信息，类似如下所示

@SpringBootApplication
@MapperScan("com.mapper")
@ComponentScan("com.controller")
public class demo  {

    public static void main(String[] args) {
         SpringApplication.run(demo.class, args);
    }

}

2.数据库对象的准确引用

在之前调用示例中我们使用账户TESTDM登录时对象TEST_BLOCK_T只在模式TESTDM中存在，如果该对象在多个模式下存在，则需要做相应处理，以下为两种处理方式：

调整application.properties

spring.datasource.driverClassName=dm.jdbc.driver.DmDriver
spring.datasource.url=jdbc:dm://10.1.29.113:5236/TESTDM
spring.datasource.username=TESTDM
spring.datasource.password=123456

在spring.datasource.url中明确指出调用的模式

增加对象的模式节点引用
修改实体类文件Block.java注解为

@TableName(value = "TESTDM.TEST_BLOCK_T")

三、可能异常

1.无效的表或视图名

在运行工程中如果出现如下类似错误

2024-04-16 15:27:43.466 ERROR 1120 --- [nio-8080-exec-1] o.a.c.c.C.[.[.[/].[dispatcherServlet]    : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is org.springframework.dao.DataIntegrityViolationException:
### Error querying database.  Cause: dm.jdbc.driver.DMException: 第1 行附近出现错误:
无效的表或视图名[TEST_BLOCK_T]

可能数据库账号默认模式中没有相关表，需要准确引用

2.无效的表或视图名

2024-04-17 14:20:00.878 ERROR 25116 --- [nio-8080-exec-1] o.a.c.c.C.[.[.[/].[dispatcherServlet]    : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.exceptions.PersistenceException:
### Error querying database.  Cause: org.springframework.jdbc.CannotGetJdbcConnectionException: Failed to obtain JDBC Connection; nested exception is dm.jdbc.driver.DMException: 用户名或密码错误

可能数据库账号或密码的不对，有可能为大小写不一致导致

3.网络通信异常

2024-04-17 14:22:25.803 ERROR 41240 --- [nio-8080-exec-1] o.a.c.c.C.[.[.[/].[dispatcherServlet]    : Servlet.service() for servlet [dispatcherServlet] in context with path [] threw exception [Request processing failed; nested exception is org.mybatis.spring.MyBatisSystemException: nested exception is org.apache.ibatis.exceptions.PersistenceException:
### Error querying database.  Cause: org.springframework.jdbc.CannotGetJdbcConnectionException: Failed to obtain JDBC Connection; nested exception is dm.jdbc.driver.DMException: 网络通信异常