org.opencms.gwt.shared.rpc

接口 I_CmsCoreService

所有超级接口:

com.google.gwt.user.client.rpc.RemoteService

所有已知实现类:

CmsCoreService

public interface I_CmsCoreService
extends com.google.gwt.user.client.rpc.RemoteService

Provides general core services.

从以下版本开始:

8.0.0

另请参阅:

CmsCoreService, I_CmsCoreService, I_CmsCoreServiceAsync

方法概要

方法

限定符和类型	方法和说明
CmsUUID	createUUID() Creates a new UUID.
java.util.List<CmsCategoryTreeEntry>	getCategories(java.lang.String fromCatPath, boolean includeSubCats, java.util.List<java.lang.String> refVfsPaths) Returns the categories for the given search parameters.
java.util.List<CmsCategoryTreeEntry>	getCategoriesForSitePath(java.lang.String sitePath) Returns the categories for the given reference site-path.
CmsResourceCategoryInfo	getCategoryInfo(CmsUUID structureId) Returns the category information for the given resource.
java.util.List<CmsContextMenuEntryBean>	getContextMenuEntries(CmsUUID structureId, CmsCoreData.AdeContext context) Returns the context menu entries for the given URI.
CmsReturnLinkInfo	getLinkForReturnCode(java.lang.String returnCode) Given a return code, returns the link to the page which corresponds to the return code.
CmsResourceState	getResourceState(CmsUUID structureId) Gets the resource state for a resource with a given path.
java.lang.String	getUniqueFileName(java.lang.String parentFolder, java.lang.String baseName) Returns a unique filename for the given base name and the parent folder.
java.lang.String	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.
java.lang.String	lockIfExists(java.lang.String sitePath) Locks the given resource with a temporary lock if it exists.
java.lang.String	lockTemp(CmsUUID structureId) Locks the given resource with a temporary lock.
CmsLockInfo	lockTempAndCheckModification(CmsUUID structureId, long modification) Locks the given resource with a temporary lock additionally checking that the given resource has not been modified after the given timestamp.
void	ping() An RPC method which does nothing and is just used to keep the session alive.
CmsCoreData	prefetch() Generates core data for prefetching in the host page.
void	setAvailabilityInfo(CmsUUID structureId, CmsAvailabilityInfoBean bean) Applies the changes stored in the info bean to the vfs of OpenCms.
void	setAvailabilityInfo(java.lang.String vfsPath, CmsAvailabilityInfoBean bean) Applies the changes stored in the info bean to the vfs of OpenCms.
void	setResourceCategories(CmsUUID structureId, java.util.List<java.lang.String> categories) Sets the categories of the given resource.
void	setShowEditorHelp(boolean showHelp) Sets the show editor help flag.
void	setToolbarVisible(boolean visible) Writes the tool-bar visibility into the session cache.
java.lang.String	unlock(CmsUUID structureId) Unlocks the given resource.
java.lang.String	unlock(java.lang.String sitePath) Unlocks the given resource.
java.util.Map<java.lang.String,CmsValidationResult>	validate(java.util.Map<java.lang.String,CmsValidationQuery> validationQueries) Performs a batch of validations and returns the results.
java.util.Map<java.lang.String,CmsValidationResult>	validate(java.lang.String formValidatorClass, java.util.Map<java.lang.String,CmsValidationQuery> validationQueries, java.util.Map<java.lang.String,java.lang.String> values, java.lang.String config) Performs a batch of validations using a custom form validator class.

方法详细资料

createUUID

CmsUUID createUUID()
                   throws CmsRpcException

Creates a new UUID.

返回:

the created UUID

抛出:

CmsRpcException - if something goes wrong

getCategories

java.util.List<CmsCategoryTreeEntry> getCategories(java.lang.String fromCatPath,
                                                 boolean includeSubCats,
                                                 java.util.List<java.lang.String> refVfsPaths)
                                                   throws CmsRpcException

Returns the categories for the given search parameters.

参数:

fromCatPath - the category path to start with, can be null or empty to use the root

includeSubCats - if to include all categories, or first level child categories only

refVfsPaths - the reference paths, can be null to only use the system repository

返回:

the resource categories

抛出:

CmsRpcException - if something goes wrong

getCategoriesForSitePath

java.util.List<CmsCategoryTreeEntry> getCategoriesForSitePath(java.lang.String sitePath)
                                                              throws CmsRpcException

Returns the categories for the given reference site-path.

参数:

sitePath - the reference site-path

返回:

the categories for the given reference site-path

抛出:

CmsRpcException - if something goes wrong

getCategoryInfo

CmsResourceCategoryInfo getCategoryInfo(CmsUUID structureId)
                                        throws CmsRpcException

Returns the category information for the given resource.

参数:

structureId - the resource structure id

返回:

the category information

抛出:

CmsRpcException - if something goes wrong

getContextMenuEntries

java.util.List<CmsContextMenuEntryBean> getContextMenuEntries(CmsUUID structureId,
                                                            CmsCoreData.AdeContext context)
                                                              throws CmsRpcException

Returns the context menu entries for the given URI.

参数:

structureId - the currently requested structure id

context - the ade context (sitemap or containerpage)

返回:

the context menu entries

抛出:

CmsRpcException - if something goes wrong

getLinkForReturnCode

CmsReturnLinkInfo getLinkForReturnCode(java.lang.String returnCode)
                                       throws CmsRpcException

Given a return code, returns the link to the page which corresponds to the return code.

参数:

returnCode - the return code

返回:

the link for the return code

抛出:

CmsRpcException - if something goes wrong

getResourceState

CmsResourceState getResourceState(CmsUUID structureId)
                                  throws CmsRpcException

Gets the resource state for a resource with a given path.

参数:

structureId - the resource structure id

返回:

the resource state of the resource

抛出:

CmsRpcException - if something goes wrong

getUniqueFileName

java.lang.String getUniqueFileName(java.lang.String parentFolder,
                                 java.lang.String baseName)
                                   throws CmsRpcException

Returns a unique filename for the given base name and the parent folder.

参数:

parentFolder - the parent folder of the file

baseName - the proposed file name

返回:

the unique file name

抛出:

CmsRpcException - if something goes wrong

getWorkplaceLink

java.lang.String getWorkplaceLink(CmsUUID structureId)
                                  throws CmsRpcException

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.

参数:

structureId - the structure id of the resource for which to open the workplace

返回:

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.

抛出:

CmsRpcException - if something goes wrong

lockIfExists

java.lang.String lockIfExists(java.lang.String sitePath)
                              throws CmsRpcException

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.

参数:

sitePath - the site path of the resource to lock

返回:

null if successful, an error message if not

抛出:

CmsRpcException - if something goes wrong

lockTemp

java.lang.String lockTemp(CmsUUID structureId)
                          throws CmsRpcException

Locks the given resource with a temporary lock.

参数:

structureId - the structure id of the resource to lock

返回:

null if successful, an error message if not

抛出:

CmsRpcException - if something goes wrong

lockTempAndCheckModification

CmsLockInfo lockTempAndCheckModification(CmsUUID structureId,
                                       long modification)
                                         throws CmsRpcException

Locks the given resource with a temporary lock additionally checking that the given resource has not been modified after the given timestamp.

参数:

structureId - the structure id of the resource to lock

modification - the timestamp to check

返回:

null if successful, an error message if not

抛出:

CmsRpcException - if something goes wrong

ping

void ping()

An RPC method which does nothing and is just used to keep the session alive.

prefetch

CmsCoreData prefetch()
                     throws CmsRpcException

Generates core data for prefetching in the host page.

返回:

the core data

抛出:

CmsRpcException - if something goes wrong

setAvailabilityInfo

void setAvailabilityInfo(CmsUUID structureId,
                       CmsAvailabilityInfoBean bean)
                         throws CmsRpcException

Applies the changes stored in the info bean to the vfs of OpenCms.

参数:

structureId - the structure id of the modified resource

bean - the bean with the information of the dialog

抛出:

CmsRpcException - if the RPC call goes wrong

setAvailabilityInfo

void setAvailabilityInfo(java.lang.String vfsPath,
                       CmsAvailabilityInfoBean bean)
                         throws CmsRpcException

Applies the changes stored in the info bean to the vfs of OpenCms.

参数:

vfsPath - the vfs path of the modified resource

bean - the bean with the information of the dialog

抛出:

CmsRpcException - if the RPC call goes wrong

setResourceCategories

void setResourceCategories(CmsUUID structureId,
                         java.util.List<java.lang.String> categories)
                           throws CmsRpcException

Sets the categories of the given resource. Will remove all other categories.

参数:

structureId - the resource structure id

categories - the categories to set

抛出:

CmsRpcException - if something goes wrong

setShowEditorHelp

void setShowEditorHelp(boolean showHelp)
                       throws CmsRpcException

Sets the show editor help flag.

参数:

showHelp - the show help flag

抛出:

CmsRpcException - if something goes wrong

setToolbarVisible

void setToolbarVisible(boolean visible)
                       throws CmsRpcException

Writes the tool-bar visibility into the session cache.

参数:

visible - true if the tool-bar is visible

抛出:

CmsRpcException - if something goes wrong

unlock

java.lang.String unlock(CmsUUID structureId)
                        throws CmsRpcException

Unlocks the given resource.

参数:

structureId - the structure id of the resource to unlock

返回:

null if successful, an error message if not

抛出:

CmsRpcException - if something goes wrong

unlock

java.lang.String unlock(java.lang.String sitePath)
                        throws CmsRpcException

Unlocks the given resource.

参数:

sitePath - the site path of the resource to unlock

返回:

null if successful, an error message if not

抛出:

CmsRpcException - if something goes wrong

validate

java.util.Map<java.lang.String,CmsValidationResult> validate(java.util.Map<java.lang.String,CmsValidationQuery> validationQueries)
                                                             throws CmsRpcException

Performs a batch of validations and returns the results.

参数:

validationQueries - a map from field names to validation queries

返回:

a map from field names to validation results

抛出:

CmsRpcException - if something goes wrong

validate

java.util.Map<java.lang.String,CmsValidationResult> validate(java.lang.String formValidatorClass,
                                                           java.util.Map<java.lang.String,CmsValidationQuery> validationQueries,
                                                           java.util.Map<java.lang.String,java.lang.String> values,
                                                           java.lang.String config)
                                                             throws CmsRpcException

Performs a batch of validations using a custom form validator class.

参数:

formValidatorClass - the class name of the form validator

validationQueries - a map from field names to validation queries

values - the map of all field values

config - the form validator configuration string

返回:

a map from field names to validation results

抛出:

CmsRpcException - if the RPC call goes wrong