一、Mapper代理的开发方式
1.介绍
Mapper代理使用的是jdk的动态代理
2.Mapper代理的开发规范
1、 mapper接口的全限定名要和mapper映射文件的namespace值一致。
2、 mapper接口的方法名称要和mapper映射文件的statement的id一致。
3、 mapper接口的方法参数类型要和mapper映射文件的statement的parameterType的值一致,而且它的参数是一个。
4、 mapper接口的方法返回值类型要和mapper映射文件的statement的resultType的值一致。
3.案例
(1)MybatisUtils工具类
public class MybatisUtils {
static SqlSession sqlSession;
static SqlSessionFactory sqlSessionFactory ;
static {
try {
sqlSessionFactory = new SqlSessionFactoryBuilder().build(Resources.getResourceAsReader("mybatisConfig.xml"));
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
}
public static SqlSession getSqlSession() {
return sqlSessionFactory.openSession();
}
}
(2)UserMapper接口
public interface UserMapper {
public void save(User u);
public User findById(int id);
public List<User> findAll();
}
(3)UserMapper映射文件
<!-- 基于mapper代理开发
namespace:跟接口对应
id:与接口中的各方法名一致
parameterType :与接口中的参数一致
returnType:与接口中方法的返回值一致
-->
<mapper namespace="com.qf.dao.UserMapper">
<!-- 新增 -->
<insert id="save" parameterType="com.qf.bean.User">
insert into user(username,password) values(#{username},#{password})
</insert>
<!-- 全查 -->
<select id="findAll" resultType="com.qf.bean.User">
select * from user
</select>
<!-- 根据id查 -->
<select id="findById" parameterType="int" resultType="com.qf.bean.User">
select * from user where id=#{id}
</select>
</mapper>
(4)MyBatisConfig配置文件
<configuration>
<environments default="development">
<environment id="development">
<!-- 使用jdbc方式控制事务 -->
<transactionManager type="JDBC"/>
<!-- mybatis提供的连接池链接数据
未来:mybatis+spring+sprignmvc 这一步交给spring
-->
<dataSource type="POOLED">
<property name="driver" value="com.mysql.jdbc.Driver"/>
<property name="url" value="jdbc:mysql:///mystu?unicode=true&characterEncoding=utf-8"/>
<property name="username" value="root"/>
<property name="password" value="111"/>
</dataSource>
</environment>
</environments>
<!-- 指定映射文件 -->
<mappers>
<!-- <mapper resource="com/qf/dao/UserMapper.xml"/> -->
<!-- 指定映射文件所在的包 -->
<package name="com.qf.dao"/>
</mappers>
</configuration>
(5)TestMapper(测试类)
public class TestMapper {
public static void main(String[] args) {
SqlSession sqlSession=MybatisUtils.getSqlSession();
UserMapper userMapper=sqlSession.getMapper(UserMapper.class);
User u=new User();
u.setUsername("赵六");
u.setPassword("112233");
userMapper.save(u);
List<User> list=userMapper.findAll();
for (User user : list) {
System.out.println(user);
}
User user=userMapper.findById(2);
System.out.println(user);
}
}
二、全局配置文件
SqlMapConfig.xml的配置内容和顺序如下(顺序不能乱):dtd约束规定
名称 | 解释 |
---|---|
Properties | (属性)属性配置文件 |
Settings | (全局参数设置) 懒加载 二级缓存 |
typeAliases | (类型别名) |
typeHandlers | (类型处理器) |
objectFactory | (对象工厂) |
plugins | (插件) 分页插件 |
environments | (环境信息集合) |
environment | (单个环境信息) |
transactionManager | (事物) |
dataSource | (数据源) |
mappers | (映射器) |
1.常用配置
(1)Properties
加载的顺序
1、先加载properties中property标签声明的属性
2、 再加载properties标签引入的java配置文件(properties配置文件)中的属性
3、 parameterType的值会和properties的属性值发生冲突。
示例:
<properties resource="dbinfo.properties">
<!-- <property name="driver" value="com.mysql.jdbc.Driver"/> -->
</properties>
(2).settings
Setting(设置) | Description(描述) | Valid Values(验证值组) |
---|---|---|
cacheEnabled | 在全局范围内启用或禁用缓存配置任何映射器在此配置下。 | true | false |
lazyLoadingEnabled | 在全局范围内启用或禁用延迟加载。禁用时,所有协会将热加载 | true | false |
aggressiveLazyLoading | 启用时,有延迟加载属性的对象将被完全加载后调用懒惰的任何属性。否则,每一个属性是按需加载。 | true | false |
multipleResultSetsEnabled | 允许或不允许从一个单独的语句(需要兼容的驱动程序)要返回多个结果集。 | true | false |
useColumnLabel | 使用列标签,而不是列名。在这方面,不同的驱动有不同的行为。参考驱动文档或测试两种方法来决定你的驱动程序的行为如何。 | true | false |
useGeneratedKeys | 允许JDBC支持生成的密钥。兼容的驱动程序是必需的。此设置强制生成的键被使用,如果设置为true,一些驱动会不兼容性,但仍然可以工作。 | true | false |
autoMappingBehavior | 指定MyBatis的应如何自动映射列到字段/属性。NONE自动映射。 PARTIAL只会自动映射结果没有嵌套结果映射定义里面。 FULL会自动映射的结果映射任何复杂的(包含嵌套或其他)。 | NONE, PARTIAL, FULL |
defaultExecutorType | 配置默认执行人。SIMPLE执行人确实没有什么特别的。 REUSE执行器重用准备好的语句。 BATCH执行器重用语句和批处理更新。 | SIMPLE REUSE BATCH |
defaultStatementTimeout | 设置驱动程序等待一个数据库响应的秒数。 | Any positive integer |
safeRowBoundsEnabled | 允许使用嵌套的语句RowBounds。 | true | false |
mapUnderscoreToCamelCase | 从经典的数据库列名A_COLUMN启用自动映射到骆驼标识的经典的Java属性名aColumn。 | true | false |
localCacheScopeMyBatis | 使用本地缓存,以防止循环引用,并加快反复嵌套查询。默认情况下(SESSION)会话期间执行的所有查询缓存。如果localCacheScope=STATMENT本地会话将被用于语句的执行,只是没有将数据共享之间的两个不同的调用相同的SqlSession。 | SESSION | STATEMENT |
dbcTypeForNull | 指定为空值时,没有特定的JDBC类型的参数的JDBC类型。有些驱动需要指定列的JDBC类型,但其他像NULL,VARCHAR或OTHER的工作与通用值。 | JdbcType enumeration. Most common are: NULL, VARCHAR and OTHER |
lazyLoadTriggerMethods | 指定触发延迟加载的对象的方法。 | A method name list separated by commas |
defaultScriptingLanguage | 指定所使用的语言默认为动态SQL生成。 | A type alias or fully qualified class name. |
callSettersOnNulls | 指定如果setter方法或地图的put方法时,将调用检索到的值是null。它是有用的,当你依靠Map.keySet()或null初始化。注意原语(如整型,布尔等)不会被设置为null。 | true | false |
logPrefix | 指定的前缀字串,MyBatis将会增加记录器的名称。 | Any String |
logImpl | 指定MyBatis的日志实现使用。如果此设置是不存在的记录的实施将自动查找。 | SLF4J | LOG4J | LOG4J2 | JDK_LOGGING |COMMONS_LOGGING | STDOUT_LOGGING | NO_LOGGING |
proxyFactory | 指定代理工具,MyBatis将会使用创建懒加载能力的对象。 | CGLIB | JAVASSIS |
(3)typeAliases
- 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 |
- 自定义别名
<typeAliases>
<!-- <typeAlias type="com.qf.domain.Book" alias="book"/> -->
<!-- 批量别名定义(推荐) -->
<!-- package:指定包名称来为该包下的po类声明别名,默认的别名就是类名(首字母大小写都可) -->
<package name="com.qf.domain" />
</typeAliases>
(4)Mappers
<mapper resource=’’/>
使用相对于类路径的资源<mapper class=’’/>
使用mapper接口的全限定名<package name=’’/>
注册指定包下的所有映射文件
三、映射文件
输入映射
parameterType
如果传入对个参数,若参数类型是实体类中的
①:若参数类型是实体类中的,可以传入实体类
②:也可以将参数设置为Map
输出映射
resultType(实体类和数据库的字段一致)
使用resultType进行结果映射时,需要查询出的列名和映射的对象的属性名一致,才能映射成功。
如果查询的列名和对象的属性名全部不一致,那么映射的对象为空。
如果查询的列名和对象的属性名有一个一致,那么映射的对象不为空,但是只有映射正确那一个属性才有值。
如果查询的sql的列名有别名,那么这个别名就是和属性映射的列名。
resultMap(数据库的字段和实体列的字段不一致)
使用resultMap进行结果映射时,不需要查询的列名和映射的属性名必须一致。但是需要声明一个resultMap节点,来对列名和属性名进行映射。
property: 实体类中的字段名
column: 数据库中的字段名
总结:
ResultType
:结果集类型 可以是对象也可以是Map 实体类和数据库表的字段一致
ResultMap
:结果集映射 ,当实体类属性与数据库字段(别名)不一致 需要做结果映射
ParameterType
: 参数类型 可以是对象也可以是Map
ParameterMap
:不用