mybatis映射文件-(2)-单个入参与多个入参

一、当传入一个参数时:

1、接口文件(参数是 一个id ,或者是 一个对象)

package com.mybatis.mapper;

import com.mybatis.bean.Employee;

public interface EmployeeMapper {

	public Employee getEmpById(Integer id);
	
	public void addEmp(Employee employee);

	
}

2、sql映射文件

<?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>

	<insert id="addEmp" parameterType="com.mybatis.bean.Employee"
		useGeneratedKeys="true" keyProperty="id" >
		insert into tbl_employee(last_name,email,gender) 
		values(#{lastName},#{email},#{gender})
	</insert>
</mapper>

3、总结:单个参数情况下,sql映射文件中的引用:

(1)如果是基本参数类型,#{可以取任意名,因为只有一个变量可以调用}
(2)如果是一个java bean对象,则引用各bean的属性即可。

POJO:
如果多个参数正好是我们业务逻辑的数据模型,我们就可以直接传入pojo;
#{属性名}:取出传入的pojo的属性值。

TO:
如果多个参数不是业务模型中的数据,但是经常要使用,推荐来编写一个TO(Transfer Object)数据传输对象
Page{
int index;
int size;
}

二、当传入多个参数时:

多个参数:mybatis会做特殊处理。
多个参数会被封装成 一个map,
key:param1…paramN,或者参数的索引也可以
value:传入的参数值
#{}就是从map中获取指定的key的值;

举例:

//接口文件,两个参数的情况下
public Employee getEmpByIdAndLastName(Integer id,String lastName);
<!-- sql映射文件 -->
<!--  public Employee getEmpByIdAndLastName(Integer id,String lastName);-->
 <select id="getEmpByIdAndLastName" resultType="com.mybatis.bean.Employee">
 	select * from tbl_employee where id = #{id} and last_name=#{lastName}
 </select>

结果,JUnit测试报错:

异常:
org.apache.ibatis.binding.BindingException: 
Parameter 'id' not found. 
Available parameters are [1, 0, param1, param2]

操作:
方法:public Employee getEmpByIdAndLastName(Integer id,String lastName);
取值:#{id},#{lastName}

报错原因:
多个参数:mybatis会做特殊处理。
多个参数会被封装成 一个map,
key:param1…paramN,或者参数的索引也可以
value:传入的参数值
#{}就是从map中获取指定的key的值;
解决办法:在sql映射文件中调用:#{param1},#{param2} 或者 #{0} ,#{1}

多个入参方法二:@Param(“xxx”)

但是不便于阅读和理解,于是可以采用:@Param(“xxx”)

【命名参数】:明确指定封装参数时map的key;@Param("xxx")
	多个参数会被封装成 一个map,
	key:使用@Param注解指定的值
	value:参数值
	#{指定的key}取出对应的参数值
操作:
接口:public Employee getEmpByIdAndLastName(@Param("id")Integer id,@Param("lastName")String lastName);
sql映射:
<!--  public Employee getEmpByIdAndLastName(Integer id,String lastName);-->
 	<select id="getEmpByIdAndLastName" resultType="com.atguigu.mybatis.bean.Employee">
 		select * from tbl_employee where id = #{id} and last_name=#{lastName}
 	</select>

###### 这样就能正确取值了 #######

多个入参方法三:Map

单元测试:
EmployeeMapper mapper = openSession.getMapper(EmployeeMapper.class);
Map<String, Object> map = new HashMap<>();
map.put("id", 2);
map.put("lastName", "Tom");
map.put("tableName", "tbl_employee");
Employee employee = mapper.getEmpByMap(map);
System.out.println(employee);


接口:public Employee getEmpByMap(Map<String, Object> map);

sql映射:
<!-- public Employee getEmpByMap(Map<String, Object> map); -->
 	<select id="getEmpByMap" resultType="com.atguigu.mybatis.bean.Employee">
 		select * from ${tableName} where id=${id} and last_name=#{lastName}
 	</select>

Map:
如果多个参数不是业务模型中的数据,没有对应的pojo,不经常使用,为了方便,我们也可以传入map
#{key}:取出map中对应的值
===================参数值的获取=======================
#{}:可以获取map中的值或者pojo对象属性的值;
${}:可以获取map中的值或者pojo对象属性的值;

select * from tbl_employee where id=${id} and last_name=#{lastName}
Preparing: select * from tbl_employee where id=2 and last_name=?
	区别:
	#{}:是以预编译的形式,将参数设置到sql语句中;PreparedStatement;防止sql注入
	${}:取出的值直接拼装在sql语句中;会有安全问题;
	大多情况下,我们去参数的值都应该去使用#{};
		
	原生jdbc不支持占位符的地方我们就可以使用${}进行取值
	比如分表、排序。。。;按照年份分表拆分
	      select * from ${year}_salary where xxx;
	      select * from tbl_employee order by ${f_name} ${order}

#{}:更丰富的用法:
	规定参数的一些规则:
	javaType、 jdbcType、 mode(存储过程)、 numericScale、
	resultMap、 typeHandler、 jdbcTypeName、 expression(未来准备支持的功能);

	jdbcType通常需要在某种特定的条件下被设置:
		在我们数据为null的时候,有些数据库可能不能识别mybatis对null的默认处理。比如Oracle(报错);
		
		JdbcType OTHER:无效的类型;因为mybatis对所有的null都映射的是原生Jdbc的OTHER类型,oracle不能正确处理;
		
		由于全局配置中:jdbcTypeForNull=OTHER;oracle不支持;两种办法
		1、#{email,jdbcType=NULL};
		2、jdbcTypeForNull=NULL
			<setting name="jdbcTypeForNull" value="NULL"/>

多个入参方法四:集合

##特别注意:如果是Collection(List、Set)类型或者是数组,
也会特殊处理。也是把传入的list或者数组封装在map中。
如果是集合Collection ===> key:collection
如果是List===> key:list
如果是数组===> key:array

接口:public Employee getEmpById(List ids);
sql映射:取出第一个id的值: #{list[0]}

=====================思考======================
public Employee getEmp(@Param(“id”)Integer id,String lastName);
取值:id==>#{id/param1} lastName==>#{param2}

public Employee getEmp(Integer id,@Param(“e”)Employee emp);
取值:id==>#{param1} lastName===>#{param2.lastName/e.lastName}

mybatis映射文件-(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="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>
	
		<!-- 5、databaseIdProvider:支持多数据库厂商的;
		 type="DB_VENDOR":VendorDatabaseIdProvider
		 	作用就是得到数据库厂商的标识(驱动getDatabaseProductName()),mybatis就能根据数据库厂商标识来执行不同的sql;
		 	MySQL,Oracle,SQL Server,xxxx
	  -->
	<databaseIdProvider type="DB_VENDOR">
		<!-- 为不同的数据库厂商起别名 -->
		<property name="MySQL" value="mysql"/>
		<property name="Oracle" value="oracle"/>
		<property name="SQL Server" value="sqlserver"/>
	</databaseIdProvider>
	
	<!-- 将我们写好的sql映射文件(EmployeeMapper.xml)一定要注册到全局配置文件(mybatis-config.xml)中 
	如果 数据库全局文件 和 子配置文件 不在同一个目录 ,就需要 /目录/目录/.../EmployeeMapper_old.xml
	-->
	<mappers>
	    <!-- 新方法操作mybatis 需要 的配置文件 -->
		<mapper resource="EmployeeMapper_new.xml" />
	</mappers>
</configuration>

二、编辑映射文件:

<?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>
	
	<!-- public void addEmp(Employee employee); -->
	<!-- parameterType:参数类型,可以省略, 
	获取自增主键的值:
		mysql支持自增主键,自增主键值的获取,mybatis也是利用statement.getGenreatedKeys();
		useGeneratedKeys="true";使用自增主键获取主键值策略
		keyProperty;指定对应的主键属性,也就是mybatis获取到主键值以后,将这个值封装给javaBean的哪个属性
	-->
	<insert id="addEmp" parameterType="com.mybatis.bean.Employee"
		useGeneratedKeys="true" keyProperty="id" databaseId="mysql">
		insert into tbl_employee(last_name,email,gender) 
		values(#{lastName},#{email},#{gender})
	</insert>
	
	<!-- 
	获取非自增主键的值:
		Oracle不支持自增;Oracle使用序列来模拟自增;
		每次插入的数据的主键是从序列中拿到的值;如何获取到这个值;
	 -->
	<insert id="addEmp" databaseId="oracle">
		<!-- 
		keyProperty:查出的主键值封装给javaBean的哪个属性
		order="BEFORE":当前sql在插入sql之前运行
			   AFTER:当前sql在插入sql之后运行
		resultType:查出的数据的返回值类型
		
		BEFORE运行顺序:
			先运行selectKey查询id的sql;查出id值封装给javaBean的id属性
			在运行插入的sql;就可以取出id属性对应的值
		AFTER运行顺序:
			先运行插入的sql(从序列中取出新值作为id);
			再运行selectKey查询id的sql;
		 -->
		<selectKey keyProperty="id" order="BEFORE" resultType="Integer">
			<!-- 编写查询主键的sql语句 -->
			<!-- BEFORE-->
			select EMPLOYEES_SEQ.nextval from dual 
			<!-- AFTER:
			 select EMPLOYEES_SEQ.currval from dual -->
		</selectKey>
		
		<!-- 插入时的主键是从序列中拿到的 -->
		<!-- BEFORE:-->
		insert into employees(EMPLOYEE_ID,LAST_NAME,EMAIL) 
		values(#{id},#{lastName},#{email<!-- ,jdbcType=NULL -->}) 
		<!-- AFTER:
		insert into employees(EMPLOYEE_ID,LAST_NAME,EMAIL) 
		values(employees_seq.nextval,#{lastName},#{email}) -->
	</insert>
	
	
	<!-- public void updateEmp(Employee employee);  -->
	<update id="updateEmp">
		update tbl_employee 
		set last_name=#{lastName},email=#{email},gender=#{gender}
		where id=#{id}
	</update>
	
	<!-- public void deleteEmpById(Integer id); -->
	<delete id="deleteEmpById">
		delete from tbl_employee where id=#{id}
	</delete>
	
</mapper>

三、编辑接口文件

package com.mybatis.mapper;

import com.mybatis.bean.Employee;

public interface EmployeeMapper {

	public Employee getEmpById(Integer id);
	
	public void addEmp(Employee employee);
	
	public void updateEmp(Employee employee);
	
	public void deleteEmp(Employee employee);
	
}

四、编辑bean文件

package com.mybatis.bean;

public class Employee {
	private Integer 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;
	}
	
	public Employee(){
		super();
	}
	
	public Employee(Integer id ,String lastName, String email, String gender) {
		super();
		this.id =id;
		this.lastName = lastName;
		this.email = email;
		this.gender = gender;
	}

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

}

五、编辑JUnit单元测试文件:

package com.mybatis.test;


import java.io.IOException;
import java.io.InputStream;

import org.apache.ibatis.io.Resources;
import org.apache.ibatis.session.SqlSession;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.junit.Test;

import com.mybatis.bean.Employee;
import com.mybatis.mapper.EmployeeMapper;


/**
 * 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允许增删改直接定义以下类型返回值
	 * 		Integer、Long、Boolean、void 【增删改 返回的是影响多少行,影响超过0行返回true,否则返回false】
	 * 2、我们需要手动提交数据
	 * 		sqlSessionFactory.openSession();===》手动提交
	 * 		sqlSessionFactory.openSession(true);===》自动提交
	 * @throws IOException 
	 */
	@Test
	public void test03() throws IOException{
		
		SqlSessionFactory sqlSessionFactory = getSqlSessionFactory();
		//1、获取到的SqlSession不会自动提交数据
		SqlSession openSession = sqlSessionFactory.openSession();
		
		try{
			//测试添加
			Employee employee = new Employee(null, "jerry4","[email protected]", "1");
			EmployeeMapper mapper = openSession.getMapper(EmployeeMapper.class);
			
			mapper.addEmp(employee);
			System.out.println(employee.getId());
			
			//测试修改
			//Employee employee = new Employee(1, "Tom", "[email protected]", "0");
			//boolean updateEmp = mapper.updateEmp(employee);
			//System.out.println(updateEmp);
			//测试删除
			//mapper.deleteEmpById(2);
			//2、手动提交数据
			openSession.commit();
		}finally{
			openSession.close();
		}
		
	}

}

 

mybatis全局配置文件-(6)-mappers sql映射注册

mappers 是用来进行 sql映射注册的。

方法一,文件映射方法:

1、文件路径查看

2、编辑全局映射文件:

<mappers>

	<!-- 
		mapper:注册一个sql映射 ,方法一注册配置文件
			
		resource:引用类路径下的sql映射文件【resource路径,就是以二进制bin文件夹根目录为起始目录,来计算子目录下的路径】
		mybatis/mapper/EmployeeMapper.xml
		eclipse 源码文件夹路径 到最后都会合并到类路径下。
					
		url:引用网路路径或者磁盘路径下的sql映射文件
		file:///var/mappers/AuthorMapper.xml
	-->
		<mapper url="file:///Users/jerry/Documents/workspace/Mybatis_02/conf/EmployeeMapper_new.xml"/>
		<mapper resource="mykkk/EmployeeMapper_old.xml"/>
</mappers>

3、sql映射文件:

<?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="EmployEE">
	<!--  
	1、之前没有在mybatis的全局配置文件中,开启驼峰转化 setting ,
	因此执行  select * from tb1_employee where id = #{id}  时,
	那时 数据库的字段 last_name 无法直接映射 到bean 中的lastName ,
	查询结果导致数据库 last_name 无法赋值给employee bean中的lastName
	所以,employee 中的  lastName 是空值,
	所以需要在 这里的sql语句中取别名
	select id,last_name lastName,email,gender from tbl_employee where id = #{id}
	
	2、现在已经开启了驼峰转化,所以就不需要 在sql语句中 取别名了
	下面的sql语句 也可以 直接写成:select * from tb1_employee where id = #{id}
	-->
	select id,last_name,email,gender from tbl_employee where id = #{id}
	</select>
	
	<!-- 
	默认有一个 没有添加 databaseId 的sql语句,然后是 各厂家的sql语句,调用sql语句时,选择 最匹配的sql语句 调用。
	 -->
	<select id="getEmpById" resultType="com.mybatis.bean.Employee"
		databaseId="mysql">
		select * from tbl_employee where id = #{id}
	</select>
	<select id="getEmpById" resultType="com.mybatis.bean.Employee"
		databaseId="oracle">
		select EMPLOYEE_ID id,LAST_NAME	lastName,EMAIL email 
		from employees where EMPLOYEE_ID=#{id}
	</select>
</mapper>
<?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">
	<!--  
	1、之前没有在mybatis的全局配置文件中,开启驼峰转化 setting ,
	因此执行  select * from tb1_employee where id = #{id}  时,
	那时 数据库的字段 last_name 无法直接映射 到bean 中的lastName ,
	查询结果导致数据库 last_name 无法赋值给employee bean中的lastName
	所以,employee 中的  lastName 是空值,
	所以需要在 这里的sql语句中取别名
	select id,last_name lastName,email,gender from tbl_employee where id = #{id}
	
	2、现在已经开启了驼峰转化,所以就不需要 在sql语句中 取别名了
	下面的sql语句 也可以 直接写成:select * from tb1_employee where id = #{id}
	-->
	select id,last_name,email,gender from tbl_employee where id = #{id}
	</select>
</mapper>

4、测试文件(和原来没有差别,只是将mybatis-config.xml改了一下目录)

@Test
public void test_old() throws IOException {
	String resource = "bky/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();
	}
}
	
/********************************************************************/
	
public SqlSessionFactory getSqlSessionFactory() throws IOException {
	String resource = "bky/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、全局配置文件:

<mappers>
      <!-- 旧方法操作mybatis 的配置文件,不存在接口文件,无法使用 class标签 -->
      <mapper resource="mykkk/EmployeeMapper_old.xml" />

      <!-- 新方法操作mybatis 的配置文件,存在接口文件,可以使用 class标签
    但是必须保障 在指定的class类路径下,同名的接口文件 和 同名的sql映射文件都存在 才行
      -->
      <mapper class="com.mybatis.mapper.EmployeeMapper" />
     
      <!-- 如果指定目录下,有多个接口类和对应的映射文件 需要用class标签配置 ,
      可以用批量配置方法,直接写 接口类的 包名就行
      比如上面的 可以写成 <package name="com.mybatis.mapper"/>
      -->

</mappers>

2、文件目录

3、Junit测试代码(和原来的没有区别)

4、当然 Mapper中 的class标签 ,不是一定需要 接口文件和 sql映射文件,都存在同一个目录。可以 采用对接口 注解的方式,来取消sql映射文件。

比如:对EmployeeMapper.java 接口修改并添加注解,来取消 sql映射文件。

package com.mybatis.mapper;

import org.apache.ibatis.annotations.Select;

import com.mybatis.bean.Employee;

public interface EmployeeMapper {
	
	@Select("select * from tbl_employee where id=#{id}")
	public Employee getEmpById(Integer id);
}

 

 

 

mybatis全局配置文件-(5)-databaseIdProvider 多数据库支持

MyBatis 可以根据不同的数据库厂商执行不同的语句。

【如果在全局配置文件中,没有配置databaseIdProvider,而在sql映射文件中,只定义了一条目标sql语句且该sql语句配置了databaseId=”mysql”,那么该sql语句是不会执行的】

在全局配置文件中:编辑 databaseIdProvider

<!-- databaseIdProvider:支持多数据库厂商的;
	 type="DB_VENDOR":VendorDatabaseIdProvider
	 作用就是得到数据库厂商的标识(驱动getDatabaseProductName()),mybatis就能根据数据库厂商标识来执行不同的sql;
		MySQL,Oracle,SQL Server,xxxx
 -->
	<databaseIdProvider type="DB_VENDOR">
		<!-- 为不同的数据库厂商起别名 -->
		<property name="MySQL" value="mysql"/>
		<property name="Oracle" value="oracle"/>
		<property name="SQL Server" value="sqlserver"/>
	</databaseIdProvider>

然后在对象映射文件中:sql语句中添加 databaseId

默认有一个 没有添加 databaseId 的sql语句,然后是 各厂家的sql语句,调用sql语句时,选择 最匹配的sql语句 调用。

<?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:唯一标识
resultType:返回值类型
#{id}:从传递过来的参数中取出id值

public Employee getEmpById(Integer id);
 -->
 	<select id="getEmpById" resultType="com.mybatis.bean.Employee">
		select * from tbl_employee where id = #{id}
	</select>
	<select id="getEmpById" resultType="com.mybatis.bean.Employee"
		databaseId="mysql">
		select * from tbl_employee where id = #{id}
	</select>
	<select id="getEmpById" resultType="com.mybatis.bean.Employee"
		databaseId="oracle">
		select EMPLOYEE_ID id,LAST_NAME	lastName,EMAIL email 
		from employees where EMPLOYEE_ID=#{id}
	</select>
</mapper>

 

mybatis全局配置文件-(4)-environments 环境

MyBatis可以配置多种环境,比如开发、测试和生产环境需要有不同的配置。
每种环境使用一个environment标签进行配置并指定唯一标识符。
可以通过environments标签中的default属性指定一个环境的标识符来快速的切换环境。

在mybatis全局配置文件中:编辑 environments

<!-- 
	environments:环境们,mybatis可以配置多种环境 ,default指定使用某种环境。可以达到快速切换环境。
	environment:配置一个具体的环境信息;必须有两个标签;id代表当前环境的唯一标识
	transactionManager:事务管理器;
	type:事务管理器的类型;JDBC(JdbcTransactionFactory)|MANAGED(ManagedTransactionFactory)
	自定义事务管理器:实现TransactionFactory接口.type指定为全类名
				
	dataSource:数据源;
	type:数据源类型;UNPOOLED(UnpooledDataSourceFactory)
		      |POOLED(PooledDataSourceFactory)
		      |JNDI(JndiDataSourceFactory)
	自定义数据源:实现DataSourceFactory接口,type是全类名

        下面的${jdbc.driver} 等,都是引用了 properties 属性 
 -->
		 

		 
<environments default="dev_mysql">
	<environment id="dev_mysql">
		<transactionManager type="JDBC"></transactionManager>
		<dataSource type="POOLED">
			<property name="driver" value="${jdbc.driver}" />
			<property name="url" value="${jdbc.url}" />
			<property name="username" value="${jdbc.username}" />
			<property name="password" value="${jdbc.password}" />
		</dataSource>
	</environment>
	
	<environment id="dev_oracle">
		<transactionManager type="JDBC" />
		<dataSource type="POOLED">
			<property name="driver" value="${orcl.driver}" />
			<property name="url" value="${orcl.url}" />
			<property name="username" value="${orcl.username}" />
			<property name="password" value="${orcl.password}" />
		</dataSource>
	</environment>
</environments>

 

 

mybatis全局配置文件-(3)-typeAliases 类型别名

类型别名是为Java 类型设置一个短的名字,可以方便我们引用某个类。

别名不区分大小写,别名需要在mybatis全局配置文件中,编写:

<!-- 3、typeAliases:别名处理器:可以为我们的java类型起别名 
			
	别名不区分大小写
-->
<typeAliases>
	<!-- 1、typeAlias:为某个java类型起别名
			type:指定要起别名的类型全类名;默认别名就是类名小写;employee
			alias:指定新的别名
	 -->
	<!-- <typeAlias type="com.atguigu.mybatis.bean.Employee" alias="emp"/> -->
		
	<!-- 2、package:为某个包下的所有类批量起别名 
			name:指定包名(为当前包以及下面所有的后代包的每一个类都起一个默认别名(类名小写),)
	-->
	<package name="com.mybatis.bean"/>
		
	<!-- 3、批量起别名的情况下,使用@Alias注解为某个类型指定新的别名 -->
</typeAliases>

别名取好了,就可以在对象映射文件中 使用了
(别名不区分大小写,映射文件的对象为:com.mybatis.bean.Employee)

<?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="EmployEE">
	<!--  
	1、之前没有在mybatis的全局配置文件中,开启驼峰转化 setting ,
	因此执行  select * from tb1_employee where id = #{id}  时,
	那时 数据库的字段 last_name 无法直接映射 到bean 中的lastName ,
	查询结果导致数据库 last_name 无法赋值给employee bean中的lastName
	所以,employee 中的  lastName 是空值,
	所以需要在 这里的sql语句中取别名
	select id,last_name lastName,email,gender from tbl_employee where id = #{id}
	
	2、现在已经开启了驼峰转化,所以就不需要 在sql语句中 取别名了
	下面的sql语句 也可以 直接写成:select * from tb1_employee where id = #{id}
	-->
	select id,last_name,email,gender from tbl_employee where id = #{id}
	</select>
</mapper>

补充:

值得注意的是,MyBatis已经为许多常见的Java 类型内建了相应的类型别名。它们都是大小写不敏感的,我们在起别名的时候千万不要占用已有的别名。

值得注意的是,MyBatis已经为许多常见的Java 类型内建了相应的类型别名。
它们都是大小写不敏感的,我们在起别名的时候千万不要占用已有的别名。

别名       映射的类型      别名       映射的类型      别名       映射的类型
_byte      byte         byte        Byte         date         Date 
_long 	   long         long 	    Long         decimal    BigDecimal  
_short     short        short 	    Short        bigdecimal BigDecimal 
_int 	    int         int 	   Integer       object      Object 
_integer    int         integer    Integer       map 	      Map 
_double    double       double 	    Double       hashmap     HashMap 
_float     float        float 	    Float        list 	     List 
_boolean   boolean      boolean     Boolean      arraylist   ArrayList 
string     String     collection   Collection    iterator    Iterator

 

 

mybatis全局配置文件-(2)-settings 设置

这是MyBatis 中极为重要的调整设置,它们会改变MyBatis 的运行时行为。

比如在 mybatis全局配置文件中,添加如下setting 来开启驼峰转化(默认是关闭的)

<!-- 
	settings包含很多重要的设置项
	setting:用来设置每一个设置项
		name:设置项名
		value:设置项取值
        下面的setting是用来 将数据库的字段进行驼峰转化用的,
        比如数据库的字段 last_name 将映射到 bean中的 lastName【  "_小写字母"  会自动转化成  "大写字母" 】这样就不需要 在映射文件中的sql查询语句里 写别名了 
 -->
<settings>
	<setting name="mapUnderscoreToCamelCase" value="true"/>
</settings>

mybatis接口调用下的映射文件:

<?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">
	<!--  
	1、之前没有在mybatis的全局配置文件中,开启驼峰转化 setting ,
	因此执行  select * from tb1_employee where id = #{id}  时,
	那时 数据库的字段 last_name 无法直接映射 到bean 中的lastName ,
	查询结果导致数据库 last_name 无法赋值给employee bean中的lastName
	所以,employee 中的  lastName 是空值,
	所以需要在 这里的sql语句中取别名
	select id,last_name lastName,email,gender from tbl_employee where id = #{id}
	
	2、现在已经开启了驼峰转化,所以就不需要 在sql语句中 取别名了
	下面的sql语句 也可以 直接写成:select * from tb1_employee where id = #{id}
	-->
	select id,last_name,email,gender from tbl_employee where id = #{id}
	</select>
</mapper>

bean的成员变量如下:数据库字段 last_name与bean中的lastName不能直接映射,要么在mybatis映射文件中的数据库查询中用别名,要么在mybatis全局配置文件中开启驼峰转化设置。

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 + "]";
	}

}

 

mybatis全局配置文件-(1)-properties 属性

1、新建一个dbconfig.properties文件(与mybatis的全局配置文件同目录,也可以不同目录,下面举例是同目录情况下的路径写法),用来保存数据库连接属性。

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://localhost:3306/mybatis
jdbc.username=root
jdbc.password=123456

orcl.driver=oracle.jdbc.OracleDriver
orcl.url=jdbc:oracle:thin:@localhost:1521:orcl
orcl.username=scott
orcl.password=123456

2、在默认的mybatis的全局配置文件中:

<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>

改成

<!--
	1、mybatis可以使用properties来引入外部properties配置文件的内容;
	resource:引入类路径下的资源
	url:引入网络路径或者磁盘路径下的资源
 -->
<properties resource="dbconfig.properties"></properties>

<environments default="dev_mysql">
	<environment id="dev_mysql">
		<transactionManager type="JDBC"></transactionManager>
		<dataSource type="POOLED">
			<property name="driver" value="${jdbc.driver}" />
			<property name="url" value="${jdbc.url}" />
			<property name="username" value="${jdbc.username}" />
			<property name="password" value="${jdbc.password}" />
		</dataSource>
	</environment>
</environments>

 

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 就行了。

mybatis入门概述-mybatis框架简介

MyBatis简介

核心总结:

默认情况,自动生成的 SQL映射文件,默认 Mybatis的查询,只会返回字段给beanbean中的子对象是不存在的。

除非自己自定义bean中的子对象 ,和自定义SQL语句,并将sql语句返回的属性赋值给子对象的属性中。

事实情况举例如下:
{"code":100,"msg":"处理成功!","extend":{"emp":{"empId":1,"empName":"Jerry","gender":"M","email":"[email protected]","dId":1,"department":null}}}


原是Apache的一个开源项目iBatis, 2010年6月这个项目由Apache Software Foundation 迁移到了Google Code,随着开发团队转投Google Code旗下,iBatis3.x正式更名为MyBatis ,代码于2013年11月迁移到Github(下载地址见后)。

iBatis一词来源于“internet”和“abatis”的组合,是一个基于Java的持久层框架。iBatis提供的持久层框架包括SQL Maps和Data Access Objects(DAO)

MyBatis 是支持定制化SQL、存储过程以及高级映射的优秀的持久层框架。

MyBatis 避免了几乎所有的JDBC 代码和手动设置参数以及获取结果集。

MyBatis可以使用简单的XML或注解用于配置和原始映射,将接口和Java的POJO(Plain Old Java Objects,普通的Java对象)映射成数据库中的记录.

MyBatis用处

MyBatis是一个半自动化的持久化层框架。

•JDBC
–SQL夹在Java代码块里,耦合度高导致硬编码内伤
–维护不易且实际开发需求中sql是有变化,频繁修改的情况多见

•Hibernate和JPA
–长难复杂SQL,对于Hibernate而言处理也不容易
–内部自动生产的SQL,不容易做特殊优化。
–基于全映射的全自动框架,大量字段的POJO进行部分映射时比较困难。导致数据库性能下降。

•对开发人员而言,核心sql还是需要自己优化
•sql和java编码分开,功能边界清晰,一个专注业务、一个专注数据。

mybatis下载

1、https://github.com/mybatis/mybatis-3/

2、http://central.maven.org/maven2/org/mybatis/mybatis/3.4.6/