org.opencms.xml.types
Class A_CmsXmlContentValue

java.lang.Object
  org.opencms.xml.types.A_CmsXmlContentValue

All Implemented Interfaces:

java.lang.Comparable<I_CmsXmlSchemaType>, I_CmsWidgetParameter, I_CmsXmlContentValue, I_CmsXmlSchemaType

Direct Known Subclasses:

A_CmsXmlValueCdataBase, A_CmsXmlValueTextBase, CmsXmlCategoryValue, CmsXmlHtmlValue, CmsXmlNestedContentDefinition, CmsXmlVarLinkValue, CmsXmlVfsFileValue

public abstract class A_CmsXmlContentValue
extends java.lang.Object
implements I_CmsXmlContentValue, I_CmsWidgetParameter

Base class for XML content value implementations.

Since:

6.0.0

Field Summary

protected java.lang.String	m_defaultValue The default value for nodes of this value.
protected I_CmsXmlDocument	m_document The XML content instance this value belongs to.
protected org.dom4j.Element	m_element The XML element node that contains this value.
protected java.util.Locale	m_locale The locale this value was generated for.
protected int	m_maxOccurs The maximum occurrences of this value according to the parent schema.
protected int	m_minOccurs The minimum occurrences of this value according to the parent schema.
protected java.lang.String	m_name The configured XML node name of this value.

Fields inherited from interface org.opencms.xml.types.I_CmsXmlSchemaType

XSI_NAMESPACE, XSI_NAMESPACE_ATTRIBUTE_NO_SCHEMA_LOCATION

Constructor Summary

protected	A_CmsXmlContentValue() Default constructor for a XML content type that initializes some internal values.
protected	A_CmsXmlContentValue(I_CmsXmlDocument document, org.dom4j.Element element, java.util.Locale locale, I_CmsXmlSchemaType type) Initializes the required members for this XML content value.
protected	A_CmsXmlContentValue(java.lang.String name, java.lang.String minOccurs, java.lang.String maxOccurs) Initializes the schema type descriptor values for this type descriptor.

Method Summary

void	appendXmlSchema(org.dom4j.Element root) Appends an element XML representation of this type to the given root node.
int	compareTo(I_CmsXmlSchemaType obj)
boolean	equals(java.lang.Object obj)
org.dom4j.Element	generateXml(CmsObject cms, I_CmsXmlDocument document, org.dom4j.Element root, java.util.Locale locale) Appends an XML for a new, empty node of this schema type to the given root element.
int	getChoiceMaxOccurs() Returns the maximum occurrences of choice options for this type in the current schema.
CmsXmlContentDefinition	getContentDefinition() Returns the content definition this schema type belongs to.
java.lang.String	getDefault(CmsObject cms) Returns the default value of this parameter.
java.lang.String	getDefault(java.util.Locale locale) Returns the default value for a node of this type in the current schema.
I_CmsXmlDocument	getDocument() Returns the XML content instance this value belongs to.
org.dom4j.Element	getElement() Returns the original XML element of this XML content value.
java.lang.String	getId() Returns the form id of this parameter.
int	getIndex() Returns the node index of this XML content value in the source XML document, starting with 0, with special handling of elements in choice groups.
java.lang.String	getKey() Returns the localized key identificator of this parameter.
java.util.Locale	getLocale() Returns the locale of this XML content value was generated for.
int	getMaxIndex() Returns the total number of XML elements of this type that currently exist in the source document.
int	getMaxOccurs() Returns the maximum occurrences of this type.
int	getMinOccurs() Returns the minimum occurrences of this type.
java.lang.String	getName() Returns the name.
java.lang.String	getPath() Returns the path of this XML content value in the source document.
java.lang.String	getPlainText(CmsObject cms) Returns the value of this XML content node as a plain text String.
protected CmsRelationType	getRelationType(java.lang.String path) Returns the relation type for the given path.
int	getXmlIndex() Returns the node index of this XML content value in the source XML document, starting with 0, based on the XML ordering.
boolean	hasError() Returns true if this widgets value contains an error.
int	hashCode()
boolean	isChoiceOption() Returns true if this type is an option inside of a choice sequence.
boolean	isChoiceType() Returns true if this type defines a choice sequence.
boolean	isSearchable() The default implementation always returns true.
boolean	isSimpleType() Returns true if this is a simple type, or false if this type is a nested schema.
void	moveDown() Moves this XML content value one position down in the source document, if possible.
void	moveUp() Moves this XML content value one position up in the source document, if possible.
protected void	moveValue(int step) Moves this XML content element up or down in the XML document.
protected java.lang.String	readSchemaDefinition(java.lang.String schemaUri) Convenience method to loads the XML schema definition for this value type from an external file.
void	setContentDefinition(CmsXmlContentDefinition contentDefinition) Sets the content definition this schema type belongs to.
void	setDefault(java.lang.String defaultValue) Sets the default value for a node of this type.
void	setKeyPrefix(java.lang.String prefix) Sets an optional localized key prefix identificator of this parameter.
java.lang.String	toString()
boolean	validateValue(java.lang.String value) Checks if a given value is valid according to the validation rule (regular expression) used for validation of this schema type in the XML schema.

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.opencms.xml.types.I_CmsXmlContentValue

getStringValue, setStringValue

Methods inherited from interface org.opencms.xml.types.I_CmsXmlSchemaType

createValue, getSchemaDefinition, getTypeName, newInstance

Methods inherited from interface org.opencms.widgets.I_CmsWidgetParameter

getStringValue, setStringValue

Field Detail

m_defaultValue

protected java.lang.String m_defaultValue

The default value for nodes of this value.

m_document

protected I_CmsXmlDocument m_document

The XML content instance this value belongs to.

m_element

protected org.dom4j.Element m_element

The XML element node that contains this value.

m_locale

protected java.util.Locale m_locale

The locale this value was generated for.

m_maxOccurs

protected int m_maxOccurs

The maximum occurrences of this value according to the parent schema.

m_minOccurs

protected int m_minOccurs

The minimum occurrences of this value according to the parent schema.

m_name

protected java.lang.String m_name

The configured XML node name of this value.

Constructor Detail

A_CmsXmlContentValue

protected A_CmsXmlContentValue()

Default constructor for a XML content type that initializes some internal values.

A_CmsXmlContentValue

protected A_CmsXmlContentValue(I_CmsXmlDocument document,
                               org.dom4j.Element element,
                               java.util.Locale locale,
                               I_CmsXmlSchemaType type)

Initializes the required members for this XML content value.

Parameters:

document - the XML content instance this value belongs to

element - the XML element that contains this value

locale - the locale this value is created for

type - the type instance to create the value for

A_CmsXmlContentValue

protected A_CmsXmlContentValue(java.lang.String name,
                               java.lang.String minOccurs,
                               java.lang.String maxOccurs)

Initializes the schema type descriptor values for this type descriptor.

Parameters:

name - the name of the XML node containing the value according to the XML schema

minOccurs - minimum number of occurrences of this type according to the XML schema

maxOccurs - maximum number of occurrences of this type according to the XML schema

Method Detail

appendXmlSchema

public void appendXmlSchema(org.dom4j.Element root)

Appends an element XML representation of this type to the given root node.

Specified by:

appendXmlSchema in interface I_CmsXmlSchemaType

Parameters:

root - the element to append the XML to

compareTo

public int compareTo(I_CmsXmlSchemaType obj)

Specified by:

compareTo in interface java.lang.Comparable<I_CmsXmlSchemaType>

See Also:

Comparable.compareTo(java.lang.Object)

equals

public boolean equals(java.lang.Object obj)

Overrides:

equals in class java.lang.Object

See Also:

Object.equals(java.lang.Object)

generateXml

public org.dom4j.Element generateXml(CmsObject cms,
                                     I_CmsXmlDocument document,
                                     org.dom4j.Element root,
                                     java.util.Locale locale)

Description copied from interface: I_CmsXmlSchemaType

Appends an XML for a new, empty node of this schema type to the given root element.

This is used to dynamically build a vaild XML content object from an initialized CmsXmlContentDefinition class.

Important: This method can only be used during initialization of a XML content object, not to add values to an already initialized XML content. To add values after initialization, use CmsXmlContent.addValue(CmsObject, String, Locale, int).

Specified by:

generateXml in interface I_CmsXmlSchemaType

Parameters:

cms - the current users OpenCms context

document - the document the XML is generated for

root - the element to append the XML to

locale - the locale to generate the element default content for

Returns:

the generated XML element

See Also:

I_CmsXmlSchemaType.generateXml(org.opencms.file.CmsObject, org.opencms.xml.I_CmsXmlDocument, org.dom4j.Element, java.util.Locale)

getChoiceMaxOccurs

public int getChoiceMaxOccurs()

Description copied from interface: I_CmsXmlSchemaType

Returns the maximum occurrences of choice options for this type in the current schema.

This will be greater than 0 only if I_CmsXmlSchemaType.isChoiceType() is true.

Specified by:

getChoiceMaxOccurs in interface I_CmsXmlSchemaType

Returns:

the maximum occurrences of choice options for this type in the current schema

See Also:

I_CmsXmlSchemaType.getChoiceMaxOccurs()

getContentDefinition

public CmsXmlContentDefinition getContentDefinition()

Description copied from interface: I_CmsXmlSchemaType

Returns the content definition this schema type belongs to.

If the value belongs to a nested content, then the nested content definition is returned. This means that for documents with nested schemas, the content definition of a value is not necessarily equal to the content definition of the document itself, which can be obtained using I_CmsXmlContentValue.getDocument().

Specified by:

getContentDefinition in interface I_CmsXmlSchemaType

Returns:

the content definition this schema type belongs to

See Also:

I_CmsXmlSchemaType.getContentDefinition()

getDefault

public java.lang.String getDefault(CmsObject cms)

Description copied from interface: I_CmsWidgetParameter

Returns the default value of this parameter.

If no default value has been provided, null is returned.

Specified by:

getDefault in interface I_CmsWidgetParameter

Parameters:

cms - an initialized instance of an OpenCms user context

Returns:

the default value of this parameter

See Also:

I_CmsWidgetParameter.getDefault(org.opencms.file.CmsObject)

getDefault

public java.lang.String getDefault(java.util.Locale locale)

Description copied from interface: I_CmsXmlSchemaType

Returns the default value for a node of this type in the current schema.

Specified by:

getDefault in interface I_CmsXmlSchemaType

Parameters:

locale - the locale to generate the default value for

Returns:

the default value for a node of this type in the current schema

See Also:

I_CmsXmlSchemaType.getDefault(java.util.Locale)

getDocument

public I_CmsXmlDocument getDocument()

Description copied from interface: I_CmsXmlContentValue

Returns the XML content instance this value belongs to.

Specified by:

getDocument in interface I_CmsXmlContentValue

Returns:

the XML content instance this value belongs to

See Also:

I_CmsXmlContentValue.getDocument()

getElement

public org.dom4j.Element getElement()

Description copied from interface: I_CmsXmlContentValue

Returns the original XML element of this XML content value.

Specified by:

getElement in interface I_CmsXmlContentValue

Returns:

the original XML element of this XML content value

See Also:

I_CmsXmlContentValue.getElement()

getId

public java.lang.String getId()

Description copied from interface: I_CmsWidgetParameter

Returns the form id of this parameter.

Specified by:

getId in interface I_CmsWidgetParameter

Returns:

the form id of this parameter

See Also:

I_CmsWidgetParameter.getId()

getIndex

public int getIndex()

Description copied from interface: I_CmsXmlContentValue

Returns the node index of this XML content value in the source XML document, starting with 0, with special handling of elements in choice groups.

This is useful in case there are more than one elements with the same XML node name in the source XML document.

Elements in XML choice groups will share the same number space, so a choice sequence will be numbered like this: Title[1], Text[2], Title[3], Image[4]

Specified by:

getIndex in interface I_CmsWidgetParameter

Specified by:

getIndex in interface I_CmsXmlContentValue

Returns:

the index of this XML content node in the source document with special handling of elements in choice groups

See Also:

I_CmsXmlContentValue.getIndex()

getKey

public java.lang.String getKey()

Description copied from interface: I_CmsWidgetParameter

Returns the localized key identificator of this parameter.

Specified by:

getKey in interface I_CmsWidgetParameter

Returns:

the localized key identificator of this parameter

See Also:

I_CmsWidgetParameter.getKey()

getLocale

public java.util.Locale getLocale()

Description copied from interface: I_CmsXmlContentValue

Returns the locale of this XML content value was generated for.

Specified by:

getLocale in interface I_CmsXmlContentValue

Returns:

the locale of this XML content value was generated for

See Also:

I_CmsXmlContentValue.getLocale()

getMaxIndex

public int getMaxIndex()

Description copied from interface: I_CmsXmlContentValue

Returns the total number of XML elements of this type that currently exist in the source document.

Specified by:

getMaxIndex in interface I_CmsXmlContentValue

Returns:

the total number of XML elements of this type that currently exist in the source document

See Also:

I_CmsXmlContentValue.getMaxIndex()

getMaxOccurs

public int getMaxOccurs()

Returns the maximum occurrences of this type.

Specified by:

getMaxOccurs in interface I_CmsWidgetParameter

Specified by:

getMaxOccurs in interface I_CmsXmlSchemaType

Returns:

the maximum occurrences of this type

getMinOccurs

public int getMinOccurs()

Returns the minimum occurrences of this type.

Specified by:

getMinOccurs in interface I_CmsWidgetParameter

Specified by:

getMinOccurs in interface I_CmsXmlSchemaType

Returns:

the minimum occurrences of this type

getName

public java.lang.String getName()

Returns the name.

Specified by:

getName in interface I_CmsWidgetParameter

Specified by:

getName in interface I_CmsXmlSchemaType

Returns:

the name

getPath

public java.lang.String getPath()

Description copied from interface: I_CmsXmlContentValue

Returns the path of this XML content value in the source document.

Specified by:

getPath in interface I_CmsXmlContentValue

Returns:

the path of this XML content value in the source document

See Also:

I_CmsXmlContentValue.getPath()

getPlainText

public java.lang.String getPlainText(CmsObject cms)

Description copied from interface: I_CmsXmlContentValue

Returns the value of this XML content node as a plain text String.

Plain text in this context means a pure textual representation of the content (i.e. without html tags). The plain text may be null, too, if there is no sound or useful textual representation (i.e. color values).

Specified by:

getPlainText in interface I_CmsXmlContentValue

Parameters:

cms - an initialized instance of a CmsObject

Returns:

the value of this XML content node as a plain text String

See Also:

I_CmsXmlContentValue.getPlainText(org.opencms.file.CmsObject)

getXmlIndex

public int getXmlIndex()

Description copied from interface: I_CmsXmlContentValue

Returns the node index of this XML content value in the source XML document, starting with 0, based on the XML ordering.

Elements in choice groups will be numbered like this: Title[1], Text[1], Title[2], Image[1]

Specified by:

getXmlIndex in interface I_CmsXmlContentValue

Returns:

the index of this XML content node in the source document with special handling of elements in choice groups

See Also:

I_CmsXmlContentValue.getXmlIndex()

hasError

public boolean hasError()

Description copied from interface: I_CmsWidgetParameter

Returns true if this widgets value contains an error.

Specified by:

hasError in interface I_CmsWidgetParameter

Returns:

true if this widgets value contains an error

See Also:

I_CmsWidgetParameter.hasError()

hashCode

public int hashCode()

Overrides:

hashCode in class java.lang.Object

See Also:

Object.hashCode()

isChoiceOption

public boolean isChoiceOption()

Description copied from interface: I_CmsXmlSchemaType

Returns true if this type is an option inside of a choice sequence.

This method is intended to check if this type is a node inside a choice sequence. In order to check if this type defines a choice sequence, use I_CmsXmlSchemaType.isChoiceType().

Specified by:

isChoiceOption in interface I_CmsXmlSchemaType

Returns:

true if this node defines a choice sequence

See Also:

I_CmsXmlSchemaType.isChoiceOption()

isChoiceType

public boolean isChoiceType()

Description copied from interface: I_CmsXmlSchemaType

Returns true if this type defines a choice sequence.

This method is intended to check if this type is a node defining a choice sequence. In order to check if this type is an option inside of a choice sequence, use I_CmsXmlSchemaType.isChoiceOption().

Specified by:

isChoiceType in interface I_CmsXmlSchemaType

Returns:

true if this node defines a choice sequence

See Also:

I_CmsXmlSchemaType.isChoiceType()

isSearchable

public boolean isSearchable()

The default implementation always returns true.

Specified by:

isSearchable in interface I_CmsXmlContentValue

Returns:

true in case this value is searchable by default

See Also:

I_CmsXmlContentValue.isSearchable()

isSimpleType

public boolean isSimpleType()

Description copied from interface: I_CmsXmlSchemaType

Returns true if this is a simple type, or false if this type is a nested schema.

If a value is a nested schema, it must be an instance of CmsXmlNestedContentDefinition.

Specified by:

isSimpleType in interface I_CmsXmlSchemaType

Returns:

true if this is a simple type, or false if this type is a nested schema

See Also:

I_CmsXmlSchemaType.isSimpleType()

moveDown

public void moveDown()

Description copied from interface: I_CmsXmlContentValue

Moves this XML content value one position down in the source document, if possible.

If the XML content value is already the first in it's sequence, it is not moved.

Specified by:

moveDown in interface I_CmsXmlContentValue

See Also:

I_CmsXmlContentValue.moveDown()

moveUp

public void moveUp()

Description copied from interface: I_CmsXmlContentValue

Moves this XML content value one position up in the source document, if possible.

If the XML content value is already the last in it's sequence, it is not moved.

Specified by:

moveUp in interface I_CmsXmlContentValue

See Also:

I_CmsXmlContentValue.moveUp()

setContentDefinition

public void setContentDefinition(CmsXmlContentDefinition contentDefinition)

Description copied from interface: I_CmsXmlSchemaType

Sets the content definition this schema type belongs to.

This is done automatically when the scheme type is added to a content definition. Usually there is no need to call this method from the application.

Specified by:

setContentDefinition in interface I_CmsXmlSchemaType

Parameters:

contentDefinition - the content definition to set

See Also:

I_CmsXmlSchemaType.setContentDefinition(org.opencms.xml.CmsXmlContentDefinition)

setDefault

public void setDefault(java.lang.String defaultValue)

Sets the default value for a node of this type.

Specified by:

setDefault in interface I_CmsXmlSchemaType

Parameters:

defaultValue - the default value to set

setKeyPrefix

public void setKeyPrefix(java.lang.String prefix)

Description copied from interface: I_CmsWidgetParameter

Sets an optional localized key prefix identificator of this parameter.

Specified by:

setKeyPrefix in interface I_CmsWidgetParameter

Parameters:

prefix - the optional localized key prefix identificator of this parameter

See Also:

I_CmsWidgetParameter.setKeyPrefix(java.lang.String)

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object

See Also:

Object.toString()

validateValue

public boolean validateValue(java.lang.String value)

Description copied from interface: I_CmsXmlSchemaType

Checks if a given value is valid according to the validation rule (regular expression) used for validation of this schema type in the XML schema.

To have a more refined validation according to the special requirements of the content type, use custom validation rules in the appinfo which are processed with I_CmsXmlContentHandler.resolveValidation(CmsObject, I_CmsXmlContentValue, org.opencms.xml.content.CmsXmlContentErrorHandler).

Specified by:

validateValue in interface I_CmsXmlSchemaType

Parameters:

value - the value to validate

Returns:

the validation rule (regular expression) used for this schema type in the XML schema

See Also:

I_CmsXmlSchemaType.validateValue(java.lang.String)

getRelationType

protected CmsRelationType getRelationType(java.lang.String path)

Returns the relation type for the given path.

Parameters:

path - the element path

Returns:

the relation type

moveValue

protected void moveValue(int step)

Moves this XML content element up or down in the XML document.

Please note: No check is performed if the move violates the XML document schema!

Parameters:

step - move the element up or down according to the given step value

readSchemaDefinition

protected java.lang.String readSchemaDefinition(java.lang.String schemaUri)
                                         throws CmsRuntimeException

Convenience method to loads the XML schema definition for this value type from an external file.

Parameters:

schemaUri - the schema uri to load the XML schema file from

Returns:

the loaded XML schema

Throws:

CmsRuntimeException - if something goes wrong