Package org.opencms.jsp.decorator

Class CmsDecoratorConfiguration

java.lang.Object

org.opencms.jsp.decorator.CmsDecoratorConfiguration

All Implemented Interfaces:

I_CmsDecoratorConfiguration

public class CmsDecoratorConfiguration
extends Object
implements I_CmsDecoratorConfiguration

The CmsDecoratorConfiguration initalizes and stores the text decorations.

It uses uses the information of one or more CmsDecorationDefintion to create the pre- and postfixs for text decorations.

Since:

6.1.3

Field Summary

Fields

Modifier and Type	Field	Description
static final String	XPATH_DECORATION	The xpath for the decoration configuration.
static final String	XPATH_EXCLUDE	The xpath for the exclude configuration.
static final String	XPATH_EXCLUDEATTR	The xpath for the exclude configuration.
static final String	XPATH_USELOCALE	The xpath for the uselocale configuration.

Constructor Summary

Constructors

Constructor	Description
CmsDecoratorConfiguration()	Constructor, creates a new, empty CmsDecoratorConfiguration.
CmsDecoratorConfiguration(CmsObject cms)	Constructor, creates a new, empty CmsDecoratorConfiguration.
CmsDecoratorConfiguration(CmsObject cms, String configFile)	Constructor, creates a new, CmsDecoratorConfiguration with a given config file.
CmsDecoratorConfiguration(CmsObject cms, String configFile, Locale locale)	Constructor, creates a new, CmsDecoratorConfiguration with a given config file and locale.

Method Summary

Modifier and Type	Method	Description
void	addDecorations(CmsDecorationDefintion decorationDefinition)	Adds decorations defined in a CmsDecorationDefintion object to the map of all decorations.
CmsObject	getCms()	Returns the cms.
String	getConfigFile()	Returns the configFile.
Locale	getConfigurationLocale()	Returns the configurationLocale.
CmsDecorationDefintion	getDecorationDefinition(CmsXmlContent configuration, int i)	Builds a CmsDecorationDefintion from a given configuration file.
List<CmsDecorationDefintion>	getDecorationDefinitions()	Returns the list with all CmsDecorationDefintion instances parsed from the config file.
CmsDecorationBundle	getDecorations()	Gets the decoration bundle.
List<String>	getExcludeattr()	Returns the excludeattr.
List<String>	getExcludes()	Returns the excludes.
Locale	getLocale()	Returns the locale.
List<String>	getUsedDecorations()	Returns the usedDecorations.
boolean	hasUsed(String key)	Tests if a decoration key was used before in this configuration.
void	init(CmsObject cms, String configFile, Locale locale)	Initialises the configuration.
boolean	isExcluded(String tag)	Tests if a tag is contained in the exclude list of the decorator.
boolean	isExcludedAttr(org.htmlparser.Tag tag)	Tests if a tag has an attribute thatis contained in the exclude list of the decorator.
void	markAsUsed(String key)	Mark a decoration key as already used.
void	resetMarkedDecorations()	Resets the used decoration keys.
void	setCms(CmsObject cms)	Sets the cms.
void	setConfigFile(String configFile)	Sets the configFile.
void	setConfigurationLocale(Locale configurationLocale)	Sets the configurationLocale.
void	setDecorationDefinitions(List<CmsDecorationDefintion> decorationDefinitions)	Sets the decorationDefinitions.
void	setDecorations(CmsDecorationBundle decorations)	Sets the decoration bundle, overwriting an exiting one.
void	setExcludeattr(List<String> excludeattr)	Sets the excludeattr.
void	setExcludes(List<String> excludes)	Sets the excludes.
void	setLocale(Locale locale)	Sets the locale.
void	setUsedDecorations(List<String> usedDecorations)	Sets the usedDecorations.
String	toString()

Methods inherited from class java.lang.Object

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

Field Details

XPATH_DECORATION

public static final String XPATH_DECORATION

The xpath for the decoration configuration.

See Also:

• Constant Field Values

XPATH_EXCLUDE

public static final String XPATH_EXCLUDE

The xpath for the exclude configuration.

See Also:

• Constant Field Values

XPATH_EXCLUDEATTR

public static final String XPATH_EXCLUDEATTR

The xpath for the exclude configuration.

See Also:

• Constant Field Values

XPATH_USELOCALE

public static final String XPATH_USELOCALE

The xpath for the uselocale configuration.

See Also:

• Constant Field Values

Constructor Details

CmsDecoratorConfiguration

public CmsDecoratorConfiguration()

Constructor, creates a new, empty CmsDecoratorConfiguration.

CmsDecoratorConfiguration

public CmsDecoratorConfiguration(CmsObject cms)
                          throws CmsException

Constructor, creates a new, empty CmsDecoratorConfiguration.

Parameters:

cms - the CmsObject

Throws:

CmsException - if something goes wrong

CmsDecoratorConfiguration

public CmsDecoratorConfiguration(CmsObject cms,
 String configFile)
                          throws CmsException

Constructor, creates a new, CmsDecoratorConfiguration with a given config file.

Parameters:

cms - the CmsObject

configFile - the configuration file

Throws:

CmsException - if something goes wrong

CmsDecoratorConfiguration

public CmsDecoratorConfiguration(CmsObject cms,
 String configFile,
 Locale locale)
                          throws CmsException

Constructor, creates a new, CmsDecoratorConfiguration with a given config file and locale.

Parameters:

cms - the CmsObject

configFile - the configuration file

locale - to locale to build this configuration for

Throws:

CmsException - if something goes wrong

Method Details

addDecorations

public void addDecorations(CmsDecorationDefintion decorationDefinition)
                    throws CmsException

Adds decorations defined in a CmsDecorationDefintion object to the map of all decorations.

Parameters:

decorationDefinition - the CmsDecorationDefintion the decorations to be added

Throws:

CmsException - if something goes wrong

getCms

public CmsObject getCms()

Returns the cms.

Returns:

the cms

getConfigFile

public String getConfigFile()

Returns the configFile.

Returns:

the configFile

getConfigurationLocale

public Locale getConfigurationLocale()

Returns the configurationLocale.

Returns:

the configurationLocale

getDecorationDefinition

public CmsDecorationDefintion getDecorationDefinition(CmsXmlContent configuration,
 int i)

Builds a CmsDecorationDefintion from a given configuration file.

Specified by:

getDecorationDefinition in interface I_CmsDecoratorConfiguration

Parameters:

configuration - the configuration file

i - the number of the decoration definition to create

Returns:

CmsDecorationDefintion created form configuration file

getDecorationDefinitions

public List<CmsDecorationDefintion> getDecorationDefinitions()

Returns the list with all CmsDecorationDefintion instances parsed from the config file.

Returns:

The list with all CmsDecorationDefintion instances parsed from the config file

getDecorations

public CmsDecorationBundle getDecorations()

Gets the decoration bundle.

Specified by:

getDecorations in interface I_CmsDecoratorConfiguration

Returns:

the decoration bundle to be used

getExcludeattr

public List<String> getExcludeattr()

Returns the excludeattr.

Returns:

the excludeattr

getExcludes

public List<String> getExcludes()

Returns the excludes.

Returns:

the excludes

getLocale

public Locale getLocale()

Returns the locale.

Returns:

the locale

getUsedDecorations

public List<String> getUsedDecorations()

Returns the usedDecorations.

Returns:

the usedDecorations

hasUsed

public boolean hasUsed(String key)

Tests if a decoration key was used before in this configuration.

Specified by:

hasUsed in interface I_CmsDecoratorConfiguration

Parameters:

key - the key to look for

Returns:

true if this key was already used

init

public void init(CmsObject cms,
 String configFile,
 Locale locale)
          throws CmsException

Description copied from interface: I_CmsDecoratorConfiguration

Initialises the configuration.

Specified by:

init in interface I_CmsDecoratorConfiguration

Parameters:

cms - the CmsObject

configFile - the configuration file

locale - to locale to build this configuration for

Throws:

CmsException - if something goes wrong

See Also:

• I_CmsDecoratorConfiguration.init(org.opencms.file.CmsObject, java.lang.String, java.util.Locale)

isExcluded

public boolean isExcluded(String tag)

Tests if a tag is contained in the exclude list of the decorator.

Specified by:

isExcluded in interface I_CmsDecoratorConfiguration

Parameters:

tag - the tag to test

Returns:

true if the tag is in the exclode list, false othwerwise.

isExcludedAttr

public boolean isExcludedAttr(org.htmlparser.Tag tag)

Description copied from interface: I_CmsDecoratorConfiguration

Tests if a tag has an attribute thatis contained in the exclude list of the decorator.

Specified by:

isExcludedAttr in interface I_CmsDecoratorConfiguration

Parameters:

tag - the tag to test

Returns:

true if the tag is in the exclude list, false otherwise.

See Also:

• I_CmsDecoratorConfiguration.isExcludedAttr(org.htmlparser.Tag)

markAsUsed

public void markAsUsed(String key)

Mark a decoration key as already used.

Specified by:

markAsUsed in interface I_CmsDecoratorConfiguration

Parameters:

key - the key to mark

resetMarkedDecorations

public void resetMarkedDecorations()

Resets the used decoration keys.

Specified by:

resetMarkedDecorations in interface I_CmsDecoratorConfiguration

setCms

public void setCms(CmsObject cms)

Sets the cms.

Parameters:

cms - the cms to set

setConfigFile

public void setConfigFile(String configFile)

Sets the configFile.

Parameters:

configFile - the configFile to set

setConfigurationLocale

public void setConfigurationLocale(Locale configurationLocale)

Sets the configurationLocale.

Parameters:

configurationLocale - the configurationLocale to set

setDecorationDefinitions

public void setDecorationDefinitions(List<CmsDecorationDefintion> decorationDefinitions)

Sets the decorationDefinitions.

Parameters:

decorationDefinitions - the decorationDefinitions to set

setDecorations

public void setDecorations(CmsDecorationBundle decorations)

Sets the decoration bundle, overwriting an exiting one.

Parameters:

decorations - new decoration bundle

setExcludeattr

public void setExcludeattr(List<String> excludeattr)

Sets the excludeattr.

Parameters:

excludeattr - the excludeattr to set

setExcludes

public void setExcludes(List<String> excludes)

Sets the excludes.

Parameters:

excludes - the excludes to set

setLocale

public void setLocale(Locale locale)

Sets the locale.

Parameters:

locale - the locale to set

setUsedDecorations

public void setUsedDecorations(List<String> usedDecorations)

Sets the usedDecorations.

Parameters:

usedDecorations - the usedDecorations to set

toString

public String toString()

Overrides:

toString in class Object

See Also:

• Object.toString()