org.apache.solr.search
Interface SolrCache

All Superinterfaces:
SolrInfoMBean
All Known Implementing Classes:
LRUCache

public interface SolrCache
extends SolrInfoMBean

Primary API for dealing with Solr's internal caches.

Version:
$Id: SolrCache.java 533176 2007-04-27 17:43:34Z otis $
Author:
yonik

Nested Class Summary
static class SolrCache.State
          Enumeration of possible States for cache instances.
 
Nested classes/interfaces inherited from interface org.apache.solr.core.SolrInfoMBean
SolrInfoMBean.Category
 
Field Summary
static java.util.logging.Logger log
           
 
Method Summary
 void clear()
          :TODO: copy from Map
 void close()
          Frees any non-memory resources
 java.lang.Object get(java.lang.Object key)
          :TODO: copy from Map
 SolrCache.State getState()
          Returns the last State set on this instance
 java.lang.Object init(java.util.Map args, java.lang.Object persistence, CacheRegenerator regenerator)
          The initialization routine.
 java.lang.String name()
          Name the Cache can be referenced with by SolrRequestHandlers.
 java.lang.Object put(java.lang.Object key, java.lang.Object value)
          :TODO: copy from Map
 void setState(SolrCache.State state)
          Set different cache states.
 int size()
          :TODO: copy from Map
 void warm(SolrIndexSearcher searcher, SolrCache old)
          Warm this cache associated with searcher using the old cache object.
 
Methods inherited from interface org.apache.solr.core.SolrInfoMBean
getCategory, getDescription, getDocs, getName, getSource, getSourceId, getStatistics, getVersion
 

Field Detail

log

static final java.util.logging.Logger log
Method Detail

init

java.lang.Object init(java.util.Map args,
                      java.lang.Object persistence,
                      CacheRegenerator regenerator)
The initialization routine. Instance specific arguments are passed in the args map.

The persistence object will exist across different lifetimes of similar caches. For example, all filter caches will share the same persistence object, sometimes at the same time (it must be threadsafe). If null is passed, then the cache implementation should create and return a new persistence object. If not null, the passed in object should be returned again.

Since it will exist across the lifetime of many caches, care should be taken to not reference any particular cache instance and prevent it from being garbage collected (no using inner classes unless they are static).

The persistence object is designed to be used as a way for statistics to accumulate across all instances of the same type of cache, however the object may be of any type desired by the cache implementation.

The CacheRegenerator is what the cache uses during auto-warming to renenerate an item in the new cache from an entry in the old cache.


name

java.lang.String name()
Name the Cache can be referenced with by SolrRequestHandlers. This method must return the identifier that the Cache instance expects SolrRequestHandlers to use when requesting access to it from the SolrIndexSearcher. It is strongly recommended that this method return the value of the "name" parameter from the init args. :TODO: verify this.


size

int size()
:TODO: copy from Map


put

java.lang.Object put(java.lang.Object key,
                     java.lang.Object value)
:TODO: copy from Map


get

java.lang.Object get(java.lang.Object key)
:TODO: copy from Map


clear

void clear()
:TODO: copy from Map


setState

void setState(SolrCache.State state)
Set different cache states. The state a cache is in can have an effect on how statistics are kept. The cache user (SolrIndexSearcher) will take care of switching cache states.


getState

SolrCache.State getState()
Returns the last State set on this instance

See Also:
setState(org.apache.solr.search.SolrCache.State)

warm

void warm(SolrIndexSearcher searcher,
          SolrCache old)
          throws java.io.IOException
Warm this cache associated with searcher using the old cache object. this and old will have the same concrete type.

Throws:
java.io.IOException

close

void close()
Frees any non-memory resources



Copyright © 2006 - 2009 The Apache Software Foundation