org.opencms.file.wrapper

类 A_CmsResourceWrapper

java.lang.Object

org.opencms.file.wrapper.A_CmsResourceWrapper

所有已实现的接口:

I_CmsResourceWrapper

直接已知子类:

A_CmsResourceExtensionWrapper, CmsResourceWrapperPreventCreateNameCI, CmsResourceWrapperPropertyFile, CmsResourceWrapperReplaceDeleted, CmsResourceWrapperSystemFolder, CmsResourceWrapperXmlPage

public abstract class A_CmsResourceWrapper
extends java.lang.Object
implements I_CmsResourceWrapper

Default abstract implementation of the interface I_CmsResourceWrapper.

This class returns for all methods that the action is not handled by the resource wrapper.

Subclasses can only implement those methods where they want to change the default behaviour.

从以下版本开始:

6.5.6

字段概要

字段

限定符和类型	字段和说明
protected boolean	m_isWrappedResource Is handled by this resource wrapper.

构造器概要

构造器

构造器和说明
A_CmsResourceWrapper()

方法概要

方法

限定符和类型	方法和说明
java.util.List<CmsResource>	addResourcesToFolder(CmsObject cms, java.lang.String resourcename, CmsResourceFilter filter) Here it is possible to add additional (virtual) child resources to those already existing in the VFS.
void	configure(java.lang.String configString) If there is a configuration string for the wrapper, this method will be called with the configuration string before it is used.
boolean	copyResource(CmsObject cms, java.lang.String source, java.lang.String destination, CmsResourceCopyMode siblingMode) Copies a resource.
CmsResource	createResource(CmsObject cms, java.lang.String resourcename, int type, byte[] content, java.util.List<CmsProperty> properties) Creates a new resource of the given resource type with the provided content and properties.
boolean	deleteResource(CmsObject cms, java.lang.String resourcename, CmsResourceDeleteMode siblingMode) Deletes a resource given its name.
CmsLock	getLock(CmsObject cms, CmsResource resource) Returns the lock for the resource.
boolean	lockResource(CmsObject cms, java.lang.String resourcename, boolean temporary) Locks a resource.
boolean	moveResource(CmsObject cms, java.lang.String source, java.lang.String destination) Moves a resource to the given destination.
CmsFile	readFile(CmsObject cms, java.lang.String resourcename, CmsResourceFilter filter) Reads a file resource (including it's binary content) from the VFS, using the specified resource filter.
CmsResource	readResource(CmsObject cms, java.lang.String resourcename, CmsResourceFilter filter) Reads a resource from the VFS, using the specified resource filter.
java.lang.String	restoreLink(CmsObject cms, java.lang.String uri) Returns the link to a existing resource in the VFS for the uri.
java.lang.String	rewriteLink(CmsObject cms, CmsResource res) Returns the link how it is for the resource after using this resource wrapper.
boolean	unlockResource(CmsObject cms, java.lang.String resourcename) Unlocks a resource.
CmsResource	wrapResource(CmsObject cms, CmsResource resource) Changes the given resource based on the implementation of this wrapper.
CmsFile	writeFile(CmsObject cms, CmsFile resource) Writes a resource, including it's content.

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

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

从接口继承的方法 org.opencms.file.wrapper.I_CmsResourceWrapper

isWrappedResource

字段详细资料

m_isWrappedResource

protected boolean m_isWrappedResource

Is handled by this resource wrapper.

构造器详细资料

A_CmsResourceWrapper

public A_CmsResourceWrapper()

方法详细资料

addResourcesToFolder

public java.util.List<CmsResource> addResourcesToFolder(CmsObject cms,
                                               java.lang.String resourcename,
                                               CmsResourceFilter filter)
                                                 throws CmsException

从接口复制的说明: I_CmsResourceWrapper

Here it is possible to add additional (virtual) child resources to those already existing in the VFS.

指定者:

addResourcesToFolder 在接口中 I_CmsResourceWrapper

参数:

cms - the current users OpenCms context

resourcename - the full path of the resource where to add the child resources for

filter - the resource filter to use

返回:

a list of all additionaly child CmsResources

抛出:

CmsException - if something goes wrong

另请参阅:

I_CmsResourceWrapper.addResourcesToFolder(org.opencms.file.CmsObject, java.lang.String, org.opencms.file.CmsResourceFilter)

configure

public void configure(java.lang.String configString)

从接口复制的说明: I_CmsResourceWrapper

If there is a configuration string for the wrapper, this method will be called with the configuration string before it is used.

Otherwise, it will not be called.

指定者:

configure 在接口中 I_CmsResourceWrapper

参数:

configString - the configuration string for the wrapper

另请参阅:

I_CmsResourceWrapper.configure(java.lang.String)

copyResource

public boolean copyResource(CmsObject cms,
                   java.lang.String source,
                   java.lang.String destination,
                   CmsResourceCopyMode siblingMode)
                     throws CmsException,
                            CmsIllegalArgumentException

从接口复制的说明: I_CmsResourceWrapper

Copies a resource.

First should be a check if the source and/or the destination are handled by this resource wrapper.

It is possible that the path in the source or in the destination are virtual paths and so has to be translated into valid paths existing in the VFS to copy the resource.

指定者:

copyResource 在接口中 I_CmsResourceWrapper

参数:

cms - the initialized CmsObject

source - the name of the resource to copy

destination - the name of the copy destination with complete path

siblingMode - indicates how to handle siblings during copy

返回:

true if the copy action was handled by this resource wrapper otherwise false

抛出:

CmsException - if something goes wrong

CmsIllegalArgumentException - if the destination argument is null or of length 0

另请参阅:

org.opencms.file.wrapper.I_CmsResourceWrapper#copyResource(org.opencms.file.CmsObject, java.lang.String, java.lang.String, org.opencms.file.CmsResource.CmsResourceCopyMode)

createResource

public CmsResource createResource(CmsObject cms,
                         java.lang.String resourcename,
                         int type,
                         byte[] content,
                         java.util.List<CmsProperty> properties)
                           throws CmsException,
                                  CmsIllegalArgumentException

从接口复制的说明: I_CmsResourceWrapper

Creates a new resource of the given resource type with the provided content and properties.

First should be a check if the resourcename is handled by this resource wrapper.

It is possible that the path in the resourcename is a virtual path and so has to be translated into a valid path existing in the VFS to create the resource.

指定者:

createResource 在接口中 I_CmsResourceWrapper

参数:

cms - the initialized CmsObject

resourcename - the name of the resource to create (full path)

type - the type of the resource to create

content - the content for the new resource

properties - the properties for the new resource

返回:

the created resource or null if not handled by this resource wrapper

抛出:

CmsException - if something goes wrong

CmsIllegalArgumentException - if the source argument is null or of length 0

另请参阅:

I_CmsResourceWrapper.createResource(org.opencms.file.CmsObject, java.lang.String, int, byte[], java.util.List)

deleteResource

public boolean deleteResource(CmsObject cms,
                     java.lang.String resourcename,
                     CmsResourceDeleteMode siblingMode)
                       throws CmsException

从接口复制的说明: I_CmsResourceWrapper

Deletes a resource given its name.

First should be a check if the resourcename is handled by this resource wrapper.

It is possible that the path in the resourcename is a virtual path and so has to be translated into a valid path existing in the VFS to delete the resource.

指定者:

deleteResource 在接口中 I_CmsResourceWrapper

参数:

cms - the initialized CmsObject

resourcename - the name of the resource to delete

siblingMode - indicates how to handle siblings of the deleted resource

返回:

true if the delete action was handled by this resource wrapper otherwise false

抛出:

CmsException - if something goes wrong

另请参阅:

org.opencms.file.wrapper.I_CmsResourceWrapper#deleteResource(org.opencms.file.CmsObject, java.lang.String, org.opencms.file.CmsResource.CmsResourceDeleteMode)

getLock

public CmsLock getLock(CmsObject cms,
              CmsResource resource)
                throws CmsException

从接口复制的说明: I_CmsResourceWrapper

Returns the lock for the resource.

First should be a check if the resource is handled by this resource wrapper.

It is possible that the path in the resource is a virtual path and so has to be translated into a valid path existing in the VFS to get the lock for the resource.

指定者:

getLock 在接口中 I_CmsResourceWrapper

参数:

cms - the initialized CmsObject

resource - the resource to check the lock for

返回:

the lock state of the resource or null if the action couldn't be handled by this resource wrapper

抛出:

CmsException - if something goes wrong

另请参阅:

I_CmsResourceWrapper.getLock(org.opencms.file.CmsObject, org.opencms.file.CmsResource)

lockResource

public boolean lockResource(CmsObject cms,
                   java.lang.String resourcename,
                   boolean temporary)
                     throws CmsException

从接口复制的说明: I_CmsResourceWrapper

Locks a resource.

First should be a check if the resourcename is handled by this resource wrapper.

It is possible that the path in the resourcename is a virtual path and so has to be translated into a valid path existing in the VFS to lock the resource.

指定者:

lockResource 在接口中 I_CmsResourceWrapper

参数:

cms - the current users OpenCms context

resourcename - the name of the resource to lock (full path)

temporary - true if the resource should only be locked temporarily

返回:

true if this request could be handled by this wrapper or false if not

抛出:

CmsException - if something goes wrong

另请参阅:

I_CmsResourceWrapper.lockResource(org.opencms.file.CmsObject, java.lang.String, boolean)

moveResource

public boolean moveResource(CmsObject cms,
                   java.lang.String source,
                   java.lang.String destination)
                     throws CmsException,
                            CmsIllegalArgumentException

从接口复制的说明: I_CmsResourceWrapper

Moves a resource to the given destination.

First should be a check if the source and/or the destination are handled by this resource wrapper.

It is possible that the path in the source or in the destination are virtual paths and so has to be translated into valid paths existing in the VFS to move the resource.

指定者:

moveResource 在接口中 I_CmsResourceWrapper

参数:

cms - the current cms context

source - the name of the resource to move

destination - the destination resource name

返回:

true if the move action was handled by this resource wrapper otherwise false

抛出:

CmsException - if something goes wrong

CmsIllegalArgumentException - if the source argument is null or of length 0

另请参阅:

I_CmsResourceWrapper.moveResource(org.opencms.file.CmsObject, java.lang.String, java.lang.String)

readFile

public CmsFile readFile(CmsObject cms,
               java.lang.String resourcename,
               CmsResourceFilter filter)
                 throws CmsException

从接口复制的说明: I_CmsResourceWrapper

Reads a file resource (including it's binary content) from the VFS, using the specified resource filter.

First should be a check if the resourcename is handled by this resource wrapper.

It is possible that the path in the resourcename is a virtual path and so has to be translated into a valid path existing in the VFS to read the resource.

指定者:

readFile 在接口中 I_CmsResourceWrapper

参数:

cms - the current users OpenCms context

resourcename - the name of the resource to read (full path)

filter - the resource filter to use while reading

返回:

the file resource that was read or null if it could not be handled by this resource wrapper

抛出:

CmsException - if the file resource could not be read for any reason

另请参阅:

I_CmsResourceWrapper.readFile(org.opencms.file.CmsObject, java.lang.String, org.opencms.file.CmsResourceFilter)

readResource

public CmsResource readResource(CmsObject cms,
                       java.lang.String resourcename,
                       CmsResourceFilter filter)
                         throws CmsException

从接口复制的说明: I_CmsResourceWrapper

Reads a resource from the VFS, using the specified resource filter.

First should be a check if the resourcename is handled by this resource wrapper.

It is possible that the path in the resourcename is a virtual path and so has to be translated into a valid path existing in the VFS to read the resource.

指定者:

readResource 在接口中 I_CmsResourceWrapper

参数:

cms - the current users OpenCms context

resourcename - The name of the resource to read (full path)

filter - the resource filter to use while reading

返回:

the resource that was read or null if it could not be handled by this resource wrapper

抛出:

CmsException - if the resource could not be read for any reason

另请参阅:

I_CmsResourceWrapper.readResource(org.opencms.file.CmsObject, java.lang.String, org.opencms.file.CmsResourceFilter)

restoreLink

public java.lang.String restoreLink(CmsObject cms,
                           java.lang.String uri)

从接口复制的说明: I_CmsResourceWrapper

Returns the link to a existing resource in the VFS for the uri.

Turns the virtual path into a real path to a resource in the VFS.

指定者:

restoreLink 在接口中 I_CmsResourceWrapper

参数:

cms - the initialized CmsObject

uri - the (virtual) uri to be restored

返回:

the uri where to find the resource in the VFS or null if the wrapper is not responsible

另请参阅:

I_CmsResourceWrapper.restoreLink(org.opencms.file.CmsObject, java.lang.String)

rewriteLink

public java.lang.String rewriteLink(CmsObject cms,
                           CmsResource res)

从接口复制的说明: I_CmsResourceWrapper

Returns the link how it is for the resource after using this resource wrapper.

For example: in the VFS: "/sites/default/index.html" and this resource wrapper adds the extension "jsp" then link returned should be "/sites/default/index.html.jsp".

指定者:

rewriteLink 在接口中 I_CmsResourceWrapper

参数:

cms - the initialized CmsObject

res - the resource where to rewrite the path

返回:

the rewritten path or null if the wrapper is not responsible

另请参阅:

I_CmsResourceWrapper.rewriteLink(CmsObject, CmsResource)

unlockResource

public boolean unlockResource(CmsObject cms,
                     java.lang.String resourcename)
                       throws CmsException

从接口复制的说明: I_CmsResourceWrapper

Unlocks a resource.

First should be a check if the resourcename is handled by this resource wrapper.

It is possible that the path in the resourcename is a virtual path and so has to be translated into a valid path existing in the VFS to unlock the resource.

指定者:

unlockResource 在接口中 I_CmsResourceWrapper

参数:

cms - the current users OpenCms context

resourcename - the name of the resource to unlock (full path)

返回:

true if this request could be handled by this wrapper of false if not

抛出:

CmsException - if something goes wrong

另请参阅:

I_CmsResourceWrapper.unlockResource(CmsObject, String)

wrapResource

public CmsResource wrapResource(CmsObject cms,
                       CmsResource resource)

从接口复制的说明: I_CmsResourceWrapper

Changes the given resource based on the implementation of this wrapper.

For example, some resource types like CmsResourceTypeJsp just get a .jsp extension, while other types like CmsResourceTypeXmlPage are "exploded" into a folder / file structure.

指定者:

wrapResource 在接口中 I_CmsResourceWrapper

参数:

cms - the current users OpenCms context

resource - the resource to wrap

返回:

a wrapped CmsResource object or null to not change the resource

另请参阅:

I_CmsResourceWrapper.wrapResource(org.opencms.file.CmsObject, org.opencms.file.CmsResource)

writeFile

public CmsFile writeFile(CmsObject cms,
                CmsFile resource)
                  throws CmsException

从接口复制的说明: I_CmsResourceWrapper

Writes a resource, including it's content.

First should be a check if the resource is handled by this resource wrapper.

It is possible that the path in the resource is a virtual path and so has to be translated into a valid path existing in the VFS to write the resource.

指定者:

writeFile 在接口中 I_CmsResourceWrapper

参数:

cms - the current cms context

resource - the resource to apply this operation to

返回:

the written resource or null if the action could not be handled by this resource wrapper

抛出:

CmsException - if something goes wrong

另请参阅:

I_CmsResourceWrapper.writeFile(org.opencms.file.CmsObject, org.opencms.file.CmsFile)