IBM WebSphere Application Server [dynacache]: Interface EntryInfo

Overview

Package

Class

Tree

Serialized

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: INNER | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

com.ibm.websphere.cache
Interface EntryInfo

All Known Subinterfaces:: FragmentInfo

public interface EntryInfo

EntryInfo and FragmentInfo objects contain metadata for caching and are attached to each cache entry. IdGenerators and MetaDataGenerators use these interfaces to define the caching metadata for an entry.

Typically a Id/MetaDataGenerator will get an entry's FragmentInfo object from the ServletCacheRequest, and use the object's set methods to configure that entry.

The following is a summary of the caching metadata for a CacheEntry:

The template. (set internally by WebSphere)
The id. (set internally by WebSphere with the output of the IdGenerator.getId() method)
The priority.
The timeLimit and expirationTime options.
The dataIds option.
The external cache group to which this entry will be pushed (FragmentInfo)

Field Summary

static int NOT_SHARED
          The entry is kept local to the JVM that executed the entry's JSP or command instead of shared across all JVMs.

static int SHARED_PULL
          The entry is shared across multiple JVMs; other JVMs get it by pulling it when needed and then storing it in its local cache for further requests.

static int SHARED_PUSH
          The entry is shared across multiple JVMs; the entry is pushed to all JVMs after its JSP or command is executed instead of waiting for the JVMs to pull it.

static int SHARED_PUSH_PULL
          The entry is shared across multiple JVMs; the id of the entry is pushed on initial creation (execution of JSP/Servlet or command) and stored in the other JVMs.

Method Summary

void addDataId(java.lang.String dataId)
          This unions a new data id into the dataIds variable.

void addTemplate(java.lang.String template)
          This adds a template to the templates variable.

java.util.Enumeration getDataIds()
          This gets the data ids from the dataIds variable.

long getExpirationTime()
          This gets the expiration time from the expirationTime variable.

java.lang.String getId()
          This gets the id variable.

boolean getPersistToDisk()
          This gets the value of the persist to disk boolean variable.

int getPriority()
          This gets the priority in the priority variable.

int getSharingPolicy()
          This gets the sharing policy in the sharingPolicy variable.

java.lang.String getTemplate()
          This gets one of the templates set on this entry info.

java.util.Enumeration getTemplates()
          This gets the templates in the templates variable.

int getTimeLimit()
          This gets the time limit on this cache entry.

boolean isBatchEnabled()
          This determines whether updates (when sharing is PUSH) are sent immediately or in an asynchronous batch fashion

boolean isNotShared()
          This determines whether the sharingPolicy is NOT_SHARED.

boolean isSharedPull()
          This determines whether the sharingPolicy is SHARED_PULL.

boolean isSharedPush()
          This determines whether the sharingPolicy is SHARED_PUSH.

void setBatchEnabled(boolean flag)
          This sets whether updates (when sharing is PUSH) are sent immediately or in an asynchronous batch fashion

void setExpirationTime(long expirationTime)
          This sets the expirationTime variable.

void setId(java.lang.String id)
          This sets the id variable.

void setPersistToDisk(boolean persistToDisk)
          This sets the persist-to-disk property in the persistToDisk variable.

void setPriority(int priority)
          This assigns the new priority to the priority variable.

void setSharingPolicy(int policy)
          This sets the sharing policy in the sharingPolicy variable.

void setTimeLimit(int timeLimit)
          This sets the time limit in the timeLimit variable.

Field Summary
`static int`	`NOT_SHARED` The entry is kept local to the JVM that executed the entry's JSP or command instead of shared across all JVMs.
`static int`	`SHARED_PULL` The entry is shared across multiple JVMs; other JVMs get it by pulling it when needed and then storing it in its local cache for further requests.
`static int`	`SHARED_PUSH` The entry is shared across multiple JVMs; the entry is pushed to all JVMs after its JSP or command is executed instead of waiting for the JVMs to pull it.
`static int`	`SHARED_PUSH_PULL` The entry is shared across multiple JVMs; the id of the entry is pushed on initial creation (execution of JSP/Servlet or command) and stored in the other JVMs.

Method Summary
`void`	`addDataId(java.lang.String dataId)` This unions a new data id into the dataIds variable.
`void`	`addTemplate(java.lang.String template)` This adds a template to the templates variable.
`java.util.Enumeration`	`getDataIds()` This gets the data ids from the dataIds variable.
`long`	`getExpirationTime()` This gets the expiration time from the expirationTime variable.
`java.lang.String`	`getId()` This gets the id variable.
`boolean`	`getPersistToDisk()` This gets the value of the persist to disk boolean variable.
`int`	`getPriority()` This gets the priority in the priority variable.
`int`	`getSharingPolicy()` This gets the sharing policy in the sharingPolicy variable.
`java.lang.String`	`getTemplate()` This gets one of the templates set on this entry info.
`java.util.Enumeration`	`getTemplates()` This gets the templates in the templates variable.
`int`	`getTimeLimit()` This gets the time limit on this cache entry.
`boolean`	`isBatchEnabled()` This determines whether updates (when sharing is PUSH) are sent immediately or in an asynchronous batch fashion
`boolean`	`isNotShared()` This determines whether the sharingPolicy is NOT_SHARED.
`boolean`	`isSharedPull()` This determines whether the sharingPolicy is SHARED_PULL.
`boolean`	`isSharedPush()` This determines whether the sharingPolicy is SHARED_PUSH.
`void`	`setBatchEnabled(boolean flag)` This sets whether updates (when sharing is PUSH) are sent immediately or in an asynchronous batch fashion
`void`	`setExpirationTime(long expirationTime)` This sets the expirationTime variable.
`void`	`setId(java.lang.String id)` This sets the id variable.
`void`	`setPersistToDisk(boolean persistToDisk)` This sets the persist-to-disk property in the persistToDisk variable.
`void`	`setPriority(int priority)` This assigns the new priority to the priority variable.
`void`	`setSharingPolicy(int policy)` This sets the sharing policy in the sharingPolicy variable.
`void`	`setTimeLimit(int timeLimit)` This sets the time limit in the timeLimit variable.

Field Detail

NOT_SHARED

public static final int NOT_SHARED

The entry is kept local to the JVM that executed the entry's JSP or command instead of shared across all JVMs. This option is useful when there is affinity between a client and web application server and the data is only used by that client (e.g., a shopping cart).

SHARED_PUSH

public static final int SHARED_PUSH

The entry is shared across multiple JVMs; the entry is pushed to all JVMs after its JSP or command is executed instead of waiting for the JVMs to pull it. Pushing these entries is delayed for a short time (which is configurable) to exploit the efficiency of batching several entries in one message. This option is useful when the entry is very heavily used by all clients (e.g., a popular product display).

SHARED_PULL

public static final int SHARED_PULL

The entry is shared across multiple JVMs; other JVMs get it by pulling it when needed and then storing it in its local cache for further requests. This option is useful when the entry is shared by all clients but is not accessed often enough between invalidations to warrant pushing it to other (e.g., a not-so-popular product display).

SHARED_PUSH_PULL

public static final int SHARED_PUSH_PULL

The entry is shared across multiple JVMs; the id of the entry is pushed on initial creation (execution of JSP/Servlet or command) and stored in the other JVMs. If the actual entry is requested, other JVMs first look to see if the id has been broadcasted previously before making a remote request for it.

Method Detail

getId

public java.lang.String getId()

This gets the id variable.

Returns:: The cache id.

setId

public void setId(java.lang.String id)

This sets the id variable.

Parameters:: The - cache id.

isBatchEnabled

public boolean isBatchEnabled()

This determines whether updates (when sharing is PUSH) are sent immediately or in an asynchronous batch fashion

Returns:: True if updates are done in a batch

setBatchEnabled

public void setBatchEnabled(boolean flag)

This sets whether updates (when sharing is PUSH) are sent immediately or in an asynchronous batch fashion

Parameters:: flag - true to enable batch updates, false otherwise.

getSharingPolicy

public int getSharingPolicy()

This gets the sharing policy in the sharingPolicy variable.

Returns:: The sharing policy.

getPersistToDisk

public boolean getPersistToDisk()

This gets the value of the persist to disk boolean variable.

Returns:: The the persist to disk.

setSharingPolicy

public void setSharingPolicy(int policy)

This sets the sharing policy in the sharingPolicy variable.

Parameters:: The - sharing policy.

setPersistToDisk

public void setPersistToDisk(boolean persistToDisk)

This sets the persist-to-disk property in the persistToDisk variable.

Parameters:: The - persistToDisk property.

isNotShared

public boolean isNotShared()

This determines whether the sharingPolicy is NOT_SHARED.

Returns:: True indicates that the sharingPolicy is NOT_SHARED.

isSharedPush

public boolean isSharedPush()

This determines whether the sharingPolicy is SHARED_PUSH.

Returns:: True indicates that the sharingPolicy is SHARED_PUSH.

isSharedPull

public boolean isSharedPull()

This determines whether the sharingPolicy is SHARED_PULL.

Returns:: True indicates that the sharingPolicy is SHARED_PULL.

getTimeLimit

public int getTimeLimit()

This gets the time limit on this cache entry.

Returns:: The time limit.

setTimeLimit

public void setTimeLimit(int timeLimit)

This sets the time limit in the timeLimit variable. Once an entry is cached, it will remain in the cache for this many seconds

Parameters:: timeLimit - The time limit.

getExpirationTime

public long getExpirationTime()

This gets the expiration time from the expirationTime variable.

Returns:: The expiration time.

setExpirationTime

public void setExpirationTime(long expirationTime)

This sets the expirationTime variable.

Parameters:: The - new expiration time.

getPriority

public int getPriority()

This gets the priority in the priority variable.

Returns:: The priority.

setPriority

public void setPriority(int priority)

This assigns the new priority to the priority variable.

Parameters:: priority - The new priority.

getTemplates

public java.util.Enumeration getTemplates()

This gets the templates in the templates variable.

Returns:: An Enumeration of the template names.

getTemplate

public java.lang.String getTemplate()

This gets one of the templates set on this entry info.

Returns:: A template name.

addTemplate

public void addTemplate(java.lang.String template)

This adds a template to the templates variable.

Parameters:: template - The new Template name.

getDataIds

public java.util.Enumeration getDataIds()

This gets the data ids from the dataIds variable.

Returns:: The Enumeration of data ids.

addDataId

public void addDataId(java.lang.String dataId)

This unions a new data id into the dataIds variable.

Parameters:: dataId - The new data id.