第2篇-OsCache安装配置

[color=red][size=large]OSCache是一个基于web应用的组件，他的安装工作主要是对web应用进行配置，大概的步骤如下：[/size][/color]

[color=red][b]一、下载、解压缩OSCache[/b][/color]https://java.net/downloads/oscache/下载合适的OSCache版本，解压缩下载的文件到指定目录。

[color=red][b]二、新建一个web应用[/b][/color]

[color=red][b]三、将OSCache集成到web项目中: [/b][/color]
（1）从解压缩目录取得oscache.jar文件放到/WEB-INF/lib或相应类库目录中，jar文件名可能含有版本号和该版本的发布日期信息等。
（2）将oscache.properties、oscache.tld放入WEB-INF\class目录（确切说是放在项目的src目录下，编译的时候会自动生成在WEB-INF\class目录）。
（3）配置项目对应的oscache.properties参数信息。
（4）具体使用

[color=red][b]四、OSCache使用[/b][/color]
A、缓存对象：直接调用API的接口即可
B、部分页面缓存：使用OSCache提供的taglib
修改web.xml文件，在web.xml文件中增加下面的内容，增加对OSCache提供的taglib的支持：

<taglib>
    <taglib-uri>oscache</taglib-uri> 
    <taglib-location>/WEB-INF/classes/oscache.tld</taglib-location>
</taglib>

或者在jsp页面使用以下标签(2种引入方式)

<%@ taglib uri="/WEB-INF/classes/oscache.tld" prefix="cache" %> 
<%@ taglib uri="http://www.opensymphony.com/oscache" prefix="cache" %>

C、整个页面的缓存：
用CashFilter实现页面级缓存，可缓存单个文件、缓存URL pattern和自己设定缓存属性的缓存。

<filter>
    <filter-name>CacheFilter</filter-name>
    <filter-class>com.opensymphony.oscache.web.filter.CacheFilter</filter-class>
    <init-param>
        <param-name>time</param-name>
        <param-value>600</param-value>
    </init-param>
    <init-param>
        <param-name>scope</param-name>
        <param-value>session</param-value>
    </init-param>
</filter>
<filter-mapping>
    <filter-name>CacheFilter</filter-name>
    <!-对所有jsp页面内容进行缓存-->
    <url-pattern>*.jsp</url-pattern>
</filter-mapping>

[注]只有客户访问时返回http头信息中代码为200（也就是访问已经成功）的页面信息才能够被缓存

[color=red][b]五、配置日志输出信息。[/b][/color]
1、cache.memory
是否使用内存缓存；值为：true或false。默认为true；如设置为false，那cache只能缓存到数据库或硬盘中。

2、cache.capacity
缓存的最大数量。默认是不限制，cache不会移走任何缓存内容。负数被视不限制。

3、cache.algorithm
运算规则。为了使用规则，cache的size必须是指定的。

如果cache的size不指定的话, 将不会限制缓存对象的大小。如果指定了cache的size，但不指定algorithm，那它会默认使用:com.opensymphony.oscache.base.algorithm.LRUCache

有下面三种规则：
com.opensymphony.oscache.base.algorithm.LRUCache: last in first out(最后插入的最先调用)。默认选项。
com.opensymphony.oscache.base.algorithm.FIFOCache: first int first out(最先插入的最先调用)。
com.opensymphony.oscache.base.algorithm.UnlimitedCache: cache中的内容将永远不会被丢弃。如果cache.capacity不指定值的话，它将被设为默认选项。

4、cache.blocking
是否同步。true或者false。一般设为true，避免读取脏数据。

5、cache.unlimited.disk
指定硬盘缓存是否要作限制。默认值为false。false的状况下，disk cache capacity和cache.capacity的值相同。

6、cache.persistence.class
指定类是被持久化缓存的类。class必须实现PersistenceListener接口。
作为硬盘持久，可以实现com.opensymphony.oscache.plugins.diskpersistence.HashDiskPersistenceListener接口。
它把class的toString()输出的hash值作为文件的名称。如果你要想文件名易读些（自己设定），DiskPersistenceListener的父类也能使用，但其可能有非法字符或者过长的名字。
注意：HashDiskPersistenceListener和DiskPersistenceListener需要设定硬盘路径：cache.path

7、cache.path
指定硬盘缓存的路径。目录如果不存在将被建立。同时注意oscache应该要有权限写文件系统。
例:
cache.path=c:\\myapp\\cache
cache.path=/opt/myapp/cache

8、cache.persistence.overflow.only (NEW! Since 2.1)
指定是否只有在内存不足的情况下才使用硬盘缓存。
默认值false。但推荐是true如果内存cache被允许的话。这个属性彻底的改变了cache的行为，使得persisted cache和memory是完全不同。

9、cache.event.listeners
class名列表(用逗号隔开)。每个class必须实现以下接口中的一个或者几个。
CacheEntryEventListener：接收cache add/update/flush and remove事件
CacheMapAccessEventListener ：接收cache访问事件。这个可以让你跟踪cache怎么工作。
默认是不配置任何class的。当然你可以使用一下class：
com.opensymphony.oscache.plugins.clustersupport.BroadcastingCacheEventListener: 分布式的监听器。可以广播到局域网内的其他cache实例。
com.opensymphony.oscache.extra.CacheEntryEventListenerImpl:一个简单的监听器。在cache的生命周期中记录所有entry的事件。
com.opensymphony.oscache.extra.CacheMapAccessEventListenerImpl: 记录count of cache map events（cache hits，misses and state hits）.

10、cache.key
在application和session的作用域时，用于标识cache对象的，用于ServletCacheAdministrator;此属性不是指定为"__oscache_cache"格式时为默认值, 如果代码中需要用到默认值时可以通使用com.opensymphony.oscache.base.Const.DEFAULT_CACHE_KEY来取得;

11、cache.use.host.domain.in.key
当配置多个服务器时,想通过服备器名称自动生成cache key时,可将此属性设为true. 默认值为false;

12、Additional Properties
在以上基础选项之上可以加入一些额外的属性到此文件中.
例: JavaGroupsBroadcastingListener便是额外的.

13、cache.cluster.multicast.ip
用于缓存集群. 默认为231.12.21.132

14、cache.cluster.properties
指集群中的额外配置项