org.opencms.xml

类 CmsXmlContentTypeManager

java.lang.Object

org.opencms.xml.CmsXmlContentTypeManager

public class CmsXmlContentTypeManager
extends java.lang.Object

Manager class for registered OpenCms XML content types and content collectors.

从以下版本开始:

6.0.0

构造器概要

构造器

构造器和说明
CmsXmlContentTypeManager() Creates a new content type manager.

方法概要

方法

限定符和类型	方法和说明
I_CmsXmlSchemaType	addContentType(java.lang.Class<?> clazz) Adds a XML content schema type class to the registered XML content types.
void	addSchemaType(java.lang.String className, java.lang.String defaultWidget) Adds a new XML content type schema class and XML widget to the manager by class names.
void	addWidget(java.lang.String className, java.lang.String aliasName, java.lang.String defaultConfiguration) Adds a XML content editor widget class, making this widget available for the XML content editor.
static CmsXmlContentTypeManager	createTypeManagerForTestCases() Returns a statically initialized instance of an XML content type manager (for test cases only).
I_CmsXmlContentHandler	getContentHandler(java.lang.String className, java.lang.String schemaLocation) Returns the XML content handler instance class for the specified class name.
I_CmsXmlSchemaType	getContentType(org.dom4j.Element typeElement, java.util.Set<CmsXmlContentDefinition> nestedDefinitions) Generates an initialized instance of a XML content type definition from the given XML schema element.
I_CmsXmlSchemaType	getContentType(java.lang.String typeName) Returns the content type registered with the given name, or null.
I_CmsXmlContentHandler	getFreshContentHandler(java.lang.String className) Returns a fresh XML content handler instance for the specified class name.
java.util.List<I_CmsXmlSchemaType>	getRegisteredSchemaTypes() Returns an alphabetically sorted list of all configured XML content schema types.
java.lang.String	getRegisteredWidgetAlias(java.lang.String className) Returns the alias for the given Widget class name, may be null if no alias is defined for the class.
java.util.List<java.lang.String>	getRegisteredWidgetNames() Returns an alphabetically sorted list of the class names of all configured XML widgets.
I_CmsWidget	getWidget(java.lang.String name) Returns an initialized widget class by it's class name or by it's alias.
I_CmsWidget	getWidgetDefault(java.lang.String typeName) Returns the editor widget for the specified XML content type.
java.lang.String	getWidgetDefaultConfiguration(I_CmsWidget widget) Returns the default widget configuration set in opencms-vfs.xml or null if nothing is found.
java.lang.String	getWidgetDefaultConfiguration(java.lang.String name) Returns the default widget configuration set in opencms-vfs.xml or null if nothing is found.
void	initialize(CmsObject cms) Initializes XML content types managed in this XML content type manager.

从类继承的方法 java.lang.Object

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

构造器详细资料

CmsXmlContentTypeManager

public CmsXmlContentTypeManager()

Creates a new content type manager.

方法详细资料

createTypeManagerForTestCases

public static CmsXmlContentTypeManager createTypeManagerForTestCases()

Returns a statically initialized instance of an XML content type manager (for test cases only).

返回:

a statically initialized instance of an XML content type manager

addContentType

public I_CmsXmlSchemaType addContentType(java.lang.Class<?> clazz)
                                  throws CmsXmlException

Adds a XML content schema type class to the registered XML content types.

参数:

clazz - the XML content schema type class to add

返回:

the created instance of the XML content schema type

抛出:

CmsXmlException - in case the class is not an instance of I_CmsXmlSchemaType

addSchemaType

public void addSchemaType(java.lang.String className,
                 java.lang.String defaultWidget)

Adds a new XML content type schema class and XML widget to the manager by class names.

参数:

className - class name of the XML content schema type class to add

defaultWidget - class name of the default XML widget class for the added XML content type

addWidget

public void addWidget(java.lang.String className,
             java.lang.String aliasName,
             java.lang.String defaultConfiguration)

Adds a XML content editor widget class, making this widget available for the XML content editor.

参数:

className - the widget class to add

aliasName - the (optional) alias name to use for the widget class

defaultConfiguration - the default configuration of the widget

getContentHandler

public I_CmsXmlContentHandler getContentHandler(java.lang.String className,
                                       java.lang.String schemaLocation)
                                         throws CmsXmlException

Returns the XML content handler instance class for the specified class name.

Only one instance of an XML content handler class per content definition name will be generated, and that instance will be cached and re-used for all operations.

参数:

className - the name of the XML content handler to return

schemaLocation - the schema location of the XML content definition that handler belongs to

返回:

the XML content handler class

抛出:

CmsXmlException - if something goes wrong

getContentType

public I_CmsXmlSchemaType getContentType(org.dom4j.Element typeElement,
                                java.util.Set<CmsXmlContentDefinition> nestedDefinitions)
                                  throws CmsXmlException

Generates an initialized instance of a XML content type definition from the given XML schema element.

参数:

typeElement - the element to generate the XML content type definition from

nestedDefinitions - the nested (included) XML content sub-definitions

返回:

an initialized instance of a XML content type definition

抛出:

CmsXmlException - in case the element does not describe a valid XML content type definition

getContentType

public I_CmsXmlSchemaType getContentType(java.lang.String typeName)

Returns the content type registered with the given name, or null.

参数:

typeName - the name to look up the content type for

返回:

the content type registered with the given name, or null

getFreshContentHandler

public I_CmsXmlContentHandler getFreshContentHandler(java.lang.String className)
                                              throws CmsXmlException

Returns a fresh XML content handler instance for the specified class name.

参数:

className - the name of the XML content handler to return

返回:

the XML content handler class

抛出:

CmsXmlException - if something goes wrong

getRegisteredSchemaTypes

public java.util.List<I_CmsXmlSchemaType> getRegisteredSchemaTypes()

Returns an alphabetically sorted list of all configured XML content schema types.

返回:

an alphabetically sorted list of all configured XML content schema types

getRegisteredWidgetAlias

public java.lang.String getRegisteredWidgetAlias(java.lang.String className)

Returns the alias for the given Widget class name, may be null if no alias is defined for the class.

参数:

className - the name of the widget

返回:

the alias for the given Widget class name, may be null if no alias is defined for the class

getRegisteredWidgetNames

public java.util.List<java.lang.String> getRegisteredWidgetNames()

Returns an alphabetically sorted list of the class names of all configured XML widgets.

返回:

an alphabetically sorted list of the class names of all configured XML widgets

getWidget

public I_CmsWidget getWidget(java.lang.String name)

Returns an initialized widget class by it's class name or by it's alias.

参数:

name - the class name or alias name to get the widget for

返回:

the widget instance for the class name

getWidgetDefault

public I_CmsWidget getWidgetDefault(java.lang.String typeName)

Returns the editor widget for the specified XML content type.

参数:

typeName - the name of the XML content type to get the widget for

返回:

the editor widget for the specified XML content type

getWidgetDefaultConfiguration

public java.lang.String getWidgetDefaultConfiguration(I_CmsWidget widget)

Returns the default widget configuration set in opencms-vfs.xml or null if nothing is found.

参数:

widget - the widget instance to get the default configuration for

返回:

the default widget configuration

getWidgetDefaultConfiguration

public java.lang.String getWidgetDefaultConfiguration(java.lang.String name)

Returns the default widget configuration set in opencms-vfs.xml or null if nothing is found.

参数:

name - the class name or alias name to get the default configuration for

返回:

the default widget configuration

initialize

public void initialize(CmsObject cms)
                throws CmsRoleViolationException

Initializes XML content types managed in this XML content type manager.

参数:

cms - an initialized OpenCms user context with "Administrator" role permissions

抛出:

CmsRoleViolationException - in case the provided OpenCms user context doea not have "Administrator" role permissions