Mybatis 核心配置文件

四、MyBatis主配置文件MyBatis学习 之 一、MyBatis简介与配置MyBatisSpringMySqlMyBatis学习 之 二、SQL语句映射文件(1)resultMapMyBatis学习 之 二、SQL语句映射文件(2)增删改查、参数、缓存MyBatis学习 之 三、动态SQL语句MyBatis学习 之 四、MyBatis配置文件在定义sqlSessionFactory时需要指定MyBatis主配置文件Xml代码bean idsqlSessionFactory classorg.mybatis.spring.SqlSessionFactoryBean property nameconfigLocation valueclasspath:mybatis-config.xml / property namedataSource refdataSource / /beanMyBatis配置文件中大标签configuration下子标签包括configuration |--- properties |--- settings |--- typeAliases |--- typeHandlers |--- objectFactory |--- plugins |--- environments |--- |--- environment |--- |--- |--- transactionManager |--- |--- |__ dataSource |__ mappers4.1 properties属性properties和java的.properties的配置文件有关。配置properties的resource指定.properties的路径然后再在properties标签下配置property的name和value则可以替换.properties文件中相应属性值。Xml代码!-- 属性替换 -- properties resourcemysql.properties property namejdbc.driverClassName valuecom.mysql.jdbc.Driver/ property namejdbc.url valuejdbc:mysql://localhost:3306/student_manager/ property nameusername valueroot/ property namepassword valuelimingnihao/ /properties4.2 settings设置这是MyBatis 修改操作运行过程细节的重要的步骤。下方这个表格描述了这些设置项、含义和默认值。设置项描述允许值默认值cacheEnabled对在此配置文件下的所有cache 进行全局性开/关设置。true | falsetruelazyLoadingEnabled全局性设置懒加载。如果设为‘false’则所有相关联的都会被初始化加载。true | falsetrueaggressiveLazyLoading当设置为‘true’的时候懒加载的对象可能被任何懒属性全部加载。否则每个属性都按需加载。true | falsetruemultipleResultSetsEnabled允许和不允许单条语句返回多个数据集取决于驱动需求true | falsetrueuseColumnLabel使用列标签代替列名称。不同的驱动器有不同的作法。参考一下驱动器文档或者用这两个不同的选项进行测试一下。true | falsetrueuseGeneratedKeys允许JDBC 生成主键。需要驱动器支持。如果设为了true这个设置将强制使用被生成的主键有一些驱动器不兼容不过仍然可以执行。true | falsefalseautoMappingBehavior指定MyBatis 是否并且如何来自动映射数据表字段与对象的属性。PARTIAL将只自动映射简单的没有嵌套的结果。FULL 将自动映射所有复杂的结果。NONE,PARTIAL,FULLPARTIALdefaultExecutorType配置和设定执行器SIMPLE 执行器执行其它语句。REUSE 执行器可能重复使用prepared statements 语句BATCH执行器可以重复执行语句和批量更新。SIMPLEREUSEBATCHSIMPLEdefaultStatementTimeout设置一个时限以决定让驱动器等待数据库回应的多长时间为超时正整数Not Set(null)例如Xml代码settings setting namecacheEnabled valuetrue / setting namelazyLoadingEnabled valuetrue / setting namemultipleResultSetsEnabled valuetrue / setting nameuseColumnLabel valuetrue / setting nameuseGeneratedKeys valuefalse / setting nameenhancementEnabled valuefalse / setting namedefaultExecutorType valueSIMPLE / /settings4.3 typeAliases类型别名类型别名是Java 类型的简称。它仅仅只是关联到XML 配置简写冗长的JAVA 类名。例如Xml代码typeAliases typeAlias aliasUserEntity typecom.manager.data.model.UserEntity / typeAlias aliasStudentEntity typecom.manager.data.model.StudentEntity / typeAlias aliasClassEntity typecom.manager.data.model.ClassEntity / /typeAliases使用这个配置“StudentEntity”就能在任何地方代替“com.manager.data.model.StudentEntity”被使用。对于普通的Java类型有许多内建的类型别名。它们都是大小写不敏感的由于重载的名字要注意原生类型的特殊处理。别名映射的类型_bytebyte_longlong_shortshort_intint_integerint_doubledouble_floatfloat_booleanbooleanstringStringbyteBytelongLongshortShortintIntegerintegerIntegerdoubleDoublefloatFloatbooleanBooleandateDatedecimalBigDecimalbigdecimalBigDecimalobjectObjectmapMaphashmapHashMaplistListarraylistArrayListcollectionCollectioniteratorIterator4.4 typeHandlers类型句柄无论是MyBatis在预处理语句中设置一个参数还是从结果集中取出一个值时类型处理器被用来将获取的值以合适的方式转换成Java类型。下面这个表格描述了默认的类型处理器。类型处理器Java类型JDBC类型BooleanTypeHandlerBooleanboolean任何兼容的布尔值ByteTypeHandlerBytebyte任何兼容的数字或字节类型ShortTypeHandlerShortshort任何兼容的数字或短整型IntegerTypeHandlerIntegerint任何兼容的数字和整型LongTypeHandlerLonglong任何兼容的数字或长整型FloatTypeHandlerFloatfloat任何兼容的数字或单精度浮点型DoubleTypeHandlerDoubledouble任何兼容的数字或双精度浮点型BigDecimalTypeHandlerBigDecimal任何兼容的数字或十进制小数类型StringTypeHandlerStringCHAR和VARCHAR类型ClobTypeHandlerStringCLOB和LONGVARCHAR类型NStringTypeHandlerStringNVARCHAR和NCHAR类型NClobTypeHandlerStringNCLOB类型ByteArrayTypeHandlerbyte[]任何兼容的字节流类型BlobTypeHandlerbyte[]BLOB和LONGVARBINARY类型DateTypeHandlerDatejava.utilTIMESTAMP类型DateOnlyTypeHandlerDatejava.utilDATE类型TimeOnlyTypeHandlerDatejava.utilTIME类型SqlTimestampTypeHandlerTimestampjava.sqlTIMESTAMP类型SqlDateTypeHandlerDatejava.sqlDATE类型SqlTimeTypeHandlerTimejava.sqlTIME类型ObjectTypeHandlerAny其他或未指定类型EnumTypeHandlerEnumeration类型VARCHAR-任何兼容的字符串类型作为代码存储而不是索引。你可以重写类型处理器或创建你自己的类型处理器来处理不支持的或非标准的类型。要这样做的话简单实现TypeHandler接口org.mybatis.type然后映射新的类型处理器类到Java类型还有可选的一个JDBC类型。然后再typeHandlers中添加这个类型处理器。新定义的类型处理器将会覆盖已经存在的处理Java的String类型属性和VARCHAR参数及结果的类型处理器。要注意MyBatis不会审视数据库元信息来决定使用哪种类型所以你必须在参数和结果映射中指定那是VARCHAR类型的字段来绑定到正确的类型处理器上。这是因为MyBatis直到语句被执行都不知道数据类型的这个现实导致的。Java代码public class LimingStringTypeHandler implements TypeHandler { Override public void setParameter(PreparedStatement ps, int i, Object parameter, JdbcType jdbcType) throws SQLException { System.out.println(setParameter - parameter: ((String) parameter) , jdbcType: jdbcType.TYPE_CODE); ps.setString(i, ((String) parameter)); } Override public Object getResult(ResultSet rs, String columnName) throws SQLException { System.out.println(getResult - columnName: columnName); return rs.getString(columnName); } Override public Object getResult(CallableStatement cs, int columnIndex) throws SQLException { System.out.println(getResult - columnIndex: columnIndex); return cs.getString(columnIndex); } }在配置文件的typeHandlers中添加typeHandler标签。Xml代码typeHandlers typeHandler javaTypeString jdbcTypeVARCHAR handlerliming.student.manager.type.LimingStringTypeHandler/ /typeHandlers4.5 ObjectFactory对象工厂每次MyBatis 为结果对象创建一个新实例都会用到ObjectFactory。默认的ObjectFactory 与使用目标类的构造函数创建一个实例毫无区别如果有已经映射的参数那也可能使用带参数的构造函数。如果你重写ObjectFactory 的默认操作你可以通过继承org.apache.ibatis.reflection.factory.DefaultObjectFactory创建一下你自己的。ObjectFactory接口很简单。它包含两个创建用的方法一个是处理默认构造方法的另外一个是处理带参数构造方法的。最终setProperties方法可以被用来配置ObjectFactory。在初始化你的ObjectFactory实例后objectFactory元素体中定义的属性会被传递给setProperties方法。Java代码public class LimingObjectFactory extends DefaultObjectFactory { private static final long serialVersionUID -399284318168302833L; Override public Object create(Class type) { return super.create(type); } Override public Object create(Class type, ListClass constructorArgTypes, ListObject constructorArgs) { System.out.println(create - type: type.toString()); return super.create(type, constructorArgTypes, constructorArgs); } Override public void setProperties(Properties properties) { System.out.println(setProperties - properties: properties.toString() , someProperty: properties.getProperty(someProperty)); super.setProperties(properties); } }配置文件中添加objectFactory标签Xml代码objectFactory typeliming.student.manager.configuration.LimingObjectFactory property namesomeProperty value100/ /objectFactory4.6 plugins插件MyBatis允许你在某一点拦截已映射语句执行的调用。默认情况下MyBatis允许使用插件来拦截方法调用Executor(update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)ParameterHandler(getParameterObject, setParameters)ResultSetHandler(handleResultSets, handleOutputParameters)StatementHandler(prepare, parameterize, batch, update, query)这些类中方法的详情可以通过查看每个方法的签名来发现而且它们的源代码在MyBatis的发行包中有。你应该理解你覆盖方法的行为假设你所做的要比监视调用要多。如果你尝试修改或覆盖一个给定的方法你可能会打破MyBatis的核心。这是低层次的类和方法要谨慎使用插件。使用插件是它们提供的非常简单的力量。简单实现拦截器接口要确定你想拦截的指定签名。4.7 environments环境MyBatis 可以配置多个环境。这可以帮助你SQL 映射对应多种数据库等。4.8 mappers映射器这里是告诉MyBatis 去哪寻找映射SQL 的语句。可以使用类路径中的资源引用或者使用字符输入确切的URL 引用。例如Xml代码mappers mapper resourcecom/manager/data/maps/UserMapper.xml / mapper resourcecom/manager/data/maps/StudentMapper.xml / mapper resourcecom/manager/data/maps/ClassMapper.xml / /mappers