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>