Infinispan配置与API使用详解

### Infinispan配置与API使用详解 #### 1. 配置设置概述 Infinispan的默认和命名缓存部分共享相同的类型定义（配置），可用于所有缓存（默认）或特定缓存（命名缓存）。以下是一些可用于定义不同配置的元素及其描述： | 元素 | 描述 | | --- | --- | | locking | 定义锁容器的并发级别、隔离级别、锁获取时间和缓存的并发行为 | | persistence | 缓存加载器和存储的配置 | | sites | 跨站点复制的缓存配置，可用于为远程网格配置备份缓存 | | transaction | 定义缓存的事务设置 | | customInterceptors | 为给定缓存配置自定义拦截器 | | dataContainer | 控制缓存的内部数据结构 | | eviction | 定义缓存的逐出特征 | | expiration | 定义缓存条目的过期设置 | | unsafe | 需谨慎使用，仅在特定情况下推荐。包含unreliableReturnValues布尔属性，可通过打破映射契约来提高性能 | | versioning | 控制缓存条目的版本控制 | | clustering | 指定缓存的集群设置，如同步特征、新缓存加入或离开集群时的状态转移等 | | jmxStatistics | 启用通过JMX进行统计收集和报告 | | storeAsBinary | 常用于集群模式，允许指定缓存条目的键和值是序列化为二进制格式存储还是作为引用存储 | | invocationBatching | 启用缓存的调用批处理，默认值为false | | deadlockDetection | 配置死锁检测 | | indexing | 启用缓存条目的索引以进行搜索，默认禁用 | | compatibility | 启用嵌入式和远程端点共享缓存数据的兼容模式 | #### 2. 默认配置示例 以下是一个默认配置的示例： ```xml <default> <locking concurrencyLevel="100" lockAcquisitionTimeout="1000" /> <transaction transactionMode="NON_TRANSACTIONAL" reaperWakeUpInterval="123" completedTxTimeout="3123" /> <jmxStatistics enabled="false" /> </default> ``` #### 3. dataContainer元素的使用 dataContainer元素常用于等价性设置，包含keyEquivalence和valueEquivalence属性，可自定义Infinispan比较缓存键的方式。例如，当在Infinispan缓存中存储数组时，默认的equals()和hashCode()实现可能产生不理想的结果，因为可能希望基于数组内容而不是对象引用进行计算。从Infinispan 5.3开始，用户可以使用新的Equivalence<T>接口为键和值提供自己的实现。Infinispan提供了两种实现： - org.infinispan.commons.equivalence.ByteArrayEquivalence：用于比较无符号字节数组。 - org.infinispan.commons.equivalence.AnyServerEquivalence：默认选项，可支持多种不同类型，将equals()和hashCode()方法的调用委托给对象本身。 配置文件示例如下： ```xml <dataContainer keyEquivalence= "org.jboss.as.clustering.infinispan.equivalence.AnyServerEquivalence" valueEquivalence="org.jboss.as.clustering.infinispan.equivalence.AnyServerEquivalence" /> ``` ```xml <dataContainer keyEquivalence= "org.infinispan.commons.equivalence.ByteArrayEquivalence" valueEquivalence="org.infinispan.commons.equivalence.ByteArrayEquivalence" /> ``` #### 4. 声明式创建Infinispan缓存 要使用XML文件声明式创建Infinispan缓存，可创建一个CacheContainer实例，并将配置文件的路径/名称或包含配置文件内容的流传递给构造函数。示例代码如下： ```java String config = "resources/infinispan-eviction.xml"; CacheContainer container = new DefaultCacheManager(config); ``` #### 5. Infinispan 7.0.x的声明式配置 Infinispan 7.0的新XML模式文件中，<infinispan>根元素仍然存在，但Infinispan 6.0.x中的全局、默认和命名缓存子元素被移除，因为服务器模块中缓存容器的默认缓存语义略有不同，全局配置也是如此，服务器模块中的大多数服务在幕后自动注入。新的<infinispan>子元素定义如下： - jgroups：使用JGroups定义传输协议栈配置。 - threads：定义线程子系统，可由Infinispan缓存容器用于声明和引用可管理的线程池和资源。 - cache-container：指定缓存容器配置。 #### 6. 理解JGroups元素 JGroups元素用于处理传输配置，可定义单个JGroups栈。配置设置在包含其定义的文件中，可在stack-file元素中引用，示例如下： ```xml <jgroups> <stack-file name="udp" path="jgroups-udp.xml"/> <stack-file name="tcp" path="jgroups-tcp.xml"/> </jgroups> ``` 上述配置使用了两个JGroups文件，可由缓存容器元素中的传输栈属性引用。 #### 7. 配置线程子系统 线程元素用于定义线程执行器并管理线程池和资源。线程子系统是Infinispan执行并行任务的重要部分，Infinispan提供了一些有用的线程池，在多核架构中更具相关性。以下是线程子系统中需要配置的一些子元素： - **thread-factory**：用于在需要时创建新线程，实现java.util.concurrent.ThreadFactory类。需要为创建的bean添加名称，还可选择定义线程组名称（group-name属性）、创建线程名称的模式（thread-name-pattern属性）以及指定创建线程的优先级（priority属性）。示例如下： ```xml <threads> <thread-factory name="infinispan-factory" group-name="infinispan" thread-name-pattern="%G %i" priority="5"/> ``` - **线程池执行器**：Infinispan提供了三种有用的线程池执行器，如下表所示： | 元素 | 描述 | | --- | --- | | blocking-bounded-queue-thread-pool | 定义具有有界队列的线程池执行器，提交任务的线程可能会被阻塞，直到有空闲线程处理它们。线程池可并行处理多个任务，受max-threads属性限制。可使用queue-length属性定义队列长度，避免创建巨大队列和可能的内存溢出问题。还可定义其他属性，如name、core-threads、keepalive-time、thread-factory | | cached-thread-pool | 定义一个线程池执行器，根据需要创建新线程，但如果有可用线程，将从缓存中返回先前构造的线程；否则，将创建一个新线程并加入池中。属性包括name、thread-factory | | scheduled-thread-pool | 定义一个单线程执行器，可安排任务定期执行或在特定延迟后执行。属性包括name、thread-factory | 以下是一个完整的线程子系统配置示例： ```xml <threads> <thread-factory ```