Mybatis从入门到进阶

1、简介

1.1 什么是Mybatis

• MyBatis 是一款优秀的持久层框架;
• 它支持自定义 SQL、存储过程以及高级映射。MyBatis 免除了几乎所有的 JDBC 代码以及设置参数和获取结果集的工作。MyBatis 可以通过简单的 XML 或注解来配置和映射原始类型、接口和 Java POJO（Plain Old Java Objects，普通老式 Java 对象）为数据库中的记录。

1.2 持久化

数据持久化

• 持久化就是将程序的数据在持久状态和瞬时状态转化的过程
• 内存：断电即失
• 数据库（Jdbc）,io文件持久化。

为什么要持久化？

• 有一些对象，不能让他丢掉
• 内存太贵

1.3 持久层

Dao层、Service层、Controller层

• 完成持久化工作的代码块
• 层界限十分明显

1.4 为什么需要MyBatis

• 帮助程序员将数据存入到数据库中
• 方便
• 传统的JDBC代码太复杂了，简化，框架，自动化
• 不用MyBatis也可以，技术没有高低之分
• 优点：
  • 简单易学
  • 灵活
  • sql和代码的分离，提高了可维护性。
  • 提供映射标签，支持对象与数据库的orm字段关系映射
  • 提供对象关系映射标签，支持对象关系组建维护
  • 提供xml标签，支持编写动态sql

2、第一个Mybatis程序

思路：搭建环境 --> 导入MyBatis --> 编写代码 --> 测试

2.1 搭建环境

新建项目

1. 创建一个普通的maven项目

2. 删除src目录 （就可以把此工程当做父工程了，然后创建子工程）

3. 导入maven依赖

   	<dependencies>
           <dependency>
               <groupId>org.mybatisgroupId>
               <artifactId>mybatisartifactId>
               <version>3.4.6version>
           dependency>
           <dependency>
               <groupId>mysqlgroupId>
               <artifactId>mysql-connector-javaartifactId>
               <version>5.1.42version>
           dependency>
           <dependency>
               <groupId>junitgroupId>
               <artifactId>junitartifactId>
               <version>4.11version>
               <scope>testscope>
           dependency>
       dependencies>
   
       
       <build>
           <resources>
               <resource>
                   <directory>src/main/resourcesdirectory>
                   <includes>
                       <include>**/*.propertiesinclude>
                       <include>**/*.xmlinclude>
                   includes>
                   <filtering>truefiltering>
               resource>
               <resource>
                   <directory>src/main/javadirectory>
                   <includes>
                       <include>**/*.propertiesinclude>
                       <include>**/*.xmlinclude>
                   includes>
                   <filtering>truefiltering>
               resource>
           resources>
       build>
   

4. 创建一个Module

2.2 创建一个模块

• 编写mybatis的核心配置文件

  
  
  <configuration>
      <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?userSSL=true&useUnicode=true&characterEncoding=UTF-8"/>
                  <property name="username" value="root"/>
                  <property name="password" value="root"/>
              dataSource>
          environment>
      environments>
      <mappers>
          <mapper resource="com/jay/dao/UserMapper.xml"/>
      mappers>
  configuration>
  

• 编写mybatis工具类

  package com.jay.util;
  
  import org.apache.ibatis.io.Resources;
  import org.apache.ibatis.session.SqlSession;
  import org.apache.ibatis.session.SqlSessionFactory;
  import org.apache.ibatis.session.SqlSessionFactoryBuilder;
  
  import java.io.IOException;
  import java.io.InputStream;
  
  /**
   * @description:
   * @author: jay
   * @create: 2021-03-16 00:28
   **/
  public class MybatisUtils {
  
      static SqlSessionFactory sqlSessionFactory = null;
  
      static {
          try {
              //使用Mybatis第一步 ：获取sqlSessionFactory对象
              String resource = "mybatis-config.xml";
              InputStream inputStream = Resources.getResourceAsStream(resource);
              sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
          } catch (IOException e) {
              e.printStackTrace();
          }
      }
  
      //既然有了 SqlSessionFactory，顾名思义，我们可以从中获得 SqlSession 的实例.
      // SqlSession 提供了在数据库执行 SQL 命令所需的所有方法。
      public static SqlSession getSqlSession() {
          return sqlSessionFactory.openSession();
      }
  }
  

2.3 编写代码

• 实体类

• Dao接口

• 接口实现类 （由原来的UserDaoImpl转变为一个Mapper配置文件）

• 测试

  @Test
  public void getUserList() {
      SqlSession sqlSession = MybatisUtils.getSqlSession();
      UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
      List<User> userList = userMapper.getUserList();
      for (User user : userList) {
          System.out.println(user);
      }
      sqlSession.close();
  }
  

3、CURD

1. namespace

​ namespace中的包名要和Dao/Mapper接口的包名一致

2. select

​ 选择，查询语句；

​ id：就是对应的namespace中的方法名；

​ resultType : Sql语句执行的返回值；

​ parameterType : 参数类型；

3. Insert

4. update

5. Delete

6. 万能Map

​ 假设，我们的实体类，或者数据库中的表，字段或者参数过多，我们应该考虑使用Map!

7. 模糊查询

​ 通配符% %

4、配置解析

1. 核心配置文件

mybatis-config.xml

configuration（配置）

• properties（属性）
• settings（设置）
• typeAliases（类型别名）
• typeHandlers（类型处理器）
• objectFactory（对象工厂）
• plugins（插件）
• environments（环境配置）
  • environment（环境变量）
    • transactionManager（事务管理器）
    • dataSource（数据源）
• databaseIdProvider（数据库厂商标识）
• mappers（映射器）

2. 环境配置 environments

​ MyBatis默认的事务管理器就是JDBC ，连接池：POOLED

3. 属性 properties

​ db.properties

driver=com.mysql.jdbc.Driver
# &serverTimezone=UTC # 新版需要
url=jdbc:mysql://localhost:3306/mybatis?userSSL=true&useUnicode=true&characterEncoding=UTF-8
username=root
password=root

<properties resource="db.properties">
    <property name="username" value="root"/>
    <property name="password" value="xxxx"/>
properties>

外部资源属性>内部资源属性

4. 类型别名 typeAliases

指定类

指定包 取别名

<typeAliases>
	
    <package name="com.jay.pojo"/>
typeAliases>

@Alias("xxx") // 需要配合 
public class User {
    
}

5. 设置 Settings

这是 MyBatis 中极为重要的调整设置，它们会改变 MyBatis 的运行时行为。

6. 其他配置

• typeHandlers（类型处理器）
• objectFactory（对象工厂）
• plugins 插件
  • mybatis-generator-core
  • mybatis-plus
  • 通用mapper

7. 映射器 mappers

MapperRegistry：注册绑定我们的Mapper文件；

<mappers>
    <mapper resource="com/jay/mapper/UserMapper.xml"/>
mappers>


<mappers>
    <mapper class="com.jay.mapper.UserMapper"/>
mappers>



<mappers>
    <package name="com.jay.mapper"/>
mappers>

8. 作用域和生命周期

声明周期和作用域是至关重要的，因为错误的使用会导致非常严重的并发问题。

mybatis-config.xml --> SqlSessionFactoryBuilder --> SqlSessionFactory --> SqlSession --> mapper

SqlSessionFactoryBuilder

​ 这个类可以被实例化、使用和丢弃，一旦创建了 SqlSessionFactory，就不再需要它了。

​ 因此 SqlSessionFactoryBuilder 实例的最佳作用域是方法作用域（也就是局部方法变量）。

SqlSessionFactory

​ SqlSessionFactory 一旦被创建就应该在应用的运行期间一直存在，没有任何理由丢弃它或重新创建另一个实例。

​ 使用 SqlSessionFactory 的最佳实践是在应用运行期间不要重复创建多次，多次重建 SqlSessionFactory 被视为一种代码“坏习惯”。

​ 因此 SqlSessionFactory 的最佳作用域是应用作用域。

​ 有很多方法可以做到，最简单的就是使用单例模式或者静态单例模式。

SqlSession

​ 每个线程都应该有它自己的 SqlSession 实例。

​ SqlSession 的实例不是线程安全的，因此是不能被共享的，所以它的最佳的作用域是请求或方法作用域。

​ 绝对不能将 SqlSession 实例的引用放在一个类的静态域，甚至一个类的实例变量也不行。

​ 也绝不能将 SqlSession 实例的引用放在任何类型的托管作用域中，比如 Servlet 框架中的 HttpSession。

​ 如果你现在正在使用一种 Web 框架，考虑将 SqlSession 放在一个和 HTTP 请求相似的作用域中。

​ 换句话说，每次收到 HTTP 请求，就可以打开一个 SqlSession，返回一个响应后，就关闭它。

​ 这个关闭操作很重要，为了确保每次都能执行关闭操作，你应该把这个关闭操作放到 finally 块中。

5、解决属性名和字段名不一致的问题

• 起别名

<select id="getUserById" resultType="com.kuang.pojo.User">
    select id,name,pwd as password from USER where id = #{id}
select>

<resultMap id="UserMap" type="User">
    
    <result column="id" property="id">result>
    <result column="name" property="name">result>
    <result column="pwd" property="password">result>
resultMap>

<select id="getUserList" resultMap="UserMap">
    select * from USER
select>

• resultMap 元素是 MyBatis 中最重要最强大的元素。

• ResultMap 的设计思想是，对简单的语句做到零配置，对于复杂一点的语句，只需要描述语句之间的关系就行了。

• ResultMap 的优秀之处——你完全可以不用显式地配置它们。

• 如果这个世界总是这么简单就好了。

6、日志

6.1 日志工厂

如果一个数据库操作，出现了异常，我们需要排错，日志就是最好的助手！

曾经：sout、debug

现在：日志工厂

• SLF4J
• LOG4J 【掌握】
• LOG4J2
• JDK_LOGGING
• COMMONS_LOGGING
• STDOUT_LOGGING 【掌握】
• NO_LOGGING

在MyBatis中具体使用哪一个日志实现，在设置中设定

STDOUT_LOGGING

<settings>
    <setting name="logImpl" value="STDOUT_LOGGING"/>
settings>

6.2 Log4j

• Log4j是Apache的一个开源项目，通过使用Log4j，我们可以控制日志信息输送的目的地是控制台、文件、GUI组件；

• 我们也可以控制每一条日志的输出格式；

• 通过定义每一条日志信息的级别，我们能够更加细致地控制日志的生成过程；

• 最令人感兴趣的就是，这些可以通过一个配置文件来灵活地进行配置，而不需要修改应用的代码。

1. 先导入log4j的包

   <dependency>
       <groupId>log4jgroupId>
       <artifactId>log4jartifactId>
       <version>1.2.17version>
   dependency>
   
   

2. log4j.properties

   #将等级为DEBUG的日志信息输出到console和file这两个目的地，console和file的定义在下面的代码
   log4j.rootLogger=DEBUG,console,file
   
   #控制台输出的相关设置
   log4j.appender.console = org.apache.log4j.ConsoleAppender
   log4j.appender.console.Target = System.out
   log4j.appender.console.Threshold=DEBUG
   log4j.appender.console.layout = org.apache.log4j.PatternLayout
   log4j.appender.console.layout.ConversionPattern=[%c]-%m%n
   #文件输出的相关设置
   log4j.appender.file = org.apache.log4j.RollingFileAppender
   log4j.appender.file.File=./log/rzp.log
   log4j.appender.file.MaxFileSize=10mb
   log4j.appender.file.Threshold=DEBUG
   log4j.appender.file.layout=org.apache.log4j.PatternLayout
   log4j.appender.file.layout.ConversionPattern=[%p][%d{yy-MM-dd}][%c]%m%n
   #日志输出级别
   log4j.logger.org.mybatis=DEBUG
   log4j.logger.java.sql=DEBUG
   log4j.logger.java.sql.Statement=DEBUG
   log4j.logger.java.sql.ResultSet=DEBUG
   log4j.logger.java.sq1.PreparedStatement=DEBUG
   
   

3. 配置settings为log4j实现

4. 测试运行

Log4j简单使用

1. 在要使用Log4j的类中，导入包 import org.apache.log4j.Logger;

2. 日志对象，参数为当前类的class对象

   Logger logger = Logger.getLogger(UserMapperTest.class);
   

3. 日志级别

   logger.info("info: 测试log4j");
   logger.debug("debug: 测试log4j");
   logger.error("error:测试log4j");
   

   1. info
   2. debug
   3. error

7、分页

思考：为什么分页？

• 减少数据的处理量

7.1 使用Limit分页

SELECT * from user limit startIndex,pageSize 

使用MyBatis实现分页，核心SQL

1. 接口

   List<User> selectUsersByLimit(Map map);
   

2. Mapper.xml

   <select id="selectUsersByLimit" resultMap="BaseResultMap">
       select
       <include refid="Base_Column_List"/>
       from user
       limit #{startIndex},#{pageSize}
   select>
   

3. 测试

   private SqlSessionFactory sqlSessionFactory;
   
   @Before
   public void before() throws IOException {
       String resource = "mybatis-config.xml";
       InputStream inputStream = Resources.getResourceAsStream(resource);
       sqlSessionFactory = new SqlSessionFactoryBuilder().build(inputStream);
   }
   
   @Test
   public void selectUsersByLimit() {
       SqlSession sqlSession = sqlSessionFactory.openSession();
       UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
       Map map = new HashMap<>();
       map.put("startIndex",1);
       map.put("pageSize",2);
       List<User> users = userMapper.selectUsersByLimit(map);
       for (User user : users) {
           System.out.println(user);
       }
       sqlSession.close();
   }
   

7.2 RowBounds分页

不再使用SQL实现分页

1. 接口

   List<User> getUserByRowBounds();
   

2. mapper.xml

   <select id="getUserByRowBounds" resultMap="BaseResultMap">
       select
       <include refid="Base_Column_List"/>
       from user
   select>
   

3. 测试

   @Test
   public void getUserByRowBounds() {
       SqlSession sqlSession = sqlSessionFactory.openSession();
       RowBounds rowBounds = new RowBounds(1, 2);
       List<User> users = sqlSession.selectList("com.jay.mapper.UserMapper.getUserByRowBounds", null, rowBounds);
       for (User user : users) {
           System.out.println(user);
       }
       sqlSession.close();
   }
   

7.3 分页插件

Mybatis PageHepler

1. 引包

   <dependency>
       <groupId>com.github.pagehelpergroupId>
       <artifactId>pagehelperartifactId>
       <version>5.2.0version>
   dependency>
   

2. 接口

   List<User> getUserByPageHelper();
   

3. xml

   <select id="getUserByPageHelper" resultMap="BaseResultMap">
       select
       <include refid="Base_Column_List"/>
       from user
   select>
   

4. 测试

    @Test
   public void getUserByPageHelper() {
       SqlSession sqlSession = sqlSessionFactory.openSession();
       UserMapper userMapper = sqlSession.getMapper(UserMapper.class);
       Page page = PageHelper.startPage(2,1);
       // Page page = PageHelper.offsetPage(1, 1);
       List<User> users = userMapper.getUserByPageHelper();
       logger.info("total ==> " + page.getTotal());
       for (User user : users) {
           System.out.println(user);
       }
       sqlSession.close();
   }
   

8、使用注解开发

8.1 面向接口开发

​ 三个面向区别

• 面向对象是指，我们考虑问题时，以对象为单位，考虑它的属性和方法；
• 面向过程是指，我们考虑问题时，以一个具体的流程（事务过程）为单位，考虑它的实现；
• 接口设计与非接口设计是针对复用技术而言的，与面向对象（过程）不是一个问题，更多的体现就是对系统整体的架构；

8.2 使用注解开发

• 注解在接口上实现

  @Select("select * from user")
  List<User> getUsers();
  
  

• 需要在核心配置文件中绑定接口

  <mappers>
      <mapper class="com.kuang.dao.UserMapper"/>
  mappers>
  

本质：反射机制实现

底层：动态代理

8.3 注解CURD

//方法存在多个参数，所有的参数前面必须加上@Param("id")注解
@Delete("delete from user where id = ${uid}")
int deleteUser(@Param("uid") int id);

关于@Param( )注解

• 基本类型的参数或者String类型，需要加上
• 引用类型不需要加
• 如果只有一个基本类型的话，可以忽略，但是建议大家都加上
• 我们在SQL中引用的就是我们这里的@Param()中设定的属性名

#{} 和 ${}

9、Lombok

• 在IDEA中安装Lombok插件
• 在项目中导入lombok的jar包

<dependency>
    <groupId>org.projectlombokgroupId>
    <artifactId>lombokartifactId>
    <version>1.18.10version>
    <scope>providedscope>
dependency>

• 在程序上加注解

@Getter and @Setter
@FieldNameConstants
@ToString
@EqualsAndHashCode
@AllArgsConstructor, @RequiredArgsConstructor and @NoArgsConstructor
@Log, @Log4j, @Log4j2, @Slf4j, @XSlf4j, @CommonsLog, @JBossLog, @Flogger, @CustomLog
@Data
@Builder
@SuperBuilder
@Singular
@Delegate
@Value
@Accessors
@Wither
@With
@SneakyThrows
@val

@Data
@AllArgsConstructor
@NoArgsConstructor
public class User {
    private int id;
    private String name;
    private String password;
}

10、一对一处理

1. 测试环境搭建

1. 导入lombok
2. 新建实体类Teacher,Student
3. 建立Mapper接口
4. 建立Mapper.xml文件
5. 在核心配置文件中绑定注册我们的Mapper接口或者文件 【方式很多，随心选】
6. 测试查询是否能够成功

实体类

@Data
public class Teacher implements Serializable {
    private static final long serialVersionUID = 1L;

    private Integer id;
    private String name;
    private Integer age;
    List<Student> students;
}

@Data
public class Student implements Serializable {
    private static final long serialVersionUID = 1L;

    private Integer id;
    private String name;
    private Integer age;
    private Integer tId;
    private Teacher teacher;
}

StudentDao

List<Student> selectAll();
List<Student> selectAllByTid(Integer tId);

StudentDao.xml

	<resultMap id="StudentTeacher" extends="BaseResultMap" type="student">
        <association property="teacher" fetchType="lazy" column="t_id" javaType="teacher"
                     select="com.jay.dao.TeacherDao.selectByPrimaryKey"/>
    resultMap>
    <select id="selectAll" resultMap="StudentTeacher">
        select
        <include refid="Base_Column_List"/>
        from student
    select>

    <select id="selectAllByTid" resultMap="BaseResultMap">
        select
        <include refid="Base_Column_List"/>
        from student
        where t_id = #{tId}
    select>

11、一对多处理

TeacherDao

List<Teacher> selectAll();

TeacherDao.xml

	<resultMap id="TeacherStudent" extends="BaseResultMap" type="teacher">
        <collection property="students" fetchType="lazy" column="id" ofType="student" javaType="arrayList"
                    select="com.jay.dao.StudentDao.selectAllByTid">
        collection>
    resultMap>
    <select id="selectAll" resultMap="TeacherStudent">
        select
        <include refid="Base_Column_List"/>
        from teacher
    select>

小结

1. 关联 - association 【一对一】
2. 集合 - collection 【一对多】
3. javaType & ofType
   1. JavaType用来指定实体类中的类型
   2. ofType用来指定映射到List或者集合中的pojo类型，泛型中的约束类型

注意点：

• 保证SQL的可读性，尽量保证通俗易懂
• 注意一对多和多对一，属性名和字段的问题
• 如果问题不好排查错误，可以使用日志，建议使用Log4j

12、动态SQL

创建一个基础工程

1. 导包

2. 编写配置文件

3. 编写实体类

   @Data
   public class Blog implements Serializable {
       private static final long serialVersionUID = 1L;
       
       private Integer id;
       private String title;
       private String author;
       private Date createTime;
       private Integer views;
   }
   

4. 编写实体类对应Mapper接口和Mapper.xml文件

IF

choose (when, otherwise)

trim、where、set

SQL片段

注意事项：

• 最好基于单标来定义SQL片段
• 不要存在where标签

foreach

  SELECT *
  FROM POST P
  WHERE ID in
  
        #{item}
  

bind

元素允许你在 OGNL 表达式以外创建一个变量，并将其绑定到当前的上下文。比如：

<select id="selectBlogsLike" resultType="Blog">
  <bind name="pattern" value="'%' + _parameter.getTitle() + '%'" />
  SELECT * FROM BLOG
  WHERE title LIKE #{pattern}
select>

动态SQL就是在拼接SQL语句，我们只要保证SQL的正确性，按照SQL的格式，去排列组合就可以了

建议：

• 先在Mysql中写出完整的SQL，再对应的去修改成我们的动态SQL实现通用即可

13、缓存

13.1 简介

查询 ： 连接数据库，耗资源

一次查询的结果，给他暂存一个可以直接取到的地方 --> 内存：缓存

我们再次查询的相同数据的时候，直接走缓存，不走数据库了

1. 什么是缓存[Cache]？
   1. 存在内存中的临时数据
   2. 将用户经常查询的数据放在缓存（内存）中，用户去查询数据就不用从磁盘上（关系型数据库文件）查询，从缓存中查询，从而提高查询效率，解决了高并发系统的性能问题
2. 为什么使用缓存？
   1. 减少和数据库的交互次数，减少系统开销，提高系统效率
3. 什么样的数据可以使用缓存？
   1. 经常查询并且不经常改变的数据 【可以使用缓存】

13.2 MyBatis缓存

• MyBatis包含一个非常强大的查询缓存特性，它可以非常方便的定制和配置缓存，缓存可以极大的提高查询效率。
• MyBatis系统中默认定义了两级缓存：一级缓存和二级缓存
  • 默认情况下，只有一级缓存开启（SqlSession级别的缓存，也称为本地缓存）
  • 二级缓存需要手动开启和配置，他是基于namespace级别的缓存。
  • 为了提高可扩展性，MyBatis定义了缓存接口Cache。我们可以通过实现Cache接口来定义二级缓存。

13.3 一级缓存

• 一级缓存也叫本地缓存：SqlSession
  • 与数据库同一次会话期间查询到的数据会放在本地缓存中
  • 以后如果需要获取相同的数据，直接从缓存中拿，没必要再去查询数据库

测试步骤：

1. 开启日志
2. 测试在一个Session中查询两次记录
3. 查看日志输出

缓存失效的情况：

1. 查询不同的东西
2. 增删改操作，可能会改变原来的数据，所以必定会刷新缓存
3. 查询不同的Mapper.xml
4. 手动清理缓存

13.4 二级缓存

• 二级缓存也叫全局缓存，一级缓存作用域太低了，所以诞生了二级缓存
• 基于namespace级别的缓存，一个名称空间，对应一个二级缓存
• 工作机制
  • 一个会话查询一条数据，这个数据就会被放在当前会话的一级缓存中
  • 如果会话关闭了，这个会员对应的一级缓存就没了；但是我们想要的是，会话关闭了，一级缓存中的数据被保存到二级缓存中
  • 新的会话查询信息，就可以从二级缓存中获取内容
  • 不同的mapper查询出的数据会放在自己对应的缓存（map）中

一级缓存开启（SqlSession级别的缓存，也称为本地缓存）

• 二级缓存需要手动开启和配置，他是基于namespace级别的缓存。
• 为了提高可扩展性，MyBatis定义了缓存接口Cache。我们可以通过实现Cache接口来定义二级缓存。

步骤：

1. 开启全局缓存

   
   <setting name="cacheEnabled" value="true"/>
   

2. 在Mapper.xml中使用缓存

   
   <cache
          eviction="FIFO"
          flushInterval="60000"
          size="512"
          readOnly="true"/>
   

3. 测试

   1. 问题：我们需要将实体类序列化，否则就会报错

小结：

• 只要开启了二级缓存，在同一个Mapper下就有效
• 所有的数据都会放在一级缓存中
• 只有当前会话提交，或者关闭的时候，才会提交到二级缓存中

13.5 缓存原理

注意：

• 只有查询才有缓存，根据数据是否需要缓存（修改是否频繁选择是否开启）useCache=“true”

    <select id="getUserById" resultType="user" useCache="true">
        select * from user where id = #{id}
    select>

13.6 自定义缓存-ehcache

Ehcache是一种广泛使用的开源Java分布式缓存。主要面向通用缓存

1. 导包

   <dependency>
       <groupId>org.mybatis.cachesgroupId>
       <artifactId>mybatis-ehcacheartifactId>
       <version>1.2.1version>
   dependency>
   

2. 在mapper中指定使用我们的ehcache缓存实现

   <cache type="org.mybatis.caches.ehcache.EhcacheCache"/>