tip:如果要查看这一系列文章，可点击 这里
第二部分：OSCache使用指南
一、下载安装
OSCache是一个基于web应用的组件，他的安装工作主要是对web应用进行配置，大概的步骤如下：
1. 下载、解压缩OSCache
从http://www.opensymphony.com/oscache/download.html下载合适的OSCache版本， 解压缩下载的文件到指定目录 。
2、新建立一个web应用
3、将OSCache集成到web项目当中。
（1）从解压缩目录取得oscache.jar 文件放到 /WEB-INF/lib 或相应类库目录中，jar文件名可能含有版本号和该版本的发布日期信息等。
（2）将oscache.properties、oscache.tld放入WEB-INF\class目录（确切说是放在项目的src目录下，编译的时候会自动生成在WEB-INF\class目录）。
（3）配置项目对应的oscache.properties参数信息。
（4）具体使用
A、缓存对象：直接调用API的接口即可（详见[Java]用OSCache进行缓存对象）
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页面使用以下标签
<%@ taglib uri="/WEB-INF/classes/oscache.tld" 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（也就是访问已经成功）的页面信息才能够被缓存
4、配置日志输出信息。
二、oscache.properties 文件配置向导
oscache.properties 中的配置项详解:
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
指集群中的额外配置项. 以下是默认设置:(此属性的相关说将在集群文档中说明)
UDP(mcast_addr=231.12.21.132;mcast_port=45566;ip_ttl=32;\
mcast_send_buf_size=150000;mcast_recv_buf_size=80000):\
PING(timeout=2000;num_initial_members=3):\
MERGE2(min_interval=5000;max_interval=10000):\
FD_SOCK:VERIFY_SUSPECT(timeout=1500):\
pbcast.NAKACK(gc_lag=50;retransmit_timeout=300,600,1200,2400,4800;max_xmit_size=8192):\
UNICAST(timeout=300,600,1200,2400):\
pbcast.STABLE(desired_avg_gossip=20000):\
FRAG(frag_size=8096;down_thread=false;up_thread=false):\
pbcast.GMS(join_timeout=5000;join_retry_timeout=2000;shun=false;print_local_addr=true)
