【Java EE 学习 79 上】【mybatis 基本使用方法】

一、简介

　　mybatis类似于hibernate，都是简化对数据库操作的框架，但是和hibernate不同的是，mybatis更加灵活，整体来说框架更小，这体现在它需要我们手写SQL语句，而hibernate则将对数据库的操作对程序员完全透明了，程序员只需要按照面向对象的思想编写代码即可，想要看sql语句，就必须在配置文件中声明

<property name="show_sql">true</property>

　　hibernate对数据库的操作封装的非常彻底，因此灵活性不高，mybatis能够实现类似于hibernate的功能，但是需要自己写sql语句，这并不表示使用mybatis更加繁琐，相反的，个人认为mybatis框架很小，配置起来也非常简单，mybatis真正优秀的地方在哪里，为什么它会越来越火？

　　mybatis官方给出的mybatics 3.1.1文档中有这么一段话说出了为何mybatis这么火的原因：

　　

　　其中文意思大概就是：Mybatis提供的完整功能集能够通过使用基于“映射语言”的XML来实现，这正是Mybatis流行这么多年的原因。

　　以上内容是mybatis中的“映射文件”相关的内容，从这段话中不难看出。Mybatis的核心是“映射文件”，通过该映射文件能够实现Mybatis的所有功能。其形式如上所示。

二、Mybatis的基本使用方法

　　　练习项目源代码：https://github.com/kdyzm/day79_1_mybatisdemo

　　1.总的配置文件

　　　　和hibernate有些相似，Mybatis中也有两种配置文件，一种配置文件是“总的配置文件”，类似于hibernate中的hibernate.cfg.xml，名字随意，但是最好起一个比较规范的名字，能够见名知意，我习惯使用mybatis-config.xml命名。在mybatis 3.1.1文档中有详细的使用说明，其提供了最简单的使用形式：

 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE configuration
 PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
 "http://mybatis.org/dtd/mybatis-3-config.dtd">
 <configuration>
     <environments default="development">
         <environment id="development">
             <transactionManager type="JDBC" />
             <dataSource type="POOLED">
                 <property name="driver" value="${driver}" />
                 <property name="url" value="${url}" />
                 <property name="username" value="${username}" />
                 <property name="password" value="${password}" />
             </dataSource>
         </environment>
     </environments>
     <mappers>
         <mapper resource="org/mybatis/example/BlogMapper.xml" />
     </mappers>
 </configuration>

　　配置文件的位置任意，但是推荐放到classpath路径下，文档中说明该文件可以放到任意位置，在windows下可以使用file:///协议直接访问，但是我没试过。

　　以上内容非常简单，将对应的变量替换掉，接下来就是配置所谓的“映射文件”BlogMapper.xml。

　　2.映射文件

　　映射文件的写法和形式如下：

 <?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">
 <mapper namespace="org.mybatis.example.BlogMapper">
     <select id="selectBlog" parameterType="int" resultType="Blog">
         select * from Blog where id = #{id}
     </select>
 </mapper>

　　同样这也是文档中给出的例子，当然，这是最简单的例子，但是所有的配置文件中都需要对其进行配置，可以说是最核心而且是最基础的配置方式了。

　　说明：

　　　　namespace属性：命名空间，该命名空间的值任意，但是必须保证在整个项目中唯一，对应一个实体如Student，一定要有一个唯一的命名空间，所以这里直接取该实体的类名即可。

　　　　mapper标签中的内容是所有对数据库操作的sql语句。这里的select标签表示里面的呃sql语句是查询语句，如果是update标签，表示是更新语句......

　　　　id属性：该属性表示唯一，这自然不必说，但是该属性只是在当前Mapper标签中唯一即可。在引用该sql语句的时候，直接使用namespace+.+id来表示。

　　　　parameterType：参数类型，这里表示的是#{id}中的id对应的参数类型。

　　　　resultType：结果集类型，如果是Student，则不应当直接写上Student，而应当写上com.kdyzm.domain.Student,这里能够直接写上Blog是因为该Blog是已经声明了的“引用类型”。引用的写法之后再说。

三、使用Mybatis的CRUD操作。

　　和hibernat相同，mybatis的CRUD操作都依赖于一个Session对象，但是该对象在mybatis中有了新名字，名为SqlSession，而且创建它使用的工厂名字也不再是SessionFactory,而是SqlSessionFactory，示例代码如下：

　　获取SqlSessionFactory对象的方式：

String resource = "org/mybatis/example/mybatis-config.xml";
InputStream inputStream = Resources.getResourceAsStream(resource);
sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

　　获取SqlSession对象的方式：

SqlSession session = sqlSessionFactory.openSession();

　　之后就是使用Session对象的使用问题了。

　　1.准备工作

　　下载相关jar包并加入classpath，过程略，下载地址：https://github.com/mybatis/mybatis-3/releases

　　（1）log4j配置文件

　　为了方便查看控制台输出使用的log4j的配置文件：

 log4j.rootLogger=DEBUG, Console
 #Console
 log4j.appender.Console=org.apache.log4j.ConsoleAppender
 log4j.appender.Console.layout=org.apache.log4j.PatternLayout
 log4j.appender.Console.layout.ConversionPattern=%d [%t] %-5p [%c] - %m%n
 log4j.logger.java.sql.ResultSet=INFO
 log4j.logger.org.apache=INFO
 log4j.logger.java.sql.Connection=DEBUG
 log4j.logger.java.sql.Statement=DEBUG
 log4j.logger.java.sql.PreparedStatement=DEBUG

log4j.properties

　　（2）总的配置文件

 <?xml version="1.0" encoding="UTF-8" ?>
 <!DOCTYPE configuration
 PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
 "http://mybatis.org/dtd/mybatis-3-config.dtd">
 <configuration>
     <environments default="development">
         <environment id="development">
             <transactionManager type="JDBC" />
             <dataSource type="POOLED">
                 <property name="driver" value="com.mysql.jdbc.Driver" />
                 <property name="url" value="jdbc:mysql://localhost:3306/mybatis" />
                 <property name="username" value="root" />
                 <property name="password" value="5a6f38" />
             </dataSource>
         </environment>
     </environments>
     <mappers>
         <mapper resource="com/kdyzm/domain/Student.xml"/>
         <mapper resource="com/kdyzm/domain/Person.xml"/>
         <mapper resource="com/kdyzm/domain/Clazz.xml"/>
     </mappers>
 </configuration>

mybatis-config.xml

　　总的配置文件中并没有什么实质性的东西，最核心的配置都在“映射文件”中。

　　（3）新建3个类：

 package com.kdyzm.domain;

 public class Student {
     private Integer id;
     private String name;
     private String password;
     private Integer age;
     private Clazz clazz;
     /*************************** 分割线 ******************************************/
     public Integer getId() {
         return id;
     }

     public void setId(Integer id) {
         this.id = id;
     }

     public String getName() {
         return name;
     }

     public void setName(String name) {
         this.name = name;
     }

     public String getPassword() {
         return password;
     }

     public void setPassword(String password) {
         this.password = password;
     }

     public Integer getAge() {
         return age;
     }

     public void setAge(Integer age) {
         this.age = age;
     }

     public Clazz getClazz() {
         return clazz;
     }

     public void setClazz(Clazz clazz) {
         this.clazz = clazz;
     }

     @Override
     public String toString() {
         return "Student [id=" + id + ", name=" + name + ", password=" + password + ", age=" + age + "]";
     }
 }

com.kdyzm.domain.Student

 package com.kdyzm.domain;

 public class Person {
     private int personId;
     private String personName;
     private String personAge;
 /****************************华丽的分割线***************************************/
     public int getPersonId() {
         return personId;
     }
     public void setPersonId(int personId) {
         this.personId = personId;
     }
     public String getPersonAge() {
         return personAge;
     }
     public void setPersonAge(String personAge) {
         this.personAge = personAge;
     }
     public String getPersonName() {
         return personName;
     }
     public void setPersonName(String personName) {
         this.personName = personName;
     }
     @Override
     public String toString() {
         return "Person [personId=" + personId + ", personName=" + personName + ", personAge=" + personAge + "]";
     }
 }

com.kdyzm.domain.Person

 package com.kdyzm.domain;

 import java.util.List;

 public class Clazz {
     private int id;
     private String name;
     private String desc;
     private List<Student> students;
 /*************************华丽的分割线************************/
     public int getId() {
         return id;
     }
     public void setId(int id) {
         this.id = id;
     }
     public String getName() {
         return name;
     }
     public void setName(String name) {
         this.name = name;
     }
     public String getDesc() {
         return desc;
     }
     public void setDesc(String desc) {
         this.desc = desc;
     }
     public List<Student> getStudents() {
         return students;
     }
     public void setStudents(List<Student> students) {
         this.students = students;
     }
     @Override
     public String toString() {
         return "Clazz [id=" + id + ", name=" + name + ", desc=" + desc + "]";
     }
 }

com.kdyzm.domain.Clazz

　　用的最多的两个类是Student和Clazz，Person类基本上没用上。

　　2.查询

　　　　com.kdyzm.domain.Student.xml配置文件中的mapper标签：

<mapper namespace="com.kdyzm.domain.Student"></mapper>

　　（1）查询一个Student对象

<select id="selectUserById" parameterType="int" resultMap="com.kdyzm.domain.Student">
     select s.* ,c.* from student s,clazz c where s.clazz=c.clazzid and s.studentid=#{id};
</select>

　　　　java代码：

Student student=session.selectOne("com.kdyzm.domain.Student.selectUserById", "1");

　　（2）查询Student的集合

<select id="selectAllStudent" resultType="com.kdyzm.domain.Student">
    select * from Student
</select>

　　java代码：

Collection<Student> students=sqlSession.selectList("com.kdyzm.domain.Student.selectAllStudent");

　　3.插入

<insert id="insertIntoStudent" parameterType="com.kdyzm.domain.Student">
        insert into
        student(studentid,name,password,age) values(#{id},#{name},#{password},#{age})
    </insert>

　　java代码：

 String statement="com.kdyzm.domain.Student.insertIntoStudent";
 Student student=new Student();
 student.setId(7);
 student.setName("张三");
 student.setAge(13);
 student.setPassword("xiaozhang");
 int result=session.insert(statement, student);
 session.commit();

　　这里一定不要忘了提交的动作：commit();

　　4.更新

<update id="updateStudentByStudentObject" parameterType="com.kdyzm.domain.Student">
    update
    student set name=#{name},password=#{password},age=#{age} where
    studentid=#{id}
</update>

　　5.删除

<delete id="deleteUserById" parameterType="string">
    delete from student
    where studentid = #{id}
</delete>

四、注意事项

　　1.parameterType属性和resultType属性的类型问题

　　　　（1）经常使用parameterType类型为string或者int类型作为id对一个对象进行操作，经常传入一个对象的类型如com.kdyzm.domain.Student对一个对象进行修改操作，可以使用HashMap类型来替换对象类型，这时候类型值就需要写上hashMap。　　

　　　　（2）返回值是一个对象还是一个对象的集合，返回值类型都是同一种，如果是普通对象类型，那么以Student为例就是com.kdyzm.domain.Student，如果是HashMap类型，那么就是hashMap。

　　2.parameterType的类型问题

　　　　如果parameterType类型是基本数据类型或者String类型，那么在sql中的#{id}中的id名字可以任意写，只是起着占位符的作用，但是如果是对象类型的话，则名字就需要和对象中的属性名完全相同才行，因为需要调用对象的get方法获取字段的值。

五、解决数据库中表的字段和对象中的属性字段名字不一致的情况

　　解决方法有两种：

　　1.第一种方式是大家首先能够想到的最通用的方式，那就是起别名，如

select id as studentId,name as studentName from student

　　但是使用这种方式有一个非常明显的缺点，那就是针对每一次查询都必须这么写，显得非常乱而且书写起来非常的不方便，还容易出错，导致的直接后果就是效率低下。

　　使用第二种方式能够解决这种麻烦。

　　2.第二种解决方式和在hibernate中的配置方式很相似，都是映射表中的字段到对象中的属性字段的方法。

<!-- 使用ResultMap标签解决数据库中表的字段和类中的属性字段不一致的情况 -->
<resultMap type="com.kdyzm.domain.Person" id="personMap">
    <id column="id" property="personId"/>
    <result column="name" property="personName"/>
    <result column="age" property="personAge"/>
</resultMap>

　　其中column中填写数据库表中的列名，property中填写对应对象中的字段名。

六、多对一关系查询和一对多关系查询

　　在hibernate中我们经常使用关联关系查询，比如查到了Student对象之后直接就能够获取Clazz对象,获取了Clazz对象之后直接就能够得到List<Student>对象，同样，在mybatis中也能欧做到这一点，这里先不考虑懒加载的事情。

　　这里使用Student和Clazz为例说明

　　1.一对多关系

　　　　Clazz和Student之间是一对多的关系，现在的需求就是根据Clazz对象获取所有的Student对象。

　　　　可以利用之前提到的resultMap标签实现这一点，首先需要在Clazz类中有List<Student>students成员变量，同时提供对应的set/get方法；然后进行映射文件中的XML文件的配置：

 <resultMap type="com.kdyzm.domain.Clazz" id="clazzMap">
     <id property="id" column="clazzid"></id>
     <result property="name" column="name" />
     <result column="describtion" property="desc" />
     <collection property="students" ofType="com.kdyzm.domain.Student">
         <id column="studentid" property="id"></id>
         <result column="name" property="name" />
         <result column="password" property="password" />
         <result column="age" property="age" />
     </collection>
 </resultMap>

　　　　和之前不太相同的是添加了黄色背景部分的内容。

　　　　property属性对应着类中的字段名称，ofType属性是集合中的元素类型。collection标签的子标签是ofType类型中的所有成员变量，当然虽然Student类中有Clazz类型的成员变量，但是这里不要写上，除此之外所有的成员变量都要写上。

　　sql查询的方式也要修改，这里必须是两表联合查询才行，同时将resultType改成resultMap：

 <select id="selectClazzById" resultMap="clazzMap" parameterType="int">
     select s.*,c.* from student s,clazz c where c.clazzid =#{id} and s.clazz=c.clazzid
 </select>

　　java代码：

 String statement = "com.kdyzm.domain.Clazz.selectClazzById";
 Clazz clazz = session.selectOne(statement, "1");
 List<Student> students = clazz.getStudents();
 for (Student student : students) {
     System.out.println(student);
 }

　　2.多对一关系的实现

　　Student对象和Clazz对象之间是多对一的关系，现在的需求就是需要根据Student对象获取其对应的Clazz对象。

　　这里还是需要借助于resultMap标签：

 <resultMap type="com.kdyzm.domain.Student" id="studentMap">
     <id column="studentid" property="id"></id>
     <result column="name" property="name"/>
     <result column="password" property="password"/>
     <result column="age" property="age"/>
     <association property="clazz" javaType="com.kdyzm.domain.Clazz">
         <id property="id" column="clazzid"></id>
         <result property="name" column="name"/>
         <result column="describtion" property="desc" />
     </association>
 </resultMap>

　　当然了，最关键的还是以上黄色背景部分的内容，这里使用association标签完成任务。

　　property属性填写的是对象中的相应字段，javaType对应的是其java类型。然后association标签内填写该对象中的所有属性和表中字段的对应关系，注意，所有的一定都要填写完整，否则没有填写完整的部分对应的字段就会是NULL类型。

　　当然，查询的sql语句也必须改变，改成两张表的联合查询：

<!-- 根据UserId查询User对象的查询方法 -->
<select id="selectUserById" parameterType="int" resultMap="studentMap">
     select s.* ,c.* from student s,clazz c where s.clazz=c.clazzid and s.studentid=#{id};
</select>

　　java代码如下：

String statement = "com.kdyzm.domain.Student.selectUserById";
Student student = session.selectOne(statement, "1");
System.out.println(student.getClazz());

七、mybatics的基础部分内容就是这么多，接下来是和spring的整合过程。