Java框架（八）之Mybatis（Mapper代理的开发方式、全局配置文件、映射文件）

一、Mapper代理的开发方式

1.介绍

Mapper代理使用的是jdk的动态代理

2.Mapper代理的开发规范

1、 mapper接口的全限定名要和mapper映射文件的namespace值一致。
2、 mapper接口的方法名称要和mapper映射文件的statement的id一致。
3、 mapper接口的方法参数类型要和mapper映射文件的statement的parameterType的值一致，而且它的参数是一个。
4、 mapper接口的方法返回值类型要和mapper映射文件的statement的resultType的值一致。

3.案例

（1）MybatisUtils工具类

public class MybatisUtils {
	static SqlSession sqlSession;
	static SqlSessionFactory sqlSessionFactory ; 
	static {
		try {
			 sqlSessionFactory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsReader("mybatisConfig.xml"));
		} catch (IOException e) {
			// TODO Auto-generated catch block
			e.printStackTrace();
		}
	}
	public static SqlSession getSqlSession() {
		return sqlSessionFactory.openSession();
	}
}

（2）UserMapper接口

public interface UserMapper {
	public void save(User u);
	public User findById(int id);
	public List<User> findAll();
	
}

（3）UserMapper映射文件

<!-- 基于mapper代理开发
	namespace:跟接口对应
	id:与接口中的各方法名一致
	parameterType ：与接口中的参数一致
	returnType:与接口中方法的返回值一致
 -->
<mapper namespace="com.qf.dao.UserMapper">
<!-- 新增 -->
	<insert id="save" parameterType="com.qf.bean.User">
		insert into user(username,password) values(#{username},#{password})
	</insert>
	<!-- 全查 -->
	<select id="findAll"  resultType="com.qf.bean.User">
		select * from user
	</select>
	<!-- 根据id查 -->
	<select id="findById" parameterType="int" resultType="com.qf.bean.User">
		select * from user where id=#{id}
	</select>
</mapper>

（4）MyBatisConfig配置文件

<configuration>
	<environments default="development"> 
		<environment id="development">
			<!-- 使用jdbc方式控制事务 -->
			<transactionManager type="JDBC"/> 
			<!-- mybatis提供的连接池链接数据
			  未来：mybatis+spring+sprignmvc  这一步交给spring
			 -->
			<dataSource type="POOLED">
				<property name="driver" value="com.mysql.jdbc.Driver"/> 
				<property name="url" value="jdbc:mysql:///mystu?unicode=true&amp;characterEncoding=utf-8"/>
				<property name="username" value="root"/> 
				<property name="password" value="111"/>
			</dataSource> 
		</environment>
	</environments>
	<!-- 指定映射文件 -->
	<mappers>
		<!-- <mapper resource="com/qf/dao/UserMapper.xml"/> -->
		<!-- 指定映射文件所在的包 -->
		<package name="com.qf.dao"/>
	</mappers>
</configuration>

（5）TestMapper（测试类）

public class TestMapper {
	public static void main(String[] args) {
		SqlSession sqlSession=MybatisUtils.getSqlSession();
		UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
		User u=new User();
		u.setUsername("赵六");
		u.setPassword("112233");
		userMapper.save(u);
		
		List<User> list=userMapper.findAll();
		for (User user : list) {
			System.out.println(user);
		}
		User user=userMapper.findById(2);
		System.out.println(user);
	}
}

二、全局配置文件

SqlMapConfig.xml的配置内容和顺序如下（顺序不能乱）：dtd约束规定

名称	解释
Properties	（属性）属性配置文件
Settings	（全局参数设置） 懒加载 二级缓存
typeAliases	（类型别名）
typeHandlers	（类型处理器）
objectFactory	（对象工厂）
plugins	（插件） 分页插件
environments	（环境信息集合）
environment	（单个环境信息）
transactionManager	（事物）
dataSource	（数据源）
mappers	（映射器）

1.常用配置

（1）Properties

加载的顺序
1、先加载properties中property标签声明的属性
2、 再加载properties标签引入的java配置文件(properties配置文件)中的属性
3、 parameterType的值会和properties的属性值发生冲突。
示例：

<properties resource="dbinfo.properties">
  		<!-- <property name="driver" value="com.mysql.jdbc.Driver"/> -->
  	</properties>

（2）.settings

Setting(设置)	Description（描述）	Valid Values(验证值组)
cacheEnabled	在全局范围内启用或禁用缓存配置任何映射器在此配置下。	true | false
lazyLoadingEnabled	在全局范围内启用或禁用延迟加载。禁用时，所有协会将热加载	true | false
aggressiveLazyLoading	启用时，有延迟加载属性的对象将被完全加载后调用懒惰的任何属性。否则，每一个属性是按需加载。	true | false
multipleResultSetsEnabled	允许或不允许从一个单独的语句（需要兼容的驱动程序）要返回多个结果集。	true | false
useColumnLabel	使用列标签，而不是列名。在这方面，不同的驱动有不同的行为。参考驱动文档或测试两种方法来决定你的驱动程序的行为如何。	true | false
useGeneratedKeys	允许JDBC支持生成的密钥。兼容的驱动程序是必需的。此设置强制生成的键被使用，如果设置为true，一些驱动会不兼容性，但仍然可以工作。	true | false
autoMappingBehavior	指定MyBatis的应如何自动映射列到字段/属性。NONE自动映射。 PARTIAL只会自动映射结果没有嵌套结果映射定义里面。 FULL会自动映射的结果映射任何复杂的（包含嵌套或其他）。	NONE, PARTIAL, FULL
defaultExecutorType	配置默认执行人。SIMPLE执行人确实没有什么特别的。 REUSE执行器重用准备好的语句。 BATCH执行器重用语句和批处理更新。	SIMPLE REUSE BATCH
defaultStatementTimeout	设置驱动程序等待一个数据库响应的秒数。	Any positive integer
safeRowBoundsEnabled	允许使用嵌套的语句RowBounds。	true | false
mapUnderscoreToCamelCase	从经典的数据库列名A_COLUMN启用自动映射到骆驼标识的经典的Java属性名aColumn。	true | false
localCacheScopeMyBatis	使用本地缓存，以防止循环引用，并加快反复嵌套查询。默认情况下（SESSION）会话期间执行的所有查询缓存。如果localCacheScope=STATMENT本地会话将被用于语句的执行，只是没有将数据共享之间的两个不同的调用相同的SqlSession。	SESSION | STATEMENT
dbcTypeForNull	指定为空值时，没有特定的JDBC类型的参数的JDBC类型。有些驱动需要指定列的JDBC类型，但其他像NULL，VARCHAR或OTHER的工作与通用值。	JdbcType enumeration. Most common are: NULL, VARCHAR and OTHER
lazyLoadTriggerMethods	指定触发延迟加载的对象的方法。	A method name list separated by commas
defaultScriptingLanguage	指定所使用的语言默认为动态SQL生成。	A type alias or fully qualified class name.
callSettersOnNulls	指定如果setter方法​​或地图的put方法时，将调用检索到的值是null。它是有用的，当你依靠Map.keySet（）或null初始化。注意原语（如整型，布尔等）不会被设置为null。	true | false
logPrefix	指定的前缀字串，MyBatis将会增加记录器的名称。	Any String
logImpl	指定MyBatis的日志实现使用。如果此设置是不存在的记录的实施将自动查找。	SLF4J | LOG4J | LOG4J2 | JDK_LOGGING |COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING
proxyFactory	指定代理工具，MyBatis将会使用创建懒加载能力的对象。	CGLIB | JAVASSIS

（3）typeAliases

• mybatis支持的别名

别名	映射的类型
_byte	byte
_long	long
_short	short
_int	int
_integer	int
_double	double
_float	float
_boolean	boolean
string	String
byte	Byte
long	Long
short	Short
int	Integer
integer	Integer
double	Double
float	Float
boolean	Boolean
date	Date
decimal	BigDecimal
bigdecimal	BigDecimal

• 自定义别名

<typeAliases>
		<!-- <typeAlias type="com.qf.domain.Book" alias="book"/> -->
		<!-- 批量别名定义（推荐） -->
		<!-- package：指定包名称来为该包下的po类声明别名，默认的别名就是类名（首字母大小写都可） -->
		<package name="com.qf.domain" />
	</typeAliases>

（4）Mappers

• <mapper resource=’’/> 使用相对于类路径的资源
• <mapper class=’’/> 使用mapper接口的全限定名
• <package name=’’/> 注册指定包下的所有映射文件

三、映射文件

输入映射

parameterType

如果传入对个参数，若参数类型是实体类中的
①：若参数类型是实体类中的，可以传入实体类
②：也可以将参数设置为Map

输出映射

resultType（实体类和数据库的字段一致）

使用resultType进行结果映射时，需要查询出的列名和映射的对象的属性名一致，才能映射成功。
如果查询的列名和对象的属性名全部不一致，那么映射的对象为空。
如果查询的列名和对象的属性名有一个一致，那么映射的对象不为空，但是只有映射正确那一个属性才有值。
如果查询的sql的列名有别名，那么这个别名就是和属性映射的列名。

resultMap（数据库的字段和实体列的字段不一致）

使用resultMap进行结果映射时，不需要查询的列名和映射的属性名必须一致。但是需要声明一个resultMap节点，来对列名和属性名进行映射。

property: 实体类中的字段名
column: 数据库中的字段名

总结：

ResultType:结果集类型 可以是对象也可以是Map 实体类和数据库表的字段一致
ResultMap：结果集映射 ，当实体类属性与数据库字段（别名）不一致 需要做结果映射
ParameterType： 参数类型 可以是对象也可以是Map
ParameterMap：不用