org.opencms.db

类 CmsAliasManager

java.lang.Object

org.opencms.db.CmsAliasManager

public class CmsAliasManager
extends java.lang.Object

The alias manager provides access to the aliases stored in the database.

字段概要

字段

限定符和类型	字段和说明
protected CmsSecurityManager	m_securityManager The security manager for accessing the database.

构造器概要

构造器

构造器和说明
CmsAliasManager(CmsSecurityManager securityManager) Creates a new alias manager instance.

方法概要

方法

限定符和类型	方法和说明
protected void	checkPermissionsForMassEdit(CmsObject cms) Checks whether the current user has the permissions to mass edit the alias table, and throws an exception otherwise.
java.util.List<CmsAlias>	getAliasesForPath(CmsObject cms, java.lang.String siteRoot, java.lang.String aliasPath) Gets the list of aliases for a path in a given site.
java.util.List<CmsAlias>	getAliasesForSite(CmsObject cms, java.lang.String siteRoot) Gets the list of aliases for a given site root.
java.util.List<CmsAlias>	getAliasesForStructureId(CmsObject cms, CmsUUID structureId) Gets the aliases for a given structure id.
java.util.List<CmsRewriteAlias>	getRewriteAliases(CmsObject cms, java.lang.String siteRoot) Reads the rewrite aliases for a given site root.
CmsRewriteAliasMatcher	getRewriteAliasMatcher(CmsObject cms, java.lang.String siteRoot) Gets the rewrite alias matcher for the given site.
boolean	hasPermissionsForMassEdit(CmsObject cms, java.lang.String siteRoot) Checks whether the current user has permissions for mass editing the alias table.
protected CmsAliasImportResult	importAlias(CmsObject cms, java.lang.String siteRoot, java.lang.String aliasPath, java.lang.String vfsPath, CmsAliasMode mode) Imports a single alias.
java.util.List<CmsAliasImportResult>	importAliases(CmsObject cms, byte[] aliasData, java.lang.String siteRoot, java.lang.String separator) Imports alias CSV data.
protected CmsAliasImportResult	processAliasImport(CmsObject cms, java.lang.String siteRoot, java.lang.String aliasPath, java.lang.String vfsPath, CmsAliasMode mode) Processes a single alias import operation which has already been parsed into fields.
protected CmsAliasImportResult	processAliasLine(CmsObject cms, java.lang.String siteRoot, java.lang.String line, java.lang.String separator) Processes a line from a CSV file containing the alias data to be imported.
void	saveAliases(CmsObject cms, CmsUUID structureId, java.util.List<CmsAlias> aliases) Saves the aliases for a given structure id, completely replacing any existing aliases for the same structure id.
void	saveRewriteAliases(CmsObject cms, java.lang.String siteRoot, java.util.List<CmsRewriteAlias> newAliases) Saves the rewrite alias for a given site root.
void	updateAliases(CmsObject cms, java.util.Collection<CmsAlias> toDelete, java.util.Collection<CmsAlias> toAdd) Updates the aliases in the database.

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

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

字段详细资料

m_securityManager

protected CmsSecurityManager m_securityManager

The security manager for accessing the database.

构造器详细资料

CmsAliasManager

public CmsAliasManager(CmsSecurityManager securityManager)

Creates a new alias manager instance.

参数:

securityManager - the security manager

方法详细资料

getAliasesForPath

public java.util.List<CmsAlias> getAliasesForPath(CmsObject cms,
                                         java.lang.String siteRoot,
                                         java.lang.String aliasPath)
                                           throws CmsException

Gets the list of aliases for a path in a given site.

This should only return either an empty list or a list with a single element.

参数:

cms - the current CMS context

siteRoot - the site root for which we want the aliases

aliasPath - the alias path

返回:

the aliases for the given site root and path

抛出:

CmsException - if something goes wrong

getAliasesForSite

public java.util.List<CmsAlias> getAliasesForSite(CmsObject cms,
                                         java.lang.String siteRoot)
                                           throws CmsException

Gets the list of aliases for a given site root.

参数:

cms - the current CMS context

siteRoot - the site root

返回:

the list of aliases for the given site

抛出:

CmsException - if something goes wrong

getAliasesForStructureId

public java.util.List<CmsAlias> getAliasesForStructureId(CmsObject cms,
                                                CmsUUID structureId)
                                                  throws CmsException

Gets the aliases for a given structure id.

参数:

cms - the current CMS context

structureId - the structure id of a resource

返回:

the aliases which point to the resource with the given structure id

抛出:

CmsException - if something goes wrong

getRewriteAliases

public java.util.List<CmsRewriteAlias> getRewriteAliases(CmsObject cms,
                                                java.lang.String siteRoot)
                                                  throws CmsException

Reads the rewrite aliases for a given site root.

参数:

cms - the current CMS context

siteRoot - the site root for which the rewrite aliases should be retrieved

返回:

the list of rewrite aliases for the given site root

抛出:

CmsException - if something goes wrong

getRewriteAliasMatcher

public CmsRewriteAliasMatcher getRewriteAliasMatcher(CmsObject cms,
                                            java.lang.String siteRoot)
                                              throws CmsException

Gets the rewrite alias matcher for the given site.

参数:

cms - the CMS context to use

siteRoot - the site root

返回:

the alias matcher for the site with the given site root

抛出:

CmsException - if something goes wrong

hasPermissionsForMassEdit

public boolean hasPermissionsForMassEdit(CmsObject cms,
                                java.lang.String siteRoot)

Checks whether the current user has permissions for mass editing the alias table.

参数:

cms - the current CMS context

siteRoot - the site root to check

返回:

true if the user from the CMS context is allowed to mass edit the alias table

importAliases

public java.util.List<CmsAliasImportResult> importAliases(CmsObject cms,
                                                 byte[] aliasData,
                                                 java.lang.String siteRoot,
                                                 java.lang.String separator)
                                                   throws java.lang.Exception

Imports alias CSV data.

参数:

cms - the current CMS context

aliasData - the alias data

siteRoot - the root of the site into which the alias data should be imported

separator - the field separator which is used by the imported data

返回:

the list of import results

抛出:

java.lang.Exception - if something goes wrong

saveAliases

public void saveAliases(CmsObject cms,
               CmsUUID structureId,
               java.util.List<CmsAlias> aliases)
                 throws CmsException

Saves the aliases for a given structure id, completely replacing any existing aliases for the same structure id.

参数:

cms - the current CMS context

structureId - the structure id of a resource

aliases - the list of aliases which should be written

抛出:

CmsException - if something goes wrong

saveRewriteAliases

public void saveRewriteAliases(CmsObject cms,
                      java.lang.String siteRoot,
                      java.util.List<CmsRewriteAlias> newAliases)
                        throws CmsException

Saves the rewrite alias for a given site root.

参数:

cms - the current CMS context

siteRoot - the site root for which the rewrite aliases should be saved

newAliases - the list of aliases to save

抛出:

CmsException - if something goes wrong

updateAliases

public void updateAliases(CmsObject cms,
                 java.util.Collection<CmsAlias> toDelete,
                 java.util.Collection<CmsAlias> toAdd)
                   throws CmsException

Updates the aliases in the database.

参数:

cms - the current CMS context

toDelete - the collection of aliases to delete

toAdd - the collection of aliases to add

抛出:

CmsException - if something goes wrong

checkPermissionsForMassEdit

protected void checkPermissionsForMassEdit(CmsObject cms)
                                    throws CmsException

Checks whether the current user has the permissions to mass edit the alias table, and throws an exception otherwise.

参数:

cms - the current CMS context

抛出:

CmsException

importAlias

protected CmsAliasImportResult importAlias(CmsObject cms,
                               java.lang.String siteRoot,
                               java.lang.String aliasPath,
                               java.lang.String vfsPath,
                               CmsAliasMode mode)
                                    throws CmsException

Imports a single alias.

参数:

cms - the current CMS context

siteRoot - the site root

aliasPath - the alias path

vfsPath - the VFS path

mode - the alias mode

返回:

the result of the import

抛出:

CmsException - if something goes wrong

processAliasImport

protected CmsAliasImportResult processAliasImport(CmsObject cms,
                                      java.lang.String siteRoot,
                                      java.lang.String aliasPath,
                                      java.lang.String vfsPath,
                                      CmsAliasMode mode)

Processes a single alias import operation which has already been parsed into fields.

参数:

cms - the current CMS context

siteRoot - the site root

aliasPath - the alias path

vfsPath - the VFS resource path

mode - the alias mode

返回:

the result of the import operation

processAliasLine

protected CmsAliasImportResult processAliasLine(CmsObject cms,
                                    java.lang.String siteRoot,
                                    java.lang.String line,
                                    java.lang.String separator)

Processes a line from a CSV file containing the alias data to be imported.

参数:

cms - the current CMS context

siteRoot - the site root

line - the line with the data to import

separator - the field separator

返回:

the import result