Category: mybatis基础

mybatis基础-关键注意点bean的构造函数问题

当我用Junit单元测试，来学习mybatis时：

mybatis的bean文件中，采用的是默认构造函数。

当bean需要自定义构造函数时，一定要记得顺便 添加一个 无参构函数。因为mybatis用到了反射。无参构造函数是必须的。

如果自定义构造函数后，忘记添加了默认无参构造函数，那么就会报错。说缺少（，，，）形式的构造函数，但是不会说缺少无参构造函数。这个要注意啦。

 

mybatis基础-配置开发环境

一、搭建数据源

mysql客户端连接mysql数据库，执行下面语句。【第一次写的时候，居然写成tbl_employee{}，sql语句没有{},应该是()  】

CREATE TABLE tb1_employee (
   id INT(11) PRIMARY KEY AUTO_INCREMENT,
   last_name VARCHAR(255),
   gender CHAR(1),
   email VARCHAR(255)

)

因为不区分大小写，所以也可以采用如下写法：

create table tbl_employee(
  id int(11) primary key auto_increment,
  last_name varchar(255),
  gender char(1),
  email varchar(255)
)

创建完表格后，并在其中添加一条记录。

id	last_name    gender	     email
1	   mike	       0     [email protected]

二、创建项目代码

1、工程代码总览：

（代码包括mybatis 的两种操作 方法）

2、添加项目jar包

项目用到的jar包主要有：
mybatis-3.4.6.jar 【mybatis 包】
mysql-connector-java-5.1.18.jar 【mysql 驱动包】

额外添加的包：
mybatis-3.4.6-sources.jar 【mybatis 源码包，方便debug 跟踪代码】
mybatis-3.4.6-javadoc【mybatis 文档包，方便查看】
log4j-1.2.17.jar 【日志打印包，需要配合 log4j 的配置文件一起使用，这里用到的配置文件是log4j.xml】

log4j.xml文件：

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE log4j:configuration SYSTEM "log4j.dtd">
 
<log4j:configuration xmlns:log4j="http://jakarta.apache.org/log4j/">
 
 <appender name="STDOUT" class="org.apache.log4j.ConsoleAppender">
   <param name="Encoding" value="UTF-8" />
   <layout class="org.apache.log4j.PatternLayout">
    <param name="ConversionPattern" value="%-5p %d{MM-dd HH:mm:ss,SSS} %m  (%F:%L) \n" />
   </layout>
 </appender>
 <logger name="java.sql">
   <level value="debug" />
 </logger>
 <logger name="org.apache.ibatis">
   <level value="info" />
 </logger>
 <root>
   <level value="debug" />
   <appender-ref ref="STDOUT" />
 </root>
</log4j:configuration>

3、创建ORM中的对象

package com.mybatis.bean;

public class Employee {
	private int id;
	private String lastName;
	private String email;
	private String gender;

	public int getId() {
		return id;
	}

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

	public String getLastName() {
		return lastName;
	}

	public void setLastName(String lastName) {
		this.lastName = lastName;
	}

	public String getEmail() {
		return email;
	}

	public void setEmail(String email) {
		this.email = email;
	}

	public String getGender() {
		return gender;
	}

	public void setGender(String gender) {
		this.gender = gender;
	}

	@Override
	public String toString() {
		return "Employee [id=" + id + ", lastName=" + lastName + ", email=" + email + ", gender=" + gender + "]";
	}

}

4、创建全局配置文件

mybatis-config.xml【文件名可以随便取，只要在代码中加载全局配置文件时，文件名写对就行】

<?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="Kitty521!" />
			</dataSource>
		</environment>
	</environments>
	<!-- 将我们写好的sql映射文件（EmployeeMapper.xml）一定要注册到全局配置文件（mybatis-config.xml）中 
	如果 数据库全局文件 和 子配置文件 不在同一个目录 ，就需要 /目录/目录/.../EmployeeMapper_old.xml
	-->
	<mappers>
	    <!-- 旧方法操作mybatis 需要 的配置文件 -->
		<mapper resource="EmployeeMapper_old.xml" />
	    <!-- 新方法操作mybatis 需要 的配置文件 -->
		<mapper resource="EmployeeMapper_new.xml" />
	</mappers>
</configuration>

5、旧方法操作mybatis

（1）对象映射配置文件:EmployeeMapper_old.xml

<?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="com.mybatis.hhh.EmployeeMapper">
<!-- 
上面的 namespace:名称空间;名字随便写

下面的 id：唯一标识
下面的 resultType：返回值类型
下面的 #{id}：从传递过来的参数中取出id值
 -->
	<select id="selectEmp" resultType="com.mybatis.bean.Employee">
	<!-- select * from tb1_employee where id = #{id}  
	这样的查询结果导致数据库 last_name 无法赋值给employee bean中的lastName
	所以，employee 中的  lastName 是空值，解决版本是 查询结果 取 别名-->	
	select id ,last_name lastName,email, gender from tbl_employee where id = #{id}
	</select>
</mapper>

(2) JUnit 单元测试:

public class MybatisTest {

	/**
	 * 1、根据xml配置文件（全局配置文件）创建一个SqlSessionFactory对象 有数据源一些运行环境信息
	 * 2、sql映射文件；配置了每一个sql，以及sql的封装规则等。 
	 * 3、将sql映射文件注册在全局配置文件中
	 * 4、写代码：
	 * 		1）、根据全局配置文件得到SqlSessionFactory；
	 * 		2）、使用sqlSession工厂，获取到sqlSession对象使用他来执行增删改查
	 * 			一个sqlSession就是代表和数据库的一次会话，用完关闭
	 * 		3）、使用sql的唯一标志来告诉MyBatis执行哪个sql。sql都是保存在sql映射文件中的。
	 * 
	 * @throws IOException
	 */
	@Test
	public void test_old() throws IOException {
		String resource = "mybatis-config.xml";
		InputStream inputStream = Resources.getResourceAsStream(resource);
		SqlSessionFactory sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);

		//获取sqlSession实例 ，能直接执行已经映射的sql语句。
		// sql的唯一标识：statement Unique identifier matching the statement to use.
		// 执行sql要用的参数：parameter A parameter object to pass to the statement.
		SqlSession openSession = sqlSessionFactory.openSession();
		try{
		//唯一标识符可以直接写 selectEmp 但为了防止 和别可能有的冲突，添加了命名空间
	    Employee employee =  openSession.selectOne("com.mybatis.hhh.EmployeeMapper.selectEmp",1);
	    System.out.println(employee);
		}catch (Exception e) {
			// TODO: handle exception
		}finally {
		    openSession.close();
		}
	}
}

6、新方法操作mybatis

（1）对象映射配置文件:EmployeeMapper_new.xml

<?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="com.mybatis.mapper.EmployeeMapper">
<!-- 
上面的 namespace:名称空间;指定为接口的全类名
下面的 id：唯一标识被规定为接口方法名 【public Employee getEmpById(Integer id);】
下面的 resultType：返回值类型
下面的 #{id}：从传递过来的参数中取出id值
 -->
	<select id="getEmpById" resultType="com.mybatis.bean.Employee">
		select id,last_name lastName,email,gender from tbl_employee where id = #{id}
	</select>
</mapper>

（2）创建对象映射的接口文件

EmployeeMapper.java

package com.mybatis.mapper;

import com.mybatis.bean.Employee;

public interface EmployeeMapper {

	public Employee getEmpById(Integer id);
	
}

(3)JUnit 单元测试

/**
 * 1、接口式编程
 * 	原生：		Dao		====>  DaoImpl
 * 	mybatis：	Mapper	====>  xxMapper.xml
 * 
 * 2、SqlSession代表和数据库的一次会话；用完必须关闭；
 * 3、SqlSession和connection一样她都是非线程安全。每次使用都应该去获取新的对象。(就是不要放在共享成员变量里面，A线程用完释放，B线程再用就为空了)
 * 4、mapper接口没有实现类，但是mybatis会为这个接口生成一个代理对象。
 * 		（将接口和xml进行绑定）
 * 		EmployeeMapper empMapper =	sqlSession.getMapper(EmployeeMapper.class);
 * 5、两个重要的配置文件：
 * 		mybatis的全局配置文件：包含数据库连接池信息，事务管理器信息等...系统运行环境信息
 * 		sql映射文件：保存了每一个sql语句的映射信息：
 * 					将sql抽取出来。	
 *
 */
public class MybatisTest {

        public SqlSessionFactory getSqlSessionFactory() throws IOException {
	        String resource = "mybatis-config.xml";
	        InputStream inputStream = Resources.getResourceAsStream(resource);
	        return new SqlSessionFactoryBuilder().build(inputStream);
        }

        @Test
	public void test_new() throws IOException {
		// 1、获取sqlSessionFactory对象
		SqlSessionFactory sqlSessionFactory = getSqlSessionFactory();
		// 2、获取sqlSession对象
		SqlSession openSession = sqlSessionFactory.openSession();
		try {
			// 3、获取接口的实现类对象
			//会为接口自动的创建一个代理对象，代理对象去执行增删改查方法
			EmployeeMapper mapper = openSession.getMapper(EmployeeMapper.class);
			Employee employee = mapper.getEmpById(1);
			System.out.println(mapper.getClass());
			System.out.println(employee);
		} finally {
			openSession.close();
		}

	}

}

 

三、全局配置文件解析

1、配置标签顺序

在mybatis的全局配置文件中， 在 <configuration>标签下：

Content Model : (properties?, settings?, typeAliases?, typeHandlers?, objectFactory?, objectWrapperFactory?,

reflectorFactory?, plugins?, environments?, databaseIdProvider?, mappers?)

注意上面的子标签都是有顺序的

2、标签详解请看相关章节

 

四、映射文件解析

 

补充：

SqlSession 的实例不是线程安全的，因此是不能被共享的。

SqlSession每次使用完成后需要正确关闭，这个关闭操作是必须的

SqlSession可以直接调用方法的id进行数据库操作，但是我们一般还是推荐使用SqlSession获取到Mapper接口的代理类，执行代理对象的方法，可以更安全的进行类型检查操作

关于JUnit单元测试，只需在eclipse中新建 JUnit Test Case 就行了。