OSCache使用介紹

OSCache使用介紹

 

一.OSCache简介

OSCache是OpenSymphony这个开源项目众多Projects中的一个。他是一个高效的J2EE缓存框架，能够很好的解决动态网站速度的问题。下面来

看下OSCache解决了动态网站的哪些令人郁闷的问题。

1.缓存动态内容：其实我们的动态网页上一般只有一部分是动态的（表头，表尾一般是不变的），如果我们缓存整个网页显然不成，因为有部分是

随着请求有可能变的。OSCache提供的方式是允许我们只缓存一部分网页。

2.缓存2进制内容：产生的图片和PDF文件在服务器加载的时候非常的耗时。OSCache解决这个问题是通过一个Servlet2.3的缓存过滤功能，然后能

够缓存任意的URI（比如一个完整的页面或者是一个产生的图片/PDF文件）

3.容错：有这种情况或许我们会遇到，就是当一个动态的网页出现错误。即便我们的页面有95%都加载完毕，但就是由于这个错误，整个页面就会

返回错误的提示或页面。OSCache允许我们提供出现错误时的缓存内容，如果出现就适时的提示出来了。

除了上面的这些Servlet的特征外，OSCache完全可以充当任何一个java程序的缓存方案。OSCache 的一般特征如下：

1.缓存任意对象：可以不受限制的缓存JSP的一部分或是Http请求，任何的Java对象都可以被缓存。

2.全面的API：通过API可以完完全全的控制OSCache的任何特性。

3.持久缓存：我们可以把认为重要的数据缓存到硬盘上。

4.支持集群：集群缓存数据能被单个的进行参数配置，不需要修改代码。

5.缓存记录的过期：你可以有最大限度的控制缓存对象的过期，包括可插入式的刷新策略（如果默认性能不需要时）。

二.OSCache运行环境

如果用到OSCache Tag Library的话，需要Servlet2.3和JSP1.2的支持。如果是直接用OSCache API的话那么就不需要Servlet容器的支持。

目前可以正常运行的Web容器：

1.OrionServer(版本1.4.0和更高)

2.JRun(3.0或更好)

3.WebLogic(8.1或以上)

4.Websphere(5.0或以上)

5.Resin(1.2.3或以上)

6.TomCat(4.0或以上)

7.iPlanet(6.0或以上)

用到缓存过滤需要Servlet2.3支持.目前知道的可以个工作在OrionServer,WebLogic,Tomcat上.

OSCache需要Java的版本至少是java 1.4.

三.OSCache的安装

1.解压oscache-2.4.1-full后发现他下面有如下文件:

2.把oscache-2.4.1.jar放到/WEB-INF/lib下.

3.要确保commons-logging.jar也在环境变量中.一般情况下他也放在/WEB-INF/lib下.

4. 把/etc/oscache.properties放入/WEB-INF/classes下.如果用的Eclipse的话,建议新建一个 Source Folder比如叫Src_Config,然后就这个OSCache的属性文件放在其中.通过修改这个OSCache的配置文件可以改变文件缓存的磁盘路径,配置持久侦听等等.

5.把etc/META-INF/oscache.tld也放在/WEB-INF/classes下.

你的目录结构如下:

四.OSCache应用学习

1.JSP的应用

要是想应用OSCache的标签,我们必须先要引入进来.方式有两种.

其一.在web.xml中加入:

<taglib>

<taglib-uri>oscache</taglib-uri>

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

</taglib>

然后我们在JSp中就可以<%@ taglib uri="oscache" prefix="os"%>这样来引用了.

其二,直接引用.直接在JSp中加入OSCache的标签库引用

<%@ taglib uri="/WEB- INF/classes/oscache.tld" prefix="os"%>.如果要进入官方的标签库的话也行.& lt;%@ taglib uri="http://www.opensymphony.com/oscache" prefix="cache" %& gt;这样就不用再把oscache.tld放在/WEB-INF/classes下了.

目前OSCache有5个标签.他们是cache, usecached, flush, addgroup, addgroups.下面我们来分别介绍一下他们的属性和用法.

<cache></cache>

他是OSCache中最主要的标签了.括起来的内容将根据属性的设置来缓存起来.第一次执行的时候,OSCache会把cache标签中的JSp执行并且缓存起来,以后再执行的话,他会首先判断缓存的内容是否过期,如果过期那么会从新执行并缓存.否则就直接从缓存中读取.判定过期的条件如下:

i.缓存的内容超过了属性time所指定的时间.

ii.不符合cron设置的时间间隔.

iii.如果scope指定的范围刷新的话,则认为过期了.如Session过期.

属性如下:

key   : 缓存的Key,可以是任何的字符,用来寻找缓存的内容用的.可以理解成HashMap中的Key.不能把2个要缓存的东东定义成一个名字,那样后一个会覆盖前一个的内容.默认情况,如果不指定Key的话,OSCache也会自动生成一个Key,规则是请求的URI+当前页面的Query String.

scope : 缓存的范围.有2个, application和session.默认值是application.

time   : 缓存内容的时间.以秒为单位,默认是3600秒.到了指定的时间,就会刷新缓存内容.如果指定一个负数的话,意味着永远不会过期.

duration : 也是用来指定缓存内容的时间,它和time属性只能是2选1,它的特点是可以用Simple Data Format 或者是ISO-8601进行日期格式化.

cron   : 用万年历的形式指定缓存内容何时过期的.它应用的Unix的万年历形式,如("0 * * * *")

refresh : 是个Boolean值,如果是True的话,则不管前面提到的过期检查,都刷新.默认情况是false.

mode   : 设置这项为”silent”将防止把括起来的内容输出.这在你预加载缓存内容而不愿显示给用户看到时很有用.

groups : 可以提供一个以逗号分割的组名称.如group="A, B".这将允许你以组的名义来操作他们,分组非常有用,比如你要缓存的内容正好需要另外一个应用程序的一部分或数据,当依赖的发生了改变,正好联动的可以使很多的组过期,进而使与组发生关联的缓存内容得到更新.

language : 设置编码方式.

refreshpolicyclass:指定自定义的类来处理缓存的内容什么时候过期.这个类需要从 refreshpolicyparam com.opensymphony.oscache.web.WebEntryRefreshPolicy继承.

refreshpolicyparam : 它和上面的是联合使用的.是给refreshpolicyclass传任意的参数的.指定这项的话,就必须有refreshpolicyclass,否则就不起作用.

属性就这么多了,下面举几个应用的例子:

<os:cache key="<%=myKey%>" time="1800" refresh="<%=needRefresh%>">

<!--这里是要缓存的内容-->

</os:cache>

这里将myKey标识的缓存内容保持30分钟,到期自动刷新.如果needRefresh为true也会刷新(适合于更新内容的即时刷新).

<os:cache key="<%=myKey%>" cron="0 2 * * *" refresh="<%=needRefresh%>">

<!--这里是要缓存的内容-->

</os:cache>

将myKey标识的缓存内容在每天的凌晨2时自动刷新.如果needRefresh为true也会刷新(适合于更新内容的即时刷新).

举到了这个例子,我不得不把cron表达式多说几句.首先这五颗星的位置代表

分,小时,一个月中的天,月,一周中的天

分: 无疑问0~59.

小时 : 无疑问 0~23.

天(月) : 1~31

月 : 1~12,用英文全称也可以.如January, April

天(周): 0~6(0代表Sunday; 1代表Monday… 6代表Saturday)

举个例子,比如我们想让缓存的内容在4月的晚上11:45分过期.我们可以这样来写

"45 23 * April *".

<usecached />

需要放在cache标签中嵌套使用(一般配合try..catch使用)告诉他的上级标签是否应用缓存的译本. 则出现异常时将会替换包括上级标签在内的所有内容(提示:Missing cached content). use="true|false" : 是否应用的标记. 默认为True.一般省略.

应用例子:

<os:cache>

..内容..

    <% try {%>

    ......其它内容

    <%}catch (Exception e) {%>

    Inside catch: <os:usecached use="<%=isUsed%>"/> YES

    <% } %>

</os:cache>

则出现异常时的页面输出有两种:

1>. isUsed=false

..内容..

......其它内容

Inside catch: YES

2>. isUsed=true

Missing cached content

<flush />

这个标签是用于在运行时状态下刷新缓存的.这个标签非常有用,因为它可以放在Web程序的管理部分使管理员可以决定何时刷新缓存.

属性如下:

scope : 刷新的范围.3个值, "application", "session" and null .null表示刷新所有.

Key : 和scope联合使用,刷新指定范围的指定缓存.如果不指定scope则key无效.

group : 和scope联合使用, 刷新指定范围的指定组中的缓存. 不指定scope无效.

Pattern :任何包含了pattren指定的字符串的缓存都被更新.它也是和scope连用.但是现在官方不赞成再用这个属性了.用group完全可以取代这个.便于管理.

language : 设置编码方式

举几个应用的例子:

刷新整个application.

<os:flush scope="application" />

刷新session中的foobar这个缓存.

<os:flush scope="session" key="foobar" />

在application 中刷新所有currencyData 组中的缓存

<os:flush scope="application" group="currencyData" />

<addgroup />

这个标签也是必须嵌套在cache标签中的.把缓存的东东放入到指定的组中.这样就可以以组来刷新指定的内容了.

属性只有group来指定名字的.例子如下:

把test1加入到group1和group2中

<os:cache key="test1">

    < os:addgroup group="group1" />

    ... some jsp content ...

    < os:addgroup group="group2" />

    ... some more jsp content ...

</ os:cache>

<addgroups /> (2.3及以后的版本中新加的)

同上面的功能相同,只不过可以不用一个一个加group了.例子如下:

< os:cache key="test1">

    ... some jsp content ...

    < os:addgroups groups="group1,group2" />

    ... some jsp content ...

</ os:cache>

2.API的应用

在实际应用中除了JSP标签库和CacheFilter(下面介绍)外,还可以使用OSCache提供的Java API .下面我来介绍一个实用的 Java类 ,使用GeneralCacheAdministrator来建立,刷新和管理缓存. GeneralCacheAdministrator 可以被实例化,里面有很多的实用方法.此外它还管理加载cache.properties并且根据这个属性文件创建一个缓存实例.因此你最好使用单例模式来创建GeneralCacheAdministrator实例.

主要用到的GeneralCacheAdministrator的方法有

public Object getFromCache(String key) throws NeedsRefreshException; -- 从缓存中获取一个key标识的对象.

public Object getFromCache(String key, int refreshPeriod) throws NeedsRefreshException ; -- 从缓存中获取一个key标识的对象. refreshPeriod刷新周期,标识此对象在缓存中保存的时间(单位:秒)

public void putInCache(String key, Object content) -- 存储一个由Key标识的缓存对象.

public void putInCache(String key, Object content, String[] groups)   -- 存储一个由Key标识的属于groups中所有成员的缓存对象.

public void flushEntry(String key) -- 更新一个Key标识的缓存对象.

public void flushGroup(String group) --更新一组属于groupr标识的所有缓存对象.

public void flushAll() -- 更新所有缓存.

public void cancelUpdate(String key) --- 取消更新 只用于在处理捕获的NeedsRefreshException异常并尝试生成新缓存内容失效的时候.

public void removeEntry(String key) ---从缓中移除一个key标识的对象

public void clear() --- 清除所有缓存

官方的使用例子:

///采取补救措施的典型方案

String myKey = "myKey";

String myValue;

int myRefreshPeriod = 1000; //刷新周期1000秒

try {

//从Cache中获得 要做类型转换

myValue = (String) admin.getFromCache(myKey, myRefreshPeriod);

} catch (NeedsRefreshException nre) {

try {

  // Cache中没有则从库获得数据.

  myValue = "This is the content retrieved.";

  // 存放在Cache中 键值myKey

  admin.putInCache(myKey, myValue);

} catch (Exception ex) {

// 尝试恢复Cache中的内容

  myValue = (String) nre.getCacheContent();

  // 如果Cache中的内容没有复原 则用这个终级方法

  admin.cancelUpdate(myKey); //取消对myKey的更新 即类似数据回滚

}

}

///不采取补救措施的典型方案

String myKey = "myKey";

String myValue;

int myRefreshPeriod = 1000;

try {

//从Cache中获得 要做类型转换

myValue = (String) admin.getFromCache(myKey, myRefreshPeriod);

} catch (NeedsRefreshException nre) {

try {

  // Cache中没有则从库获得数据.

  myValue = "This is the content retrieved.";

  // 存放在Cache中 键值myKey

  admin.putInCache(myKey, myValue);

  updated = true;

} finally {

  if (!updated) {

    // 如果Cache中的内容更新出现异常 则用这个终级方法

  admin.cancelUpdate(myKey); //取消对myKey的更新 即类似数据回滚

  }

}

}

注意:

如果一个NeedsRefreshException出现 必须调用admin.putInCache或甚至admin.cancelUpdate来避免死锁情况发生.

3.CacheFilter的应用

OScache可以是你很轻易的缓存网站中全部页面,甚至是那些2进制文件.从2.4版本开始你可以在运行期设置和覆盖CacheFilter的初始化参数.注意,只有返回状态为200的页面才会缓存. (HttpServletResponse.SC_OK).

配置CacheFilter,在Web.xml中加入如下:

<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>

<url-pattern>*.jsp</url-pattern>

</filter-mapping>

这个例子将在session范围缓存所有JSp10分钟.默认情况scope为application,时间为1小时.

如果ICacheKeyProvider不设置的话,这个CacheFilter将使用(URI+QueryString)作为缓存Key.

你可以使用下列的初始化参数来设置CacheFilter:

Parameter: time

设置缓存时间,默认是1个小时.可以设置为-1(不确定).这样他就不会过期了.除非你明确刷新它(前面说到的refresh =”true”).或者是更改这个刷新的策略.

Parameter: scope

同cache的scope. 也是有application(default)和session

Parameter: cron (NEW! Since 2.3)

同cache的scope.设置过期

Parameter: fragment (NEW! Since 2.2)

作用不太清除,用默认即可.

Parameter: nocache (NEW! Since 2.2)

定义那些页面不需要缓存.”off”---缓存所有;”sessionIdInURL”---如果session中包括这URL的则不缓存这个页面

Parameter: lastModified (NEW! Since 2.2)

定义是否把Header发送到Response中.

”off”----不发送,即便它设置在过滤链中.

“on”----如果在过滤链中则发送.

“inital”(default)----最后更改的信息将基于当前时间被设置

Parameter: max-age (NEW! Since 2.3.1)

设置在浏览器中缓存的最大时间.在设置的期间,不再向服务器请求,而是从自己的缓存中查找页面.默认是60秒.

Parameter: expires (NEW! Since 2.2)

定义过期header发送到Response中的时间.

“off”----不发送.

“on”(default)---如果在过滤链中则发送.并且time这个过期信息将基于时间参数和页面内容的创建时间初始化.

Parameter: ICacheKeyProvider (NEW! Since 2.2)

指定实现ICacheKeyProvider接口的类.

Parameter: ICacheGroupsProvider (NEW! Since 2.2)

指定实现ICacheGroupsProvider接口的类

Parameter: EntryRefreshPolicy (New! Since 2.3)

指定实现EntryRefreshPolicy接口的类.

Parameter: disableCacheOnMethods (New! Since 2.4)

指定请求方式不进行缓存.默认Null,对所有的请求方式都缓存.例如:

<init-param>

  <param-name>disableCacheOnMethods</param-name>

  <param-value>POST,PUT,DELETE</param-value>

</init-param>

Parameter: oscache-properties-file (New! Since 2.4)

通过指定OSCache的属性文件,开发者就能运行多个CacheFilter

4.OSCache的属性文件.(oscache.properties)

cache.memory

值为true或false.默认为true.如果设置为false那么缓存到数据库或硬盘中.似乎有点傻,所以我们一般不改此项.

cache.capacity

缓存元素的个数.默认是没有限制的.

cache.algorithm

缓存的算法.注意要是指定算法的话,必须把上面的缓存个数指定.这里支持三种算法.

com.opensymphony.oscache.base.algorithm.LRUCache – 最后最近使用

com.opensymphony.oscache.base.algorithm.FIFOCache – 先进先出

com.opensymphony.oscache.base.algorithm.UnlimitedCache – 无限缓存

cache.blocking

是否同步化。true 或者 false。一般设为true，避免读取脏数据。

cache.unlimited.disk

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

cache.persistence.class

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

cache.path

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

cache.persistence.overflow.only (NEW! Since 2.1)

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

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的生命周期中记录count of 所有entry的事件。 com.opensymphony.oscache.extra.CacheMapAccessEventListenerImpl －记录 count of cache map events（cache hits，misses and state hits）.

cache.key

设置ServletCacheAdministrator使用的Key.在代码中如果需要用到的话,可以通过com.opensymphony.oscache.web.ServletCacheAdministrator.DEFAULT_CACHE_KEY得到.

cache.use.host.domain.in.key

如果你的服务器是被配置到多台主机上的话,你或许想加上一个主机的名字在它生成的缓存Key上.true的话会加上.默认值是false.

附加的属性: cache.cluster.multicast.ip, cache.cluster.properties

5.小结:

OSCache的使用主要有4种：

POJO 缓存

HTTP Response 缓存

JSP Tag Library 缓存

O/R Data Access 缓存

1)、POJO 缓存

这种方式的缓存直接调用OSCache的API进行，主要用于处理页面内容会根据参数动态改变，可以将参数设置为key值来保存数据：

首先，声明成员变量：

// OSCache Adminitrator instance

private static GeneralCacheAdministrator cacheAdmin = null;

其次，进行初始化：

public RingArtistAction() {

cacheAdmin = new GeneralCacheAdministrator();

}

将POJO进行缓存：

// Cache data key and refresh period

String key = sex + ":" + place;

int refreshPeriod = Constants.getIntegerValue(Constants.OSCACHE_REFRESH_PERIOD).intValue();

try {

  // Get from the cache

artists = (Map) cacheAdmin.getFromCache(key, refreshPeriod);

} catch (NeedsRefreshException nre) {

  try {

    // Get the value (probably from the database)

int count = getArtistCount(sex, place, errors);

artists = getArtistData(sex, place, count, errors);

    // Store in the cache

cacheAdmin.putInCache(key, artists);

  } catch (Exception ex) {

    // We have the current content if we want fail-over.

artists = (Map) nre.getCacheContent();

    // It is essential that cancelUpdate is called if the

    // cached content is not rebuilt

cacheAdmin.cancelUpdate(key);

ex.printStackTrace();

  }

}

2)、HTTP Response 缓存

这种方式的缓存用来处理整个页面的内容固定，不会根据参数动态改变：

首先在web.xml中配置CacheFilter：

<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>86400</param-value>

</init-param>

<init-param>

<param-name>scope</param-name>

<param-value>application</param-value>

</init-param>

</filter>

将所有需要缓存的页面加入filter-mapping：

<filter-mapping>

<filter-name>Set Character Encoding</filter-name>

<url-pattern>/*</url-pattern>

</filter-mapping>

注意，只有返回状态为200（HttpServletResponse.SC_OK）的内容才会被缓存

3)、JSP Tag 缓存

JSP Tag缓存主要用于缓存JSP页面的局部内容：

<cache:cache key="especialcategory" cron="* 5 * * *">

<jsp:include page="/ringcategory.do" flush="true" >

<jsp:param name="ringType" value="1"/>

</jsp:include>

</cache:cache>

4)、O/R Data Access 缓存

请阅读参考资料的内容获取详情。

 

 

 

来自：http://www.360doc.com/content/10/0406/12/203871_21805801.shtml