This project has retired. For details please refer to its Attic page.

org.apache.tiles
Class BasicAttributeContext

java.lang.Object
  org.apache.tiles.BasicAttributeContext

All Implemented Interfaces:

Serializable, AttributeContext

Direct Known Subclasses:

BasicAttributeContext, Definition

public class BasicAttributeContext
extends Object
implements AttributeContext, Serializable

Basic implementation for AttributeContext.

Since:

2.1.0

Version:

$Rev: 788344 $ $Date: 2009-06-25 14:47:40 +0200 (gio, 25 giu 2009) $

See Also:

Serialized Form

Field Summary

protected Map<String,Attribute>	attributes Template attributes.
protected Map<String,Attribute>	cascadedAttributes Cascaded template attributes.
protected String	preparer Associated ViewPreparer URL or classname, if defined.
protected Attribute	templateAttribute The template attribute, to render a template.

Constructor Summary

BasicAttributeContext()
Constructor.

BasicAttributeContext(AttributeContext context)
Copy constructor.

BasicAttributeContext(BasicAttributeContext context)
Copy constructor.

BasicAttributeContext(Map<String,Attribute> attributes)
Constructor.

Method Summary

void	addAll(Map<String,Attribute> newAttributes) Add all attributes to this context.
void	addMissing(Map<String,Attribute> defaultAttributes) Add all missing attributes to this context.
void	clear() Clear the attributes.
Attribute	getAttribute(String name) Retrieve the named attribute, either cascaded or not.
Iterator<String>	getAttributeNames() Iterator of all attribute names.
Attribute	getCascadedAttribute(String name) Retrieve the attribute that has been cascaded at upper levels.
Set<String>	getCascadedAttributeNames() Returns the names of the cascaded attributes.
Attribute	getLocalAttribute(String name) Retrieve the attribute that has been defined in this context (i.e. not cascaded).
Set<String>	getLocalAttributeNames() Returns the names of the local attributes, i.e. the one that have not been cascaded.
String	getPreparer() Get associated preparer instance.
Attribute	getTemplateAttribute() Returns the attribute that will be used to render a template.
void	inherit(AttributeContext parent) Copies all missing attributes from the parent attribute context to this one.
void	inherit(BasicAttributeContext parent) Inherits the attribute context, inheriting, i.e. copying if not present, the attributes.
void	inheritCascadedAttributes(AttributeContext context) Copies the cascaded attributes to this attribute context.
void	putAttribute(String name, Attribute value) Add the specified attribute.
void	putAttribute(String name, Attribute value, boolean cascade) Add the specified attribute.
void	setPreparer(String url) Set associated preparer instance.
void	setTemplateAttribute(Attribute templateAttribute) Sets the template attribute, that will be used to render the template page.

Methods inherited from class java.lang.Object

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

Field Detail

templateAttribute

protected Attribute templateAttribute

The template attribute, to render a template.

Since:

2.1.2

preparer

protected String preparer

Associated ViewPreparer URL or classname, if defined.

Since:

2.1.0

attributes

protected Map<String,Attribute> attributes

Template attributes.

Since:

2.1.0

cascadedAttributes

protected Map<String,Attribute> cascadedAttributes

Cascaded template attributes.

Since:

2.1.0

Constructor Detail

BasicAttributeContext

public BasicAttributeContext()

Constructor.

Since:

2.1.0

BasicAttributeContext

public BasicAttributeContext(Map<String,Attribute> attributes)

Constructor. Create a context and set specified attributes.

Parameters:

attributes - Attributes to initialize context.

Since:

2.1.0

BasicAttributeContext

public BasicAttributeContext(AttributeContext context)

Copy constructor.

Parameters:

context - The constructor to copy.

Since:

2.1.0

BasicAttributeContext

public BasicAttributeContext(BasicAttributeContext context)

Copy constructor.

Parameters:

context - The constructor to copy.

Since:

2.1.0

Method Detail

getTemplateAttribute

public Attribute getTemplateAttribute()

Returns the attribute that will be used to render a template.

Specified by:

getTemplateAttribute in interface AttributeContext

Returns:

The template attribute.

setTemplateAttribute

public void setTemplateAttribute(Attribute templateAttribute)

Sets the template attribute, that will be used to render the template page.

Specified by:

setTemplateAttribute in interface AttributeContext

Parameters:

templateAttribute - The template attribute.

getPreparer

public String getPreparer()

Get associated preparer instance.

Specified by:

getPreparer in interface AttributeContext

Returns:

The preparer name.

setPreparer

public void setPreparer(String url)

Set associated preparer instance.

Specified by:

setPreparer in interface AttributeContext

Parameters:

url - The preparer name.

inheritCascadedAttributes

public void inheritCascadedAttributes(AttributeContext context)

Copies the cascaded attributes to this attribute context.

Specified by:

inheritCascadedAttributes in interface AttributeContext

Parameters:

context - The parent context to be used.

inherit

public void inherit(AttributeContext parent)

Copies all missing attributes from the parent attribute context to this one.

Specified by:

inherit in interface AttributeContext

Parameters:

parent - The attribute context to copy attributes from.

inherit

public void inherit(BasicAttributeContext parent)

Inherits the attribute context, inheriting, i.e. copying if not present, the attributes.

Parameters:

parent - The attribute context to inherit.

Since:

2.1.0

addAll

public void addAll(Map<String,Attribute> newAttributes)

Add all attributes to this context. Copies all of the mappings from the specified attribute map to this context. New attribute mappings will replace any mappings that this context had for any of the keys currently in the specified attribute map.

Specified by:

addAll in interface AttributeContext

Parameters:

newAttributes - Attributes to add.

Since:

2.1.0

addMissing

public void addMissing(Map<String,Attribute> defaultAttributes)

Add all missing attributes to this context. Copies all of the mappings from the specified attributes map to this context. New attribute mappings will be added only if they don't already exist in this context.

Specified by:

addMissing in interface AttributeContext

Parameters:

defaultAttributes - Attributes to add.

Since:

2.1.0

getAttribute

public Attribute getAttribute(String name)

Retrieve the named attribute, either cascaded or not.

Specified by:

getAttribute in interface AttributeContext

Parameters:

name - key name for the attribute.

Returns:

Attribute associated with the given name.

getLocalAttribute

public Attribute getLocalAttribute(String name)

Retrieve the attribute that has been defined in this context (i.e. not cascaded).

Specified by:

getLocalAttribute in interface AttributeContext

Parameters:

name - key name for the attribute.

Returns:

Attribute The local attribute associated with the given name, if present, or null otherwise.

getCascadedAttribute

public Attribute getCascadedAttribute(String name)

Retrieve the attribute that has been cascaded at upper levels.

Specified by:

getCascadedAttribute in interface AttributeContext

Parameters:

name - key name for the attribute.

Returns:

Attribute The cascaded attribute associated with the given name, if present, or null otherwise.

getAttributeNames

public Iterator<String> getAttributeNames()

Iterator of all attribute names.

Specified by:

getAttributeNames in interface AttributeContext

Returns:

iterator of all names.

getLocalAttributeNames

public Set<String> getLocalAttributeNames()

Returns the names of the local attributes, i.e. the one that have not been cascaded.

Specified by:

getLocalAttributeNames in interface AttributeContext

Returns:

The local attribute names.

getCascadedAttributeNames

public Set<String> getCascadedAttributeNames()

Returns the names of the cascaded attributes.

Specified by:

getCascadedAttributeNames in interface AttributeContext

Returns:

The cascaded attribute names.

putAttribute

public void putAttribute(String name,
                         Attribute value)

Add the specified attribute. The attribute value will be available only in the current context, i.e. it is like calling AttributeContext.putAttribute(String, Attribute, boolean) with cascade = false.

Specified by:

putAttribute in interface AttributeContext

Parameters:

name - name of the attribute

value - value of the attribute

putAttribute

public void putAttribute(String name,
                         Attribute value,
                         boolean cascade)

Add the specified attribute.

Specified by:

putAttribute in interface AttributeContext

Parameters:

name - name of the attribute

value - value of the attribute

cascade - If true, the attribute value will be available in all nested contexts. If false, it will be available only in the current context.

clear

public void clear()

Clear the attributes.

Specified by:

clear in interface AttributeContext