Package org.opencms.gwt
Class CmsCoreService
java.lang.Object
javax.servlet.GenericServlet
javax.servlet.http.HttpServlet
com.google.gwt.user.server.rpc.AbstractRemoteServiceServlet
com.google.gwt.user.server.rpc.RemoteServiceServlet
org.opencms.gwt.CmsGwtService
org.opencms.gwt.CmsCoreService
- All Implemented Interfaces:
com.google.gwt.user.client.rpc.RemoteService
,com.google.gwt.user.server.rpc.SerializationPolicyProvider
,Serializable
,javax.servlet.Servlet
,javax.servlet.ServletConfig
,I_CmsCoreService
Provides general core services.
- Since:
- 8.0.0
- See Also:
-
Field Summary
Fields inherited from class com.google.gwt.user.server.rpc.AbstractRemoteServiceServlet
perThreadRequest, perThreadResponse
-
Constructor Summary
-
Method Summary
Modifier and TypeMethodDescriptionstatic List<CmsCategoryTreeEntry>
buildCategoryTree
(CmsObject cms, List<CmsCategory> categories) Builds the tree structure for the given categories.changePassword
(String oldPassword, String newPassword, String newPasswordConfirm) Changes the password of the current user.Creates a new UUID.Returns the latest messages for the current user.Collect GWT build ids from the different ADE modules.getCategories
(String fromPath, boolean includeSubCats, String refPath, boolean showWithRepositories, Set<String> selected) Returns the categories for the given search parameters.getCategoriesForSitePath
(String sitePath) Returns the categories for the given reference site-path.static List<CmsCategoryTreeEntry>
getCategoriesForSitePathStatic
(CmsObject cms, String sitePath) Helper method for getting the category beans for the given site path.static List<CmsCategoryTreeEntry>
getCategoriesForSitePathStatic
(CmsObject cms, String sitePath, String localCategoryRepositoryPath) Helper method for getting the category beans for the given site path.getCategoryInfo
(CmsUUID structureId) Returns the category information for the given resource.static List<CmsContextMenuEntryBean>
getContextMenuEntries
(CmsObject cms, CmsUUID structureId, CmsCoreData.AdeContext context, Map<String, String> params) Returns the context menu entries for the given URI.getContextMenuEntries
(CmsUUID structureId, CmsCoreData.AdeContext context) Returns the context menu entries for the given URI.getContextMenuEntries
(CmsUUID structureId, CmsCoreData.AdeContext context, Map<String, String> params) Returns the context menu entries for the given URI.static String
getFileExplorerLink
(CmsObject cms, String siteRoot) Returns the file explorer link prefix.getLinkForReturnCode
(String returnCode) Given a return code, returns the link to the page which corresponds to the return code.protected CmsLockInfo
Helper method for locking a resource which returns some information on whether the locking failed, and why.protected CmsLockInfo
Helper method for locking a resource which returns some information on whether the locking failed, and why.getResourceState
(CmsUUID structureId) Gets the resource state for a resource with a given path.getUniqueFileName
(String parentFolder, String baseName) Returns a unique filename for the given base name and the parent folder.Returns the user info.static String
getVaadinWorkplaceLink
(CmsObject cms, String resourceRootFolder) Returns the workplace link.static String
getVaadinWorkplaceLink
(CmsObject cms, CmsUUID structureId) Returns the workplace link.static I_CmsValidationService
getValidationService
(String name) Internal helper method for getting a validation service.getWorkplaceLink
(CmsUUID structureId) Returns a link for the OpenCms workplace that will reload the whole workplace, switch to the explorer view, the site of the given explorerRootPath and show the folder given in the explorerRootPath.Gets the workplace link for the given path.static <T> T
instantiate
(Class<T> anInterface, String className) Instantiates a class given its name using its default constructor.static CmsReturnLinkInfo
internalGetLinkForReturnCode
(CmsObject cms, String returnCode) Implementation method for getting the link for a given return code.Loads the user settings for the current user.lockIfExists
(String sitePath) Locks the given resource with a temporary lock if it exists.lockIfExists
(String sitePath, long loadTime) Locks the given resource with a temporary lock if it exists.Locks the given resource with a temporary lock.Locks the given resource with a temporary lock.prefetch()
Generates core data for prefetching in the host page.static CmsCoreData
prefetch
(javax.servlet.http.HttpServletRequest request) Fetches the core data.void
Saves the user settings for the current user.void
setResourceCategories
(CmsUUID structureId, List<String> categories) Sets the categories of the given resource.void
setShowEditorHelp
(boolean visible) Sets the show editor help flag.void
setToolbarVisible
(boolean visible) Writes the tool-bar visibility into the session cache.Unlocks the given resource.Unlocks the given resource.validate
(String formValidatorClass, Map<String, CmsValidationQuery> validationQueries, Map<String, String> values, String config) Performs a batch of validations using a custom form validator class.validate
(Map<String, CmsValidationQuery> validationQueries) Performs a batch of validations and returns the results.Methods inherited from class org.opencms.gwt.CmsGwtService
checkPermissions, clearThreadStorage, doGetSerializationPolicy, doUnexpectedFailure, ensureLock, ensureLock, ensureLock, ensureLock, ensureSession, error, getCmsObject, getPropertiesByName, getRequest, getResponse, isBroadcastCall, log, log, logError, service, setBroadcastPoll, setCms, setContext, setRequest, setResponse, tryUnlock
Methods inherited from class com.google.gwt.user.server.rpc.RemoteServiceServlet
checkPermutationStrongName, getCodeServerPolicyUrl, getRequestModuleBasePath, getSerializationPolicy, init, loadPolicyFromCodeServer, onAfterResponseSerialized, onBeforeRequestDeserialized, processCall, processCall, processPost, shouldCompressResponse
Methods inherited from class com.google.gwt.user.server.rpc.AbstractRemoteServiceServlet
doPost, getPermutationStrongName, getThreadLocalRequest, getThreadLocalResponse, onAfterRequestDeserialized, readContent
Methods inherited from class javax.servlet.http.HttpServlet
doDelete, doGet, doHead, doOptions, doPut, doTrace, getLastModified, service
Methods inherited from class javax.servlet.GenericServlet
destroy, getInitParameter, getInitParameterNames, getServletConfig, getServletContext, getServletInfo, getServletName, init
-
Constructor Details
-
CmsCoreService
public CmsCoreService()
-
-
Method Details
-
buildCategoryTree
public static List<CmsCategoryTreeEntry> buildCategoryTree(CmsObject cms, List<CmsCategory> categories) Builds the tree structure for the given categories.- Parameters:
cms
- the current cms contextcategories
- the categories- Returns:
- the tree root element
-
getCategoriesForSitePathStatic
public static List<CmsCategoryTreeEntry> getCategoriesForSitePathStatic(CmsObject cms, String sitePath) throws CmsException Helper method for getting the category beans for the given site path.- Parameters:
cms
- the CMS context to usesitePath
- the site path- Returns:
- the list of category beans
- Throws:
CmsException
- if something goes wrong
-
getCategoriesForSitePathStatic
public static List<CmsCategoryTreeEntry> getCategoriesForSitePathStatic(CmsObject cms, String sitePath, String localCategoryRepositoryPath) throws CmsException Helper method for getting the category beans for the given site path.- Parameters:
cms
- the CMS context to usesitePath
- the site pathlocalCategoryRepositoryPath
- the categories for this repository are added separately- Returns:
- the list of category beans
- Throws:
CmsException
- if something goes wrong
-
getFileExplorerLink
Returns the file explorer link prefix. Append resource site path for complete link.- Parameters:
cms
- the cms contextsiteRoot
- the site root- Returns:
- the file explorer link prefix
-
getVaadinWorkplaceLink
Returns the workplace link.- Parameters:
cms
- the cms contextstructureId
- the structure id of the current resource- Returns:
- the workplace link
-
getVaadinWorkplaceLink
Returns the workplace link.- Parameters:
cms
- the cms contextresourceRootFolder
- the resource folder root path- Returns:
- the workplace link
-
getValidationService
Internal helper method for getting a validation service.- Parameters:
name
- the class name of the validation service- Returns:
- the validation service
- Throws:
CmsException
- if something goes wrong
-
instantiate
Instantiates a class given its name using its default constructor.Also checks whether the class with the given name is the subclass of another class/interface.
- Type Parameters:
T
- the type of the interface/class passed as a parameter- Parameters:
anInterface
- the interface or class against which the class should be checkedclassName
- the name of the class- Returns:
- a new instance of the class
- Throws:
CmsException
- if the instantiation fails
-
internalGetLinkForReturnCode
public static CmsReturnLinkInfo internalGetLinkForReturnCode(CmsObject cms, String returnCode) throws CmsException Implementation method for getting the link for a given return code.- Parameters:
cms
- the CMS contextreturnCode
- the return code- Returns:
- the link for the return code
- Throws:
CmsException
- if something goes wrong
-
prefetch
Fetches the core data.- Parameters:
request
- the current request- Returns:
- the core data
-
changePassword
public String changePassword(String oldPassword, String newPassword, String newPasswordConfirm) throws CmsRpcException Description copied from interface:I_CmsCoreService
Changes the password of the current user.- Specified by:
changePassword
in interfaceI_CmsCoreService
- Parameters:
oldPassword
- the old passwordnewPassword
- the value entered for the new passwordnewPasswordConfirm
- the value entered for the confirmation of the new password- Returns:
- an error message if an error occurred, or null if the password was successfully changed
- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
createUUID
Description copied from interface:I_CmsCoreService
Creates a new UUID.- Specified by:
createUUID
in interfaceI_CmsCoreService
- Returns:
- the created UUID
- See Also:
-
getBroadcast
Description copied from interface:I_CmsCoreService
Returns the latest messages for the current user.- Specified by:
getBroadcast
in interfaceI_CmsCoreService
- Returns:
- the messages
- See Also:
-
getCategories
public List<CmsCategoryTreeEntry> getCategories(String fromPath, boolean includeSubCats, String refPath, boolean showWithRepositories, Set<String> selected) throws CmsRpcException Description copied from interface:I_CmsCoreService
Returns the categories for the given search parameters.- Specified by:
getCategories
in interfaceI_CmsCoreService
- Parameters:
fromPath
- the category path to start with, can benull
or empty to use the rootincludeSubCats
- if to include all categories, or first level child categories onlyrefPath
- the reference path (site-relative path according to which the available category repositories are determined), can benull
to only use the system repositoryshowWithRepositories
- flag, indicating if also the category repositories should be returned as categoryselected
- a set of paths of currently selected categories (which should be included in the result even if they are marked as hidden)- Returns:
- the resource categories
- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
org.opencms.gwt.shared.rpc.I_CmsCoreService#getCategories(java.lang.String, boolean, java.lang.String, boolean)
-
getCategoriesForSitePath
Description copied from interface:I_CmsCoreService
Returns the categories for the given reference site-path.- Specified by:
getCategoriesForSitePath
in interfaceI_CmsCoreService
- Parameters:
sitePath
- the reference site-path- Returns:
- the categories for the given reference site-path
- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
getCategoryInfo
Description copied from interface:I_CmsCoreService
Returns the category information for the given resource.- Specified by:
getCategoryInfo
in interfaceI_CmsCoreService
- Parameters:
structureId
- the resource structure id- Returns:
- the category information
- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
getLinkForReturnCode
Description copied from interface:I_CmsCoreService
Given a return code, returns the link to the page which corresponds to the return code.- Specified by:
getLinkForReturnCode
in interfaceI_CmsCoreService
- Parameters:
returnCode
- the return code- Returns:
- the link for the return code
- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
getResourceState
Description copied from interface:I_CmsCoreService
Gets the resource state for a resource with a given path.- Specified by:
getResourceState
in interfaceI_CmsCoreService
- Parameters:
structureId
- the resource structure id- Returns:
- the resource state of the resource
- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
getUniqueFileName
Description copied from interface:I_CmsCoreService
Returns a unique filename for the given base name and the parent folder.- Specified by:
getUniqueFileName
in interfaceI_CmsCoreService
- Parameters:
parentFolder
- the parent folder of the filebaseName
- the proposed file name- Returns:
- the unique file name
- See Also:
-
getUserInfo
Description copied from interface:I_CmsCoreService
Returns the user info.- Specified by:
getUserInfo
in interfaceI_CmsCoreService
- Returns:
- the user info
- See Also:
-
getWorkplaceLink
Description copied from interface:I_CmsCoreService
Returns a link for the OpenCms workplace that will reload the whole workplace, switch to the explorer view, the site of the given explorerRootPath and show the folder given in the explorerRootPath.- Specified by:
getWorkplaceLink
in interfaceI_CmsCoreService
- Parameters:
structureId
- the structure id of the resource for which to open the workplace- Returns:
- a link for the OpenCms workplace that will reload the whole workplace, switch to the explorer view, the site of the given explorerRootPath and show the folder given in the explorerRootPath.
- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
getWorkplaceLinkForPath
Description copied from interface:I_CmsCoreService
Gets the workplace link for the given path.- Specified by:
getWorkplaceLinkForPath
in interfaceI_CmsCoreService
- Parameters:
path
- the path- Returns:
- the workplace link for the path
- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
loadUserSettings
Description copied from interface:I_CmsCoreService
Loads the user settings for the current user.- Specified by:
loadUserSettings
in interfaceI_CmsCoreService
- Returns:
- the user settings for the current user
- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
lockIfExists
Description copied from interface:I_CmsCoreService
Locks the given resource with a temporary lock if it exists.If the resource does not exist yet, the closest existing ancestor folder will check if it is lockable.
- Specified by:
lockIfExists
in interfaceI_CmsCoreService
- Parameters:
sitePath
- the site path of the resource to lock- Returns:
null
if successful, an error message if not- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
lockIfExists
Description copied from interface:I_CmsCoreService
Locks the given resource with a temporary lock if it exists.If the resource does not exist yet, the closest existing ancestor folder will check if it is lockable.
- Specified by:
lockIfExists
in interfaceI_CmsCoreService
- Parameters:
sitePath
- the site path of the resource to lockloadTime
- the time when the requested resource was loaded- Returns:
null
if successful, an error message if not- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
lockTemp
Description copied from interface:I_CmsCoreService
Locks the given resource with a temporary lock.- Specified by:
lockTemp
in interfaceI_CmsCoreService
- Parameters:
structureId
- the structure id of the resource to lock- Returns:
null
if successful, an error message if not- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
lockTemp
Description copied from interface:I_CmsCoreService
Locks the given resource with a temporary lock.Locking will fail in case the requested resource has been changed since the given load time.
- Specified by:
lockTemp
in interfaceI_CmsCoreService
- Parameters:
structureId
- the resource structure idloadTime
- the time when the requested resource was loaded- Returns:
null
if successful, an error message if not- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
prefetch
Description copied from interface:I_CmsCoreService
Generates core data for prefetching in the host page.- Specified by:
prefetch
in interfaceI_CmsCoreService
- Returns:
- the core data
- See Also:
-
saveUserSettings
public void saveUserSettings(Map<String, String> userSettings, Set<String> edited) throws CmsRpcExceptionDescription copied from interface:I_CmsCoreService
Saves the user settings for the current user.- Specified by:
saveUserSettings
in interfaceI_CmsCoreService
- Parameters:
userSettings
- the new values for the user settingsedited
- the keys of the user settings which were actually edited- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
setResourceCategories
public void setResourceCategories(CmsUUID structureId, List<String> categories) throws CmsRpcException Description copied from interface:I_CmsCoreService
Sets the categories of the given resource. Will remove all other categories.- Specified by:
setResourceCategories
in interfaceI_CmsCoreService
- Parameters:
structureId
- the resource structure idcategories
- the categories to set- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
setShowEditorHelp
Description copied from interface:I_CmsCoreService
Sets the show editor help flag.- Specified by:
setShowEditorHelp
in interfaceI_CmsCoreService
- Parameters:
visible
- the show help flag- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
setToolbarVisible
Description copied from interface:I_CmsCoreService
Writes the tool-bar visibility into the session cache.- Specified by:
setToolbarVisible
in interfaceI_CmsCoreService
- Parameters:
visible
-true
if the tool-bar is visible- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
unlock
Description copied from interface:I_CmsCoreService
Unlocks the given resource.- Specified by:
unlock
in interfaceI_CmsCoreService
- Parameters:
structureId
- the structure id of the resource to unlock- Returns:
null
if successful, an error message if not- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
unlock
Description copied from interface:I_CmsCoreService
Unlocks the given resource.- Specified by:
unlock
in interfaceI_CmsCoreService
- Parameters:
sitePath
- the root path of the resource to unlock- Returns:
null
if successful, an error message if not- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
validate
public Map<String,CmsValidationResult> validate(Map<String, CmsValidationQuery> validationQueries) throws CmsRpcExceptionDescription copied from interface:I_CmsCoreService
Performs a batch of validations and returns the results.- Specified by:
validate
in interfaceI_CmsCoreService
- Parameters:
validationQueries
- a map from field names to validation queries- Returns:
- a map from field names to validation results
- Throws:
CmsRpcException
- if something goes wrong- See Also:
-
validate
public Map<String,CmsValidationResult> validate(String formValidatorClass, Map<String, CmsValidationQuery> validationQueries, Map<String, throws CmsRpcExceptionString> values, String config) Description copied from interface:I_CmsCoreService
Performs a batch of validations using a custom form validator class.- Specified by:
validate
in interfaceI_CmsCoreService
- Parameters:
formValidatorClass
- the class name of the form validatorvalidationQueries
- a map from field names to validation queriesvalues
- the map of all field valuesconfig
- the form validator configuration string- Returns:
- a map from field names to validation results
- Throws:
CmsRpcException
- if the RPC call goes wrong- See Also:
-
getBuildIds
Collect GWT build ids from the different ADE modules.- Returns:
- the map of GWT build ids
-
getLock
Helper method for locking a resource which returns some information on whether the locking failed, and why.- Parameters:
structureId
- the structure id of the resource- Returns:
- the locking information
- Throws:
CmsException
- if something went wrong
-
getLock
Helper method for locking a resource which returns some information on whether the locking failed, and why.- Parameters:
sitepath
- the site path of the resource to lock- Returns:
- the locking information
- Throws:
CmsException
- if something went wrong
-