目录
1、核心配置文件
-
mybatis-config.xml
-
MyBatis 的配置文件包含了会深深影响 MyBatis 行为的设置和属性信息。
-
configuration(配置) properties(属性) settings(设置) typeAliases(类型别名) typeHandlers(类型处理器) objectFactory(对象工厂) plugins(插件) environments(环境配置) environment(环境变量) transactionManager(事务管理器) dataSource(数据源) databaseIdProvider(数据库厂商标识) mappers(映射器)
2、环境配置(environments)
Mybatis可以配置成适应多种环境
不过要记住:尽量可以配置多个环境,但是每个sqlsessionFactory实例只能选择一种环境,拥有两套环境,可以通过切换<environments default="development">中environment id值
Mybatis默认的事务管理器就是JDBC
<environments default="development"> <environment id="development"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <!-- 使用正确的驱动类 --> <property name="driver" value="com.mysql.cj.jdbc.Driver"/> <!-- 修正URL格式,移除aws-wrapper前缀 --> <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> <environment id="test"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> <!-- 使用正确的驱动类 --> <property name="driver" value="com.mysql.cj.jdbc.Driver"/> <!-- 修正URL格式,移除aws-wrapper前缀 --> <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC"/> <property name="username" value="root"/> <property name="password" value="123456"/> </dataSource> </environment> </environments>
3、事务管理器
4、数据源
POOLED– 这种数据源的实现利用“池”的概念将 JDBC 连接对象组织起来,避免了创建新的连接实例时所必需的初始化和认证时间。 这种处理方式很流行,能使并发 Web 应用快速响应请求。
UNPOOLED– 这个数据源的实现会每次请求时打开和关闭连接。虽然有点慢,但对那些数据库连接可用性要求不高的简单应用程序来说,是一个很好的选择。 性能表现则依赖于使用的数据库,对某些数据库来说,使用连接池并不重要,这个配置就很适合这种情形。UNPOOLED 类型的数据源仅仅需要配置以下 5 种属性:
-
driver
– 这是 JDBC 驱动的 Java 类全限定名(并不是 JDBC 驱动中可能包含的数据源类)。 -
url
– 这是数据库的 JDBC URL 地址。 -
username
– 登录数据库的用户名。 -
password
– 登录数据库的密码。 -
defaultTransactionIsolationLevel
– 默认的连接事务隔离级别。 -
defaultNetworkTimeout
– 等待数据库操作完成的默认网络超时时间(单位:毫秒)。查看java.sql.Connection#setNetworkTimeout()
的 API 文档以获取更多信息。
JNDI – 这个数据源实现是为了能在如 EJB 或应用服务器这类容器中使用,容器可以集中或在外部配置数据源,然后放置一个 JNDI 上下文的数据源引用。这种数据源配置只需要两个属性:
-
initial_context
– 这个属性用来在 InitialContext 中寻找上下文(即,initialContext.lookup(initial_context))。这是个可选属性,如果忽略,那么将会直接从 InitialContext 中寻找 data_source 属性。 -
data_source
– 这是引用数据源实例位置的上下文路径。提供了 initial_context 配置时会在其返回的上下文中进行查找,没有提供时则直接在 InitialContext 中查找。
5、属性(properties)
我们可以通过properties属性来实现引用配置文件
这些属性可以在外部进行配置,并可以进行动态替换。你既可以在典型的 Java 属性文件中配置这些属性,也可以在 properties 元素的子元素中设置。
编写好的配置文件:【db.properties】
<!-- 方式一:直接在properties文件中配置 -->
driver = com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8&serverTimezone=UTC
username=root
password=123456
在核心配置文件中引入
-
可以直接引入外部文件
-
可以在其中增加一些属性配置
-
如果两个文件有同一个字段,优先使用外部配置文件的
<!-- 引入外部配置文件 -->
<properties resource="db.properties">
<!-- 方式二:可以在环境前的资源配置中配置资源 -->
<property name="username" value="root"/>
<property name="password" value="123456"/>
</properties>
5、类型别名(typeAliases)
-
类型别名可为 Java 类型设置一个缩写名字。
-
它仅用于 XML 配置,意在降低冗余的全限定类名书写。
<!-- 可以给实体类取别名 -->
<typeAliases>
<typeAlias type="com.twit.pojo.User" alias="User"/>
</typeAliases>
<!-- 取别名之前 -->
<select id="getUserById" resultType="com.twit.pojo.User">
select * from user where id=#{id};
</select>
<!-- 取别名之后 -->
<select id="getUserList" resultType="User">
select * from user;
</select>
也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean,比如:
扫描实体类的包,它的默认别名就为这个类的类名,首字母小写
<!-- 可以给实体类取别名,自动扫描类型 -->
<typeAliases>
<package name="com.twit.pojo"/>
</typeAliases>
<!-- 首字母小写,自动识别为别名 -->
<select id="getUserById" resultType="user">
select * from user where id=#{id};
</select>
在实体类比较少的时候使用第一种,实体类比较多的时候使用第二种
第一种可以DIY自定义别名,第二种则不行,若有注解,则别名为其注解值。
@Alias("twit")
public class User {
}
注解类名为“twit”
默认别名:
别名 | 映射的类型 |
---|---|
_byte | byte |
_long | long |
_short | short |
_int | int |
_integer | int |
_double | double |
_float | float |
_boolean | boolean |
string | java.lang.String |
byte | java.lang.Byte |
long | java.lang.Long |
short | java.lang.Short |
int | java.lang.Integer |
integer | java.lang.Integer |
double | java.lang.Double |
float | java.lang.Float |
boolean | java.lang.Boolean |
date | java.util.Date |
decimal | java.math.BigDecimal |
bigdecimal | java.math.BigDecimal |
object | java.lang.Object |
map | java.util.Map |
hashmap | java.util.HashMap |
list | java.util.List |
arraylist | java.util.ArrayList |
collection | java.util.Collection |
iterator | java.util.Iterator |
6、设置(settings)
设置名 | 描述 | 有效值 | 默认值 |
---|---|---|---|
cacheEnabled | 全局性地开启或关闭所有映射器配置文件中已配置的任何缓存。 | true | false | true |
lazyLoadingEnabled | 延迟加载的全局开关。当开启时,所有关联对象都会延迟加载。 特定关联关系中可通过设置 fetchType 属性来覆盖该项的开关状态。 | true | false | false |
useColumnLabel | 使用列标签代替列名。实际表现依赖于数据库驱动,具体可参考数据库驱动的相关文档,或通过对比测试来观察。 | true | false | true |
useGeneratedKeys | 允许 JDBC 支持自动生成主键,需要数据库驱动支持。如果设置为 true,将强制使用自动生成主键。尽管一些数据库驱动不支持此特性,但仍可正常工作(如 Derby)。 | true | false | False |
mapUnderscoreToCamelCase | 是否开启驼峰命名自动映射,即从经典数据库列名 A_COLUMN 映射到经典 Java 属性名 aColumn。 | true | false | False |
logImpl | 指定 MyBatis 所用日志的具体实现,未指定时将自动查找。 | SLF4J | LOG4J | LOG4J2 | JDK_LOGGING | COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING | 未设置 |
其中:
记住:
7、其他配置
-
-
mybatis-generator-core
-
mybatis-plus
-
通用mapper
-
8、映射器(mappers)
官方文档映射器使用三种方法:
<!-- 使用相对于类路径的资源引用 -->
<mappers>
<mapper resource="org/mybatis/builder/AuthorMapper.xml"/>
<mapper resource="org/mybatis/builder/BlogMapper.xml"/>
<mapper resource="org/mybatis/builder/PostMapper.xml"/>
</mappers>
<!-- 使用映射器接口实现类的完全限定类名 -->
<mappers>
<mapper class="org.mybatis.builder.AuthorMapper"/>
<mapper class="org.mybatis.builder.BlogMapper"/>
<mapper class="org.mybatis.builder.PostMapper"/>
</mappers>
<!-- 将包内的映射器接口实现全部注册为映射器 -->
<mappers>
<package name="org.mybatis.builder"/>
</mappers>
实例:
方式一: 使用resource注册【推荐使用】
<!-- 每一个Mapper.xml都需要在Mabatis核心配置文件中注册 -->
<mappers>
<mapper resource="com/twit/Mapper/UserMapper.xml" />
</mappers>
方式二: 使用class文件绑定注册
<!-- 每一个Mapper.xml都需要在Mabatis核心配置文件中注册 -->
<mappers>
<mapper class="com.twit.Mapper.UserMapper"/>
</mappers>
注意点:
-
接口和她的Mapper配置文件必须同名
-
接口和他的Mapper配置文件必须在同一个包下
方式三: 使用扫描包进行注入绑定
<!-- 每一个Mapper.xml都需要在Mabatis核心配置文件中注册 -->
<mappers>
<package name="com.twit.Mapper"/>
</mappers>
注意点:
-
接口和她的Mapper配置文件必须同名
-
接口和他的Mapper配置文件必须在同一个包下
9、作用域(Scope)和生命周期
不同作用域和生命周期类别是至关重要的,因为错误的使用会导致非常严重的并发问题。
SqlSessionFactoryBuilder:
-
一旦创建了 SqlSessionFactory,就不再需要它了。
-
就相当于一个局部变量
SessionFactory:
-
说白了就是可以理解为:数据库连接池
-
SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在,没有任何理由丢弃它或重新创建另一个实例。
-
因此 SqlSessionFactory 的最佳作用域是应用作用域。
-
最简单的就是使用单例模式或者静态单例模式。
SqlSession:
-
连接到连接池的一个请求
-
SqlSession 的实例不是线程安全的,因此是不能被共享的,所以它的最佳的作用域是请求或方法作用域。
-
用完之后需要赶紧关闭,否则会导致资源被占用
理解:
-
SqlSessionFacotryBuilder 造车工厂 造了100台车.然后卖给了租车公司 (SqlSessionFactory).然后直接倒闭.
-
SqlSession 用户 租车,使用车
-
结束 结束 用户(SqlSession)执行完(Mapper)做完想做的事之后,必须归还"汽车"给租车公司(SqlSessionFactory). 也就是需要 SqlSession.close()
这里面的每一个Mapper就代表一个具体的业务