org.craftercms.core.service.impl

Class AbstractCachedContentStoreService

java.lang.Object

org.craftercms.core.service.impl.AbstractCachedContentStoreService

All Implemented Interfaces:

ContentStoreService

Direct Known Subclasses:

ContentStoreServiceImpl

public abstract class AbstractCachedContentStoreService
extends Object
implements ContentStoreService

Abstract ContentStoreService that provides caching to actual implementations. Subclasses just have to implement the do* methods to provide the cacheable objects. Caching works the following way: when an interface method is called, and there's no cached object associated to the parameter-based compound key, the do* method of the same name is called to execute the actual method code. The returned object is then cached with the compound key.

Author:

Alfonso Vásquez

Field Summary

Fields

Modifier and Type	Field and Description
protected CacheTemplate	cacheTemplate Helper that uses an array of key elements (as the compound key) an a callback (when no cache object is found) for caching.
static String	CONST_KEY_ELEM_CHILDREN A constant added to all getChildren() cache keys.
static String	CONST_KEY_ELEM_ITEM A constant added to all getItem() cache keys.
static String	CONST_KEY_ELEM_TREE A constant added to all getTree() cache keys.
protected CachingOptions	defaultCachingOptions The default caching options to use when none are specified in the method.

Fields inherited from interface org.craftercms.core.service.ContentStoreService

UNLIMITED_TREE_DEPTH

Constructor Summary

Constructors

Constructor and Description
AbstractCachedContentStoreService()

Method Summary

Modifier and Type	Method and Description
protected abstract List<Item>	doFindChildren(Context context, CachingOptions cachingOptions, String url, ItemFilter filter, ItemProcessor processor)
protected abstract Item	doFindItem(Context context, CachingOptions cachingOptions, String url, ItemProcessor processor)
protected abstract Tree	doFindTree(Context context, CachingOptions cachingOptions, String url, int depth, ItemFilter filter, ItemProcessor processor)
List<Item>	findChildren(Context context, CachingOptions cachingOptions, String url, ItemFilter filter, ItemProcessor processor) Returns the children of the folder at the given url, returning null if the folder can't be found.
List<Item>	findChildren(Context context, String url) Returns the children of the folder at the given url, returning null if the folder can't be found.
Item	findItem(Context context, CachingOptions cachingOptions, String url, ItemProcessor processor) Returns the content store item for the given url, returning null if not found.
Item	findItem(Context context, String url) Returns the content store item for the given url, returning null if not found.
Tree	findTree(Context context, CachingOptions cachingOptions, String url, int depth, ItemFilter filter, ItemProcessor processor) Returns the folder at the given url as a tree, or null if the folder wasn't found.
Tree	findTree(Context context, String url) Returns the folder at the given url as a tree, or null if the folder wasn't found.
Tree	findTree(Context context, String url, int depth) Returns the folder at the given url as a tree, or null if the folder wasn't found.
List<Item>	getChildren(Context context, CachingOptions cachingOptions, String url, ItemFilter filter, ItemProcessor processor) Returns the children of the folder at the given url.
List<Item>	getChildren(Context context, String url) Returns the children of the folder at the given url.
Item	getItem(Context context, CachingOptions cachingOptions, String url, ItemProcessor processor) Returns the content store item for the given url.
Item	getItem(Context context, String url) Returns the content store item for the given url.
Tree	getTree(Context context, CachingOptions cachingOptions, String url, int depth, ItemFilter filter, ItemProcessor processor) Returns the folder at the given url as a tree.
Tree	getTree(Context context, String url) Returns the folder at the given url as a tree.
Tree	getTree(Context context, String url, int depth) Returns the folder at the given url as a tree.
void	setCacheTemplate(CacheTemplate cacheTemplate) Sets the CacheTemplate, which is used as a helper for caching.
void	setDefaultCachingOptions(CachingOptions defaultCachingOptions) Sets the default caching options to use when none are specified in the method.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.craftercms.core.service.ContentStoreService

createContext, destroyContext, exists, findContent, findContent, getContent, getContent, getContext, validate

Field Detail

CONST_KEY_ELEM_ITEM

public static final String CONST_KEY_ELEM_ITEM

A constant added to all getItem() cache keys.

See Also:

Constant Field Values

CONST_KEY_ELEM_CHILDREN

public static final String CONST_KEY_ELEM_CHILDREN

A constant added to all getChildren() cache keys.

See Also:

Constant Field Values

CONST_KEY_ELEM_TREE

public static final String CONST_KEY_ELEM_TREE

A constant added to all getTree() cache keys.

See Also:

Constant Field Values

cacheTemplate

protected CacheTemplate cacheTemplate

Helper that uses an array of key elements (as the compound key) an a callback (when no cache object is found) for caching.

defaultCachingOptions

protected CachingOptions defaultCachingOptions

The default caching options to use when none are specified in the method. Can be null.

Constructor Detail

AbstractCachedContentStoreService

public AbstractCachedContentStoreService()

Method Detail

setCacheTemplate

public void setCacheTemplate(CacheTemplate cacheTemplate)

Sets the CacheTemplate, which is used as a helper for caching.

setDefaultCachingOptions

public void setDefaultCachingOptions(CachingOptions defaultCachingOptions)

Sets the default caching options to use when none are specified in the method. Can be null.

findItem

public Item findItem(Context context,
                     String url)
              throws InvalidContextException,
                     XmlFileParseException,
                     XmlMergeException,
                     ItemProcessingException,
                     StoreException

Description copied from interface: ContentStoreService

Returns the content store item for the given url, returning null if not found. See Item for the types of files an item can be.

Specified by:

findItem in interface ContentStoreService

Parameters:

context - the context with the store configuration (required)

url - the url of the item (required)

Returns:

the item

Throws:

InvalidContextException - if the context is invalid

XmlFileParseException - if there was an error while parsing the item's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing the item

StoreException - if an error occurred while accessing the content store

findItem

public Item findItem(Context context,
                     CachingOptions cachingOptions,
                     String url,
                     ItemProcessor processor)
              throws InvalidContextException,
                     XmlFileParseException,
                     XmlMergeException,
                     ItemProcessingException,
                     StoreException

Description copied from interface: ContentStoreService

Returns the content store item for the given url, returning null if not found. See Item for the types of files an item can be.

Specified by:

findItem in interface ContentStoreService

Parameters:

context - the context to the content store (required)

cachingOptions - the caching options for any caching operation done inside this service call (optional)

url - the url of the item (optional, can be null)

processor - additional ItemProcessor (optional, can be null)

Returns:

the item

Throws:

InvalidContextException - if the context is invalid

XmlFileParseException - if there was an error while parsing the item's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing the item

StoreException - if an error occurred while accessing the content store

getItem

public Item getItem(Context context,
                    String url)
             throws InvalidContextException,
                    PathNotFoundException,
                    XmlFileParseException,
                    XmlMergeException,
                    ItemProcessingException,
                    StoreException

Description copied from interface: ContentStoreService

Returns the content store item for the given url. See Item for the types of files an item can be.

Specified by:

getItem in interface ContentStoreService

Parameters:

context - the context with the store configuration (required)

url - the url of the item (required)

Returns:

the item

Throws:

InvalidContextException - if the context is invalid

PathNotFoundException - if the file the url points to can't be found

XmlFileParseException - if there was an error while parsing the item's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing the item

StoreException - if an error occurred while accessing the content store

getItem

public Item getItem(Context context,
                    CachingOptions cachingOptions,
                    String url,
                    ItemProcessor processor)
             throws InvalidContextException,
                    PathNotFoundException,
                    XmlFileParseException,
                    XmlMergeException,
                    ItemProcessingException,
                    StoreException

Description copied from interface: ContentStoreService

Returns the content store item for the given url. See Item for the types of files an item can be.

Specified by:

getItem in interface ContentStoreService

Parameters:

context - the context to the content store (required)

cachingOptions - the caching options for any caching operation done inside this service call (optional)

url - the url of the item (optional, can be null)

processor - additional ItemProcessor (optional, can be null)

Returns:

the item

Throws:

InvalidContextException - if the context is invalid

PathNotFoundException - if the file the url points to can't be found

XmlFileParseException - if there was an error while parsing the item's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing the item

StoreException - if an error occurred while accessing the content store

findChildren

public List<Item> findChildren(Context context,
                               String url)
                        throws InvalidContextException,
                               XmlFileParseException,
                               XmlMergeException,
                               ItemProcessingException,
                               StoreException

Description copied from interface: ContentStoreService

Returns the children of the folder at the given url, returning null if the folder can't be found.

Specified by:

findChildren in interface ContentStoreService

Parameters:

context - the context to the content store (required)

url - the url of the folder (required)

Returns:

the children of the folder

Throws:

InvalidContextException - if the context is invalid

XmlFileParseException - if there was an error while parsing a children's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing an item

StoreException - if an error occurred while accessing the content store

findChildren

public List<Item> findChildren(Context context,
                               CachingOptions cachingOptions,
                               String url,
                               ItemFilter filter,
                               ItemProcessor processor)
                        throws InvalidContextException,
                               XmlFileParseException,
                               XmlMergeException,
                               ItemProcessingException,
                               StoreException

Description copied from interface: ContentStoreService

Returns the children of the folder at the given url, returning null if the folder can't be found.

Specified by:

findChildren in interface ContentStoreService

Parameters:

context - the context to the content store (required)

cachingOptions - the caching options for any caching operation done inside this service call (optional)

url - the url of the folder (required)

filter - an ItemFilter to filter out undesired children (optional, can be null)

processor - additional ItemProcessor for the children (optional, can be null)

Returns:

the children of the folder

Throws:

InvalidContextException - if the context is invalid

XmlFileParseException - if there was an error while parsing a children's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing an item

StoreException - if an error occurred while accessing the content store

getChildren

public List<Item> getChildren(Context context,
                              String url)
                       throws InvalidContextException,
                              PathNotFoundException,
                              XmlFileParseException,
                              XmlMergeException,
                              ItemProcessingException,
                              StoreException

Description copied from interface: ContentStoreService

Returns the children of the folder at the given url.

Specified by:

getChildren in interface ContentStoreService

Parameters:

context - the context to the content store (required)

url - the url of the folder (required)

Returns:

the children of the folder

Throws:

InvalidContextException - if the context is invalid

PathNotFoundException - if the folder the url points to can't be found

XmlFileParseException - if there was an error while parsing a children's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing an item

StoreException - if an error occurred while accessing the content store

getChildren

public List<Item> getChildren(Context context,
                              CachingOptions cachingOptions,
                              String url,
                              ItemFilter filter,
                              ItemProcessor processor)
                       throws InvalidContextException,
                              PathNotFoundException,
                              XmlFileParseException,
                              XmlMergeException,
                              ItemProcessingException,
                              StoreException

Description copied from interface: ContentStoreService

Returns the children of the folder at the given url.

Specified by:

getChildren in interface ContentStoreService

Parameters:

context - the context to the content store (required)

cachingOptions - the caching options for any caching operation done inside this service call (optional)

url - the url of the folder (required)

filter - an ItemFilter to filter out undesired children (optional, can be null)

processor - additional ItemProcessor for the children (optional, can be null)

Returns:

the children of the folder

Throws:

InvalidContextException - if the context is invalid

PathNotFoundException - if the folder the url points to can't be found

XmlFileParseException - if there was an error while parsing a children's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing an item

StoreException - if an error occurred while accessing the content store

findTree

public Tree findTree(Context context,
                     String url)
              throws InvalidContextException,
                     XmlFileParseException,
                     XmlMergeException,
                     ItemProcessingException,
                     StoreException

Description copied from interface: ContentStoreService

Returns the folder at the given url as a tree, or null if the folder wasn't found. The tree children are returned as Items when they're files and as Trees when they're folders. The tree depth is ContentStoreService.UNLIMITED_TREE_DEPTH.

Specified by:

findTree in interface ContentStoreService

Parameters:

context - the context to the content store (required)

url - the url of the folder (required)

Returns:

the folder as a tree

Throws:

InvalidContextException - if the context is invalid

XmlFileParseException - if there was an error while parsing a children's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing an item

StoreException - if an error occurred while accessing the content store

findTree

public Tree findTree(Context context,
                     String url,
                     int depth)
              throws InvalidContextException,
                     XmlFileParseException,
                     XmlMergeException,
                     ItemProcessingException,
                     StoreException

Description copied from interface: ContentStoreService

Returns the folder at the given url as a tree, or null if the folder wasn't found. The tree children are returned as Items when they're files and as Trees when they're folders.

Specified by:

findTree in interface ContentStoreService

Parameters:

context - the context to the content store (required)

url - the url of the folder (required)

depth - the number of levels the tree should have. Use #UNLIMITED_TREE_DEPTH when you want the tree to include all files/folder until the bottom of the folder hierarchy (required)

Returns:

the folder as a tree

Throws:

InvalidContextException - if the context is invalid

XmlFileParseException - if there was an error while parsing a children's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing an item

StoreException - if an error occurred while accessing the content store

findTree

public Tree findTree(Context context,
                     CachingOptions cachingOptions,
                     String url,
                     int depth,
                     ItemFilter filter,
                     ItemProcessor processor)
              throws InvalidContextException,
                     XmlFileParseException,
                     XmlMergeException,
                     ItemProcessingException,
                     StoreException

Description copied from interface: ContentStoreService

Returns the folder at the given url as a tree, or null if the folder wasn't found. The tree children are returned as Items when they're files and as Trees when they're folders.

Specified by:

findTree in interface ContentStoreService

Parameters:

context - the context to the content store (required)

cachingOptions - the caching options for any caching operation done inside this service call (optional)

url - the url of the folder (required)

depth - the number of levels the tree should have. Use #UNLIMITED_TREE_DEPTH when you want the tree to include all files/folder until the bottom of the folder hierarchy (required)

filter - an ItemFilter to filter out undesired items in the tree (optional, can be null)

processor - additional ItemProcessor for the tree's items (optional, can be null)

Returns:

the folder as a tree

Throws:

InvalidContextException - if the context is invalid

XmlFileParseException - if there was an error while parsing a children's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing an item

StoreException - if an error occurred while accessing the content store

getTree

public Tree getTree(Context context,
                    String url)
             throws InvalidContextException,
                    PathNotFoundException,
                    XmlFileParseException,
                    XmlMergeException,
                    ItemProcessingException,
                    StoreException

Description copied from interface: ContentStoreService

Returns the folder at the given url as a tree. The tree children are returned as Items when they're files and as Trees when they're folders. The tree depth is ContentStoreService.UNLIMITED_TREE_DEPTH.

Specified by:

getTree in interface ContentStoreService

Parameters:

context - the context to the content store (required)

url - the url of the folder (required)

Returns:

the folder as a tree

Throws:

InvalidContextException - if the context is invalid

PathNotFoundException - if the folder the url points to can't be found

XmlFileParseException - if there was an error while parsing a children's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing an item

StoreException - if an error occurred while accessing the content store

getTree

public Tree getTree(Context context,
                    String url,
                    int depth)
             throws InvalidContextException,
                    PathNotFoundException,
                    XmlFileParseException,
                    XmlMergeException,
                    ItemProcessingException,
                    StoreException

Description copied from interface: ContentStoreService

Returns the folder at the given url as a tree. The tree children are returned as Items when they're files and as Trees when they're folders.

Specified by:

getTree in interface ContentStoreService

Parameters:

context - the context to the content store (required)

url - the url of the folder (required)

depth - the number of levels the tree should have. Use #UNLIMITED_TREE_DEPTH when you want the tree to include all files/folder until the bottom of the folder hierarchy (required)

Returns:

the folder as a tree

Throws:

InvalidContextException - if the context is invalid

PathNotFoundException - if the folder the url points to can't be found

XmlFileParseException - if there was an error while parsing a children's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing an item

StoreException - if an error occurred while accessing the content store

getTree

public Tree getTree(Context context,
                    CachingOptions cachingOptions,
                    String url,
                    int depth,
                    ItemFilter filter,
                    ItemProcessor processor)
             throws InvalidContextException,
                    PathNotFoundException,
                    XmlFileParseException,
                    XmlMergeException,
                    ItemProcessingException,
                    StoreException

Description copied from interface: ContentStoreService

Returns the folder at the given url as a tree. The tree children are returned as Items when they're files and as Trees when they're folders.

Specified by:

getTree in interface ContentStoreService

Parameters:

context - the context to the content store (required)

cachingOptions - the caching options for any caching operation done inside this service call (optional)

url - the url of the folder (required)

depth - the number of levels the tree should have. Use #UNLIMITED_TREE_DEPTH when you want the tree to include all files/folder until the bottom of the folder hierarchy (required)

filter - an ItemFilter to filter out undesired items in the tree (optional, can be null)

processor - additional ItemProcessor for the tree's items (optional, can be null)

Returns:

the folder as a tree

Throws:

InvalidContextException - if the context is invalid

PathNotFoundException - if the folder the url points to can't be found

XmlFileParseException - if there was an error while parsing a children's XML descriptor

XmlMergeException - if there was an error while attempting to do a merge of XML descriptors

ItemProcessingException - if there was an error while processing an item

StoreException - if an error occurred while accessing the content store

doFindItem

protected abstract Item doFindItem(Context context,
                                   CachingOptions cachingOptions,
                                   String url,
                                   ItemProcessor processor)
                            throws InvalidContextException,
                                   XmlFileParseException,
                                   XmlMergeException,
                                   ItemProcessingException,
                                   StoreException

Throws:

InvalidContextException

XmlFileParseException

XmlMergeException

ItemProcessingException

StoreException

doFindChildren

protected abstract List<Item> doFindChildren(Context context,
                                             CachingOptions cachingOptions,
                                             String url,
                                             ItemFilter filter,
                                             ItemProcessor processor)
                                      throws InvalidContextException,
                                             XmlFileParseException,
                                             XmlMergeException,
                                             ItemProcessingException,
                                             StoreException

Throws:

InvalidContextException

XmlFileParseException

XmlMergeException

ItemProcessingException

StoreException

doFindTree

protected abstract Tree doFindTree(Context context,
                                   CachingOptions cachingOptions,
                                   String url,
                                   int depth,
                                   ItemFilter filter,
                                   ItemProcessor processor)
                            throws InvalidContextException,
                                   XmlFileParseException,
                                   XmlMergeException,
                                   ItemProcessingException,
                                   StoreException

Throws:

InvalidContextException

XmlFileParseException

XmlMergeException

ItemProcessingException

StoreException