mybatis使用指南.docx

mybatis使用指南.docx

《mybatis使用指南.docx》由会员分享，可在线阅读，更多相关《mybatis使用指南.docx（100页珍藏版）》请在冰豆网上搜索。

mybatis使用指南

一、Mybatis介绍

　　MyBatis是一个支持普通SQL查询，存储过程和高级映射的优秀持久层框架。

MyBatis消除了几乎所有的JDBC代码和参数的手工设置以及对结果集的检索封装。

MyBatis可以使用简单的XML或注解用于配置和原始映射，将接口和Java的POJO（PlainOldJavaObjects，普通的Java对象）映射成数据库中的记录。

二、mybatis快速入门

2.1、准备开发环境

 1、创建测试项目，普通java项目或者是JavaWeb项目均可，如下图所示：

2、添加相应的jar包

【mybatis】mybatis-3.1.1.jar

【MYSQL驱动包】mysql-connector-java-5.1.7-bin.jar

3、创建数据库和表，针对MySQL数据库

　　SQL脚本如下：

1createdatabasemybatis;

2usemybatis;

3CREATETABLEusers（idINTPRIMARYKEYAUTO_INCREMENT,NAMEVARCHAR（20）,ageINT）;

4INSERTINTOusers（NAME,age）VALUES（'孤傲苍狼',27）;

5INSERTINTOusers（NAME,age）VALUES（'白虎神皇',27）;

　　将SQL脚本在MySQL数据库中执行，完成创建数据库和表的操作，如下：

　　到此，前期的开发环境准备工作全部完成。

2.2、使用MyBatis查询表中的数据

　　1、添加Mybatis的配置文件conf.xml

　　在src目录下创建一个conf.xml文件，如下图所示：

　　conf.xml文件中的内容如下：

xmlversion="1.0"encoding="UTF-8"?

>

DOCTYPEconfigurationPUBLIC"-//mybatis.org//DTDConfig3.0//EN""http:

//mybatis.org/dtd/mybatis-3-config.dtd">

--配置数据库连接信息-->

mysql:

//localhost:

3306/mybatis"/>

　　2、定义表所对应的实体类，如下图所示：

　　User类的代码如下：

packageme.gacl.domain;

/**

*@authorgacl

*users表所对应的实体类

*/

publicclassUser{

//实体类的属性和表的字段名称一一对应

privateintid;

11privateStringname;

12privateintage;

13

14publicintgetId（）{

15returnid;

16}

17

18publicvoidsetId（intid）{

19this.id=id;

20}

21

22publicStringgetName（）{

23returnname;

24}

25

26publicvoidsetName（Stringname）{

27this.name=name;

28}

29

30publicintgetAge（）{

31returnage;

32}

33

34publicvoidsetAge（intage）{

35this.age=age;

36}

37

38@Override

39publicStringtoString（）{

40return"User[id="+id+",name="+name+",age="+age+"]";

41}

42}

　　3、定义操作users表的sql映射文件userMapper.xml

　　创建一个me.gacl.mapping包，专门用于存放sql映射文件，在包中创建一个userMapper.xml文件，如下图所示：

　　userMapper.xml文件的内容如下：

1

xmlversion="1.0"encoding="UTF-8"?

>

2

DOCTYPEmapperPUBLIC"-//mybatis.org//DTDMapper3.0//EN""http:

//mybatis.org/dtd/mybatis-3-mapper.dtd">

3

--为这个mapper指定一个唯一的namespace，namespace的值习惯上设置成包名+sql映射文件名，这样就能够保证namespace的值是唯一的

4例如namespace="me.gacl.mapping.userMapper"就是me.gacl.mapping（包名）+userMapper（userMapper.xml文件去除后缀）

5-->

6

7

--在select标签中编写查询的SQL语句，设置select标签的id属性为getUser，id属性值必须是唯一的，不能够重复

8使用parameterType属性指明查询时使用的参数类型，resultType属性指明查询返回的结果集类型

9resultType="me.gacl.domain.User"就表示将查询结果封装成一个User类的对象返回

10User类就是users表所对应的实体类

11-->

12

--

13根据id查询得到一个user对象

14-->

15

16resultType="me.gacl.domain.User">

17select*fromuserswhereid=#{id}

18

19

　　4、在conf.xml文件中注册userMapper.xml文件

1

xmlversion="1.0"encoding="UTF-8"?

>

2

DOCTYPEconfigurationPUBLIC"-//mybatis.org//DTDConfig3.0//EN""http:

//mybatis.org/dtd/mybatis-3-config.dtd">

3

4

5

6

7

--配置数据库连接信息-->

8

9

10

mysql:

//localhost:

3306/mybatis"/>

11

12

13

14

15

16

17

18

--注册userMapper.xml文件，

19userMapper.xml位于me.gacl.mapping这个包下，所以resource写成me/gacl/mapping/userMapper.xml-->

20

21

22

23

　　5、编写测试代码：

执行定义的select语句

　　创建一个Test1类，编写如下的测试代码：

packageme.gacl.test;

importjava.io.IOException;

importjava.io.InputStream;

importjava.io.Reader;

importme.gacl.domain.User;

importorg.apache.ibatis.io.Resources;

importorg.apache.ibatis.session.SqlSession;

importorg.apache.ibatis.session.SqlSessionFactory;

importorg.apache.ibatis.session.SqlSessionFactoryBuilder;

publicclassTest1{

publicstaticvoidmain（String[]args）throwsIOException{

//mybatis的配置文件

Stringresource="conf.xml";

//使用类加载器加载mybatis的配置文件（它也加载关联的映射文件）

InputStreamis=Test1.class.getClassLoader（）.getResourceAsStream（resource）;

//构建sqlSession的工厂

SqlSessionFactorysessionFactory=newSqlSessionFactoryBuilder（）.build（is）;

//使用MyBatis提供的Resources类加载mybatis的配置文件（它也加载关联的映射文件）

//Readerreader=Resources.getResourceAsReader（resource）;

//构建sqlSession的工厂

//SqlSessionFactorysessionFactory=newSqlSessionFactoryBuilder（）.build（reader）;

//创建能执行映射文件中sql的sqlSession

SqlSessionsession=sessionFactory.openSession（）;

/**

*映射sql的标识字符串，

*me.gacl.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值，

*getUser是select标签的id属性值，通过select标签的id属性值就可以找到要执行的SQL

*/

Stringstatement="me.gacl.mapping.userMapper.getUser";//映射sql的标识字符串

//执行查询返回一个唯一user对象的sql

Useruser=session.selectOne（statement,1）;

System.out.println（user）;

}

}

　　执行结果如下：

　　可以看到，数据库中的记录已经成功查询出来了。

一、使用MyBatis对表执行CRUD操作——基于XML的实现

1、定义sql映射xml文件

　　userMapper.xml文件的内容如下：

1

xmlversion="1.0"encoding="UTF-8"?

>

2

DOCTYPEmapperPUBLIC"-//mybatis.org//DTDMapper3.0//EN""http:

//mybatis.org/dtd/mybatis-3-mapper.dtd">

3

--为这个mapper指定一个唯一的namespace，namespace的值习惯上设置成包名+sql映射文件名，这样就能够保证namespace的值是唯一的

4例如namespace="me.gacl.mapping.userMapper"就是me.gacl.mapping（包名）+userMapper（userMapper.xml文件去除后缀）

5-->

6

7

--在select标签中编写查询的SQL语句，设置select标签的id属性为getUser，id属性值必须是唯一的，不能够重复

8使用parameterType属性指明查询时使用的参数类型，resultType属性指明查询返回的结果集类型

9resultType="me.gacl.domain.User"就表示将查询结果封装成一个User类的对象返回

10User类就是users表所对应的实体类

11-->

12

--

13根据id查询得到一个user对象

14-->

15

16resultType="me.gacl.domain.User">

17select*fromuserswhereid=#{id}

18

19

20

--创建用户（Create）-->

21

22insertintousers（name,age）values（#{name},#{age}）

23

24

25

--删除用户（Remove）-->

26

27deletefromuserswhereid=#{id}

28

29

30

--修改用户（Update）-->

31

32updateuserssetname=#{name},age=#{age}whereid=#{id}

33

34

35

--查询全部用户-->

36

37select*fromusers

38

39

40

　　单元测试类代码如下：

1packageme.gacl.test;

2

3importjava.util.List;

4importme.gacl.domain.User;

5importme.gacl.util.MyBatisUtil;

6importorg.apache.ibatis.session.SqlSession;

7importorg.junit.Test;

8

9publicclassTestCRUDByXmlMapper{

10

11@Test

12publicvoidtestAdd（）{

13//SqlSessionsqlSession=MyBatisUtil.getSqlSession（false）;

14SqlSessionsqlSession=MyBatisUtil.getSqlSession（true）;

15/**

16*映射sql的标识字符串，

17*me.gacl.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值，

18*addUser是insert标签的id属性值，通过insert标签的id属性值就可以找到要执行的SQL

19*/

20Stringstatement="me.gacl.mapping.userMapper.addUser";//映射sql的标识字符串

21Useruser=newUser（）;

22user.setName（"用户孤傲苍狼"）;

23user.setAge（20）;

24//执行插入操作

25intretResult=sqlSession.insert（statement,user）;

26//手动提交事务

27//sqlSmit（）;

28//使用SqlSession执行完SQL之后需要关闭SqlSession

29sqlSession.close（）;

30System.out.println（retResult）;

31}

32

33@Test

34publicvoidtestUpdate（）{

35SqlSessionsqlSession=MyBatisUtil.getSqlSession（true）;

36/**

37*映射sql的标识字符串，

38*me.gacl.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值，

39*updateUser是update标签的id属性值，通过update标签的id属性值就可以找到要执行的SQL

40*/

41Stringstatement="me.gacl.mapping.userMapper.updateUser";//映射sql的标识字符串

42Useruser=newUser（）;

43user.setId（3）;

44user.setName（"孤傲苍狼"）;

45user.setAge（25）;

46//执行修改操作

47intretResult=sqlSession.update（statement,user）;

48//使用SqlSession执行完SQL之后需要关闭SqlSession

49sqlSession.close（）;

50System.out.println（retResult）;

51}

52

53@Test

54publicvoidtestDelete（）{

55SqlSessionsqlSession=MyBatisUtil.getSqlSession（true）;

56/**

57*映射sql的标识字符串，

58*me.gacl.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值，

59*deleteUser是delete标签的id属性值，通过delete标签的id属性值就可以找到要执行的SQL

60*/

61Stringstatement="me.gacl.mapping.userMapper.deleteUser";//映射sql的标识字符串

62//执行删除操作

63intretResult=sqlSession.delete（statement,5）;

64//使用SqlSession执行完SQL之后需要关闭SqlSession

65sqlSession.close（）;

66System.out.println（retResult）;

67}

68

69@Test

70publicvoidtestGetAll（）{

71SqlSessionsqlSession=MyBatisUtil.getSqlSession（）;

72/**

73*映射sql的标识字符串，

74*me.gacl.mapping.userMapper是userMapper.xml文件中mapper标签的namespace属性的值，

75*getAllUsers是select标签的id属性值，通过select标签的id属性值就可以找到要执行的SQL

76*/

77Stringstatement="me.gacl.mapping.userMapper.getAllUsers";//映射sql的标识字符串

78//执行查询操作，将查询结果自动封装成List返回

79ListlstUsers=sqlSession.selectList（statement）;

80//使用SqlSession执行完SQL之后需要关闭SqlSession

81sqlSession.close（）;

82System.out.println（lstUsers）;

83}

84}

二、使用MyBatis对表执行CRUD操作——基于注解的实现

　　1、定义sql映射的接口

　　UserMapperI接口的代码如下：

1packageme.gacl.mapping;

2

3importjava.util.List;

4importme.gacl.domain.User;

5importorg.apache.ibatis.annotations.Delete;

6importorg.apache.ibatis.annotations.Insert;

7importorg.apache.ibatis.annotations.Select;

8importorg.apache.ibatis.annotations.Update;

9

10/**

11*@authorgacl

12*定义sql映射的接口，使用注解指明方法要执行的SQL

13*/

14publicinterfaceUserMapperI{

15

16//使用@Insert注解指明add方法要执行的SQL

17@Insert（"insertintousers（name,age）values（#{name},#{age}）"）

18publicintadd（Useruser）;

19

20//使用@Delete注解指明deleteById方法要执行的SQL

21@Delete（"deletefr