mybatis--入门程序

入门程序

需求：

对用户信息的增删改查操作。

1、  根据用户ID来查询用户信息；

2、  根据用户名称来模糊查询用户信息列表；

3、  添加用户

4、  删除用户（练习）

5、  修改用户（练习）

1、环境准备

l  Jdk环境：jdk1.7.0_72

l  Ide环境：eclipse indigo

l  数据库环境：MySQL5.1

l  Mybatis：3.2.7

1、数据库初始化

数据库脚本：

/*SQLyog v10.2 MySQL - 5.1.72-community : Database - mybatis**********************************************************************//*!40101 SET NAMES utf8 */;/*!40101 SET SQL_MODE=''*/;/*!40014 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0 */;/*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */;/*!40101 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO' */;/*!40111 SET @OLD_SQL_NOTES=@@SQL_NOTES, SQL_NOTES=0 */;/*Table structure for table `items` */CREATE TABLE `items` (  `id` int(11) NOT NULL AUTO_INCREMENT,  `name` varchar(32) NOT NULL COMMENT '商品名称',  `price` float(10,1) NOT NULL COMMENT '商品定价',  `detail` text COMMENT '商品描述',  `pic` varchar(64) DEFAULT NULL COMMENT '商品图片',  `createtime` datetime NOT NULL COMMENT '生产日期',  PRIMARY KEY (`id`)) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8;/*Table structure for table `orderdetail` */CREATE TABLE `orderdetail` (  `id` int(11) NOT NULL AUTO_INCREMENT,  `orders_id` int(11) NOT NULL COMMENT '订单id',  `items_id` int(11) NOT NULL COMMENT '商品id',  `items_num` int(11) DEFAULT NULL COMMENT '商品购买数量',  PRIMARY KEY (`id`),  KEY `FK_orderdetail_1` (`orders_id`),  KEY `FK_orderdetail_2` (`items_id`),  CONSTRAINT `FK_orderdetail_1` FOREIGN KEY (`orders_id`) REFERENCES `orders` (`id`) ON DELETE NO ACTION ON UPDATE NO ACTION,  CONSTRAINT `FK_orderdetail_2` FOREIGN KEY (`items_id`) REFERENCES `items` (`id`) ON DELETE NO ACTION ON UPDATE NO ACTION) ENGINE=InnoDB AUTO_INCREMENT=5 DEFAULT CHARSET=utf8;/*Table structure for table `orders` */CREATE TABLE `orders` (  `id` int(11) NOT NULL AUTO_INCREMENT,  `user_id` int(11) NOT NULL COMMENT '下单用户id',  `number` varchar(32) NOT NULL COMMENT '订单号',  `createtime` datetime NOT NULL COMMENT '创建订单时间',  `note` varchar(100) DEFAULT NULL COMMENT '备注',  PRIMARY KEY (`id`),  KEY `FK_orders_1` (`user_id`),  CONSTRAINT `FK_orders_id` FOREIGN KEY (`user_id`) REFERENCES `user` (`id`) ON DELETE NO ACTION ON UPDATE NO ACTION) ENGINE=InnoDB AUTO_INCREMENT=6 DEFAULT CHARSET=utf8;/*Table structure for table `user` */CREATE TABLE `user` (  `id` int(11) NOT NULL AUTO_INCREMENT,  `username` varchar(32) NOT NULL COMMENT '用户名称',  `birthday` date DEFAULT NULL COMMENT '生日',  `sex` char(1) DEFAULT NULL COMMENT '性别',  `address` varchar(256) DEFAULT NULL COMMENT '地址',  PRIMARY KEY (`id`)) ENGINE=InnoDB AUTO_INCREMENT=27 DEFAULT CHARSET=utf8;/*!40101 SET SQL_MODE=@OLD_SQL_MODE */;/*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */;/*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */;/*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */;

1、  执行sql_table.sql脚本，创建数据库表；

2、  执行sql_data.sql初始化测试数据。

数据库表：

订单商品案例的数据库脚本中，总共包含四张表，其中入门程序只使用user表：

用户表的表结构如下：

2、下载mybatis

mybaits的代码由github.com管理，下载地址：https://github.com/mybatis/mybatis-3/releases

Lib：mybatis的依赖包

Mybatis-3.2.7.jar：mybatis的核心包

Mybatis-3.2.7.pdf：mybatis的使用指南

2、工程搭建

第一步：创建java工程

用eclipse创建一个java工程，jdk使用1.7.0_72。

第二步：加入jar包

加入以下四部分jar包，其中junit的jar包，是非必须的。

l  Mybatis核心包

l  Mybatis依赖包

l  MySQL驱动包

l  Junit单元测试包（单元测试需要的包）

第三步：添加log4j.properties文件

Mybatis使用的日志包是log4j的，所以需要添加log4j.properties。

在classpath下创建log4j.properties如下：

文件内容可以从mybatis-3.2.7.pdf中拷贝

# Global logging configurationlog4j.rootLogger=DEBUG, stdout# Console output...log4j.appender.stdout=org.apache.log4j.ConsoleAppenderlog4j.appender.stdout.layout=org.apache.log4j.PatternLayoutlog4j.appender.stdout.layout.ConversionPattern=%5p [%t] - %m%n

日志级别在开发阶段设置成DEBUG，在生产阶段设置成INFO或者ERROR。

4、编程步骤

1、  创建PO类，根据需求创建；

2、  创建全局配置文件SqlMapConfig.xml；

3、  编写映射文件；

4、  加载映射文件，在SqlMapConfig.xml中进行加载；

5、  编写测试程序，即编写Java代码，连接并操作数据库。

         思路：

a)        读取配置文件；

b)        通过SqlSessionFactoryBuilder创建SqlSessionFactory会话工厂。

c)        通过SqlSessionFactory创建SqlSession。

d)        调用SqlSession的操作数据库方法。

e)        关闭SqlSession。

5、代码开发

(1)创建PO类

创建的po类的属性要和数据库中表的列名一致（如果表中的列名是带有下划线，那么po类中对应的的属性名要采用驼峰式命名）

User.java类如下：

package com.itheima.mybatis.po;/** *   * <p> * Title: User */public class User {private int id;private String username;// 用户姓名private String sex;// 性别private Date birthday;// 生日private String address;// 地址public int getId() {return id;}public void setId(int id) {this.id = id;}public String getUsername() {return username;}public void setUsername(String username) {this.username = username;}public String getSex() {return sex;}public void setSex(String sex) {this.sex = sex;}public Date getBirthday() {return birthday;}public void setBirthday(Date birthday) {this.birthday = birthday;}public String getAddress() {return address;}public void setAddress(String address) {this.address = address;}@Overridepublic String toString() {return "User [id=" + id + ", username=" + username + ", sex=" + sex+ ", birthday=" + birthday + ", address=" + address + "]";}}

(2)创建SqlMapConfig.xml配置文件

在classpath下，创建SqlMapConfig.xml文件

SqlMapConfig.xml（文件头可以从mybatis-3.2.7.pdf文档的2.1.2小节中拷贝）：

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE configurationPUBLIC "-//mybatis.org//DTD Config 3.0//EN""http://mybatis.org/dtd/mybatis-3-config.dtd"><configuration><!-- 配置mybatis的环境信息,与spring整合，该信息由spring来管理 --><environments default="development"><environment id="development"><!-- 配置JDBC事务控制，由mybatis进行管理 --><transactionManager type="JDBC"></transactionManager><!-- 配置数据源，采用mybatis连接池 --><dataSource type="POOLED"><property name="driver" value="com.mysql.jdbc.Driver"/><property name="url" value="jdbc:mysql://localhost:3306/mybatis?useUnicode=true&characterEncoding=utf8"/><property name="username" value="root"/><property name="password" value="123456"/></dataSource></environment></environments><!-- 加载映射文件 User.xml --><mappers><mapper resource="User.xml"/></mappers></configuration>

(3)需求开发

在classpath下，创建sqlmap文件夹。在sqlmap目录下，创建User.xml映射文件。

Mybatis的映射文件头（可以从mybatis-3.2.7.pdf文件中拷贝）：

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE mapper    PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"    "http://mybatis.org/dtd/mybatis-3-mapper.dtd">

1、根据用户ID查询用户信息

在config目录下，创建User.xml（这种命名规范是由ibatis遗留下来）

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE mapper    PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN"    "http://mybatis.org/dtd/mybatis-3-mapper.dtd"><!-- namespace：命名空间，对statement的信息进行分类管理 --><!-- 注意：在mapper代理时，它具有特殊及重要的作用 --><mapper namespace="test"><!-- 根据用户ID查询用户信息 --><!-- select：表示一个MappedStatement对象 --><!-- id：statement的唯一标示 --><!-- #{}：表示一个占位符？ --><!-- #{id}：里面的id表示输入参数的参数名称，如果该参数是简单类型，那么#{}里面的参数名称可以任意 --><!-- parameterType：输入参数的java类型 --><!-- resultType：输出结果的所映射的java类型（单条结果所对应的java类型） --><select id="findUserById" parameterType="int" resultType="com.itheima.mybatis.po.User">SELECT * FROM USER WHERE id =#{id}</select></mapper>

在全局配置文件（SqlMapConfig.xml）中加载映射文件（User.xml）

<!-- 加载映射文件 --><mappers><mapper resource="User.xml"/></mappers>

测试代码：

public class MybatisFirst {@Testpublic void findUserByIdTest() throws Exception{//1、读取配置文件String resource = "SqlMapConfig.xml";InputStream inputStream = Resources.getResourceAsStream(resource);//2、根据配置文件创建SqlSessionFactorySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);//3、SqlSessionFactory创建SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();//4、SqlSession执行statement，并返回映射结果//第一个参数：statement的id，建议：namespace.statementId（确保唯一）//第二个参数：入参的值，它的类型要和映射文件中对应的statement的入参类型一致User user = sqlSession.selectOne("test.findUserById", 1);//打印输出结果集System.out.println(user);//5、关闭SqlSessionsqlSession.close();}}

2、根据用户名称来模糊查询用户信息列表

映射文件：在User.xml中添加：

<!-- 根据用户名称模糊查询用户列表 --><!-- ${}：表示一个sql的连接符 --><!-- ${value}：里面的value表示输入参数的参数名称，如果该参数是简单类型，那么${}里面的参数名称必须是value --><!-- ${}这种写法存在sql注入的风险，所以要慎用！！但是在一些场景下，必须使用${}，比如排序时，动态传入排序的列名，${}会原样输出，不加解释 --><select id="findUsersByName" parameterType="java.lang.String"resultType="com.itheima.mybatis.po.User">SELECT * FROM USER WHERE username LIKE '%${value}%'</select>

加载映射文件：已配置

测试代码：

@Testpublic void findUsersByNameTest() throws Exception {// 1、读取配置文件String resource = "SqlMapConfig.xml";InputStream inputStream = Resources.getResourceAsStream(resource);// 2、根据配置文件创建SqlSessionFactorySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);// 3、SqlSessionFactory创建SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();// 4、SqlSession执行statement，并返回映射结果// 第一个参数：statement的id，建议：namespace.statementId（确保唯一）// 第二个参数：入参的值，它的类型要和映射文件中对应的statement的入参类型一致List<User> users = sqlSession.selectList("test.findUsersByName", "小明");// 打印输出结果集System.out.println(users);// 5、关闭SqlSessionsqlSession.close();}

3、添加用户
映射文件：在User.xml中添加：

<!-- 添加用户 --><!-- 如果主键的值是通过MySQL自增机制生成的，那么我们此处不需要再显示的给ID赋值 --><insert id="insertUser" parameterType="cn.itcast.mybatis.po.User">INSERT INTO USER(username,sex,birthday,address) VALUES (#{username},#{sex},#{birthday},#{address})</insert>

测试代码：

注意：增删改操作要对SqlSession执行commit操作。

  @Testpublic void insertUserTest() throws Exception {// 1、读取配置文件String resource = "SqlMapConfig.xml";InputStream inputStream = Resources.getResourceAsStream(resource);// 2、根据配置文件创建SqlSessionFactorySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);// 3、SqlSessionFactory创建SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();// 4、SqlSession执行statement，并返回映射结果//构建user参数，没有赋值的属性采取默认值User user = new User();user.setUsername("东哥1");user.setAddress("清河宝盛西里");// 第一个参数：statement的id，建议：namespace.statementId（确保唯一）// 第二个参数：入参的值，它的类型要和映射文件中对应的statement的入参类型一致sqlSession.insert("test.insertUser", user);//切记：增删改操作时，要执行commit操作sqlSession.commit();// 5、关闭SqlSessionsqlSession.close();}

3.1、主键返回之MySQL自增主键

思路：

Ø  MySQL自增主键，是指在insert之前MySQL会自动生成一个自增的主键。

Ø  我们可以通过MySQL的函数获取到刚插入的自增主键:

LAST_INSERT_ID()

Ø  这个函数是在insert语句之后去调用。

 

修改映射文件：

<!-- 添加用户之自增主键返回（selectKey方式） --><!-- [selectKey标签]：通过select查询来生成主键[keyProperty]：指定存放生成主键的属性[resultType]：生成主键所对应的Java类型[order]：指定该查询主键SQL语句的执行顺序，相对于insert语句[last_insert_id]：MySQL的函数，要配合insert语句一起使用--><insert id="insertUser" parameterType="cn.itcast.mybatis.po.User"><selectKey keyProperty="id" resultType="int" order="AFTER">SELECT LAST_INSERT_ID()</selectKey>INSERT INTO USER(username,sex,birthday,address) VALUES (#{username},#{sex},#{birthday},#{address})

3.2主键返回之MySQL函数UUID

注意：使用mysql的uuid()函数生成主键，需要修改表中id字段类型为string，长度设置成35位。

<!-- 添加用户之UUID主键返回 --><!-- [uuid]：MySQL的函数，生成的主键是35位的字符串，所以使用它时要修改id的类型为字符类型注意：1、此时order采用BEFORE，因为需要先生成出主键，再执行insert语句，只要不是自增主键，order都设为before2、显式的给ID赋值--><insert id="insertUser" parameterType="cn.itcast.mybatis.po.User"><selectKey keyProperty="id" resultType="string" order="BEFORE">SELECT UUID()</selectKey>INSERT INTO USER(id,username,sex,birthday,address) VALUES (#{id},#{username},#{sex},#{birthday},#{address})</insert>

3.3主键返回之Oracle序列返回

序列也就是sequence，它是Oracle的主键生成策略

<!-- 添加用户之sequence返回 --><!-- 通过Oracle的sequence获取主键方式与MySQL的uuid方式基本一致--><insert id="insertUser" parameterType="cn.itcast.mybatis.po.User"><selectKey keyProperty="id" resultType="int" order="BEFORE">SELECT user_seq.nextval() FROM dual</selectKey>INSERT INTO USER(id,username,sex,birthday,address) VALUES (#{id},#{username},#{sex},#{birthday},#{address})</insert>

4、删除用户

编写映射文件：

<!-- 根据ID删除用户 --><delete id="deleteUser" parameterType="int">DELETE FROM USER WHERE id= #{id}</delete>

测试：

@Testpublic void deleteUserTest() throws Exception{// 1、读取配置文件String resource = "SqlMapConfig.xml";InputStream inputStream = Resources.getResourceAsStream(resource);// 2、根据配置文件创建SqlSessionFactorySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);// 3、SqlSessionFactory创建SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();// 4、SqlSession执行statement，并返回映射结果// 第一个参数：statement的id，建议：namespace.statementId（确保唯一）// 第二个参数：入参的值，它的类型要和映射文件中对应的statement的入参类型一致sqlSession.delete("test.deleteUser", 30);//切记：增删改操作时，要执行commit操作sqlSession.commit();// 5、关闭SqlSessionsqlSession.close();}

5、修改用户

映射文件：

<!-- 根据传入的用户信息修改用户 --><update id="updateUser" parameterType="cn.itcast.mybatis.po.User">UPDATE USER SET username = #{username},sex=#{sex} WHERE id=#{id}</update>

测试：

@Testpublic void updateUserTest() throws Exception{// 1、读取配置文件String resource = "SqlMapConfig.xml";InputStream inputStream = Resources.getResourceAsStream(resource);// 2、根据配置文件创建SqlSessionFactorySqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);// 3、SqlSessionFactory创建SqlSessionSqlSession sqlSession = sqlSessionFactory.openSession();// 4、SqlSession执行statement，并返回映射结果//构建user参数，没有赋值的属性采取默认值User user = new User();user.setId(28);user.setUsername("东哥11");user.setAddress("清河宝盛西里");// 第一个参数：statement的id，建议：namespace.statementId（确保唯一）// 第二个参数：入参的值，它的类型要和映射文件中对应的statement的入参类型一致sqlSession.update("test.updateUser", user);//切记：增删改操作时，要执行commit操作sqlSession.commit();// 5、关闭SqlSessionsqlSession.close();}

6、小结

1.1.1  parameterType和resultType

parameterType指定输入参数的java类型，可以填写别名或Java类的全限定名。

resultType指定输出结果的java类型，可以填写别名或Java类的全限定名。

1.1.2  #{}和${}

#{}：相当于预处理中的占位符？。

#{}里面的参数表示接收java输入参数的名称。

#{}可以接受HashMap、简单类型、POJO类型的参数。

当接受简单类型的参数时，#{}里面可以是value，也可以是其他。

#{}可以防止SQL注入。

${}：相当于拼接SQL串，对传入的值不做任何解释的原样输出。

${}会引起SQL注入，所以要谨慎使用。

${}可以接受HashMap、简单类型、POJO类型的参数。

当接受简单类型的参数时，${}里面只能是value。

1.1.3  selectOne和selectList

selectOne：只能查询0或1条记录，大于1条记录的话，会报错：

selectList：可以查询0或N条记录