|
IBM WebSphere® DataPower® XC10 Appliance Release 2.5 Client API Specification |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
public interface BackingMapConfiguration
A BackingMapConfiguration object can be used to override BackingMap settings on the
client side. The com.ibm.websphere.objectgrid.plugins.Evictor
and the com.ibm.websphere.objectgrid.plugins.MapEventListener
Plugins can be overridden.
Other Evictor related settings can be adjusted as well as client, near-cache specific options.
Use the com.ibm.websphere.objectgrid.config.ObjectGridConfigFactory.createBackingMapConfiguration(String)
method to create a BackingMapConfiguration
Evictor
,
MapEventListener
,
Plugin
,
ObjectGridConfigFactory
Method Summary | |
---|---|
void |
addPlugin(Plugin plugin)
Add a Plugin to this BackingMapConfiguration. |
String |
getEvictionTriggers()
Gets the list of eviction triggers for this BackingMapConfiguration. |
com.ibm.websphere.objectgrid.OutputFormat |
getKeyOutputFormat()
Retrieves the data format for all data access APIs that return cache keys. |
String |
getName()
Get the name of this BackingMapConfiguration |
int |
getNumberOfBuckets()
Deprecated. Deprecated in 8.6. Buckets are no longer required. Use the isNearCacheEnabled() flag to disable
the near cache in the ObjectGrid configuration XML file. |
List |
getPlugins()
Get the Plugins that have been attached to this BackingMapConfiguration. |
int |
getTimeToLive()
Gets the "time to live" for each map entry. |
TTLType |
getTtlEvictorType()
Gets the "time to live" Evictor type for this BackingMapConfiguration. |
com.ibm.websphere.objectgrid.OutputFormat |
getValueOutputFormat()
Retrieves the data format for all data access APIs that return cache values. |
Boolean |
isNearCacheEnabled()
If true, the client local cache is enabled for supported configurations. |
Boolean |
isNearCacheInvalidationEnabled()
If true, clients with local caches are automatically invalidated when the data grid map is updated. |
Boolean |
isNearCacheLastAccessTTLSyncEnabled()
If true, clients automatically send time-to-live access information to the remote data grid when accessed and the TTLType.LAST_ACCESS_TIME
TTL evictor type is configured. |
void |
setEvictionTriggers(String evictionTriggers)
Sets the eviction triggers for this BackingMapConfiguration. |
void |
setKeyOutputFormat(com.ibm.websphere.objectgrid.OutputFormat dataFormat)
Sets the data format for all data access APIs that return cache keys. |
void |
setNearCacheEnabled(Boolean nearCacheEnabled)
Enables or disables the client local cache for supported configurations. |
void |
setNearCacheInvalidationEnabled(Boolean nearCacheInvalidationEnabled)
Set to true to enable client near cache invalidation. |
void |
setNearCacheLastAccessTTLSyncEnabled(Boolean nearCacheLastAccessTTLSyncEnabled)
Enables or disables time-to-live access information synchronization to the remote data grid when accessed and the TTLType.LAST_ACCESS_TIME
TTL evictor type is configured. |
void |
setNumberOfBuckets(int numBuckets)
Deprecated. Deprecated in 8.6. Buckets are no longer required. Use the isNearCacheEnabled() flag to disable
the near cache in the ObjectGrid configuration XML file. |
void |
setPlugins(List pluginList)
Set the Plugins for this BackingMapConfiguration. |
void |
setTimeToLive(int seconds)
Sets "time to live" of each BackingMap entry in seconds. |
void |
setTtlEvictorType(TTLType ttlEvictorType)
Set the "time to live" Evictor type for this BackingMapConfiguration. |
void |
setValueOutputFormat(com.ibm.websphere.objectgrid.OutputFormat dataFormat)
Sets the data format for all data access APIs that return cache values. |
Method Detail |
---|
String getName()
void addPlugin(Plugin plugin)
Plugin
to this BackingMapConfiguration. The Plugins that can be overridden on a
client-side BackingMap are com.ibm.websphere.objectgrid.plugins.Evictor
and com.ibm.websphere.objectgrid.plugins.MapEventListener
.
plugin
- setPlugins(List)
void setPlugins(List pluginList)
pluginList
- - a List of PluginsaddPlugin(Plugin)
List getPlugins()
Plugin
objectsint getNumberOfBuckets()
isNearCacheEnabled()
flag to disable
the near cache in the ObjectGrid configuration XML file.
void setNumberOfBuckets(int numBuckets)
isNearCacheEnabled()
flag to disable
the near cache in the ObjectGrid configuration XML file.
BackingMap
.
The BackingMap
implementation uses a hash map for its
implementation. If there are a lot of entries in the BackingMap
then more buckets means better performance because the risk of collisions
is lower as the number of buckets grows. More buckets also means more
concurrency.
numBuckets
- BackingMap.setNumberOfBuckets(int)
int getTimeToLive()
void setTimeToLive(int seconds)
If this method is not called, the lifetime of an entry is forever (or until
the application explicitly removes or invalidates the entry, or a user
defined Evictor
evicts the entry).
seconds
- TTLType getTtlEvictorType()
TTLType.NONE
setTtlEvictorType(TTLType) was not called- See Also:
setTimeToLive(int)
void setTtlEvictorType(TTLType ttlEvictorType)
BackingMap
entry is computed.
If this method is not called, TTLType.NONE
is used
to indicate the map entry has no expiration time (e.g. is allowed to live
until explicitly removed or invalidated by the application, or evicted
by a user defined Evictor
).
ttlEvictorType
- BackingMap.setTtlEvictorType(TTLType)
String getEvictionTriggers()
See BackingMap
for a list of valid eviction triggers.
setEvictionTriggers(String) was not called- Since:
- WAS XD 6.1.0.3
void setEvictionTriggers(String evictionTriggers)
See BackingMap
for a list of valid eviction triggers.
evictionTriggers
- a semicolon separated list of eviction triggersBoolean isNearCacheInvalidationEnabled()
void setNearCacheInvalidationEnabled(Boolean nearCacheInvalidationEnabled)
nearCacheInvalidationEnabled
- If true, the client near cache invalidation is enabled. If false, invalidation
is disabled. If null, the override is not specified and the client will use the setting from the remote data grid.Boolean isNearCacheLastAccessTTLSyncEnabled()
TTLType.LAST_ACCESS_TIME
TTL evictor type is configured.
void setNearCacheLastAccessTTLSyncEnabled(Boolean nearCacheLastAccessTTLSyncEnabled)
TTLType.LAST_ACCESS_TIME
TTL evictor type is configured.
nearCacheLastAccessTTLSyncEnabled
- If true, the last-access time-to-live information is sent to the remote data grid.
If false, the last-access information is not sent. If null, the override is not specified and the client will use the
setting from the remote data grid.Boolean isNearCacheEnabled()
void setNearCacheEnabled(Boolean nearCacheEnabled)
nearCacheEnabled
- If true, the client local cache is enabled for supported configurations. If false, the
client local cache is disabled. If null, the override is not specified and the client will use the
setting from the remote data grid.com.ibm.websphere.objectgrid.OutputFormat getKeyOutputFormat()
void setKeyOutputFormat(com.ibm.websphere.objectgrid.OutputFormat dataFormat)
dataFormat
- the data format to use or null to use the default.com.ibm.websphere.objectgrid.OutputFormat getValueOutputFormat()
void setValueOutputFormat(com.ibm.websphere.objectgrid.OutputFormat dataFormat)
dataFormat
- the data format to use or null to use the default.
|
IBM WebSphere® DataPower® XC10 Appliance Release 2.5 Client API Specification |
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |