org.opencms.ade.configuration

类 CmsADEConfigData

java.lang.Object

org.opencms.ade.configuration.CmsADEConfigData

public class CmsADEConfigData
extends java.lang.Object

A class which represents the accessible configuration data at a given point in a sitemap.

字段概要

字段

限定符和类型	字段和说明
protected boolean	m_createContentsLocally The "create contents locally" flag.
protected boolean	m_discardInheritedModelPages Should inherited model pages be discarded?
protected boolean	m_discardInheritedProperties Should inherited properties be discard?
protected boolean	m_discardInheritedTypes Should inherited types be discarded?
protected CmsFormatterChangeSet	m_formatterChangeSet The configured formatter changes.

构造器概要

构造器

构造器和说明
CmsADEConfigData() Default constructor to create an empty configuration.
CmsADEConfigData(java.lang.String basePath) Creates an empty configuration data object with a given base path.
CmsADEConfigData(java.lang.String basePath, java.util.List<CmsResourceTypeConfig> resourceTypeConfig, boolean discardInheritedTypes, java.util.List<CmsPropertyConfig> propertyConfig, boolean discardInheritedProperties, java.util.List<CmsDetailPageInfo> detailPageInfos, java.util.List<CmsModelPageConfig> modelPages, java.util.List<CmsFunctionReference> functionReferences, boolean discardInheritedModelPages, boolean createContentsLocally, CmsFormatterChangeSet formatterChangeSet) Creates a new configuration data instance.

方法概要

方法

限定符和类型	方法和说明
void	applyAllFormatterChanges(java.util.Map<CmsUUID,I_CmsFormatterBean> formatters, CmsFormatterConfigurationCacheState formatterCacheState) Applies the formatter change sets of this and all parent configurations to a map of external (non-schema) formatters.
protected void	checkInitialized() Checks whether the configuration is initialized and throws an error otherwise.
protected void	checkNotInitialized() Checks whether the configuration is *NOT* initialized and throws an error otherwise.
protected static <C extends I_CmsConfigurationObject<C>> java.util.List<C>	combineConfigurationElements(java.util.List<C> parentConfigs, java.util.List<C> childConfigs) Generic method to merge lists of named configuration objects.
protected void	createContentDirectory() Creates the content directory for this configuration node if possible.
static CmsADEConfigData	emptyConfiguration(java.lang.String basePath) Creates an empty configuration for a given base path.
java.util.Map<CmsUUID,I_CmsFormatterBean>	getActiveFormatters() Gets the active external (non-schema) formatters for this sub-sitemap.
java.util.List<CmsDetailPageInfo>	getAllDetailPages() Gets the list of all detail pages.
java.util.List<CmsDetailPageInfo>	getAllDetailPages(boolean update) Gets a list of all detail pages.
java.lang.String	getBasePath() Gets the configuration base path.
CmsFormatterConfigurationCacheState	getCachedFormatters() Gets the cached formatters.
protected CmsObject	getCmsObject() Gets the CMS object used for VFS operations.
java.lang.String	getContentFolderPath() Gets the content folder path.
java.util.List<CmsResourceTypeConfig>	getCreatableTypes(CmsObject cms) Returns a list of the creatable resource types.
CmsModelPageConfig	getDefaultModelPage() Returns the default model page.
java.util.List<CmsDetailPageInfo>	getDetailPagesForType(java.lang.String type) Gets the detail pages for a specific type.
protected java.util.Map<java.lang.String,java.util.List<CmsDetailPageInfo>>	getDetailPagesMap(java.util.List<CmsDetailPageInfo> detailPages) Helper method to converts a list of detail pages to a map from type names to lists of detail pages for each type.
protected java.util.Map<java.lang.String,java.lang.String>	getFolderTypes() Collects the folder types in a map.
java.util.List<CmsFormatterChangeSet>	getFormatterChangeSets() Returns the formatter change sets for this and all parent sitemaps, ordered by increasing folder depth of the sitemap.
CmsFormatterConfiguration	getFormatters(CmsObject cms, CmsResource res) Gets the formatter configuration for a resource.
protected CmsFormatterConfiguration	getFormattersFromSchema(CmsObject cms, CmsResource res) Gets the formatters from the schema.
CmsFunctionReference	getFunctionReference(java.lang.String name) Gets a named function reference.
java.util.List<CmsFunctionReference>	getFunctionReferences() Gets the list of configured function references.
java.util.Map<CmsUUID,I_CmsFormatterBean>	getInactiveFormatters() Gets the map of external (non-schema) formatters which are inactive in this sub-sitemap.
CmsDetailPageInfo	getMainDetailPage(java.lang.String type) Gets the main detail page for a specific type.
java.util.List<CmsModelPageConfig>	getModelPages() Gets the list of available model pages.
CmsFormatterChangeSet	getOwnFormatterChangeSet() Gets the formatter changes for this sitemap configuration.
java.util.List<CmsPropertyConfig>	getPropertyConfiguration() Gets the configuration for the available properties.
java.util.Map<java.lang.String,CmsXmlContentProperty>	getPropertyConfigurationAsMap() Gets the property configuration as a map of CmsXmlContentProperty instances.
CmsResource	getResource() Returns the resource from which this configuration was read.
CmsResourceTypeConfig	getResourceType(java.lang.String typeName) Returns the configuration for a specific resource type.
java.util.List<CmsResourceTypeConfig>	getResourceTypes() Gets a list of all available resource type configurations.
java.util.Collection<CmsResourceTypeConfig>	getSearchableTypes(CmsObject cms) Gets the searchable resource type configurations.
java.util.Set<java.lang.String>	getTypesWithActiveSchemaFormatters() Gets the set of resource type names for which schema formatters can be enabled or disabled and which are not disabled in this sub-sitemap.
java.util.Set<java.lang.String>	getTypesWithModifiableFormatters() Gets the set of names of resource types which have schema-based formatters that can be enabled or disabled.
void	initialize(CmsObject cms) Initializes the configuration object.
protected java.util.List<CmsFunctionReference>	internalGetFunctionReferences() Internal method for getting the function references.
protected java.util.List<CmsResourceTypeConfig>	internalGetResourceTypes() Helper method for getting the list of resource types.
boolean	isCreateContentsLocally() Returns the value of the "create contents locally" flag.
boolean	isDiscardInheritedModelPages() Returns the value of the "discard inherited model pages" flag.
boolean	isDiscardInheritedProperties() Returns the value of the "discard inherited properties" flag.
boolean	isDiscardInheritedTypes() Returns the value of the "discard inherited types" flag.
boolean	isModuleConfiguration() Returns true if this is a module configuration instead of a normal sitemap configuration.
protected java.util.List<CmsDetailPageInfo>	mergeDetailPages(java.util.List<CmsDetailPageInfo> parentDetailPages, java.util.List<CmsDetailPageInfo> ownDetailPages) Merges two lists of detail pages, one from a parent configuration and one from a child configuration.
protected void	mergeParent(CmsADEConfigData parent) Merges the parent's data into this object.
CmsADEConfigData	parent() Fetches the parent configuration of this configuration.
protected void	processModuleOrdering() Handle the ordering from the module configurations.
void	setIsModuleConfig(boolean isModuleConfig) Sets the "module configuration" flag.
void	setResource(CmsResource resource) Sets the configuration file resource.
protected java.util.List<CmsDetailPageInfo>	updateUris(java.util.List<CmsDetailPageInfo> detailPages) Helper method to correct paths in detail page beans if the corresponding resources have been moved.

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

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

字段详细资料

m_createContentsLocally

protected boolean m_createContentsLocally

The "create contents locally" flag.

m_discardInheritedModelPages

protected boolean m_discardInheritedModelPages

Should inherited model pages be discarded?

m_discardInheritedProperties

protected boolean m_discardInheritedProperties

Should inherited properties be discard?

m_discardInheritedTypes

protected boolean m_discardInheritedTypes

Should inherited types be discarded?

m_formatterChangeSet

protected CmsFormatterChangeSet m_formatterChangeSet

The configured formatter changes.

构造器详细资料

CmsADEConfigData

public CmsADEConfigData()

Default constructor to create an empty configuration.

CmsADEConfigData

public CmsADEConfigData(java.lang.String basePath)

Creates an empty configuration data object with a given base path.

参数:

basePath - the base path

CmsADEConfigData

public CmsADEConfigData(java.lang.String basePath,
                java.util.List<CmsResourceTypeConfig> resourceTypeConfig,
                boolean discardInheritedTypes,
                java.util.List<CmsPropertyConfig> propertyConfig,
                boolean discardInheritedProperties,
                java.util.List<CmsDetailPageInfo> detailPageInfos,
                java.util.List<CmsModelPageConfig> modelPages,
                java.util.List<CmsFunctionReference> functionReferences,
                boolean discardInheritedModelPages,
                boolean createContentsLocally,
                CmsFormatterChangeSet formatterChangeSet)

Creates a new configuration data instance.

参数:

basePath - the base path

resourceTypeConfig - the resource type configuration

discardInheritedTypes - the "discard inherited types" flag

propertyConfig - the property configuration

discardInheritedProperties - the "discard inherited properties" flag

detailPageInfos - the detail page configuration

modelPages - the model page configuration

functionReferences - the function reference configuration

discardInheritedModelPages - the "discard inherited model pages" flag

createContentsLocally - the "create contents locally" flag

formatterChangeSet - the formatter changes

方法详细资料

emptyConfiguration

public static CmsADEConfigData emptyConfiguration(java.lang.String basePath)

Creates an empty configuration for a given base path.

参数:

basePath - the base path

返回:

the empty configuration object

combineConfigurationElements

protected static <C extends I_CmsConfigurationObject<C>> java.util.List<C> combineConfigurationElements(java.util.List<C> parentConfigs,
                                                                                     java.util.List<C> childConfigs)

Generic method to merge lists of named configuration objects.

The lists are merged such that the configuration objects from the child list rise to the front of the result list, and two configuration objects will be merged themselves if they share the same name.

For example, if we have two lists of configuration objects:

parent: A1, B1, C1

child: D2, B2

then the resulting list will look like:

D2, B3, A1, C1

where B3 is the result of merging B1 and B2.

类型参数:

C - the type of configuration object

参数:

parentConfigs - the parent configurations

childConfigs - the child configurations

返回:

the merged configuration object list

applyAllFormatterChanges

public void applyAllFormatterChanges(java.util.Map<CmsUUID,I_CmsFormatterBean> formatters,
                            CmsFormatterConfigurationCacheState formatterCacheState)

Applies the formatter change sets of this and all parent configurations to a map of external (non-schema) formatters.

参数:

formatters - the external formatter map which will be modified

formatterCacheState - the formatter cache state from which new external formatters should be fetched

getActiveFormatters

public java.util.Map<CmsUUID,I_CmsFormatterBean> getActiveFormatters()

Gets the active external (non-schema) formatters for this sub-sitemap.

返回:

the map of active external formatters by structure id

getAllDetailPages

public java.util.List<CmsDetailPageInfo> getAllDetailPages()

Gets the list of all detail pages.

返回:

the list of all detail pages

getAllDetailPages

public java.util.List<CmsDetailPageInfo> getAllDetailPages(boolean update)

Gets a list of all detail pages.

参数:

update - if true, this method will try to correct the root paths in the returned objects if the corresponding resources have been moved

返回:

the list of all detail pages

getBasePath

public java.lang.String getBasePath()

Gets the configuration base path.

For example, if the configuration file is located at /sites/default/.content/.config, the base path is /sites/default.

返回:

the base path of the configuration

getCachedFormatters

public CmsFormatterConfigurationCacheState getCachedFormatters()

Gets the cached formatters.

返回:

the cached formatters

getContentFolderPath

public java.lang.String getContentFolderPath()

Gets the content folder path.

For example, if the configuration file is located at /sites/default/.content/.config, the content folder path is /sites/default/.content

返回:

the content folder path

getCreatableTypes

public java.util.List<CmsResourceTypeConfig> getCreatableTypes(CmsObject cms)
                                                        throws CmsException

Returns a list of the creatable resource types.

参数:

cms - the CMS context used to check whether the resource types are creatable

返回:

the list of creatable resource type

抛出:

CmsException - if something goes wrong

getDefaultModelPage

public CmsModelPageConfig getDefaultModelPage()

Returns the default model page.

返回:

the default model page

getDetailPagesForType

public java.util.List<CmsDetailPageInfo> getDetailPagesForType(java.lang.String type)

Gets the detail pages for a specific type.

参数:

type - the type name

返回:

the list of detail pages for that type

getFormatterChangeSets

public java.util.List<CmsFormatterChangeSet> getFormatterChangeSets()

Returns the formatter change sets for this and all parent sitemaps, ordered by increasing folder depth of the sitemap.

返回:

the formatter change sets for all ancestor sitemaps

getFormatters

public CmsFormatterConfiguration getFormatters(CmsObject cms,
                                      CmsResource res)

Gets the formatter configuration for a resource.

参数:

cms - the current CMS context

res - the resource for which the formatter configuration should be retrieved

返回:

the configuration of formatters for the resource

getFunctionReference

public CmsFunctionReference getFunctionReference(java.lang.String name)

Gets a named function reference.

参数:

name - the name of the function reference

返回:

the function reference for the given name

getFunctionReferences

public java.util.List<CmsFunctionReference> getFunctionReferences()

Gets the list of configured function references.

返回:

the list of configured function references

getInactiveFormatters

public java.util.Map<CmsUUID,I_CmsFormatterBean> getInactiveFormatters()

Gets the map of external (non-schema) formatters which are inactive in this sub-sitemap.

返回:

the map inactive external formatters

getMainDetailPage

public CmsDetailPageInfo getMainDetailPage(java.lang.String type)

Gets the main detail page for a specific type.

参数:

type - the type name

返回:

the main detail page for that type

getModelPages

public java.util.List<CmsModelPageConfig> getModelPages()

Gets the list of available model pages.

返回:

the list of available model pages

getOwnFormatterChangeSet

public CmsFormatterChangeSet getOwnFormatterChangeSet()

Gets the formatter changes for this sitemap configuration.

返回:

the formatter change set

getPropertyConfiguration

public java.util.List<CmsPropertyConfig> getPropertyConfiguration()

Gets the configuration for the available properties.

返回:

the configuration for the available properties

getPropertyConfigurationAsMap

public java.util.Map<java.lang.String,CmsXmlContentProperty> getPropertyConfigurationAsMap()

Gets the property configuration as a map of CmsXmlContentProperty instances.

返回:

the map of property configurations

getResource

public CmsResource getResource()

Returns the resource from which this configuration was read.

返回:

the resource from which this configuration was read

getResourceType

public CmsResourceTypeConfig getResourceType(java.lang.String typeName)

Returns the configuration for a specific resource type.

参数:

typeName - the name of the type

返回:

the resource type configuration for that type

getResourceTypes

public java.util.List<CmsResourceTypeConfig> getResourceTypes()

Gets a list of all available resource type configurations.

返回:

the available resource type configurations

getSearchableTypes

public java.util.Collection<CmsResourceTypeConfig> getSearchableTypes(CmsObject cms)

Gets the searchable resource type configurations.

参数:

cms - the current CMS context

返回:

the searchable resource type configurations

getTypesWithActiveSchemaFormatters

public java.util.Set<java.lang.String> getTypesWithActiveSchemaFormatters()

Gets the set of resource type names for which schema formatters can be enabled or disabled and which are not disabled in this sub-sitemap.

返回:

the set of types for which schema formatters are active

getTypesWithModifiableFormatters

public java.util.Set<java.lang.String> getTypesWithModifiableFormatters()

Gets the set of names of resource types which have schema-based formatters that can be enabled or disabled.

返回:

the set of names of resource types which have schema-based formatters that can be enabled or disabled

initialize

public void initialize(CmsObject cms)

Initializes the configuration object.

参数:

cms - the CMS context to be used for VFS operations

isCreateContentsLocally

public boolean isCreateContentsLocally()

Returns the value of the "create contents locally" flag.

If this flag is set, contents of types configured in a super-sitemap will be created in the sub-sitemap (if the user creates them from the sub-sitemap).

返回:

the "create contents locally" flag

isDiscardInheritedModelPages

public boolean isDiscardInheritedModelPages()

Returns the value of the "discard inherited model pages" flag.

If this flag is set, inherited model pages will be discarded for this sitemap.

返回:

the "discard inherited model pages" flag

isDiscardInheritedProperties

public boolean isDiscardInheritedProperties()

Returns the value of the "discard inherited properties" flag.

If this is flag is set, inherited property definitions will be discarded for this sitemap.

返回:

the "discard inherited properties" flag.

isDiscardInheritedTypes

public boolean isDiscardInheritedTypes()

Returns the value of the "discard inherited types" flag.

If this flag is set, inherited resource types from a super-sitemap will be discarded for this sitemap.

返回:

the "discard inherited types" flag

isModuleConfiguration

public boolean isModuleConfiguration()

Returns true if this is a module configuration instead of a normal sitemap configuration.

返回:

true if this is a module configuration

parent

public CmsADEConfigData parent()

Fetches the parent configuration of this configuration.

If this configuration is a sitemap configuration with no direct parent configuration, the module configuration will be returned. If this configuration already is a module configuration, null will be returned.

返回:

the parent configuration

setIsModuleConfig

public void setIsModuleConfig(boolean isModuleConfig)

Sets the "module configuration" flag.

参数:

isModuleConfig - true if this configuration should be marked as a module configuration

setResource

public void setResource(CmsResource resource)

Sets the configuration file resource.

参数:

resource - the configuration file resource

checkInitialized

protected void checkInitialized()

Checks whether the configuration is initialized and throws an error otherwise.

checkNotInitialized

protected void checkNotInitialized()

Checks whether the configuration is *NOT* initialized and throws an error otherwise.

createContentDirectory

protected void createContentDirectory()
                               throws CmsException

Creates the content directory for this configuration node if possible.

抛出:

CmsException - if something goes wrong

getCmsObject

protected CmsObject getCmsObject()

Gets the CMS object used for VFS operations.

返回:

the CMS object

getDetailPagesMap

protected java.util.Map<java.lang.String,java.util.List<CmsDetailPageInfo>> getDetailPagesMap(java.util.List<CmsDetailPageInfo> detailPages)

Helper method to converts a list of detail pages to a map from type names to lists of detail pages for each type.

参数:

detailPages - the list of detail pages

返回:

the map of detail pages

getFolderTypes

protected java.util.Map<java.lang.String,java.lang.String> getFolderTypes()
                                                                   throws CmsException

Collects the folder types in a map.

返回:

the map of folder types

抛出:

CmsException - if something goes wrong

getFormattersFromSchema

protected CmsFormatterConfiguration getFormattersFromSchema(CmsObject cms,
                                                CmsResource res)

Gets the formatters from the schema.

参数:

cms - the current CMS context

res - the resource for which the formatters should be retrieved

返回:

the formatters from the schema

internalGetFunctionReferences

protected java.util.List<CmsFunctionReference> internalGetFunctionReferences()

Internal method for getting the function references.

返回:

the function references

internalGetResourceTypes

protected java.util.List<CmsResourceTypeConfig> internalGetResourceTypes()

Helper method for getting the list of resource types.

返回:

the list of resource types

mergeDetailPages

protected java.util.List<CmsDetailPageInfo> mergeDetailPages(java.util.List<CmsDetailPageInfo> parentDetailPages,
                                                 java.util.List<CmsDetailPageInfo> ownDetailPages)

Merges two lists of detail pages, one from a parent configuration and one from a child configuration.

参数:

parentDetailPages - the parent's detail pages

ownDetailPages - the child's detail pages

返回:

the merged detail pages

mergeParent

protected void mergeParent(CmsADEConfigData parent)

Merges the parent's data into this object.

参数:

parent - the parent configuration data

processModuleOrdering

protected void processModuleOrdering()

Handle the ordering from the module configurations.

updateUris

protected java.util.List<CmsDetailPageInfo> updateUris(java.util.List<CmsDetailPageInfo> detailPages)

Helper method to correct paths in detail page beans if the corresponding resources have been moved.

参数:

detailPages - the original list of detail pages

返回:

the corrected list of detail pages