org.xbrlapi.aspects

Interface LabelCache

All Superinterfaces:

java.io.Serializable

All Known Implementing Classes:

MemoryLabelCache, StoreLabelCache

public interface LabelCache
extends java.io.Serializable

Label Cache

This interface defines the capabilities of aspect label caching systems.

Label caching systems are intended to improve the performance of aspect rendering systems by determining aspect and aspect value labels in advance.

Author:

Geoff Shuetrim (geoff@galexy.net)

Method Summary

Methods

Modifier and Type	Method and Description
void	cacheLabel(java.lang.Class<?> labellerClass, java.lang.String aspectId, java.lang.String valueId, java.lang.String locale, java.lang.String resourceRole, java.lang.String linkRole, java.lang.String label, boolean isFallbackLabel) Caches the given label, replacing earlier versions of such label in the cache to ensure that there is only ever one label in the cache that matches the selection criteria.
java.lang.String	getLabel(java.lang.Class<?> labellerClass, java.lang.String aspectId, java.lang.String valueId, java.lang.String locale, java.lang.String resourceRole, java.lang.String linkRole)
java.lang.String	getLabelWithoutFallback(java.lang.Class<?> labellerClass, java.lang.String aspectId, java.lang.String valueId, java.lang.String locale, java.lang.String resourceRole, java.lang.String linkRole)

Method Detail

getLabel

java.lang.String getLabel(java.lang.Class<?> labellerClass,
                        java.lang.String aspectId,
                        java.lang.String valueId,
                        java.lang.String locale,
                        java.lang.String resourceRole,
                        java.lang.String linkRole)
                          throws XBRLException

Parameters:

aspectId - the ID of the aspect - must not be null.

valueId - The id of the aspect value - must not be null.

locale - The XML language code - can be null.

resourceRole - The label resource role - can be null.

linkRole - The link role for the extended link containing the label - can be null.

Returns:

the label matching the parameters or null if there is no such label in the cache.

Throws:

XBRLException

getLabelWithoutFallback

java.lang.String getLabelWithoutFallback(java.lang.Class<?> labellerClass,
                                       java.lang.String aspectId,
                                       java.lang.String valueId,
                                       java.lang.String locale,
                                       java.lang.String resourceRole,
                                       java.lang.String linkRole)
                                         throws XBRLException

Parameters:

aspectId - the ID of the aspect - must not be null.

valueId - The id of the aspect value - must not be null.

locale - The XML language code - can be null.

resourceRole - The label resource role - can be null.

linkRole - The link role for the extended link containing the label - can be null.

Returns:

the label matching the parameters or null if there is no such label in the cache. Fallback labels (those generated by a superclass of the specified aspect labeller) are not returned.

Throws:

XBRLException

cacheLabel

void cacheLabel(java.lang.Class<?> labellerClass,
              java.lang.String aspectId,
              java.lang.String valueId,
              java.lang.String locale,
              java.lang.String resourceRole,
              java.lang.String linkRole,
              java.lang.String label,
              boolean isFallbackLabel)
                throws XBRLException

Caches the given label, replacing earlier versions of such label in the cache to ensure that there is only ever one label in the cache that matches the selection criteria.

Parameters:

aspectId - the ID of the aspect - must not be null.

valueId - The id of the aspect value - must not be null.

locale - The XML language code - can be null.

resourceRole - The label resource role - can be null.

linkRole - The link role for the extended link containing the label - can be null.

label - The label to cache - must not be null.

isFallbackLabel - true if the label is a fallback label and false otherwise.

Throws:

XBRLException