mybatis总概览（3）(总配置，protertiies，typeAliases，mappers，parameterType)

1，SqlMapConfig.xml总览

mybatis的全局配置文件SqlMapConfig.xml，配置内容如下：

properties（属性）
settings（全局配置参数）
typeAliases（类型别名）
typeHandlers（类型处理器）
objectFactory（对象工厂）
plugins（插件）
environments（环境集合属性对象）
  environment（环境子属性对象）
    transactionManager（事务管理）
    dataSource（数据源）
mappers（映射器）

注意：(ps：对于上面属性的位置是有序的！）

2，properties属性

可以将properties属性（数据库连接参数）单独配置在db.properties中，只需要在SqlMapConfig.xml中加载db.properties的属性值（用EL表达式获取值即可）。

在SqlMapConfig.xml中就不需要对数据库连接参数硬编码。（如果单独修改数据库参数，就不需要检查整个配置是否被修改了）

将数据库连接参数只配置在db.properties中，原因：方便对参数进行统一管理，其它xml可以引用该db.properties。

 （当需要用程序修改配置的时候，对单个简单结构的配置文件修改更加容易）

例子：db.properties文件：

在sqlMapConfig.xml加载属性文件：（通过标签加载，通过EL获取）

properties特性：

注意： MyBatis 将按照下面的顺序来加载属性：
      1,在 properties 元素体内定义的属性首先被读取(properties中可以定义property标签属性的）。 
      2,然后会读取properties 元素中resource或 url 加载文件中的属性，它会覆盖已读取的同名属性。 
      3,最后读取parameterType传递的属性，它会覆盖已读取的同名属性。
        （即${属性}占位符和其他property属性同名，将取property的属性值，而不会去从传入的对象中取值）

建议：

1,不要在properties元素体内添加任何属性值，只将属性值定义在properties引用的文件中。
2，在properties文件中定义属性名要有一定的特殊性，如：XXXXX.XXXXX.XXXX（防止重名）

3，settings全局参数配置

mybatis框架在运行时可以调整一些运行参数。
比如：开启二级缓存、开启延迟加载。

全局参数将会影响mybatis的运行行为(早期版本需要通过该配置手动进行优化，现在大部分实现自动优化）。

 详细参见“学习资料/mybatis-settings.xlsx”文件

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

4，typeAliases(别名）重点

在mapper.xml中，定义很多的statement，statement需要parameterType指定输入参数的类型、需要resultType指定输出结果的映射类型。
如果在指定类型时输入类型全路径，不方便进行开发，可以针对parameterType或resultType指定的类型定义一些别名，在mapper.xml中通过别名定义，方便开发。

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 

自定义别名：单个和批量

在SqlMapConfig.xml中配置：

<typeAliases>
    <!-- 单个别名定义 -->
    <typeAlias alias="user" type="cn.itcast.mybatis.po.User"/>
    <!-- 批量别名定义，扫描整个包下的类，别名为类名（首字母大写或小写都可以） -->
    <package name="cn.itcast.mybatis.po"/>
    <package name="其它包"/>
</typeAliases>

注意：（ps：如果用包扫描的方式，会出现：class not found:org.jboss.vfs.vfs )

引用别名（在map.xml)：

 5， typeHandlers（类型处理器）

mybatis中通过typeHandlers完成jdbc类型和java类型的转换。(通常框架已经自动转换了）

通常情况下，mybatis提供的类型处理器满足日常需要，不需要自定义.

mybatis支持类型处理器：

类型处理器                   Java类型           JDBC类型
BooleanTypeHandler     Boolean，boolean     任何兼容的布尔值
ByteTypeHandler        Byte，byte           任何兼容的数字或字节类型
ShortTypeHandler       Short，short         任何兼容的数字或短整型
IntegerTypeHandler     Integer，int         任何兼容的数字和整型
LongTypeHandler        Long，long           任何兼容的数字或长整型
FloatTypeHandler       Float，float         任何兼容的数字或单精度浮点型
DoubleTypeHandler      Double，double       任何兼容的数字或双精度浮点型
BigDecimalTypeHandler  BigDecimal           任何兼容的数字或十进制小数类型
StringTypeHandler      String               CHAR和VARCHAR类型
ClobTypeHandler        String               CLOB和LONGVARCHAR类型
NStringTypeHandler     String               NVARCHAR和NCHAR类型
NClobTypeHandler       String               NCLOB类型
ByteArrayTypeHandler   byte[]               任何兼容的字节流类型
BlobTypeHandler        byte[]               BLOB和LONGVARBINARY类型
DateTypeHandler        Date（java.util）     TIMESTAMP类型
DateOnlyTypeHandler     Date（java.util）    DATE类型
TimeOnlyTypeHandler     Date（java.util）    TIME类型
SqlTimestampTypeHandler Timestamp（java.sql）TIMESTAMP类型
SqlDateTypeHandler     Date（java.sql）      DATE类型
SqlTimeTypeHandler     Time（java.sql）      TIME类型
ObjectTypeHandler        任意                其他或未指定类型
EnumTypeHandler         Enumeration类型      VARCHAR-任何兼容的字符串类型，作为代码存储（而不是索引）。

6，mappers（映射文件配置）

通过resource加载单个映射文件

使用相对于类路径的资源
如：<mapper resource="sqlmap/User.xml" />

通过class(mapper接口)加载单个mapper

前提：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。

使用mapper接口类路径
如：<mapper class="cn.itcast.mybatis.mapper.UserMapper"/>

通过package批量加载mapper(推荐使用)

前提：此种方法要求mapper接口名称和mapper映射文件名称相同，且放在同一个目录中。

注册指定包下的所有mapper接口
如：<package name="cn.itcast.mybatis.mapper"/>

注意：（ps：不管是之前的别名还是现在的映射，用包扫描的方式，都会出现：class not found:org.jboss.vfs.vfs )

 7，输入映射

通过parameterType指定输入参数的类型，类型可以是简单类型、hashmap、pojo的包装类型

7.1，传递pojo的包装对象

 需求：完成用户信息的综合查询，需要传入查询条件很复杂（可能包括用户信息、其它信息，比如商品、订单的）

定义包装对象

定义包装对象将查询条件(pojo)以类组合的方式包装起来(即：对象里面包含对象）。

public class UserQueryVo {    
    private User user;  
    //自定义用户扩展类
    private UserCustom userCustom;
    ...
   //省略了属性的get/set方法

mapper.xml映射文件

mapper.java

测试代码

7.2， 传递hashmap

Sql映射文件定义如下：（下面hashmap是别名的缩写，可以用hashmap类全名）

<!-- 传递hashmap综合查询用户信息 -->
    <select id="findUserByHashmap" parameterType="hashmap" resultType="user">
       select * from user where id=#{id} and username like '%${username}%'
    </select>

上边占位符里面的都是hashmap的key。

Public void testFindUserByHashmap()throws Exception{
        //获取session
        SqlSession session = sqlSessionFactory.openSession();
        //获限mapper接口实例
        UserMapper userMapper = session.getMapper(UserMapper.class);
        //构造查询条件Hashmap对象
        HashMap<String, Object> map = new HashMap<String, Object>();
        map.put("id", 1);
        map.put("username", "管理员");
        
        //传递Hashmap对象查询用户列表
        List<User>list = userMapper.findUserByHashmap(map);
        //关闭session
        session.close();
    }

异常测试：

传递的map中的key和sql中解析的key不一致。
测试结果没有报错，只是通过key获取值为空。