mybatis-ehcache-spring

Mybatis ehcache with spring. Mybatis cache metrics.

License	Apache 2
Categories	Ehcache Data Caching MyBatis ORM
GroupId	io.github.hengyunabc
ArtifactId	mybatis-ehcache-spring
Last Version	0.0.1
Release Date	Mar 25, 2016
Type	jar
Description	mybatis-ehcache-spring Mybatis ehcache with spring. Mybatis cache metrics.
Project URL	https://github.com/hengyunabc/mybatis-ehcache-spring
Source Code Management	https://github.com/hengyunabc/mybatis-ehcache-spring

Download mybatis-ehcache-spring

Filename	Size
mybatis-ehcache-spring-0.0.1.pom
mybatis-ehcache-spring-0.0.1.jar	10 KB
mybatis-ehcache-spring-0.0.1-sources.jar	6 KB
mybatis-ehcache-spring-0.0.1-javadoc.jar	57 KB

How to add to project

Apache Maven

<!-- https://jarcasting.com/artifacts/io.github.hengyunabc/mybatis-ehcache-spring/ -->
<dependency>
    <groupId>io.github.hengyunabc</groupId>
    <artifactId>mybatis-ehcache-spring</artifactId>
    <version>0.0.1</version>
</dependency>

Gradle Groovy

// https://jarcasting.com/artifacts/io.github.hengyunabc/mybatis-ehcache-spring/
implementation 'io.github.hengyunabc:mybatis-ehcache-spring:0.0.1'

Gradle Kotlin

// https://jarcasting.com/artifacts/io.github.hengyunabc/mybatis-ehcache-spring/
implementation ("io.github.hengyunabc:mybatis-ehcache-spring:0.0.1")

Apache Buildr

'io.github.hengyunabc:mybatis-ehcache-spring:jar:0.0.1'

Apache Ivy

<dependency org="io.github.hengyunabc" name="mybatis-ehcache-spring" rev="0.0.1">
  <artifact name="mybatis-ehcache-spring" type="jar" />
</dependency>

Groovy Grape

@Grapes(
@Grab(group='io.github.hengyunabc', module='mybatis-ehcache-spring', version='0.0.1')
)

Scala SBT

libraryDependencies += "io.github.hengyunabc" % "mybatis-ehcache-spring" % "0.0.1"

Leiningen

[io.github.hengyunabc/mybatis-ehcache-spring "0.0.1"]

Dependencies

compile (1)

Group / Artifact	Type	Version
net.sf.ehcache : ehcache-core	jar	2.6.10

provided (6)

Group / Artifact	Type	Version
org.mybatis : mybatis	jar	3.2.7
io.dropwizard.metrics : metrics-ehcache	jar	3.1.1
javax.transaction : transaction-api	jar	1.1
org.springframework : spring-core	jar	4.1.6.RELEASE
org.springframework : spring-context	jar	4.1.6.RELEASE
org.springframework : spring-beans	jar	4.1.6.RELEASE

test (2)

Group / Artifact	Type	Version
junit : junit	jar	4.12
org.slf4j : slf4j-simple	jar	1.7.12

Project Modules

There are no modules declared in this project.

mybatis-ehcache-spring

Why we need this project

The official mybatis-ehcache is very simple. It create ehcache like follow:

protected static CacheManager CACHE_MANAGER = CacheManager.create();

User can not set custom ehcache.xml, can not set custom CacheManager. https://github.com/mybatis/ehcache-cache

This project provide these feature:

• Load Ehcache config from custom ehcache.xml file or use a existed ehcache manager.
• Mybatis cache metrics.
• Spring integration.

##Example mybatis UserMapper xml:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<mapper namespace="io.github.xdiamond.persistence.UserMapper">
  <resultMap id="BaseResultMap" type="io.github.xdiamond.domain.User">
  
  <cache type="io.github.hengyunabc.mybatis.FacadeCache">
  </cache>
</mapper>

spring application.xml

    <!-- this bean is important -->
	<bean  class="io.github.hengyunabc.mybatis.SharedSpringContextSetter">
	</bean>
	
	<bean id="ehCacheManager"
		class="org.springframework.cache.ehcache.EhCacheManagerFactoryBean">
		<property name="configLocation" value="classpath:my-ehcache.xml" />
	</bean>
	<!-- this bean name must be mybatisCacheDefaultFactory -->
	<bean id="mybatisCacheDefaultFactory" class="io.github.hengyunabc.mybatis.MybatisEhcacheFactory">
		<property name="cacheManager" ref="ehCacheManager"></property>
	</bean>
	
	<!-- define the SqlSessionFactory -->
	<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean" >
		<property name="dataSource" ref="dataSource" />
		<property name="typeAliasesPackage" value="io.github.xdiamond.domain" />
	</bean>

	<!-- scan for mappers and let them be autowired -->
	<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer" >
		<property name="basePackage" value="io.github.xdiamond.persistence" />
	</bean>

###How it works?

1. SharedSpringContextSetter set the concurrent spring context into SharedSpringContext.
2. When mybatis need a cache, it will new a cache object, In UserMapper.xml, cache class is FacadeCache.
3. When the FacadeCache construct, it will find SpringContext from SharedSpringContext, and get the io.github.hengyunabc.mybatis.CacheFactory bean. The CacheFactory default name is 'mybatisCacheDefaultFactory'.
4. MybatisEhcacheFactory will provide the read cache, which wrapped by FacadeCache.

public class MybatisEhcacheFactory implements CacheFactory {
  protected CacheManager cacheManager;
  CacheConfiguration cacheConfiguration;

  @Override
  public Cache getCache(String id) {
    if (!cacheManager.cacheExists(id)) {
      CacheConfiguration temp = null;
      if (cacheConfiguration != null) {
        temp = cacheConfiguration.clone();
      } else {
        // based on defaultCache
        temp = cacheManager.getConfiguration().getDefaultCacheConfiguration().clone();
      }
      temp.setName(id);
      net.sf.ehcache.Cache cache = new net.sf.ehcache.Cache(temp);
      cacheManager.addCache(cache);
    }
    return new EhcacheCache(id, cacheManager.getEhcache(id));

User can provide custom ehcache CacheManager and CacheConfiguration.

Mybatis Cache Metrics

• Config your metricRegistry.

https://github.com/ryantenney/metrics-spring

<metrics:metric-registry id="metricRegistry" />

• Use MybatisMetricsEhcacheFactory.

	<bean id="mybatisCacheDefaultFactory" class="io.github.hengyunabc.mybatis.MybatisMetricsEhcacheFactory">
		<property name="cacheManager" ref="ehCacheManager"></property>
		<property name="registry" ref="metricRegistry"></property>
	</bean>

The metrics result will like these:

net.sf.ehcache.Cache.io.github.xdiamond.persistence.UserMapper.eviction-count
             value = 0
net.sf.ehcache.Cache.io.github.xdiamond.persistence.UserMapper.hits
             value = 3
net.sf.ehcache.Cache.io.github.xdiamond.persistence.UserMapper.in-memory-hits
             value = 3
net.sf.ehcache.Cache.io.github.xdiamond.persistence.UserMapper.in-memory-misses
             value = 1
net.sf.ehcache.Cache.io.github.xdiamond.persistence.UserMapper.gets
             count = 4
         mean rate = 0.07 calls/second
     1-minute rate = 0.04 calls/second
     5-minute rate = 0.01 calls/second
    15-minute rate = 0.00 calls/second
               min = 0.06 milliseconds
               max = 0.18 milliseconds
              mean = 0.13 milliseconds
            stddev = 0.05 milliseconds
            median = 0.18 milliseconds
              75% <= 0.18 milliseconds
              95% <= 0.18 milliseconds
              98% <= 0.18 milliseconds
              99% <= 0.18 milliseconds
            99.9% <= 0.18 milliseconds
net.sf.ehcache.Cache.io.github.xdiamond.persistence.UserMapper.puts
             count = 1
         mean rate = 0.02 calls/second
     1-minute rate = 0.01 calls/second
     5-minute rate = 0.00 calls/second
    15-minute rate = 0.00 calls/second

maven repository

	<repositories>
		<repository>
			<id>hengyunabc-maven-repo</id>
			<url>https://raw.githubusercontent.com/hengyunabc/maven-repo/master/repository</url>
		</repository>
	</repositories>

More

Mybatis use mapper namespace for cache id, so you can config different cache for different table in your ehcache.xml

Licence

Apache License V2

Versions

Version
0.0.1 Mar 25, 2016