当前位置：首页 > news >正文

【Ehcache技术专题】「入门到精通」带你一起从零基础进行分析和开发Ehcache框架的实战指南（缓存查询-配置篇）

news 2025/8/5 1:41:09

缓存查询

Ehcache中为我们提供了可以对Cache中缓存的元素进行查找的方式。其逻辑类似于SQL中的查找。通过给定各种限制条件，我们可以构造各种复杂的查询，然后返回结果集，也可以对查询进行分组和排序等。

使Cache可查询

Ehcache中的查询是针对于Cache而言的。但并不是所有的Cache都可以进行查询操作，我们需要指定其为一个可查询的Cache之后才可以对该Cache进行查询操作。因为在配置Cache的时候有基于xml文件的配置和基于程序代码的配置，所以对应的使一个Cache可查询也有两种方式。

基于Xml配置

当我们的Cache定义是基于Xml文件的配置时，我们只需在对应Cache定义下声明一个子元素searchable即可使当前Cache拥有可查询的功能。

Xml代码

<cache name="searchableCache" maxBytesLocalHeap="100M">  <searchable/>  
</cache>

基于代码的配置

基于代码的配置是通过新建Searchable对象，然后指定需要设置为可查询Cache对应的CacheConfiguration的Searchable对象为我们新建的Searchable对象即可。

Java代码

   public void test() {  CacheManager cacheManager = CacheManager.create();  CacheConfiguration cacheConfig = new CacheConfiguration();  cacheConfig.name("cache1").maxBytesLocalHeap(100, MemoryUnit.MEGABYTES);  Searchable searchable = new Searchable();  //指定Cache的Searchable对象。  cacheConfig.searchable(searchable);  //如下指定也行  
//    cacheConfig.addSearchable(searchable);  Cache cache1 = new Cache(cacheConfig);  cacheManager.addCache(cache1);  }

指定可搜索的属性

配置了Cache可查询后，我们还需要配置当前Cache可以对哪些属性进行查询，即可以把哪些属性作为条件来对Cache进行查询。在Ehcache中使用一个net.sf.ehcache.search.Attribute来表示一个可查询的属性。这些可查询的属性可以是我们的key、value或者它们对应的属性。定义可查询属性是通过searchable元素的子元素searchAttribute来定义的，如：

Xml代码

<cache name="userCache" maxBytesLocalHeap="50M">  <searchable>  <searchAttribute name="name"/>  </searchable>  
</cache>

其中name表示我们所定义的可查询属性的名称，是必须指定的属性。这里会通过属性提取机制提取key或者value中name所对应的属性，这里是name属性，来进行索引。关于属性提取机制将在后续讲解。

可查询属性类型

一下属性都可以用来作为Cache的可查询属性，它必须是以下类型之一：

Boolean
Byte
Short
Character
Integer
Long
Float
Double
String
java.util.Date
java.sql.Date
Enum

可查询/可索引能力定义

默认情况下，系统会自动把我们存入可查询Cache中元素的key和value作为可查询属性，命名为key和value，当它们是以上可查询类型时我们可以直接对它们进行查询。

如果不需要默认将我们的key和value作为可查询属性的话，我们可以在指定Cache为一个可查询Cache时指定searchable元素的keys属性和values属性为false即可。如：

Xml代码

<cache name="searchableCache" maxBytesLocalHeap="100M">  
.   <searchable keys="false" values="false"/>  
</cache>

属性的提取

当我们的key或者value不是可查询类型，然而我们又希望对它们进行查询时，我们就需要把key或者value中的属性提取出来作为Cache的一个可查询属性。这是通过AttributeExtractor来进行的，AttributeExtractor是一个接口，其中只定义了一个方法Object attributeFor(Element element, String attributeName)。其返回值必须是可查询属性类型之一。当然，返回null也是可以的。下面我们来看看如何定义自己的AttributeExtractor。

定义自己的AttributeExtractor

假设我们有一个名叫userCache的缓存，其中存放的元素值都是一个User对象。而我们的User对象有一个String类型的name属性。假设我们现在指定了我们的userCache的一个可查询属性为user，而其真正对应的内容是我们的Element中存放的value的name。那么这个时候我们的AttributeExtractor实现大概会是这个样子：

Java代码

public class UserAttributeExtractor implements AttributeExtractor {     @Override  public Object attributeFor(Element element, String attributeName)  throws AttributeExtractorException {  User user = (User) element.getObjectValue();  return user.getName();  }    
}

定义好了AttributeExtractor之后，我们要告诉Ehcache，缓存userCache的可查询属性user对应的AttributeExtractor是我们定义的UserAttributeExtractor，这只需要指定searchAttribute元素的class属性即可。

Xml代码

<cache name="userCache" maxBytesLocalHeap="50M">  <searchable>  <searchAttribute name="user" class="com.xxx.UserAttributeExtractor"/>  </searchable>  
</cache>

之后我们通过user属性来查询时就可以通过User对象的name属性来过滤一些结果集了。如果我们的AttributeExtractor还需要接收其它的参数的话，我们可以通过searchAttribute元素的properties属性来指定，其对应的参数是键值对的形式，中间用等号“=”隔开，多个参数之间用逗号隔开。如：

Xml代码

<cache name="userCache" maxBytesLocalHeap="50M">  <searchable>  <searchAttribute name="user" class="com.xxx.UserAttributeExtractor" properties="a=1,b=2"/>  </searchable>  
</cache>

指定了properties属性后，我们对应的AttributeExtractor必须给定一个以Properties对象为参数的构造方法才可以接收到这些指定的参数。

除了定义自己的属性提取实现类之外，Ehcache还为我们提供了一些实现类。包括KeyObjectAttributeExtractor、ValueObjectAttributeExtractor，这两个属性提取器就是默认情况下Ehcache用来把key和value提取为一个可查询属性的方式。此外还有JavaBeanAttributeExtractor和ReflectionAttributeExtractor。

JavaBeanAttributeExtractor

当定义一个可查询属性searchAttribute只指定其name属性，系统所使用的AttributeExtractor就是JavaBeanAttributeExtractor。该AttributeExtractor会从元素的key或者value中取searchAttribute的name属性值所对应的属性。

如果我们有如下这样一个可查询缓存的定义，Ehcache在给可查询属性address建立索引时就会获取元素key的address属性或者value的address属性来作为查询属性address的值。

Xml代码

<cache name="searchableCache" maxBytesLocalHeap="100M">  <searchable keys="false" values="false">  <searchAttribute name="address"/>  </searchable>  
</cache>

注意：使用JavaBeanAttributeExtractor时，如果key和value中都包含可查询属性，则系统会抛出异常，如果都不包含的话也会抛出异常。

ReflectionAttributeExtractor

当我们定义一个可查询属性searchAttribute时指定了expression属性时，系统就会使用ReflectionAttributeExtractor来提取属性的值。此属性提取器是通过反射来提取属性值的。expression必须以key、value或element开始，然后中间以点“.”来连接它们所对应的属性或方法，以及属性的属性，方法的方法。key表示元素的key，value表示元素的value，element表示元素本身。

配置案例

查询属性address的值是对应的value的address属性。

Xml代码

<cache name="searchableCache" maxBytesLocalHeap="100M">  <searchable keys="false" values="false">  <searchAttribute name="address" expression="value.address"/>  </searchable>  
</cache>

查询属性address的值是对应的value的extraInfo属性的getAddress()方法的返回值。

Xml代码

<cache name="searchableCache" maxBytesLocalHeap="100M">  <searchable keys="false" values="false">  <searchAttribute name="address" expression="value.extraInfo.getAddress()"/>  </searchable>  
</cache>

3.查询属性hitCount的值是对应的element的getHitCount()方法的返回值。

Xml代码

<cache name="searchableCache" maxBytesLocalHeap="100M">  <searchable keys="false" values="false">  <searchAttribute name="hitCount" expression="element.getHitCount()"/>  </searchable>  
</cache>

DynamicAttributesExtractor

上面介绍的AttributeExtractor都是在Cache实例化之前定义的，其会在Cache实例化时初始化这些可查询属性。而DynamicAttributesExtractor允许我们在Cache实例化后添加可查询属性。

实现原理

DynamicAttributesExtractor是一个接口，它跟AttributeExtractor接口没有任何关系。该接口中仅定义了一个方法attributesFor()，该方法将接收一个Element对象作为参数，然后返回一个将作为可查询属性的Map，该Map的key对应可查询属性的名称，而value则对应可查询属性的值。那么我们在实现DynamicAttributesExtractor接口时只需要实现attributesFor()方法即可。

使用DynamicAttributeExtractor时我们的Cache对应的Searchable必须是支持该提取器才行，这是通过Searchable对象的allowDynamicIndexing属性来指定的，使用xml配置时该属性是直接配置在searchable元素上的，而使用程序来定义时则需要通过Searchable对象来指定了。

之后我们需要把它注册给我们的Cache。通过Cache的registerDynamicAttributesExtractor()方法我们就可以给Cache注册一个动态的属性提取器了，该提取器将在往Cache中put或者replace元素时被调用。

xml代码

<cache name="userCache" maxBytesLocalHeap="50M">  <searchable allowDynamicIndexing="true">  <searchAttribute name="name" expression="value.getName()"/>  </searchable>  
</cache>