org.opencms.jsp.util

类 CmsJspVfsAccessBean

java.lang.Object

org.opencms.jsp.util.CmsJspVfsAccessBean

public final class CmsJspVfsAccessBean
extends java.lang.Object

Provides utility methods that allow convenient access to the OpenCms VFS, indented to be used from a JSP with the JSTL or EL.

从以下版本开始:

7.0.2

另请参阅:

CmsJspContentAccessBean

嵌套类概要

嵌套类

限定符和类型	类和说明
class	CmsJspVfsAccessBean.CmsExistsResourceTransformer Provides Booleans that indicate if a specified resource exists in the OpenCms VFS, the input is used as String for the resource name to read.
class	CmsJspVfsAccessBean.CmsExistsXmlTransformer Provides Booleans that indicate if a specified resource exists in the OpenCms VFS and is of type XML content or XML page, the input is used as String for the resource name to read.
class	CmsJspVfsAccessBean.CmsPermissionsLoaderTransformer Transformer that loads a resource permission from the OpenCms VFS, the input is used as String for the resource name to read the permissions for.
class	CmsJspVfsAccessBean.CmsPropertyLoaderSingleTransformer Transformer that a properties of a resource from the OpenCms VFS, the input is used as String for the property name to read.
class	CmsJspVfsAccessBean.CmsPropertyLoaderTransformer Transformer that loads properties of a resource from the OpenCms VFS with another lazy map, the input is used as String for the resource name to read.
class	CmsJspVfsAccessBean.CmsResourceLoaderTransformer Transformer that loads a resource from the OpenCms VFS, the input is used as String for the resource name to read.
class	CmsJspVfsAccessBean.CmsVfsLinkTransformer Transformer that calculates links to resources in the OpenCms VFS, the input is used as String for the resource name to use as link target.
class	CmsJspVfsAccessBean.CmsXmlContentAccessTransformer Provides XML content access beans for VFS resources.

字段概要

字段

限定符和类型	字段和说明
static java.lang.String	ATTRIBUTE_VFS_ACCESS_BEAN Request context attribute for indicating the model file for a create resource operation.

方法概要

方法

限定符和类型	方法和说明
static CmsJspVfsAccessBean	create(CmsObject cms) Creates a new instance of the JSP VFS access utility bean.
CmsObject	getCmsObject() Returns the OpenCms user context this bean was initialized with.
CmsRequestContext	getContext() Short form for getRequestContext().
CmsProject	getCurrentProject() Returns the current project from the context.
CmsUser	getCurrentUser() Returns the current user from the context.
java.util.Map<java.lang.String,java.lang.Boolean>	getExists() Short form for getExistsResource().
java.util.Map<java.lang.String,java.lang.Boolean>	getExistsResource() Returns a map that lazily checks if a resources exists in the OpenCms VFS.
java.util.Map<java.lang.String,java.lang.Boolean>	getExistsXml() Returns a map that lazily checks if a resources exists in the VFS and is of type XML content or XML page.
boolean	getFlushCaches() Flushes the internal caches of this VFS access bean.
java.util.Map<java.lang.String,java.lang.String>	getLink() Returns a map that lazily calculates links to files in the OpenCms VFS, which have been adjusted according to the web application path and the OpenCms static export rules.
java.util.Map<java.lang.String,CmsPermissionSet>	getPermissions() Short form for getReadPermissions().
java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>>	getProperty() Short form for getReadProperties().
java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>>	getPropertySearch() Short form for getReadPropertiesSearch().
java.util.Map<java.lang.String,CmsPermissionSet>	getReadPermissions() Returns a map that lazily reads resource permissions from the OpenCms VFS.
java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>>	getReadProperties() Returns a map that lazily reads all resource properties from the OpenCms VFS, without search.
java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>>	getReadPropertiesSearch() Returns a map that lazily reads all resource properties from the OpenCms VFS, with search.
java.util.Map<java.lang.String,CmsResource>	getReadResource() Returns a map that lazily reads resources from the OpenCms VFS.
java.util.Map<java.lang.String,CmsJspContentAccessBean>	getReadXml() Returns a map that lazily reads XML documents from the OpenCms VFS that are wrapped using a CmsJspContentAccessBean.
CmsRequestContext	getRequestContext() Returns the OpenCms request context the current user this bean was initialized with.
java.util.Map<java.lang.String,CmsResource>	getResource() Short form for getReadResource().
java.util.Map<java.lang.String,CmsJspContentAccessBean>	getXml() Short form for getReadXml().

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

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

字段详细资料

ATTRIBUTE_VFS_ACCESS_BEAN

public static final java.lang.String ATTRIBUTE_VFS_ACCESS_BEAN

Request context attribute for indicating the model file for a create resource operation.

方法详细资料

create

public static CmsJspVfsAccessBean create(CmsObject cms)

Creates a new instance of the JSP VFS access utility bean.

To prevent multiple creations of the bean during a request, the OpenCms request context attributes are used to cache the created VFS access utility bean.

参数:

cms - the current OpenCms user context

返回:

a new instance of the JSP VFS access utility bean

getCmsObject

public CmsObject getCmsObject()

Returns the OpenCms user context this bean was initialized with.

返回:

the OpenCms user context this bean was initialized with

getContext

public CmsRequestContext getContext()

Short form for getRequestContext().

Usage example on a JSP with the EL:

 The current URI is: ${cms:vfs(pageContext).context.uri}
 

返回:

the OpenCms request context of the current user this bean was initialized with

另请参阅:

getRequestContext()

getCurrentProject

public CmsProject getCurrentProject()

Returns the current project from the context.

Usage example on a JSP with the EL:

 The current project name is: ${cms:vfs(pageContext).currentProject.name}
 

返回:

the current project

getCurrentUser

public CmsUser getCurrentUser()

Returns the current user from the context.

Usage example on a JSP with the EL:

 The current user name is: ${cms:vfs(pageContext).currentUser.name}
 

返回:

the current user

getExists

public java.util.Map<java.lang.String,java.lang.Boolean> getExists()

Short form for getExistsResource().

Usage example on a JSP with the EL / JSTL:

 <c:if test="${cms:vfs(pageContext).exists['/checkme.html']}" >
     The resource "/checkme.html" exists.
 </c:if>
 

返回:

a map that lazily reads resources from the OpenCms VFS

另请参阅:

getExistsResource()

getExistsResource

public java.util.Map<java.lang.String,java.lang.Boolean> getExistsResource()

Returns a map that lazily checks if a resources exists in the OpenCms VFS.

Usage example on a JSP with the EL / JSTL:

 <c:if test="${cms:vfs(pageContext).existsResource['/checkme.html']}" >
     The resource "/checkme.html" exists.
 </c:if>
 

Usage example on a JSP with the <cms:contentaccess> tag:

 <cms:contentload ... >
     <cms:contentaccess var="content" />
     <c:if test="${content.vfs.existsResource['/checkme.html']}" >
         The resource "/checkme.html" exists.
     </c:if>
 </cms:contentload>

返回:

a map that lazily checks if a resources exists in the OpenCms VFS

另请参阅:

for a short form of this method

getExistsXml

public java.util.Map<java.lang.String,java.lang.Boolean> getExistsXml()

Returns a map that lazily checks if a resources exists in the VFS and is of type XML content or XML page.

Usage example on a JSP with the EL / JSTL:

 <c:if test="${cms:vfs(pageContext).existsXml['/text.xml']}" >
     The resource "/text.xml" exists and is an XML document.
 </c:if>
 

返回:

a map that lazily checks if a resources exists in the VFS and is of type XML content or XML page

getFlushCaches

public boolean getFlushCaches()

Flushes the internal caches of this VFS access bean.

The VFS access bean uses lazy initialized Maps for all access, but once a value has been read it is cached in the Map and not read again from the VFS. This means the lazy Maps act as another layer of cache to the VFS.

The VFS access bean instance itself is cached in the OpenCms request context attributes of the CmsObject, see create(CmsObject). Normally there is a new CmsObject created for all incoming requests, so the live-time of the VFS access bean is short. In that case the caching of the lazy Maps should improve performance and not be an issue. However, in rare cases an instance of a CmsObject may be kept for a long time in some custom code. In theses cases flushing the caches of the lazy Maps manually may be required, otherwise the Map caches may be out of sync with the VFS.

返回:

always returns true

getLink

public java.util.Map<java.lang.String,java.lang.String> getLink()

Returns a map that lazily calculates links to files in the OpenCms VFS, which have been adjusted according to the web application path and the OpenCms static export rules.

Please note that the target is always assumed to be in the OpenCms VFS, so you can't use this method for links external to OpenCms.

Relative links are converted to absolute links, using the current element URI as base.

Relative links are converted to absolute links, using the current OpenCms request context URI as base.

Usage example on a JSP with the EL:

 Link to the "/index.html" file: ${cms:vfs(pageContext).link['/index.html']}
 

Usage example on a JSP with the <cms:contentaccess> tag:

 <cms:contentload ... >
     <cms:contentaccess var="content" />
     Link to the "/index.html" file: ${content.vfs.link['/index.html']}
 </cms:contentload>

返回:

a map that lazily calculates links to resources in the OpenCms VFS

另请参阅:

CmsJspActionElement.link(String), CmsJspTagLink.linkTagAction(String, javax.servlet.ServletRequest)

getPermissions

public java.util.Map<java.lang.String,CmsPermissionSet> getPermissions()

Short form for getReadPermissions().

Usage example on a JSP with the EL:

 Permission string of the "/index.html" resource: ${cms:vfs(pageContext).readPermissions['/index.html'].permissionString}
 

Usage example on a JSP with the <cms:contentaccess> tag:

 <cms:contentload ... >
     <cms:contentaccess var="content" />
     Permission string of the "/index.html" resource: ${content.vfs.readPermissions['/index.html'].permissionString}
 </cms:contentload>

返回:

a map that lazily reads resource permissions from the OpenCms VFS

另请参阅:

getReadPermissions()

getProperty

public java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> getProperty()

Short form for getReadProperties().

Usage example on a JSP with the EL:

 Title property of the "/index.html" resource: ${cms:vfs(pageContext).property['/index.html']['Title']}
 

返回:

a map that lazily reads all resource properties from the OpenCms VFS, without search

另请参阅:

getReadProperties()

getPropertySearch

public java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> getPropertySearch()

Short form for getReadPropertiesSearch().

Usage example on a JSP with the EL:

 Title property of the "/index.html" resource (searched): ${cms:vfs(pageContext).propertySearch['/index.html']['Title']}
 

返回:

a map that lazily reads all resource properties from the OpenCms VFS, with search

另请参阅:

getReadPropertiesSearch()

getReadPermissions

public java.util.Map<java.lang.String,CmsPermissionSet> getReadPermissions()

Returns a map that lazily reads resource permissions from the OpenCms VFS.

Usage example on a JSP with the EL:

 Permission string of the "/index.html" resource: ${cms:vfs(pageContext).readPermissions['/index.html'].permissionString}
 

Usage example on a JSP with the <cms:contentaccess> tag:

 <cms:contentload ... >
     <cms:contentaccess var="content" />
     Permission string of the "/index.html" resource: ${content.vfs.readPermissions['/index.html'].permissionString}
 </cms:contentload>

返回:

a map that lazily reads resource permissions from the OpenCms VFS

另请参阅:

for a short form of this method

getReadProperties

public java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> getReadProperties()

Returns a map that lazily reads all resource properties from the OpenCms VFS, without search.

Usage example on a JSP with the EL:

 Title property of the "/index.html" resource: ${cms:vfs(pageContext).readProperties['/index.html']['Title']}
 

Usage example on a JSP with the <cms:contentaccess> tag:

 <cms:contentload ... >
     <cms:contentaccess var="content" />
     Title property of the "/index.html" resource: ${content.vfs.readProperties['/index.html']['Title']}
 </cms:contentload>

返回:

a map that lazily reads all resource properties from the OpenCms VFS, without search

另请参阅:

for a short form of this method

getReadPropertiesSearch

public java.util.Map<java.lang.String,java.util.Map<java.lang.String,java.lang.String>> getReadPropertiesSearch()

Returns a map that lazily reads all resource properties from the OpenCms VFS, with search.

Usage example on a JSP with the EL:

 Title property of the "/index.html" resource (searched): ${cms:vfs(pageContext).readPropertiesSearch['/index.html']['Title']}
 

Usage example on a JSP with the <cms:contentaccess> tag:

 <cms:contentload ... >
     <cms:contentaccess var="content" />
     Title property of the "/index.html" resource (searched): ${content.vfs.readPropertiesSearch['/index.html']['Title']}
 </cms:contentload>

返回:

a map that lazily reads all resource properties from the OpenCms VFS, with search

另请参阅:

for a short form of this method

getReadResource

public java.util.Map<java.lang.String,CmsResource> getReadResource()

Returns a map that lazily reads resources from the OpenCms VFS.

Usage example on a JSP with the EL:

 Root path of the "/index.html" resource: ${cms:vfs(pageContext).readResource['/index.html'].rootPath}
 

Usage example on a JSP with the <cms:contentaccess> tag:

 <cms:contentload ... >
     <cms:contentaccess var="content" />
     Root path of the "/index.html" resource: ${content.vfs.readResource['/index.html'].rootPath}
 </cms:contentload>

返回:

a map that lazily reads resources from the OpenCms VFS

另请参阅:

for a short form of this method

getReadXml

public java.util.Map<java.lang.String,CmsJspContentAccessBean> getReadXml()

Returns a map that lazily reads XML documents from the OpenCms VFS that are wrapped using a CmsJspContentAccessBean.

Usage example on a JSP with the EL:

 Title of "/text.xml": ${cms:vfs(pageContext).readXml['/text.xml'].value['Title']}
 

返回:

a map that lazily reads wrapped XML documents from the OpenCms VFS

另请参阅:

for a short form of this method

getRequestContext

public CmsRequestContext getRequestContext()

Returns the OpenCms request context the current user this bean was initialized with.

Usage example on a JSP with the EL:

 The current URI is: ${cms:vfs(pageContext).requestContext.uri}
 

返回:

the OpenCms request context the current user this bean was initialized with

另请参阅:

for a short form of this method

getResource

public java.util.Map<java.lang.String,CmsResource> getResource()

Short form for getReadResource().

Usage example on a JSP with the EL:

 Root path of the "/index.html" resource: ${cms:vfs(pageContext).resource['/index.html'].rootPath}
 

返回:

a map that lazily reads resources from the OpenCms VFS

另请参阅:

getReadResource()

getXml

public java.util.Map<java.lang.String,CmsJspContentAccessBean> getXml()

Short form for getReadXml().

Usage example on a JSP with the EL:

 Title of "/text.xml": ${cms:vfs(pageContext).xml['/text.xml'].value['Title']}
 

返回:

a map that lazily reads wrapped XML documents from the OpenCms VFS

另请参阅:

getReadXml()