基于达梦数据库开发-Java篇-编程知识

文章目录

前言
一、示例展示
- 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 {@Autowiredprivate 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;@TableIdprivate 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 {@Autowiredprivate BlockMapper blockMapper;@GetMapping("/list")@ResponseBodypublic 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: 网络通信异常