MyBatis最关键的组成部分是SqlSessionFactory,咱们能够从中获取SqlSession, 并执行映射的SQL语句。
SqlSessionFactory对象能够经过基于XML的配置信息或者JavaAPI建立。java
构建SqlSessionFactory最多见的方式是基于XML配置。myBatis的配置文件通常命名为mybatis-config.xml,
下面的 mybatis-config.xml展现了一个典型的MyBatis配置文件的样子:程序员
<?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> <properties resource="application.properties"> <property name="username" value="db_user" /> <property name="password" value="verysecurepwd" /> </properties> <settings> <setting name="cacheEnabled" value="true" /> </settings> <typeAliases> <typeAlias alias="Student" type="com.briup.pojo.Student" /> <package name="com.briup.pojo" /> </typeAliases> <typeHandlers> <typeHandler handler="com.mybatis3.typehandlers.PhoneTypeHandler" /> <package name="com.briup.typehandlers" /> </typeHandlers> <environments default="development"> <environment id="development"> <transactionManager type="JDBC" /> <dataSource type="POOLED"> <property name="driver" value="${jdbc.driverClassName}" /> <property name="url" value="${jdbc.url}" /> <property name="username" value="${jdbc.username}" /> <property name="password" value="${jdbc.password}" /> </dataSource> </environment> <environment id="production"> <transactionManager type="MANAGED" /> <dataSource type="JNDI"> <property name="data_source" value="java:comp/jdbc/MyBatisDemoDS" /> </dataSource> </environment> </environments> <mappers> <mapper resource="com/briup/mappers/StudentMapper.xml" /> <mapper url="file:///D:/mybatisdemo/mappers/StudentMapper.xml" /> <mapper class="com.briup.mappers.StudentMapper" /> </mappers> </configuration>
environments是配置mybatis当前工做的数据库环境的地方web
MyBatis支持配置多个dataSource环境,能够将应用部署到不一样的环境上,
好比:DEV(开发环境)、TEST(测试环境)、QA(质量评估环境)、UAT(用户验收环境)、PRODUCTION(生产环境),
不一样的环境可能使用的数据库环境不都同样。这时候,咱们能够经过将默认environments值(default属性)设置成想要的environment的id值。sql
有时候,咱们可能须要在相同的应用下使用多个数据库,
好比:咱们可能用一个shoppingcart数据库来存储全部的订单明细,在使用一个reports数据库存储订单明细的合计,用做报告。(也就是若是系统在运行期间若是有切换数据库环境的需求,mybatis中也能够很轻松的实现)。数据库
若是你的应用须要链接多个数据库,你须要将每一个数据库配置成独立的环境,而且为每个数据库建立一个SqlSessionFactory apache
例如,现有mybatis-config.xml文件中,配置有两个数据库信息,:编程
<environments default="shoppingcart"> <environment id="shoppingcart"> <transactionManager type="MANAGED" /> <dataSource type="JNDI"> <property name="data_source" value="java:comp/jdbc/ShoppingcartDS" /> </dataSource> </environment> <environment id="reports"> <transaction Managertype="MANAGED" /> <dataSource type="JNDI"> <property name="data_source" value="java:comp/jdbc/ReportsDS" /> </dataSource> </environment> </environments>
咱们能够为以上每一个环境建立一个SqlSessionFactory, java代码:缓存
inputStream = Resources.getResourceAsStream("mybatis-config.xml"); //默认的环境 defaultSqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream); //统计明细的环境 cartSqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream, "shoppingcart"); //统计报表的环境 reportSqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream, "reports");
注意:对于environments,咱们能够在其中配置多个environment子元素,同时还须要在environment中配置dataSource和transactionManager元素。服务器
dataSource表示的是数据源,至少会包括该链接数据库的各类信息mybatis
<dataSource type="POOLED"> <property name="driver" value="${jdbc.driverClassName}" /> <property name="url" value="${jdbc.url}" /> <property name="username" value="${jdbc.username}" /> <property name="password" value="${jdbc.password}" /> </dataSource>
dataSource的类型type属性能够配置成其内置类型之一,如:UNPOOLED,POOLED,JNDI。
UNPOOLED:MyBatis会为每个数据库操做建立一个新的链接,使用完了并关闭它,该方式适用于只有小规模数量并发用户的简单应用程序上。 POOLED:MyBatis会建立一个数据库链接池,链接池中的一个链接将会被用做数据库操做。一旦数据库操做完成,MyBatis会将此链接返回给链接池。 JNDI(Java Naming and Directory Interface,Java命名和目录接口,是SUN公司提供的一种标准的Java命名系统接口)MyBatis从在应用服务器向配置好的JNDI数据源dataSource获取数据库链接。
MyBatis支持两种类型的事务管理器:JDBC 和 MANAGED.
JDBC事务管理器,是在【jdbc程序】负责管理数据库链接的生命周期(提交、回退等等)的时候。若是将TransactionManager 属性设置成JDBC,MyBatis内部将使用JdbcTransactionFactory类建立TransactionManager。
例如,部署到ApacheTomcat的应用程序,须要应用程序本身管理事务。由于ApacheTomcat不会帮咱们管理事务。
MANAGED 事务管理器,是在【应用服务器】负责管理数据库链接生命周期的时候。若是将TransactionManager属性设置成MANAGED时,MyBatis内部使用ManagedTransactionFactory 类建立事务管理器TransactionManager。
例如,当一个Java EE的应用程序部署在相似JBoss,WebLogic,GlassFish应用服务器上时,它们会使用 EJB 进行应用服务器的事务管理能力。在这些管理环境中,你可使用MANAGED事务管理器。
注:Managed 是托管的意思,即咱们编写的应用程序自己不去管理事务,而是把事务管理交给应用所在的服务器进行管理。
简单记忆:若是设置为JDBC,则须要程序员本身设置事务提交,若是设置为MANAGED,则会将事务提交委托给web容器,web容器会帮咱们事务提交。(不过这要看web容器是否支持,好比,Tomcat不能帮咱们手动提交,因此在使用Tomcat的时候,只能设置为JDBC)
属性配置元素properties能够将配置值写死到mybatis-config.xml中,
也能够具体到一个属性文件中,而且使用属性文件的key名做为占位符。
在上述的配置中,咱们将数据库链接属性配置到了application.properties文件中,
而且为driver,URL等属性使用了占位符.
在applications.properties文件中配置数据库链接参数,以下所示:
jdbc.driverClassName=oracle.jdbc.driver.OracleDriver jdbc.url=jdbc:oracle:thin:@127.0.0.1:1521:XE jdbc.username=briup jdbc.password=briup
在mybatis-config.xml文件中,为属性使用application.properties文件中定义的占位符:
<!-- 读取application.properties文件中的数据key-value的形式 --> <properties resource="application.properties"> <!-- 注意:是applications.properties文件中的值优先级高 --> <property name="jdbc.username" value="briup" /> <property name="jdbc.password" value="briup" /> </properties> <environments default="development"> <environment id="development"> <transactionManager type="JDBC" /> <dataSource type="POOLED"> <property name="driver" value="${jdbc.driverClassName}" /> <property name="url" value="${jdbc.url}" /> <property name="username" value="${jdbc.username}" /> <property name="password" value="${jdbc.password}" /> </dataSource> </environment> </environments>
在SQLMapper配置文件中,对于resultType和parameterType属性值,咱们须要使用JavaBean 的彻底限定名。
例如:
<select id="findStudentById" parameterType="int" resultType="com.briup.pojo.Student"> SELECT STUD_ID AS ID, NAME, EMAIL, DOB FROM STUDENTS WHERE STUD_ID=#{Id} </select> <update id="updateStudent" parameterType="com.briup.pojo.Student"> UPDATE STUDENTS SET NAME=#{name}, EMAIL=#{email}, DOB=#{dob} WHERE STUD_ID=#{id} </update>
注:parameterType表示,未来调用这个sql语句的时候所传的参数的类型,(参数值或者参数对象里面的属性值 用来替换sql语句中的占位符)
resultType表示,未来调用这个sql语句的时候所返回的结果的类型(方便mybatis给咱们自动封装结果集)
这里咱们为resultType和parameterType属性值设置为Student类型的彻底限定名:com.briup.com.Student
咱们能够为彻底限定名取一个别名(alias),而后就能够在须要使用彻底限定名的地方使用别名,而不是处处使用彻底限定名。若是不取别名,会默认按类名去查找
以下例子所示,为彻底限定名起一个别名:
<typeAliases> <typeAlias alias="Student" type="com.briup.pojo.Student" /> <typeAlias alias="Teacher" type="com.briup.pojo.Teacher" /> </typeAliases>
而后在SQLMapper映射文件中,,以下使用Student的别名:
<select id="findStudentById" parameterType="int" resultType="Student"> SELECT STUD_ID AS ID, NAME, EMAIL, DOB FROM STUDENTS WHERE STUD_ID=#{id} </select> <update id="updateStudent" parameterType="Student"> UPDATE STUDENTS SET NAME=#{name}, EMAIL=#{email}, DOB=#{dob} WHERE STUD_ID=#{id} </update>
咱们还能够不用为每个JavaBean单独定义别名,能够为配置出须要取别名的类的所在的包(package),MyBatis会自动扫描包内定义的类,而后分别为每一个类注册一个小写字母开头的简单类名形式的别名。
以下所示:
<typeAliases> <package name="com.briup.pojo" /> </typeAliases>
若是Student.java和 Teacher.java 定义在com.briup.pojo包中,
则 com.briup.pojo.Student的别名会被注册为student,而com.briup.pojo.Teacher别名将会被注册为teacher。
还有另一种方式为JavaBeans起别名,使用注解 @Alias,
@Alias("stu") public class Student{ .... }
@Alias注解将会覆盖配置文件中的<typeAliases>定义。
当MyBatis将一个Java对象做为输入参数执行INSERT语句操做时,它会建立一个PreparedStatement对象,而且使用setXXX()方法对占位符设置相应的参数值 。这里,XXX能够是Int,String,Date 等 Java对象属性类型的任意一个。
示例以下:
<insert id="insertStudent" parameterType="Student"> INSERT INTO STUDENTS(STUD_ID,NAME,EMAIL,DOB) VALUES(#{stud Id},#{name},#{email},#{dob}) </insert>
为执行这个语句,MyBatis将采起如下一系列动做:
1)建立一个有占位符的PreparedStatement接口,以下:
PreparedStatement ps = connection.prepareStatement ("INSERT INTO STUDENTS(STUD_ID,NAME,EMAIL,DOB) VALUES(?,?,?,?)");
2)检查Student对象的属性studId的类型,而后使用合适的setXXX方法去设置参数值。
这里studId是integer类型,因此会使用setInt()方法:
ps.setInt(1,student.getStudId());
相似地,对于name和email属性都是String类型MyBatis使用setString()方法设置参数。
至于dob属性,MyBatis会使用setDate()方法设置dob处占位符位置的值。
MyBaits会将java.util.Date类型转换为java.sql.Timestamp并设值:
ps.setTimestamp(4, new Timestamp((student.getDob()).getTime()));
但MyBatis是怎么知道对于Integer类型属性使用setInt()和String类型属性使用setString()方法呢?
其实MyBatis是经过使用类型处理器typeHandlers来决定这么作的。
MyBatis对于如下的类型使用内建的类型处理器:
全部的 基本数据类型、基本类型的包装类型、 byte[]、java.util.Date、java.sql.Date、java,sql.Time、java.sql.Timestamp、java枚举类型等。
因此当MyBatis发现属性的类型属于上述类型,他会使用对应的类型处理器将值设置到PreparedStatement中,
一样地,当SQL结果集封装成java类对象的时候,也有相似的过程。
那若是有一个自定义的类型,怎么存储存储到数据库呢?
示例以下:
假设表STUDENTS 有一个 PHONE 字段,类型为 VARCHAR2(15),而 Student类有一个自定义类型属性
java代码:PhoneNumber 类定义类型的 phoneNumber 属性。
public class PhoneNumber{ private String countryCode; private String stateCode; private String number; public PhoneNumber(){} public PhoneNumber(String countryCode, String stateCode, String number) { this.countryCode = countryCode; this.stateCode = stateCode; this.number = number; } public PhoneNumber(String str){ if(str!=null){ String[] args = str.split("-"); this.countryCode = args[0]; this.stateCode = args[1]; this.number = args[2]; } } public String getAsString() { return countryCode + "-" + stateCode + "-" + number; } // Setters and getters ... } //Student类中引入PhoneNumber对象 public class Student{ private Integer id; private String name; private String email; private PhoneNumber phone; // Setters and getters ... }
StudentMapper.xml配置:
<insert id="insertStudent" parameterType="Student"> insert into students(name,email,phone) values(#{name},#{email},#{phone}) </insert>
这里,参数对象中的属性phone的值须要传递给#{phone};参数对象的属性phone是 PhoneNumber类型。
此时,MyBatis 并不知道该怎样来处理这个类型的对象。为了让MyBatis明白怎样处理这个自定义的Java对象类型,如PhoneNumber,咱们能够建立一个自定义的类型处理器。
MyBatis提供了抽象类BaseTypeHandler<T> ,咱们能够继承此类建立自定义类型处理器。
代码以下所示:
public class PhoneTypeHandler extends BaseTypeHandler<PhoneNumber>{ //遇到PhoneNumber参数的时候应该如何在ps中设置值 @Override public void setNonNullParameter(PreparedStatement ps, int i, PhoneNumber parameter, JdbcType jdbcType) throws SQLException { ps.setString(i, parameter.getAsString()); } //查询中遇到PhoneNumber类型的应该如何封装(使用列名封装) @Override public PhoneNumber getNullableResult(ResultSet rs, String columnName) throws SQLException { return new PhoneNumber(rs.getString(columnName)); } //查询中遇到PhoneNumber类型的应该如何封装(使用列的下标) @Override public PhoneNumber getNullableResult(ResultSet rs, int columnIndex) throws SQLException { return new PhoneNumber(rs.getString(columnIndex)); } //CallableStatement使用中遇到了PhoneNumber类型的应该如何封装 @Override public PhoneNumber getNullableResult(CallableStatement cs, int columnIndex) throws SQLException { return new PhoneNumber(cs.getString(columnIndex)); } }
注意:使用ps.setString()和rs.getString()方法是由于在数据库的表中,phone列是VARCHAR类型。
最后,一旦咱们实现了自定义的类型处理器,咱们须要在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> <typeHandlers> <typeHandler handler="com.briup.typehandlers.PhoneTypeHandler" /> </typeHandlers> </configuration>
注册PhoneTypeHandler后,MyBatis就可以将Phone类型的对象值存储到VARCHAR类型的列上。
注意:大多数状况下,【这些参数使用它们的默认值便可】
为知足应用特定的需求,MyBatis默认的全局参数设置能够被覆盖掉,以下所示:
<settings> <setting name="cacheEnabled" value="true" /> <setting name="lazyLoadingEnabled" value="true" /> <setting name="multipleResultSetsEnabled" value="true" /> <setting name="useColumnLabel" value="true" /> <setting name="useGeneratedKeys" value="false" /> <setting name="autoMappingBehavior" value="PARTIAL" /> <setting name="defaultExecutorType" value="SIMPLE" /> <setting name="defaultStatementTimeout" value="25000" /> <setting name="safeRowBoundsEnabled" value="false" /> <setting name="mapUnderscoreToCamelCase" value="false" /> <setting name="localCacheScope" value="SESSION" /> <setting name="jdbcTypeForNull" value="OTHER" /> <setting name="lazyLoadTriggerMethods" value="equals,clone,hash Code ,to String"/> <setting name="proxyFactory" value="JAVASSIST" /> <setting name="aggressiveLazyLoading" value="true" /> <setting name="logImpl" value="LOG4J " /> <setting name="logPrefix" value="LOG4J " /> <setting name="callSettersOnNulls" value="false " /> </settings>
<settings> <!-- 这个配置使全局的映射器启用或禁用缓存 --> <setting name="cacheEnabled" value="true" /> <!-- 全局启用或禁用延迟加载。当禁用时,全部关联对象都会即时加载 --> <setting name="lazyLoadingEnabled" value="true" /> <!-- 容许或不容许多种结果集从一个单独的语句中返回(须要适合的驱动) --> <setting name="multipleResultSetsEnabled" value="true" /> <!-- 使用列标签代替列名。不一样的驱动在这方便表现不一样。参考驱动文档或充分测试两种方法来决定所使用的驱动 --> <setting name="useColumnLabel" value="true" /> <!-- 容许JDBC支持生成的键。须要适合的驱动。 --> <setting name="useGeneratedKeys" value="false" /> <!-- 指定MyBatis如何自动映射列到字段/属性。PARTIAL只会自动映射简单、没有嵌套的结果。FULL会自动映射任意复杂的结果(嵌套的或其余状况) --> <setting name="autoMappingBehavior" value="PARTIAL" /> <!-- 配置默认的执行器。SIMPLE执行器没有什么特别之处。REUSE执行器重用预处理语句。BATCH执行器重用语句和批量更新 --> <setting name="defaultExecutorType" value="SIMPLE" /> <!-- 设置超时时间,它决定驱动等待一个数据库响应的时间 --> <setting name="defaultStatementTimeout" value="25000" /> <!-- 容许在嵌套语句中使用分页(RowBounds)默认false --> <setting name="safeRowBoundsEnabled" value="false" /> <!-- 是否开启自动驼峰命名规则(camel case)映射,即从经典数据库列名 A_COLUMN 到经典 Java 属性名 aColumn 的相似映射。默认false --> <setting name="mapUnderscoreToCamelCase" value="false" /> <!-- MyBatis 利用本地缓存机制(Local Cache)防止循环引用(circular references)和加速重复嵌套查询。 默认值为 SESSION,这种状况下会缓存一个会话中执行的全部查询。 若设置值为 STATEMENT,本地会话仅用在语句执行上,对相同 SqlSession 的不一样调用将不会共享数据。 --> <setting name="localCacheScope" value="SESSION" /> <!-- 当没有为参数提供特定的 JDBC 类型时,为空值指定 JDBC 类型。 某些驱动须要指定列的 JDBC 类型,多数状况直接用通常类型便可,好比 NULL、VARCHAR 或 OTHER。 --> <setting name="jdbcTypeForNull" value="OTHER" /> <!-- 指定对象的哪一个方法触发一次延迟加载。 --> <setting name="lazyLoadTriggerMethods" value="equals,clone,hashCode ,toString" /> <!-- CGLIB | JAVASSIST 默认JAVASSIST(MyBatis 3.3 or above) --> <!-- 指定 Mybatis 建立具备延迟加载能力的对象所用到的代理工具。 --> <setting name="proxyFactory" value="JAVASSIST" /> <!-- 当启用时,对任意延迟属性的调用会使带有延迟加载属性的对象完整加载;反之,每种属性将会按需加载。 --> <setting name="aggressiveLazyLoading" value="true" /> <!-- 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 --> <setting name="logImpl" value="LOG4J " /> <!-- 指定 MyBatis 增长到日志名称的前缀。值能够是任意字符串 --> <setting name="logPrefix" value="LOG4J " /> <!-- 指定当结果集中值为 null 的时候是否调用映射对象的 setter(map 对象时为 put)方法,这对于有 Map.keySet() 依赖或 null 值初始化的时候是有用的。注意基本类型(int、boolean等)是不能设置成 null 的。 默认false--> <setting name="callSettersOnNulls" value="false " /> </settings>
SQLMapper文件中主要是对SQL语句的映射,代表这个sql语句对应哪一个方法的调用。
咱们须要在mybatis-config.xml文件中配置SQLMapper文件的位置。
<mappers> <mapper resource="com/briup/mappers/StudentMapper.xml" /> <mapper url="file:///D:/mybatisdemo/app/mappers/StudentMapper.xml" /> <mapper class="com.briup.mappers.StudentMapper" /> <package name="com.briup.mappers" /> </mappers>
以上每个<mapper> 标签均可以从不一样类型的资源中加载映射mapper:
resource属性:用来指定在classpath中的mapper文件。 url属性:用来经过彻底文件系统路径或者web URL地址来指向mapper文件 class属性:用来指向一个mapper接口 package属性:用来指向能够找到Mapper接口的包名
(属于了解的内容,由于有了灵活的xml配置方法,这个方式几乎不用)
MyBatis的SqlSessionFactory接口除了使用基于XML的配置建立外也能够经过JavaAPI编程式地被建立。每一个在XML中配置的元素,均可以编程式的建立。
由于mybatis框架在读取了咱们配置的mybatis-config.xml中配置信息以后,利用这些信息去执行代码建立出咱们须要的SqlSessionFactory,再进一步获得sqlSession,最后再进行各类数据库操做。因此其实咱们彻底能够不去配置任何信息直接把信息写在代码中。 只是这样作再大多数时候都会下降代码的灵活性,因此咱们基本上接触的框架都是有相应的配置文件的.
例如:使用Java API建立SqlSessionFactory对象:
以前是读取配置文件以后再建立,如今是本身把信息写到代码中,而后再建立该对象
public static SqlSessionFactory getSqlSessionFactory() { SqlSessionFactory sqlSessionFactory = null; try { DataSource dataSource = DataSourceFactory.getDataSource(); TransactionFactory transactionFactory = new JdbcTransactionFactory(); Environment environment = new Environment("development", transactionFactory, dataSource); Configuration configuration = new Configuration(environment); configuration.getTypeAliasRegistry().registerAlias("student",Student.class); configuration.getTypeHandlerRegistry().register(PhoneNumber.class, PhoneTypeHandler.class); configuration.addMapper(StudentMapper.class); sqlSessionFactory = new SqlSessionFactoryBuilder().build(configuration); } catch (Exception e) { throw new RuntimeException(e); } return sqlSessionFactory; }
相似的,每一个在XML中配置的元素,均可以编程式的建立.
注:这里就不一一介绍了,由于绝大多数状况下咱们仍是不会把配置信息直接写到代码中的
MyBatis使用其内部LoggerFactory做为真正的日志类库使用的门面。其内部的LaggerFactory会将日志记录任务委托给以下的所示某一个日志实现,
日志记录优先级由上到下顺序递减:
SLF4J Apache Commons Logging Log4j2 Log4j JDK logging
注意:查看org.apache.ibatis.logging.LogFactory源码可知
若是MyBatis未发现上述日志记录实现,则MyBatis的日志记录功能无效,若是你的运行环境中,在classpath中有多个可用的日志类库,而且你但愿MyBaits使用某个特定的日志实现,你能够在代码中经过调用如下其中一个方法:
org.apache.ibatis.logging.LogFactory.useSlf4jLogging(); org.apache.ibatis.logging.LogFactory.useLog4JLogging(); org.apache.ibatis.logging.LogFactory.useLog4J2Logging(); org.apache.ibatis.logging.LogFactory.useJdkLogging(); org.apache.ibatis.logging.LogFactory.useCommonsLogging(); org.apache.ibatis.logging.LogFactory.useStdOutLogging();
注:若是你想自定义MyBatis日志记录,你应该在调用任何其它方法以前调用以上的其中一个方法