mybatis-config.xml配置项结构如下
配置的顺序一定要按照下面的结构从前往后写,不然会报错
configuration(配置)
properties(属性)
settings(设置)
typeAliases(类型别名)
typeHandlers(类型处理器)
objectFactory(对象工厂)
plugins(插件)
environments(环境配置)
environment(环境变量)
transactionManager(事务管理器)
dataSource(数据源)
databaseIdProvider(数据库厂商标识)
mappers(映射器)
1.environment
可以设置多套环境,不过要记住:尽管可以配置多个环境,但每个SqlSessionFactory实例只能选择一种环境
<!--配置多套环境,通过default来设置使用哪个-->
<environments default="test">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
<environment id="test">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</dataSource>
</environment>
</environments>
其中:Mybatis默认的事务管理器(transactionManager)就是JDBC,连接池(dataSource)就是POOLED
2.properties
有三种配置属性(properties)的方法,分别是
- 直接写
<environments default="development"> <environment id="development"> <transactionManager type="JDBC"/> <dataSource type="POOLED"> //直接配置值 <property name="driver" value="com.mysql.jdbc.Driver"/> <property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8"/> <property name="username" value="root"/> <property name="password" value="root"/> </dataSource> </environment> </environments>
- 配置在外部的配置文件中,然后引入使用
db.properties配置文件
driver=com.mysql.jdbc.Driver
url=jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=root
<!--引入外部配置文件-->
<properties resource="db.properties"/>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
- 配置在mybatis-config.xml文件中的properties中
<properties>
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql://localhost:3306/mybatis?useSSL=true&useUnicode=true&characterEncoding=UTF-8"/>
<property name="username" value="root"/>
<property name="password" value="root"/>
</properties>
<environments default="development">
<environment id="development">
<transactionManager type="JDBC"/>
<dataSource type="POOLED">
<property name="driver" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</dataSource>
</environment>
</environments>
3.类型别名(typeAliases)
- 类型别名可为 Java 类型设置一个缩写名字
- 它仅用于 XML 配置,意在降低冗余的全限定类名书写
方式一:使用别名配置
在mybatis-config.xml文件中采用别名:
<!--可以给实体类起别名-->
<typeAliases>
<typeAlias type="com.cbbpp.pojo.User" alias="User"/>
</typeAliases>
UserMapper.xml中可使用别名 :
<!--起别名用 resultType="User"-->
<select id="getUserList" resultType="User">
select * from mybatis.user
</select>
<!--没有起别名 resultType="com.cbbpp.pojo.User"-->
<select id="getUserById" parameterType="int" resultType="com.cbbpp.pojo.User">
select * from mybatis.user where id = #{id}
</select>
方式二:使用包名配置,也可以指定一个包名,MyBatis 会在包名下面搜索需要的 Java Bean
在mybatis-config.xml文件中包扫描设置别名
<!--采用package扫描实体类所在的包,包下所有实体类的默认别名就是这个类的类名的首字母小写-->
<typeAliases>
<package name="com.cbbpp.pojo"/>
</typeAliases>
UserMapper.xml中可使用包下所有实体类的默认别名就是这个类的类名的首字母小写作为别名 (大写也可以,但是建议用首字母小写的别名):
<!--采用实体类com.cbbpp.pojo.User中的user做为别名-->
<select id="getUserList" resultType="user">
select * from mybatis.user
</select>
注:
- 实体类比较少的时候建议使用第一种,第一种可以自定义DIY
- 实体类比较多的时候建议使用第二种,第二种是固定模式的
方式三:使用注解的方式给实体类配置别名(针对于第一种的DIY方式)
在mybatis-config.xml文件中包扫描设置别名
<!--采用package扫描实体类所在的包,包下所有实体类的默认别名就是这个类的类名的首字母小写-->
<typeAliases>
<package name="com.cbbpp.pojo"/>
</typeAliases>
实体类pojo文件:
package com.cbbpp.pojo;
import org.apache.ibatis.type.Alias;
@Alias("hello")
public class User {
private int id;
private String name;
private String pwd;
//getter() and setter()
}
UserMapper.xml文件:
<!--使用注解种的hello做别名-->
<select id="getUserList" resultType="hello">
select * from mybatis.user
</select>
以下还有从官网查到的一些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 |
object | Object |
map | Map |
hashmap | HashMap |
list | List |
arraylist | ArrayList |
collection | Collection |
iterator | Iterator |
4.其他配置
- settings(设置)
- typeAliases(类型别名)
- typeHandlers(类型处理器)
- objectFactory(对象工厂)
- plugins(插件)
5.mappers映射器
MapperRegistry:注册绑定我们的Mapper文件
方式一:
<mappers>
<mapper resource="com/cbbpp/dao/UserMapper.xml"/>
</mappers>
注:所列出的四种,个人只推荐使用第一种
方式二:
<mappers>
<mapper class="com.cbbpp.dao.UserMapper"/>
</mappers>
注意点:
- 接口和他的Mapper配置文件必须同名
- 接口和他的Mapper配置文件必须在同一个包下(不遵守这两点否则会保存)
方式三:
<mappers>
<package name="com.cbbpp.dao"/>
</mappers>
注意点:
- 接口和他的Mapper配置文件必须同名
- 接口和他的Mapper配置文件必须在同一个包下(不遵守这两点否则会保存)
方式四:
<!-- 使用完全限定资源定位符(URL) -->
<mappers>
<mapper url="file:///var/mappers/AuthorMapper.xml"/>
<mapper url="file:///var/mappers/BlogMapper.xml"/>
<mapper url="file:///var/mappers/PostMapper.xml"/>
</mappers>
注:个人建议不要使用