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
Constructors -
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 StringgetFileExplorerLink(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 CmsLockInfoHelper method for locking a resource which returns some information on whether the locking failed, and why.protected CmsLockInfoHelper 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 StringgetVaadinWorkplaceLink(CmsObject cms, String resourceRootFolder) Returns the workplace link.static StringgetVaadinWorkplaceLink(CmsObject cms, CmsUUID structureId) Returns the workplace link.static I_CmsValidationServicegetValidationService(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> Tinstantiate(Class<T> anInterface, String className) Instantiates a class given its name using its default constructor.static CmsReturnLinkInfointernalGetLinkForReturnCode(CmsObject cms, String returnCode) Implementation method for getting the link for a given return code.Loads the upload restriction info.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 CmsCoreDataprefetch(javax.servlet.http.HttpServletRequest request) Fetches the core data.voidsaveUsedCategory(String category) Saves a category used by the current user.voidSaves the user settings for the current user.voidsetResourceCategories(CmsUUID structureId, List<String> categories) Sets the categories of the given resource.voidsetShowEditorHelp(boolean visible) Sets the show editor help flag.voidsetToolbarVisible(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, tryUnlockMethods inherited from class com.google.gwt.user.server.rpc.RemoteServiceServlet
checkPermutationStrongName, getCodeServerPolicyUrl, getRequestModuleBasePath, getSerializationPolicy, init, loadPolicyFromCodeServer, onAfterResponseSerialized, onBeforeRequestDeserialized, processCall, processCall, processPost, shouldCompressResponseMethods inherited from class com.google.gwt.user.server.rpc.AbstractRemoteServiceServlet
doPost, getPermutationStrongName, getThreadLocalRequest, getThreadLocalResponse, onAfterRequestDeserialized, readContentMethods inherited from class javax.servlet.http.HttpServlet
doDelete, doGet, doHead, doOptions, doPut, doTrace, getLastModified, serviceMethods 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_CmsCoreServiceChanges the password of the current user.- Specified by:
changePasswordin 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_CmsCoreServiceCreates a new UUID.- Specified by:
createUUIDin interfaceI_CmsCoreService- Returns:
- the created UUID
- See Also:
-
getBroadcast
Description copied from interface:I_CmsCoreServiceReturns the latest messages for the current user.- Specified by:
getBroadcastin 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_CmsCoreServiceReturns the categories for the given search parameters.- Specified by:
getCategoriesin interfaceI_CmsCoreService- Parameters:
fromPath- the category path to start with, can benullor 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 benullto 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:
-
getCategoriesForSitePath
Description copied from interface:I_CmsCoreServiceReturns the categories for the given reference site-path.- Specified by:
getCategoriesForSitePathin 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_CmsCoreServiceReturns the category information for the given resource.- Specified by:
getCategoryInfoin 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_CmsCoreServiceGiven a return code, returns the link to the page which corresponds to the return code.- Specified by:
getLinkForReturnCodein 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_CmsCoreServiceGets the resource state for a resource with a given path.- Specified by:
getResourceStatein 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_CmsCoreServiceReturns a unique filename for the given base name and the parent folder.- Specified by:
getUniqueFileNamein 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_CmsCoreServiceReturns the user info.- Specified by:
getUserInfoin interfaceI_CmsCoreService- Returns:
- the user info
- See Also:
-
getWorkplaceLink
Description copied from interface:I_CmsCoreServiceReturns 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:
getWorkplaceLinkin 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_CmsCoreServiceGets the workplace link for the given path.- Specified by:
getWorkplaceLinkForPathin interfaceI_CmsCoreService- Parameters:
path- the path- Returns:
- the workplace link for the path
- Throws:
CmsRpcException- if something goes wrong- See Also:
-
loadUploadRestrictionInfo
Description copied from interface:I_CmsCoreServiceLoads the upload restriction info.- Specified by:
loadUploadRestrictionInfoin interfaceI_CmsCoreService- Returns:
- the upload restriction info
- Throws:
CmsRpcException- if something goes wrong- See Also:
-
loadUserSettings
Description copied from interface:I_CmsCoreServiceLoads the user settings for the current user.- Specified by:
loadUserSettingsin interfaceI_CmsCoreService- Returns:
- the user settings for the current user
- Throws:
CmsRpcException- if something goes wrong- See Also:
-
lockIfExists
Description copied from interface:I_CmsCoreServiceLocks 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:
lockIfExistsin interfaceI_CmsCoreService- Parameters:
sitePath- the site path of the resource to lock- Returns:
nullif successful, an error message if not- Throws:
CmsRpcException- if something goes wrong- See Also:
-
lockIfExists
Description copied from interface:I_CmsCoreServiceLocks 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:
lockIfExistsin interfaceI_CmsCoreService- Parameters:
sitePath- the site path of the resource to lockloadTime- the time when the requested resource was loaded- Returns:
nullif successful, an error message if not- Throws:
CmsRpcException- if something goes wrong- See Also:
-
lockTemp
Description copied from interface:I_CmsCoreServiceLocks the given resource with a temporary lock.- Specified by:
lockTempin interfaceI_CmsCoreService- Parameters:
structureId- the structure id of the resource to lock- Returns:
nullif successful, an error message if not- Throws:
CmsRpcException- if something goes wrong- See Also:
-
lockTemp
Description copied from interface:I_CmsCoreServiceLocks 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:
lockTempin interfaceI_CmsCoreService- Parameters:
structureId- the resource structure idloadTime- the time when the requested resource was loaded- Returns:
nullif successful, an error message if not- Throws:
CmsRpcException- if something goes wrong- See Also:
-
prefetch
Description copied from interface:I_CmsCoreServiceGenerates core data for prefetching in the host page.- Specified by:
prefetchin interfaceI_CmsCoreService- Returns:
- the core data
- See Also:
-
saveUsedCategory
Description copied from interface:I_CmsCoreServiceSaves a category used by the current user.- Specified by:
saveUsedCategoryin interfaceI_CmsCoreService- Parameters:
category- the category- Throws:
CmsRpcException- if something goes wrong- See Also:
-
saveUserSettings
public void saveUserSettings(Map<String, String> userSettings, Set<String> edited) throws CmsRpcExceptionDescription copied from interface:I_CmsCoreServiceSaves the user settings for the current user.- Specified by:
saveUserSettingsin 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_CmsCoreServiceSets the categories of the given resource. Will remove all other categories.- Specified by:
setResourceCategoriesin 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_CmsCoreServiceSets the show editor help flag.- Specified by:
setShowEditorHelpin interfaceI_CmsCoreService- Parameters:
visible- the show help flag- Throws:
CmsRpcException- if something goes wrong- See Also:
-
setToolbarVisible
Description copied from interface:I_CmsCoreServiceWrites the tool-bar visibility into the session cache.- Specified by:
setToolbarVisiblein interfaceI_CmsCoreService- Parameters:
visible-trueif the tool-bar is visible- Throws:
CmsRpcException- if something goes wrong- See Also:
-
unlock
Description copied from interface:I_CmsCoreServiceUnlocks the given resource.- Specified by:
unlockin interfaceI_CmsCoreService- Parameters:
structureId- the structure id of the resource to unlock- Returns:
nullif successful, an error message if not- Throws:
CmsRpcException- if something goes wrong- See Also:
-
unlock
Description copied from interface:I_CmsCoreServiceUnlocks the given resource.- Specified by:
unlockin interfaceI_CmsCoreService- Parameters:
sitePath- the root path of the resource to unlock- Returns:
nullif 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_CmsCoreServicePerforms a batch of validations and returns the results.- Specified by:
validatein 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_CmsCoreServicePerforms a batch of validations using a custom form validator class.- Specified by:
validatein 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
-