|
© 2005 BEA Systems, Inc. | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.bea.p13n.content.ContentCache
An object to help with caching content.
This object can placed anywhere for use as a cache. For convience, the
getContentCache
method can be used with a JSP
PageContext to create and utilize ContentCaches.
Additionally, this is what the <cm:select>
and
<cm:selectById>
tags use when useCache="true".>
Field Summary | |
protected Map |
cache
Deprecated. The cache of id to ContentHolder. |
static String |
DEF_CACHE_NAME
Deprecated. The default name of the ContentCache in the various locations ("wlps.content.cache"). |
static String |
SESSION_NAME
Deprecated. Use DEF_CACHE_NAME instead. |
Constructor Summary | |
ContentCache()
Deprecated. Constructor. |
Method Summary | |
static void |
bindToSession(ContentCache cache,
HttpSession session)
Deprecated. Bind a ContentCache into an HttpSession. |
void |
clear()
Deprecated. Clear the entire cache. |
static Object |
getAttribute(PageContext ctx,
String name,
int scope)
Deprecated. Get a scoped attribute correctly from the JSP page context. |
long |
getCachedTime(String id)
Deprecated. Get the UTC time (in ms.) of when the Content at id was cached. |
List |
getCacheIds()
Deprecated. Get an unordered list of all the cache ids. |
long |
getCacheSize()
Deprecated. Get the total number of Content objects cached (across all ids). |
Content[] |
getContent(String id,
long timeout)
Deprecated. Check the cache for the content. |
static ContentCache |
getContentCache(PageContext ctx,
int scope,
boolean create)
Deprecated. Get a ContentCache from the specified JSP context. |
static ContentCache |
getContentCache(PageContext ctx,
String scopeStr,
boolean create)
Deprecated. Get a ContentCache from the specified JSP context. |
static ContentCache |
getFromSession(HttpSession session,
boolean create)
Deprecated. Get a ContentCache from an HttpSession. |
int |
getNumCacheIds()
Deprecated. Get the number of cache ids in the cache. |
static String |
getScopeName(int scope)
Deprecated. Get the scope name based upon the scope id. |
Content[] |
remove(String id)
Deprecated. Clear a particular entry from the cache. |
static void |
removeAttribute(PageContext ctx,
String name,
int scope)
Deprecated. Remove a scoped attribute correctly from the JSP page context. |
static void |
setAttribute(PageContext ctx,
String name,
Object val,
int scope)
Deprecated. Set a scoped attribute correctly in the JSP page context. |
void |
update(String id,
Content[] content)
Deprecated. Update the cache with the content. |
void |
valueBound(HttpSessionBindingEvent evt)
Deprecated. Called when we're bound into an HttpSession. |
void |
valueUnbound(HttpSessionBindingEvent evt)
Deprecated. Called when we're unbound from an HttpSession, and clears the cache. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Field Detail |
protected Map cache
public static final String DEF_CACHE_NAME
When the getContentCache
method is used,
this is the name which will used.
public static final String SESSION_NAME
This is set to DEF_CACHE_NAME
.
Constructor Detail |
public ContentCache()
Method Detail |
public static void bindToSession(ContentCache cache, HttpSession session)
This will use DEF_CACHE_NAME
as the session
attribute name for the cache.
cache
- the content cache object.session
- the http session.public void clear()
public static Object getAttribute(PageContext ctx, String name, int scope)
ctx
- the JSP page context.name
- the attribute name.scope
- the attribute scope (PageContext.APPLICATION_SCOPE,
PageContext.PAGE_SCOPE, PageContext.REQUEST_SCOPE,
PageContext.SESSION_SCOPE).public long getCachedTime(String id)
id
- the cache id of the content.
public List getCacheIds()
Since the keys will all be Strings, this can be sorted with
Collections.sort(java.util.List)
.
public long getCacheSize()
public Content[] getContent(String id, long timeout)
Getting content from the cache does not update its time in terms of
a timeout. Only using the update(java.lang.String, com.bea.p13n.content.Content[])
method to update the cache
will do that.
id
- the cache id of the content.timeout
- the timeout in ms. for the content (less than 0 for no
timeout).
public static ContentCache getContentCache(PageContext ctx, int scope, boolean create)
This will retrieve the ContentCache from the JSP context based upon
the specified scope at the attribute named
DEF_CACHE_NAME
. If that is set and is not a
ContentCache, it will be removed.
ctx
- the JSP page context.scope
- the cache scope (one of PageContext.APPLICATION_SCOPE,
PageContext.PAGE_SCOPE, PageContext.REQUEST_SCOPE, or
PageContext.SESSION_SCOPE).create
- true to create a ContentCache if it's not there, false to
not and return null.
public static ContentCache getContentCache(PageContext ctx, String scopeStr, boolean create)
If scopeStr is "application", then PageContext.APPLICATION_SCOPE is used; if scopeStr is "page", then PageContext.PAGE_SCOPE is used; if scopeStr is "request", then PageContext.REQUEST_SCOPE is used; if scopeStr is "session", then PageContext.SESSION_SCOPE is used; otherwise, scopeStr is passed to ctx.getAttributesScope() which will determine the scope to use.
ctx
- the JSP page context.scopeStr
- the scope name.create
- true to create a ContentCache if it's not there, false to
not and return null.
public static ContentCache getFromSession(HttpSession session, boolean create)
This will retrieve the cache from the session attribute named
DEF_CACHE_NAME
. If that is set and is not a
ContentCache, it will be removed.
session
- the http session.create
- true to create a ContentCache if it's not there, false to
not and return null.
public int getNumCacheIds()
public static String getScopeName(int scope)
public Content[] remove(String id)
id
- the cache id of the content.
public static void removeAttribute(PageContext ctx, String name, int scope)
ctx
- the JSP page context.name
- the attribute name.scope
- the attribute scope (PageContext.APPLICATION_SCOPE,
PageContext.PAGE_SCOPE, PageContext.REQUEST_SCOPE,
PageContext.SESSION_SCOPE).public static void setAttribute(PageContext ctx, String name, Object val, int scope)
ctx
- the JSP page context.name
- the attribute name.val
- the attribute value.scope
- the attribute scope (PageContext.APPLICATION_SCOPE,
PageContext.PAGE_SCOPE, PageContext.REQUEST_SCOPE,
PageContext.SESSION_SCOPE).public void update(String id, Content[] content)
This can be used for new or existing content in the cache.
id
- cache id of the content.content
- the Content (null to remove).public void valueBound(HttpSessionBindingEvent evt)
valueBound
in interface HttpSessionBindingListener
public void valueUnbound(HttpSessionBindingEvent evt)
valueUnbound
in interface HttpSessionBindingListener
clear()
|
© 2005 BEA Systems, Inc. | |||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |