cache4j v0.4 API

net.sf.cache4j.impl
Class SynchronizedCache

java.lang.Object
  extended bynet.sf.cache4j.impl.SynchronizedCache
All Implemented Interfaces:
Cache, ManagedCache

public class SynchronizedCache
extends java.lang.Object
implements Cache, ManagedCache

Класс SynchronizedCache это реализация интерфейса Cache с синхронизироваными методами доступа к объектам кеша.
Получение экземпляра кеша:

     Cache _personCache = CacheFactory.getInstance().getCache("Person");
 
Получение\помещение объекта:
     Long id = ... ;
     try {
         Person person = (Person)_personCache.get(id);
         if (person != null) {
             return person;
         }
         person = loadPersonFromDb(id);
         _personCache.put(id, person);
     } catch (CacheException ce) {
         //throw new Exception(ce);
     }
 
Удаление объекта:
     Person person = ... ;
     Long id = person.getId();
     removePersonFromDb(id);
     try {
         _personCache.remove(id);
     } catch (CacheException ce) {
         //throw new Exception(ce);
     }
 

Version:
$Revision: 1.0 $ $Date:$
Author:
Yuriy Stepovoy. stepovoy@gmail.com

Constructor Summary
SynchronizedCache()
           
 
Method Summary
 void clean()
          Выполняет очистку кеша.
 void clear()
          Удаляет все объекты из кеша
 java.lang.Object get(java.lang.Object objId)
          Возвращает объект из кеша.
 CacheConfig getCacheConfig()
          Возвращает конфигруцию кеша
 CacheInfo getCacheInfo()
          Возвращает информацию о кеше
 void put(java.lang.Object objId, java.lang.Object obj)
          Помещает объект в кеш.
 void remove(java.lang.Object objId)
          Удаляет объект из кеша.
 void setCacheConfig(CacheConfig config)
          Устанавливает конфигурацию кеша.
 int size()
          Возвращает количество объектов в кеше
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

SynchronizedCache

public SynchronizedCache()
Method Detail

put

public void put(java.lang.Object objId,
                java.lang.Object obj)
         throws CacheException
Помещает объект в кеш.

Specified by:
put in interface Cache
Parameters:
objId - идентификатор объекта
obj - объект
Throws:
CacheException - если возникли проблемы, например при вычислении размера объекта
java.lang.NullPointerException - если objId==null

get

public java.lang.Object get(java.lang.Object objId)
                     throws CacheException
Возвращает объект из кеша.

Specified by:
get in interface Cache
Parameters:
objId - идентификатор объекта
Returns:
Объект возвращается только в том случае, если объект найден и время жизни объекта не закончилось и не превышено время бездействия.
Throws:
CacheException - если возникли проблемы
java.lang.NullPointerException - если objId==null

remove

public void remove(java.lang.Object objId)
            throws CacheException
Удаляет объект из кеша.

Specified by:
remove in interface Cache
Parameters:
objId - идентификатор объекта
Throws:
CacheException - если возникли проблемы
java.lang.NullPointerException - если objId==null

size

public int size()
Возвращает количество объектов в кеше

Specified by:
size in interface Cache

clear

public void clear()
           throws CacheException
Удаляет все объекты из кеша

Specified by:
clear in interface Cache
Throws:
CacheException - если возникли проблемы

getCacheInfo

public CacheInfo getCacheInfo()
Возвращает информацию о кеше

Specified by:
getCacheInfo in interface Cache

getCacheConfig

public CacheConfig getCacheConfig()
Возвращает конфигруцию кеша

Specified by:
getCacheConfig in interface Cache

setCacheConfig

public void setCacheConfig(CacheConfig config)
                    throws CacheException
Устанавливает конфигурацию кеша. При установке конфигурации все объекты кеша теряются.

Specified by:
setCacheConfig in interface ManagedCache
Parameters:
config - конфигурация
Throws:
CacheException - если возникли проблемы
java.lang.NullPointerException - если config==null

clean

public void clean()
           throws CacheException
Выполняет очистку кеша. Удаляются объекты у которых закончилось время жизни или превышен период ожидания или если объект равен null.

Specified by:
clean in interface ManagedCache
Throws:
CacheException - если возникли проблемы

cache4j v0.4 API

Copyright (c) 2006, Yuriy Stepovoy. All rights reserved. email: stepovoy@gmail.com