Data Access 之 MyBatis(三) - SQL Mapping XML(Part A)

简介: Data Access 之 MyBatis(三) - SQL Mapping XML(Part A)

一、SQL Mapping XML

MyBatis 的真正强大在于它的语句映射,这是它的魔力所在。由于它的异常强大,映射器的 XML 文件就显得相对简单。如果拿它跟具有相同功能的 JDBC 代码进行对比,你会立即发现省掉了将近 95% 的代码。MyBatis 致力于减少使用成本,让开发者能更专注于 SQL 代码。

mapper标签中的namespace属性即命名空间是指该映射文件所实现的Dao层的接口类

SQL 映射文件只有很少的几个顶级元素(按照应被定义的顺序列出):

  • cache – 该命名空间的缓存配置。
  • cache-ref – 引用其它命名空间的缓存配置。
  • resultMap – 描述如何从数据库结果集中加载对象,是最复杂也是最强大的元素。
  • sql – 可被其它语句引用的可重用语句块。
  • insert – 映射插入语句。
  • update – 映射更新语句。
  • delete – 映射删除语句。
  • select – 映射查询语句。

二、工程搭建

新建一个maven工程mybatis-mapping-xml,工程搭建步骤与上一篇QA 由浅入深持久层框架(二) - MyBatis Config XML中的搭建步骤一致。

三、insert, update 和 delete

数据变更语句 insert,update 和 delete 的实现非常接近,他们都拥有以下属性,其中红色字体标注的属性是常用的属性。

属性 描述
id 在命名空间中唯一的标识符,可以被用来引用这条语句。
parameterType 将会传入这条语句的参数的类全限定名或别名。这个属性是可选的,因为 MyBatis 可以通过类型处理器(TypeHandler)推断出具体传入语句的参数,默认值为未设置(unset)。 使用频次低。
parameterMap 用于引用外部 parameterMap 的属性,目前已被废弃。请使用行内参数映射和 parameterType 属性。
flushCache 将其设置为 true 后,只要语句被调用,都会导致本地缓存和二级缓存被清空,默认值:(对 insert、update 和 delete 语句)true。使用频次低。
timeout 这个设置是在抛出异常之前,驱动程序等待数据库返回请求结果的秒数。默认值为未设置(unset)(依赖数据库驱动)。
statementType 可选 STATEMENT,PREPARED 或 CALLABLE。这会让 MyBatis 分别使用 Statement,PreparedStatement 或 CallableStatement,默认值:PREPARED。使用频次低。
useGeneratedKeys (仅适用于 insert 和 update)这会令 MyBatis 使用 JDBC 的 getGeneratedKeys 方法来取出由数据库内部生成的主键(比如:像 MySQL 和 SQL Server 这样的关系型数据库管理系统的自动递增字段),默认值:false。
keyProperty (仅适用于 insert 和 update)指定能够唯一识别对象的属性,MyBatis 会使用 getGeneratedKeys 的返回值或 insert 语句的 selectKey 子元素设置它的值,默认值:未设置(unset)。如果生成列不止一个,可以用逗号分隔多个属性名称。
keyColumn (仅适用于 insert 和 update)设置生成键值在表中的列名,在某些数据库(像 PostgreSQL)中,当主键列不是表中的第一列的时候,是必须设置的。如果生成列不止一个,可以用逗号分隔多个属性名称。 使用频次低。
databaseId 如果配置了数据库厂商标识(databaseIdProvider),MyBatis 会加载所有不带 databaseId 或匹配当前 databaseId 的语句;如果带和不带的语句都有,则不带的会被忽略。

获取自增主键的值

数据存储在支持自增主键的数据库中,如何获取数据插入成功后数据库生成的主键值?

在EmployeeDaoTest中修改insertEmploye的测试方法,打印出插入成功后的主键值

@Test
public void insertEmployee() {
    Employee employee = new Employee();
    employee.setEmpName("peter");
    employee.setGender(0);
    employee.setEmail("peter@gmail.com");
    EmployeeDao employeeDao = openSession.getMapper(EmployeeDao.class);
    employeeDao.insertEmployee(employee);
    openSession.commit();
    System.out.println("ID为:" + employee.getId());
}
复制代码

执行测试方法

b23e7e48f33f4ac1b0caec1cb3080675_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

数据库中显示成功插入数据库

8f8fb89a828847299b2f6cbaef187509_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

但是获取到的主键值为null,MyBatis是如何获取自增主键的值的?

修改insertEmployee方法对应的SQL语句,增加两个属性

<insert id="insertEmployee" useGeneratedKeys="true" keyProperty="id">
    INSERT INTO t_employee(empname,gender,email) values (#{empName},#{gender},#{email})
</insert>
复制代码
  • useGeneratedKeys:默认为false,即不使用生成的主键
  • keyProperty:将自增主键赋值给指定的属性

再次执行测试方法

65db3ce2bc1e4614a33fa04f8b2ac528_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

现实成功打印出主键的值,且与数据库中生成的主键一致

useGeneratedKeys="true"就表示是MyBatis调用了Statement接口中的getGenerateKeys()方法,获取数据库自动生成的主键值,然后赋值给keyProperty属性指定的实体类属性

获取非自增主键的值

对于不支持自定生成主键的数据库如Oracle则可以使用selectKey子标签,selectKey标签内的语句可以设置运行顺序,是先执行还是后执行;设置为先执行则可以先查出最大的id,进行+1操作,然后在赋值给新插入的id。

selectKey标签有以下属性

属性 描述
keyProperty selectKey 语句结果应该被设置到的目标属性。如果生成列不止一个,可以用逗号分隔多个属性名称。
keyColumn 返回结果集中生成列属性的列名。如果生成列不止一个,可以用逗号分隔多个属性名称。
resultType 结果的类型。通常 MyBatis 可以推断出来,但是为了更加准确,写上也不会有什么问题。MyBatis 允许将任何简单类型用作主键的类型,包括字符串。如果生成列不止一个,则可以使用包含期望属性的 Object 或 Map。
order 可以设置为 BEFOREAFTER。如果设置为 BEFORE,那么它首先会生成主键,设置 keyProperty 再执行插入语句。如果设置为 AFTER,那么先执行插入语句,然后是 selectKey 中的语句 - 这和 Oracle 数据库的行为相似,在插入语句内部可能有嵌入索引调用。
statementType 和前面一样,MyBatis 支持 STATEMENTPREPAREDCALLABLE 类型的映射语句,分别代表 Statement, PreparedStatementCallableStatement 类型。

在EmployeeDao接口中新增一个insert的方法,不实用自增主键。

int insertEmployeeWithAllProperties(Employee employee);
复制代码

在employee.xml中增加响应的SQL映射语句,使用selectKey标签查出来的并经过计算后得出的值作为插入的id主键值

<insert id="insertEmployeeWithAllProperties">
    <selectKey order="BEFORE" resultType="integer" keyProperty="id">
        select max(id)+1 from t_employee
    </selectKey>
    INSERT INTO t_employee(id,empname,gender,email) values (#{id},#{empName},#{gender},#{email})
</insert>
复制代码

order属性定义了selectKey标签中SQL语句的执行顺序是先执行

在EmployeeDaoTest中增加测试方法insertEmployeeWithAllProperties

@Test
public void insertEmployeeWithAllProperties() {
    Employee employee = new Employee();
    employee.setEmpName("hulk");
    employee.setGender(0);
    employee.setEmail("hulk@gmail.com");
    EmployeeDao employeeDao = openSession.getMapper(EmployeeDao.class);
    employeeDao.insertEmployeeWithAllProperties(employee);
    openSession.commit();
    System.out.println("ID为:" + employee.getId());
}
复制代码

执行测试

cbadbc97759e470cb1f82b975ae15daa_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

成功打印出主键的值,查看数据库中插入的数据

93f676f0bd674696b2315fceef92a040_tplv-k3u1fbpfcp-zoom-in-crop-mark_4536_0_0_0.png

两者一致,对于不支持自增主键的数据库可以通过selectKey标签的方式获取主键的值


相关文章
|
3月前
|
XML SQL 数据格式
XML动态sql查询当前时间之前的信息报错
XML动态sql查询当前时间之前的信息报错
54 2
|
21天前
|
SQL 缓存 Java
MyBatis如何关闭一级缓存(分注解和xml两种方式)
MyBatis如何关闭一级缓存(分注解和xml两种方式)
61 5
|
5月前
|
XML Java 数据库连接
MyBatis入门——MyBatis XML配置文件(3)
MyBatis入门——MyBatis XML配置文件(3)
74 6
|
1月前
|
SQL 存储 机器学习/深度学习
将 AWS Data Lake 和 S3 与 SQL Server 结合使用
将 AWS Data Lake 和 S3 与 SQL Server 结合使用
57 0
|
2月前
|
SQL XML Java
mybatis :sqlmapconfig.xml配置 ++++Mapper XML 文件(sql/insert/delete/update/select)(增删改查)用法
当然,这些仅是MyBatis功能的初步介绍。MyBatis还提供了高级特性,如动态SQL、类型处理器、插件等,可以进一步提供对数据库交互的强大支持和灵活性。希望上述内容对您理解MyBatis的基本操作有所帮助。在实际使用中,您可能还需要根据具体的业务要求调整和优化SQL语句和配置。
48 1
|
3月前
|
SQL Java 数据库连接
MyBatis Mapper.XML 标签使用说明
MyBatis Mapper.XML 标签使用说明
38 0
|
5月前
|
SQL XML 数据库
后端数据库开发高级之通过在xml文件中映射实现动态SQL
后端数据库开发高级之通过在xml文件中映射实现动态SQL
52 3
|
5月前
|
SQL XML Java
后端数据库开发JDBC编程Mybatis之用基于XML文件的方式映射SQL语句实操
后端数据库开发JDBC编程Mybatis之用基于XML文件的方式映射SQL语句实操
73 3
|
4月前
|
XML Java 数据格式
支付系统----微信支付20---创建案例项目--集成Mybatis-plus的补充,target下只有接口的编译文件,xml文件了,添加日志的写法
支付系统----微信支付20---创建案例项目--集成Mybatis-plus的补充,target下只有接口的编译文件,xml文件了,添加日志的写法
|
5月前
|
XML Java 数据库连接
MyBatis第二课,灰度发布,@Results注解,使用xml书写mysql
MyBatis第二课,灰度发布,@Results注解,使用xml书写mysql