org.opencms.site

类 CmsSiteManagerImpl

java.lang.Object

org.opencms.site.CmsSiteManagerImpl

public final class CmsSiteManagerImpl
extends java.lang.Object

Manages all configured sites in OpenCms.

To obtain the configured site manager instance, use OpenCms.getSiteManager().

从以下版本开始:

7.0.2

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	SHARED_FOLDER_TITLE A placeholder for the title of the shared folder.

构造器概要

构造器

构造器和说明
CmsSiteManagerImpl() Creates a new CmsSiteManager.

方法概要

方法

限定符和类型	方法和说明
void	addAliasToConfigSite(java.lang.String alias, java.lang.String offset) Adds an alias to the currently configured site.
void	addSite(CmsObject cms, CmsSite site) Adds a site.
void	addSite(java.lang.String server, java.lang.String uri, java.lang.String title, java.lang.String position, java.lang.String errorPage, java.lang.String webserver, java.lang.String secureServer, java.lang.String exclusive, java.lang.String error) Adds a new CmsSite to the list of configured sites, this is only allowed during configuration.
java.util.List<CmsSite>	getAvailableSites(CmsObject cms, boolean workplaceMode) Returns a list of all sites available for the current user.
java.util.List<CmsSite>	getAvailableSites(CmsObject cms, boolean workplaceMode, boolean showShared, java.lang.String ouFqn) Returns a list of all CmsSite instances that are compatible to the given organizational unit.
java.util.List<CmsSite>	getAvailableSites(CmsObject cms, boolean workplaceMode, java.lang.String ouFqn) Returns a list of all CmsSite instances that are compatible to the given organizational unit.
CmsSite	getCurrentSite(CmsObject cms) Returns the current site for the provided OpenCms user context object.
CmsSite	getDefaultSite() Returns the default site.
java.lang.String	getDefaultUri() Returns the defaultUri.
java.lang.String	getSharedFolder() Returns the shared folder path.
CmsSite	getSite(java.lang.String rootPath, java.lang.String fallbackSiteRoot) Returns the site for the given resource path, using the fall back site root in case the resource path is no root path.
CmsSite	getSiteForRootPath(java.lang.String rootPath) Returns the site for the given resources root path, or null if the resources root path does not match any site.
CmsSite	getSiteForSiteRoot(java.lang.String siteRoot) Returns the site with has the provided site root, or null if no configured site has that site root.
java.lang.String	getSiteRoot(java.lang.String rootPath) Returns the site root part for the given resources root path, or null if the given resources root path does not match any site root.
java.util.Set<java.lang.String>	getSiteRoots() Returns an unmodifiable set of all configured site roots (Strings).
java.util.Map<CmsSiteMatcher,CmsSite>	getSites() Returns the map of configured sites, using CmsSiteMatcher objects as keys and CmsSite objects as values.
java.lang.String	getWorkplaceServer() Returns the workplace server.
CmsSiteMatcher	getWorkplaceSiteMatcher() Returns the site matcher that matches the workplace site.
void	initialize(CmsObject cms) Initializes the site manager with the OpenCms system configuration.
boolean	isMatching(CmsSiteMatcher matcher) Returns true if the given site matcher matches any configured site, which includes the workplace site.
boolean	isMatchingCurrentSite(CmsObject cms, CmsSiteMatcher matcher) Returns true if the given site matcher matches the current site.
boolean	isSharedFolder(java.lang.String name) Checks if the given path is that of a shared folder.
boolean	isSiteRoot(java.lang.String rootPath) Checks whether a given root path is a site root.
boolean	isWorkplaceRequest(CmsSiteMatcher matcher) Returns true if the given site matcher matches the configured OpenCms workplace.
boolean	isWorkplaceRequest(javax.servlet.http.HttpServletRequest req) Returns true if the given request is against the configured OpenCms workplace.
CmsSite	matchRequest(javax.servlet.http.HttpServletRequest req) Matches the given request against all configures sites and returns the matching site, or the default site if no sites matches.
CmsSite	matchSite(CmsSiteMatcher matcher) Return the configured site that matches the given site matcher, or the default site if no sites matches.
void	removeSite(CmsObject cms, CmsSite site) Removed a site.
void	setDefaultUri(java.lang.String defaultUri) Sets the default URI, this is only allowed during configuration.
void	setSharedFolder(java.lang.String sharedFolder) Sets the shared folder path.
void	setWorkplaceServer(java.lang.String workplaceServer) Sets the workplace server, this is only allowed during configuration.
boolean	startsWithShared(java.lang.String path) Returns true if the path starts with the shared folder path.
void	updateGeneralSettings(CmsObject cms, java.lang.String defaulrUri, java.lang.String workplaceServer, java.lang.String sharedFolder) Updates the general settings.
void	updateSite(CmsObject cms, CmsSite oldSite, CmsSite newSite) Updates an existing site.

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

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

字段详细资料

SHARED_FOLDER_TITLE

public static final java.lang.String SHARED_FOLDER_TITLE

A placeholder for the title of the shared folder.

另请参阅:

常量字段值

构造器详细资料

CmsSiteManagerImpl

public CmsSiteManagerImpl()

Creates a new CmsSiteManager.

方法详细资料

addAliasToConfigSite

public void addAliasToConfigSite(java.lang.String alias,
                        java.lang.String offset)

Adds an alias to the currently configured site.

参数:

alias - the URL of the alias server

offset - the optional time offset for this alias

addSite

public void addSite(CmsObject cms,
           CmsSite site)
             throws CmsException

Adds a site.

参数:

cms - the CMS object

site - the site to add

抛出:

CmsException - if something goes wrong

addSite

public void addSite(java.lang.String server,
           java.lang.String uri,
           java.lang.String title,
           java.lang.String position,
           java.lang.String errorPage,
           java.lang.String webserver,
           java.lang.String secureServer,
           java.lang.String exclusive,
           java.lang.String error)
             throws CmsConfigurationException

Adds a new CmsSite to the list of configured sites, this is only allowed during configuration.

If this method is called after the configuration is finished, a RuntimeException is thrown.

参数:

server - the Server

uri - the VFS path

title - the display title for this site

position - the display order for this site

errorPage - the URI to use as error page for this site

webserver - indicates whether to write the web server configuration for this site or not

secureServer - a secure server, can be null

exclusive - if set to true, secure resources will only be available using the configured secure url

error - if exclusive, and set to true will generate a 404 error, if set to false will redirect to secure URL

抛出:

CmsConfigurationException - if the site contains a server name, that is already assigned

getAvailableSites

public java.util.List<CmsSite> getAvailableSites(CmsObject cms,
                                        boolean workplaceMode)

Returns a list of all sites available for the current user.

参数:

cms - the current OpenCms user context

workplaceMode - if true, the root and current site is included for the admin user and the view permission is required to see the site root

返回:

a list of all site available for the current user

getAvailableSites

public java.util.List<CmsSite> getAvailableSites(CmsObject cms,
                                        boolean workplaceMode,
                                        boolean showShared,
                                        java.lang.String ouFqn)

Returns a list of all CmsSite instances that are compatible to the given organizational unit.

参数:

cms - the current OpenCms user context

workplaceMode - if true, the root and current site is included for the admin user and the view permission is required to see the site root

showShared - if the shared folder should be shown

ouFqn - the organizational unit

返回:

a list of all site available for the current user

getAvailableSites

public java.util.List<CmsSite> getAvailableSites(CmsObject cms,
                                        boolean workplaceMode,
                                        java.lang.String ouFqn)

Returns a list of all CmsSite instances that are compatible to the given organizational unit.

参数:

cms - the current OpenCms user context

workplaceMode - if true, the root and current site is included for the admin user and the view permission is required to see the site root

ouFqn - the organizational unit

返回:

a list of all site available for the current user

getCurrentSite

public CmsSite getCurrentSite(CmsObject cms)

Returns the current site for the provided OpenCms user context object.

In the unlikely case that no site matches with the provided OpenCms user context, the default site is returned.

参数:

cms - the OpenCms user context object to check for the site

返回:

the current site for the provided OpenCms user context object

getDefaultSite

public CmsSite getDefaultSite()

Returns the default site.

返回:

the default site

getDefaultUri

public java.lang.String getDefaultUri()

Returns the defaultUri.

返回:

the defaultUri

getSharedFolder

public java.lang.String getSharedFolder()

Returns the shared folder path.

返回:

the shared folder path

getSite

public CmsSite getSite(java.lang.String rootPath,
              java.lang.String fallbackSiteRoot)

Returns the site for the given resource path, using the fall back site root in case the resource path is no root path.

In case neither the given resource path, nor the given fall back site root matches any configured site, the default site is returned.

Usually the fall back site root should be taken from CmsRequestContext.getSiteRoot(), in which case a site for the site root should always exist.

This is the same as first calling getSiteForRootPath(String) with the resourcePath parameter, and if this fails calling getSiteForSiteRoot(String) with the fallbackSiteRoot parameter, and if this fails calling getDefaultSite().

参数:

rootPath - the resource root path to get the site for

fallbackSiteRoot - site root to use in case the resource path is no root path

返回:

the site for the given resource path, using the fall back site root in case the resource path is no root path

另请参阅:

getSiteForRootPath(String)

getSiteForRootPath

public CmsSite getSiteForRootPath(java.lang.String rootPath)

Returns the site for the given resources root path, or null if the resources root path does not match any site.

参数:

rootPath - the root path of a resource

返回:

the site for the given resources root path, or null if the resources root path does not match any site

另请参阅:

getSiteForSiteRoot(String), getSiteRoot(String)

getSiteForSiteRoot

public CmsSite getSiteForSiteRoot(java.lang.String siteRoot)

Returns the site with has the provided site root, or null if no configured site has that site root.

The site root must have the form: /sites/default.
That means there must be a leading, but no trailing slash.

参数:

siteRoot - the site root to look up the site for

返回:

the site with has the provided site root, or null if no configured site has that site root

另请参阅:

getSiteForRootPath(String)

getSiteRoot

public java.lang.String getSiteRoot(java.lang.String rootPath)

Returns the site root part for the given resources root path, or null if the given resources root path does not match any site root.

The site root returned will have the form: /sites/default.
That means there will a leading, but no trailing slash.

参数:

rootPath - the root path of a resource

返回:

the site root part of the resources root path, or null if the path does not match any site root

另请参阅:

getSiteForRootPath(String)

getSiteRoots

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

Returns an unmodifiable set of all configured site roots (Strings).

返回:

an unmodifiable set of all configured site roots (Strings)

getSites

public java.util.Map<CmsSiteMatcher,CmsSite> getSites()

Returns the map of configured sites, using CmsSiteMatcher objects as keys and CmsSite objects as values.

返回:

the map of configured sites, using CmsSiteMatcher objects as keys and CmsSite objects as values

getWorkplaceServer

public java.lang.String getWorkplaceServer()

Returns the workplace server.

返回:

the workplace server

getWorkplaceSiteMatcher

public CmsSiteMatcher getWorkplaceSiteMatcher()

Returns the site matcher that matches the workplace site.

返回:

the site matcher that matches the workplace site

initialize

public void initialize(CmsObject cms)

Initializes the site manager with the OpenCms system configuration.

参数:

cms - an OpenCms context object that must have been initialized with "Admin" permissions

isMatching

public boolean isMatching(CmsSiteMatcher matcher)

Returns true if the given site matcher matches any configured site, which includes the workplace site.

参数:

matcher - the site matcher to match the site with

返回:

true if the matcher matches a site

isMatchingCurrentSite

public boolean isMatchingCurrentSite(CmsObject cms,
                            CmsSiteMatcher matcher)

Returns true if the given site matcher matches the current site.

参数:

cms - the current OpenCms user context

matcher - the site matcher to match the site with

返回:

true if the matcher matches the current site

isSharedFolder

public boolean isSharedFolder(java.lang.String name)

Checks if the given path is that of a shared folder.

参数:

name - a path prefix

返回:

true if the given prefix represents a shared folder

isSiteRoot

public boolean isSiteRoot(java.lang.String rootPath)

Checks whether a given root path is a site root.

参数:

rootPath - a root path

返回:

true if the given path is the path of a site root

isWorkplaceRequest

public boolean isWorkplaceRequest(CmsSiteMatcher matcher)

Returns true if the given site matcher matches the configured OpenCms workplace.

参数:

matcher - the site matcher to match the site with

返回:

true if the given site matcher matches the configured OpenCms workplace

isWorkplaceRequest

public boolean isWorkplaceRequest(javax.servlet.http.HttpServletRequest req)

Returns true if the given request is against the configured OpenCms workplace.

参数:

req - the request to match

返回:

true if the given request is against the configured OpenCms workplace

matchRequest

public CmsSite matchRequest(javax.servlet.http.HttpServletRequest req)

Matches the given request against all configures sites and returns the matching site, or the default site if no sites matches.

参数:

req - the request to match

返回:

the matching site, or the default site if no sites matches

matchSite

public CmsSite matchSite(CmsSiteMatcher matcher)

Return the configured site that matches the given site matcher, or the default site if no sites matches.

参数:

matcher - the site matcher to match the site with

返回:

the matching site, or the default site if no sites matches

removeSite

public void removeSite(CmsObject cms,
              CmsSite site)
                throws CmsException

Removed a site.

参数:

cms - the cms object

site - the site to remove

抛出:

CmsException - if something goes wrong

setDefaultUri

public void setDefaultUri(java.lang.String defaultUri)

Sets the default URI, this is only allowed during configuration.

If this method is called after the configuration is finished, a RuntimeException is thrown.

参数:

defaultUri - the defaultUri to set

setSharedFolder

public void setSharedFolder(java.lang.String sharedFolder)

Sets the shared folder path.

参数:

sharedFolder - the shared folder path

setWorkplaceServer

public void setWorkplaceServer(java.lang.String workplaceServer)

Sets the workplace server, this is only allowed during configuration.

If this method is called after the configuration is finished, a RuntimeException is thrown.

参数:

workplaceServer - the workplace server to set

startsWithShared

public boolean startsWithShared(java.lang.String path)

Returns true if the path starts with the shared folder path.

参数:

path - the path to check

返回:

true if the path starts with the shared folder path

updateGeneralSettings

public void updateGeneralSettings(CmsObject cms,
                         java.lang.String defaulrUri,
                         java.lang.String workplaceServer,
                         java.lang.String sharedFolder)
                           throws CmsException

Updates the general settings.

参数:

cms - the cms to use

defaulrUri - the default URI

workplaceServer - the workplace server URL

sharedFolder - the shared folder URI

抛出:

CmsException - if something goes wrong

updateSite

public void updateSite(CmsObject cms,
              CmsSite oldSite,
              CmsSite newSite)
                throws CmsException

Updates an existing site.

参数:

cms - the CMS object

oldSite - the site to remove if not null

newSite - the site to add if not null

抛出:

CmsException - if something goes wrong