org.opencms.xml.types
Class CmsXmlHtmlValue

java.lang.Object
  extended by org.opencms.xml.types.A_CmsXmlContentValue
      extended by org.opencms.xml.types.CmsXmlHtmlValue
All Implemented Interfaces:
java.lang.Comparable, I_CmsWidgetParameter, I_CmsXmlContentValue, I_CmsXmlSchemaType

public class CmsXmlHtmlValue
extends A_CmsXmlContentValue
implements I_CmsXmlContentValue

Describes the XML content type "OpenCmsHtml".

Since:
6.0.0
Version:
$Revision: 1.36 $
Author:
Alexander Kandzior

Field Summary
static java.lang.String TYPE_NAME
          The name of this type as used in the XML schema.
 
Fields inherited from class org.opencms.xml.types.A_CmsXmlContentValue
m_defaultValue, m_document, m_element, m_locale, m_maxOccurs, m_minOccurs, m_name
 
Fields inherited from interface org.opencms.xml.types.I_CmsXmlSchemaType
XSI_NAMESPACE, XSI_NAMESPACE_ATTRIBUTE_NO_SCHEMA_LOCATION
 
Constructor Summary
CmsXmlHtmlValue()
          Creates a new, empty schema type descriptor of type "OpenCmsHtml".
CmsXmlHtmlValue(I_CmsXmlDocument document, org.dom4j.Element element, java.util.Locale locale)
          Creates a new XML content value of type "OpenCmsHtml".
CmsXmlHtmlValue(I_CmsXmlDocument document, org.dom4j.Element element, java.util.Locale locale, I_CmsXmlSchemaType type)
          Creates a new XML content value of type "OpenCmsHtml".
CmsXmlHtmlValue(java.lang.String name, java.lang.String minOccurs, java.lang.String maxOccurs)
          Creates a new schema type descriptor for the type "OpenCmsHtml".
 
Method Summary
 I_CmsXmlContentValue createValue(I_CmsXmlDocument document, org.dom4j.Element element, java.util.Locale locale)
          Creates a XML content value object for this type.
 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.
 CmsLinkTable getLinkTable()
          Returns the link table of this XML page element.
 java.lang.String getPlainText(CmsObject cms)
          Returns the value of this XML content node as a plain text String.
 java.lang.String getSchemaDefinition()
          Returns a String representation of the XML definition for this schema type.
 java.lang.String getStringValue(CmsObject cms)
          Returns the value of this parameter.
 java.lang.String getTypeName()
          Returns the schema type name.
 I_CmsXmlSchemaType newInstance(java.lang.String name, java.lang.String minOccurs, java.lang.String maxOccurs)
          Creates a new instance of this XML schema type initialized with the given values.
 void setStringValue(CmsObject cms, java.lang.String value)
          Sets the value of this parameter.
 
Methods inherited from class org.opencms.xml.types.A_CmsXmlContentValue
appendXmlSchema, compareTo, equals, getContentDefinition, getDefault, getDefault, getDocument, getElement, getId, getIndex, getKey, getLocale, getMaxIndex, getMaxOccurs, getMinOccurs, getName, getPath, hasError, hashCode, isSimpleType, moveDown, moveUp, moveValue, readSchemaDefinition, setContentDefinition, setDefault, setKeyPrefix, toString, validateValue
 
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
getDocument, getElement, getIndex, getLocale, getMaxIndex, getPath, moveDown, moveUp
 
Methods inherited from interface org.opencms.xml.types.I_CmsXmlSchemaType
appendXmlSchema, getContentDefinition, getDefault, getMaxOccurs, getMinOccurs, getName, isSimpleType, setContentDefinition, setDefault, validateValue
 
Methods inherited from interface java.lang.Comparable
compareTo
 

Field Detail

TYPE_NAME

public static final java.lang.String TYPE_NAME
The name of this type as used in the XML schema.

See Also:
Constant Field Values
Constructor Detail

CmsXmlHtmlValue

public CmsXmlHtmlValue()
Creates a new, empty schema type descriptor of type "OpenCmsHtml".


CmsXmlHtmlValue

public CmsXmlHtmlValue(I_CmsXmlDocument document,
                       org.dom4j.Element element,
                       java.util.Locale locale)
Creates a new XML content value of type "OpenCmsHtml".

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

CmsXmlHtmlValue

public CmsXmlHtmlValue(I_CmsXmlDocument document,
                       org.dom4j.Element element,
                       java.util.Locale locale,
                       I_CmsXmlSchemaType type)
Creates a new XML content value of type "OpenCmsHtml".

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

CmsXmlHtmlValue

public CmsXmlHtmlValue(java.lang.String name,
                       java.lang.String minOccurs,
                       java.lang.String maxOccurs)
Creates a new schema type descriptor for the type "OpenCmsHtml".

Parameters:
name - the name of the XML node containing the value according to the XML schema
minOccurs - minimum number of occurences of this type according to the XML schema
maxOccurs - maximum number of occurences of this type according to the XML schema
Method Detail

createValue

public I_CmsXmlContentValue createValue(I_CmsXmlDocument document,
                                        org.dom4j.Element element,
                                        java.util.Locale locale)
Description copied from interface: I_CmsXmlSchemaType
Creates a XML content value object for this type.

Specified by:
createValue in interface I_CmsXmlSchemaType
Parameters:
document - the XML content instance this value belongs to
element - the XML element to create the value from
locale - the locale to create the value for
Returns:
the created XML content value object
See Also:
I_CmsXmlSchemaType.createValue(I_CmsXmlDocument, org.dom4j.Element, Locale)

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
Overrides:
generateXml in class A_CmsXmlContentValue
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)

getLinkTable

public CmsLinkTable getLinkTable()
Returns the link table of this XML page element.

Returns:
the link table of this XML page element

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
Overrides:
getPlainText in class A_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)

getSchemaDefinition

public java.lang.String getSchemaDefinition()
Description copied from interface: I_CmsXmlSchemaType
Returns a String representation of the XML definition for this schema type.

Specified by:
getSchemaDefinition in interface I_CmsXmlSchemaType
Returns:
a String representation of the XML definition for this schema type
See Also:
I_CmsXmlSchemaType.getSchemaDefinition()

getStringValue

public java.lang.String getStringValue(CmsObject cms)
Description copied from interface: I_CmsWidgetParameter
Returns the value of this parameter.

Specified by:
getStringValue in interface I_CmsWidgetParameter
Specified by:
getStringValue in interface I_CmsXmlContentValue
Parameters:
cms - an initialized instance of an OpenCms user context
Returns:
the value of this parameter
See Also:
I_CmsXmlContentValue.getStringValue(org.opencms.file.CmsObject)

getTypeName

public java.lang.String getTypeName()
Description copied from interface: I_CmsXmlSchemaType
Returns the schema type name.

By convention, a XML schema type name has the form "OpenCms + ${name}". Examples are "OpenCmsString" or "OpenCmsBoolean".

The schema type name is fixed by the implementation.

Specified by:
getTypeName in interface I_CmsXmlSchemaType
Returns:
the schema type name
See Also:
I_CmsXmlSchemaType.getTypeName()

newInstance

public I_CmsXmlSchemaType newInstance(java.lang.String name,
                                      java.lang.String minOccurs,
                                      java.lang.String maxOccurs)
Description copied from interface: I_CmsXmlSchemaType
Creates a new instance of this XML schema type initialized with the given values.

Specified by:
newInstance in interface I_CmsXmlSchemaType
Parameters:
name - the name to use in the xml document
minOccurs - minimum number of occurences
maxOccurs - maximum number of occurences
Returns:
a new instance of this XML content type initialized with the given values
See Also:
I_CmsXmlSchemaType.newInstance(java.lang.String, java.lang.String, java.lang.String)

setStringValue

public void setStringValue(CmsObject cms,
                           java.lang.String value)
Description copied from interface: I_CmsWidgetParameter
Sets the value of this parameter.

This method does provide processing of the content based on the users current OpenCms context. This can be used e.g. for link extraction and replacement in the content.

Specified by:
setStringValue in interface I_CmsWidgetParameter
Specified by:
setStringValue in interface I_CmsXmlContentValue
Parameters:
cms - an initialized instance of an OpenCms user context
value - the value to set
See Also:
I_CmsXmlContentValue.setStringValue(org.opencms.file.CmsObject, java.lang.String)