MyBatis 全局配置文件
注意:后来的数据源和事务管理都是spring来做
标签执行顺序
全局配置文件【mybatis-config.xml】
- 全局配置文件:指导mybatis正确运行的一些全局设置
- SQL 映射文件:MyMapper.xml 相当于是对Mapper接口的一个实现的描述【动态* 通过接口 生成*对象 】
细节:
- 获取的是接口的***对象:mybatis自动创建的
- sqlSessionFactory和sqlSession:
SqlSessionFactory创建SqlSession对象,Factory只new一次就行
SqlSession相当于connection和数据库进行交互的,和数据库的一次会话,就应该创建一个新的sqlsession【成员变量在多线程下会出现问题】
MyBatis 的配置文件包含了影响 MyBatis 行为甚深的设置(settings)和属性(properties)信息。文档的顶层结构如下:
configuration 配置
- properties 属性
- settings 设置
- typeAliases 类型命名
- typeHandlers 类型处理器
- objectFactory 对象工厂
- plugins 插件
- environments 环境
- environment 环境变量
- transactionManager 事务管理器
- dataSource 数据源
- environment 环境变量
- databaseIdProvider 数据库厂商标识
- mappers 映射器
在Eclipse中引入XML的dtd约束文件,方便编写XML的时候有提示
只要eclipse找到了这个文件的dtd约束文件的位置即可
绑定约束文件的位置
properties属性
和spring的context : property-placeholder 引用外部配置文件
<properties resource="db.properties"></properties> <dataSource type="POOLED"> <property name="driver" value="${jdbc.driverClass}"/> <property name="url" value="${jdbc.jdbcUrl}"/> <property name="username" value="${jdbc.user}"/> <property name="password" value="${jdbc.password}"/> </dataSource>
如果属性在不只一个地方进行了配置,那么 MyBatis 将按照下面的顺序来加载:
- 在 properties 元素体内指定的属性首先被读取。
- 然后根据 properties 元素中的 resource 属性读取类路径下属性文件或根据 url 属性指定的磁盘路径/网络路径 读取属性文件,并覆盖已读取的同名属性。
- 最后读取作为方法参数传递的属性,并覆盖已读取的同名属性。
- 【其他特征详细看 官网】
settings设置 ♥
- 这是 MyBatis 中极为重要的调整设置,它们会改变 MyBatis 的运行时行为
能处理的情况为数据库字段login_account [满足驼峰命名]=> loginAccount javabean字段 就能自动映射上了 <settings> <setting name="mapUnderscoreToCamelCase" value="true"/> </settings>
typeAliases别名处理器
为常用类型(javabean)起别名;别名默认就是类名(不区分大小写),配置文件中就可以起别名了
- 类型别名是为 Java 类型设置一个短的名字,可以方便我们引用某个类。
- 类很多的情况下,可以批量设置别名这个包下的每一个类创建一个默认的别名,就是简单类名小写
- 也可以使用@Alias注解为其指定一个别名
<typeAliases> <typeAlias type="com.project.bean.Book" /> </typeAliases> <select id="getBookAll" resultType="Book"> select * from book </select> //能正常运行 也可以起自定义别名 <typeAliases> <typeAlias type="com.project.bean.Book" alias="mybook"/> </typeAliases> 可以批量处理别名 默认是类名 <typeAliases> <package name="com.project.bean"/> </typeAliases> 可以用注解起类名 @Alias("book") public class Book { } 推荐是用全类名 不用别名这些 容易引起误会
值得注意的是,MyBatis已经为许多常见的 Java 类型内建了相应的类型别名。它们都是大小写不敏感的,我们在起别名的时候千万不要占用已有的别名
typeHandlers类型处理器
原生jdbc【设置参数】
- 无论是 MyBatis 在预处理语句(PreparedStatement)中设置一个参数时,还是从结果集中取出一个值时, 都会用类型处理器将获取的值以合适的方式转换成 Java 类型。
- 自定义类型的处理器配置
你可以重写类型处理器或创建你自己的类型处理器来处理不支持的或非标准的类型。 具体做法为:实现 org.apache.ibatis.type.TypeHandler 接口, 或继承一个很便利的类 org.apache.ibatis.type.BaseTypeHandler, 然后可以选择性地将它映射到一个 JDBC 类型。<typeHandlers> <!-- 自定义好的类型处理器就这么配置上就行了 --> <typeHandler handler=""/> </typeHandlers>
日期类型的处理
- 日期和时间的处理,JDK1.8以前一直是个头疼的问题。我们通常使用JSR310规范领导者Stephen Colebourne创建的Joda-Time来操作。1.8已经实现全部的JSR310规范了。
- 日期时间处理上,我们可以使用MyBatis基于JSR310(Date and Time API)编写的各种日期时间类型处理器。
- MyBatis3.4以前的版本需要我们手动注册这些处理器,以后的版本都是自动注册的
自定义类型处理器
我们可以重写类型处理器或创建自己的类型处理器来处理不支持的或非标准的类型。
步骤:- 实现org.apache.ibatis.type.TypeHandler接口或者继承org.apache.ibatis.type.BaseTypeHandler
- 指定其映射某个JDBC类型(可选操作)
- 在mybatis全局配置文件中注册
对象工厂(objectFactory)
MyBatis 每次创建结果对象的新实例时,它都会使用一个对象工厂(ObjectFactory)实例来完成。 默认的对象工厂需要做的仅仅是实例化目标类,要么通过默认构造方法,要么在参数映射存在的时候通过参数构造方法来实例化。 如果想覆盖对象工厂的默认行为,则可以通过创建自己的对象工厂来实现。
接口-> 封装成对象 【反射】
plugins插件 强大【需要了解mybatis机制】
插件是MyBatis提供的一个非常强大的机制,我们可以通过插件来修改MyBatis的一些核心行为。插件通过动态***机制,可以介入四大对象的任何一个方法的执行。后面会有专门的章节我们来介绍mybatis运行原理以及插件
Executor (update, query, flushStatements, commit, rollback, getTransaction, close, isClosed)
ParameterHandler (getParameterObject, setParameters)
ResultSetHandler (handleResultSets, handleOutputParameters)
StatementHandler (prepare, parameterize, batch, update, query)
environments环境
MyBatis可以配置多种环境,比如开发、测试和生产环境需要有不同的配置。
不过要记住:尽管可以配置多个环境,但每个 SqlSessionFactory 实例只能选择一种环境。所以,如果你想连接两个数据库,就需要创建两个 SqlSessionFactory 实例,每个数据库对应一个。
每种环境使用一个environment标签进行配置并指定唯一标识符
可以通过environments标签中的default属性指定一个环境的标识符来快速的切换环境
注意这里的关键点:
- 默认使用的环境 ID(比如:default="development")。
- 每个 environment 元素定义的环境 ID(比如:id="development")。
- 事务管理器的配置(比如:type="JDBC")。
- 数据源的配置(比如:type="POOLED")。
默认的环境和环境 ID 是自解释的,因此一目了然。 你可以对环境随意命名,但一定要保证默认的环境 ID 要匹配其中一个环境 ID。
environment-指定具体环境
- id:指定当前环境的唯一标识
- transactionManager、和dataSource都必须有
transactionManager
type: JDBC | MANAGED | 自定义
- JDBC:使用了 JDBC 的提交和回滚设置,依赖于从数据源得到的连接来管理事务范围。 JdbcTransactionFactory
- MANAGED:不提交或回滚一个连接、让容器来管理事务的整个生命周期(比如 JEE 应用服务器的上下文)。ManagedTransactionFactory
- 自定义:实现TransactionFactory接口,type=全类名/别名
提示如果你正在使用 Spring + MyBatis,则没有必要配置事务管理器, 因为 Spring 模块会使用自带的管理器来覆盖前面的配置。
dataSource
type: UNPOOLED | POOLED | JNDI | 自定义
- UNPOOLED:不使用连接池, UnpooledDataSourceFactory,这个数据源的实现只是每次被请求时打开和关闭连接。虽然有点慢,但对于在数据库连接可用性方面没有太高要求的简单应用程序来说,是一个很好的选择
- POOLED:使用连接池, PooledDataSourceFactory ,POOLED– 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来,避免了创建新的连接实例时所必需的初始化和认证时间。 这是一种使得并发 Web 应用快速响应请求的流行处理方式。
JNDI: 在EJB 或应用服务器这类容器中查找指定的数据源【自定义可以用c3p0】
自定义:实现DataSourceFactory接口,定义数据源的获取方式。
实际开发中我们使用Spring管理数据源,并进行事务控制的配置来覆盖上述配置
databaseIdProvider环境
是mybatis 用来考虑数据库移植的
MyBatis 可以根据不同的数据库厂商执行不同的语句。
Type: DB_VENDOR
使用MyBatis提供的VendorDatabaseIdProvider解析数据库厂商标识。也可以实现DatabaseIdProvider接口来自定义。Property-name:数据库厂商标识
Property-value:为标识起一个别名,方便SQL语句使用databaseId属性引用
DB_VENDOR
会通过 DatabaseMetaData#getDatabaseProductName() 返回的字符串进行设置。由于通常情况下这个字符串都非常长而且相同产品的不同版本会返回不同的值,所以最好通过设置属性别名来使其变短MyBatis匹配规则如下:
- 如果没有配置databaseIdProvider标签,那么databaseId=null
- 如果配置了databaseIdProvider标签,使用标签配置的name去匹配数据库信息,匹配上设置databaseId=配置指定的值,否则依旧为null
- 如果databaseId不为null,他只会找到配置databaseId的sql语句
- MyBatis 会加载不带 databaseId 属性和带有匹配当前数据库databaseId 属性的所有语句。如果同时找到带有 databaseId 和不带databaseId 的相同语句,则后者会被舍弃。
<databaseIdProvider type="DB_VENDOR "> <property name="MySQL" value="mysql"/> <property name="SQl Server" value="sqlserver"/> <property name="Oracle" value="orcl"/> </databaseIdProvider> ---------------------- <select id="getBookAll" resultType="Book" databaseId="mysql"> select * from book </select> <select id="getBookAll" resultType="Book" databaseId="sqlserver"> select * from book </select> <select id="getBookAll" resultType="Book" databaseId="orcl"> select * from book </select>
mapper映射
- mapper逐个注册SQL映射文件
- 或者使用批量注册:
这种方式要求SQL映射文件名必须和接口名相同并且在同一目录下
既然 MyBatis 的行为已经由上述元素配置完了,我们现在就要定义 SQL 映射语句了。 但是首先我们需要告诉 MyBatis 到哪里去找到这些语句。 Java 在自动查找这方面没有提供一个很好的方法,所以最佳的方式是告诉 MyBatis 到哪里去找映射文件。 你可以使用相对于类路径的资源引用, 或完全限定资源定位符(包括 file:/// 的 URL),或类名和包名等。
这些配置会告诉了 MyBatis 去哪里找映射文件,剩下的细节就应该是每个 SQL 映射文件了
mapper配置信息 class【配合使用 因为是标志在类上 修改需要重新启动项目 没有动态sql】
mybatis配置文件
<mappers> <mapper class="com.project.mapper.MyMapperAnnotation"/> </mappers>
注解配置的代码
public interface MyMapperAnnotation { @Select("select * from book where isbn = #{isbn}") public Book getBookByIsbn(String isbn); @Select("select * from book") public List<Book> getBookAll(); @Update("update book set book_name = #{book_name} , price = #{price} where isbn = #{isbn}") public int updateBook(Book book); @Delete("delete from book where isbn = #{isbn}") public boolean deleteBookByIsbn(String isbn); @Insert("insert into book(book_name,price,isbn) values(#{book_name},#{price},#{isbn})") public int insertBook(Book book); }
mapper配置信息 package
- 编码配置
<mappers> <package name="com.project.mapper"/> </mappers>