org.opencms.jsp

类 CmsJspNavBuilder

java.lang.Object

org.opencms.jsp.CmsJspNavBuilder

public class CmsJspNavBuilder
extends java.lang.Object

Bean to provide a convenient way to build navigation structures based on the CmsJspNavElement.

Use this together with the CmsJspActionElement to obtain navigation information based on the current users permissions. For example, use getNavigationForFolder(String) and pass the value of the current OpenCms user context uri obtained from CmsRequestContext.getUri() as argument to obtain a list of all items in the navigation of the current folder. Then use a simple scriptlet to iterate over these items and create a HTML navigation.

从以下版本开始:

6.0.0

另请参阅:

CmsJspNavElement

嵌套类概要

嵌套类

限定符和类型	类和说明
static class	CmsJspNavBuilder.Visibility The visibility mode.

字段概要

字段

限定符和类型	字段和说明
protected CmsObject	m_cms The current CMS context.
protected java.lang.String	m_requestUri The current request URI.
protected java.lang.String	m_requestUriFolder The current request folder.
static java.lang.String	NAVIGATION_LEVEL_FOLDER Default file property value to mark navigation level folders.

构造器概要

构造器

构造器和说明
CmsJspNavBuilder() Empty constructor, so that this bean can be initialized from a JSP.
CmsJspNavBuilder(CmsObject cms) Default constructor.

方法概要

方法

限定符和类型	方法和说明
static java.lang.String	getDefaultFile(CmsObject cms, java.lang.String folder) 已过时。 use CmsObject.readDefaultFile(String) instead
java.util.List<CmsJspNavElement>	getNavigationBreadCrumb() Build a "bread crumb" path navigation to the current folder.
java.util.List<CmsJspNavElement>	getNavigationBreadCrumb(int startlevel, boolean currentFolder) Build a "bread crumb" path navigation to the current folder.
java.util.List<CmsJspNavElement>	getNavigationBreadCrumb(int startlevel, int endlevel) Build a "bread crumb" path navigation to the current folder.
java.util.List<CmsJspNavElement>	getNavigationBreadCrumb(java.lang.String folder, int startlevel, int endlevel, boolean currentFolder) Build a "bread crumb" path navigation to the given folder.
java.util.List<CmsJspNavElement>	getNavigationForFolder() Collect all navigation elements from the files of the folder of the current request URI.
static java.util.List<CmsJspNavElement>	getNavigationForFolder(CmsObject cms, java.lang.String folder) 已过时。 use getNavigationForFolder(String) instead
static java.util.List<CmsJspNavElement>	getNavigationForFolder(CmsObject cms, java.lang.String folder, int level) 已过时。 use getNavigationForFolder(String, int) instead
java.util.List<CmsJspNavElement>	getNavigationForFolder(int level) Build a navigation for the folder that is either minus levels up from of the folder of the current request URI, or that is plus levels down from the root folder towards the current request URI.
java.util.List<CmsJspNavElement>	getNavigationForFolder(java.lang.String folder) Collect all navigation visible elements from the files in the given folder.
java.util.List<CmsJspNavElement>	getNavigationForFolder(java.lang.String folder, CmsJspNavBuilder.Visibility visibility, CmsResourceFilter resourceFilter) Collect all navigation elements from the files in the given folder.
java.util.List<CmsJspNavElement>	getNavigationForFolder(java.lang.String folder, int level) Build a navigation for the folder that is either minus levels up from the given folder, or that is plus levels down from the root folder towards the given folder.
CmsJspNavElement	getNavigationForResource() Returns a navigation element for the resource of the current request URI.
static CmsJspNavElement	getNavigationForResource(CmsObject cms, java.lang.String resource) 已过时。 use getNavigationForResource(String) instead
CmsJspNavElement	getNavigationForResource(java.lang.String sitePath) Returns a navigation element for the named resource.
CmsJspNavElement	getNavigationForResource(java.lang.String sitePath, CmsResourceFilter reourceFilter) Returns a navigation element for the named resource.
static java.util.List<CmsJspNavElement>	getNavigationTreeForFolder(CmsObject cms, java.lang.String folder, int startlevel, int endlevel) 已过时。 use getNavigationForResource(String) instead
java.util.List<CmsJspNavElement>	getNavigationTreeForFolder(int startlevel, int endlevel) Builds a tree navigation for the folders between the provided start and end level.
java.util.List<CmsJspNavElement>	getNavigationTreeForFolder(java.lang.String folder, int startlevel, int endlevel) Builds a tree navigation for the folders between the provided start and end level.
java.util.List<CmsJspNavElement>	getSiteNavigation() This method builds a complete site navigation tree with entries of all branches.
static java.util.List<CmsJspNavElement>	getSiteNavigation(CmsObject cms, java.lang.String folder, int endLevel) 已过时。 use getNavigationForResource(String) instead
java.util.List<CmsJspNavElement>	getSiteNavigation(java.lang.String folder, int endLevel) This method builds a complete navigation tree with entries of all branches from the specified folder.
void	init(CmsObject cms) Initializes this bean.

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

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

字段详细资料

NAVIGATION_LEVEL_FOLDER

public static final java.lang.String NAVIGATION_LEVEL_FOLDER

Default file property value to mark navigation level folders.

另请参阅:

常量字段值

m_cms

protected CmsObject m_cms

The current CMS context.

m_requestUri

protected java.lang.String m_requestUri

The current request URI.

m_requestUriFolder

protected java.lang.String m_requestUriFolder

The current request folder.

构造器详细资料

CmsJspNavBuilder

public CmsJspNavBuilder()

Empty constructor, so that this bean can be initialized from a JSP.

CmsJspNavBuilder

public CmsJspNavBuilder(CmsObject cms)

Default constructor.

参数:

cms - context provider for the current request

方法详细资料

getDefaultFile

@Deprecated
public static java.lang.String getDefaultFile(CmsObject cms,
                                         java.lang.String folder)

已过时。 use CmsObject.readDefaultFile(String) instead

Returns the full name (including VFS path) of the default file for this navigation element or null if the navigation element is not a folder.

The default file of a folder is determined by the value of the property default-file or the system wide property setting.

参数:

cms - the CMS object

folder - full name of the folder

返回:

the name of the default file

getNavigationForFolder

@Deprecated
public static java.util.List<CmsJspNavElement> getNavigationForFolder(CmsObject cms,
                                                                 java.lang.String folder)

已过时。 use getNavigationForFolder(String) instead

Collect all navigation elements from the files in the given folder, navigation elements are of class CmsJspNavElement.

参数:

cms - context provider for the current request

folder - the selected folder

返回:

a sorted (ascending to navigation position) list of navigation elements

getNavigationForFolder

@Deprecated
public static java.util.List<CmsJspNavElement> getNavigationForFolder(CmsObject cms,
                                                                 java.lang.String folder,
                                                                 int level)

已过时。 use getNavigationForFolder(String, int) instead

Build a navigation for the folder that is either minus levels up from the given folder, or that is plus levels down from the root folder towards the given folder.

If level is set to zero the root folder is used by convention.

参数:

cms - context provider for the current request

folder - the selected folder

level - if negative, walk this many levels up, if positive, walk this many levels down from root folder

返回:

a sorted (ascending to navigation position) list of navigation elements

getNavigationForResource

@Deprecated
public static CmsJspNavElement getNavigationForResource(CmsObject cms,
                                                   java.lang.String resource)

已过时。 use getNavigationForResource(String) instead

Returns a navigation element for the named resource.

参数:

cms - context provider for the current request

resource - the resource name to get the navigation information for, must be a full path name, e.g. "/docs/index.html"

返回:

a navigation element for the given resource

getNavigationTreeForFolder

@Deprecated
public static java.util.List<CmsJspNavElement> getNavigationTreeForFolder(CmsObject cms,
                                                                     java.lang.String folder,
                                                                     int startlevel,
                                                                     int endlevel)

已过时。 use getNavigationForResource(String) instead

Builds a tree navigation for the folders between the provided start and end level.

A tree navigation includes all navigation elements that are required to display a tree structure. However, the data structure is a simple list. Each of the navigation elements in the list has the CmsJspNavElement.getNavTreeLevel() set to the level it belongs to. Use this information to distinguish between the navigation levels.

参数:

cms - context provider for the current request

folder - the selected folder

startlevel - the start level

endlevel - the end level

返回:

a sorted list of navigation elements with the navigation tree level property set

getSiteNavigation

@Deprecated
public static java.util.List<CmsJspNavElement> getSiteNavigation(CmsObject cms,
                                                            java.lang.String folder,
                                                            int endLevel)

已过时。 use getNavigationForResource(String) instead

This method builds a complete navigation tree with entries of all branches from the specified folder.

For an unlimited depth of the navigation (i.e. no endLevel), set the endLevel to a value < 0.

参数:

cms - the current CMS context

folder - the root folder of the navigation tree

endLevel - the end level of the navigation

返回:

list of navigation elements, in depth first order

getNavigationBreadCrumb

public java.util.List<CmsJspNavElement> getNavigationBreadCrumb()

Build a "bread crumb" path navigation to the current folder.

返回:

ArrayList sorted list of navigation elements

另请参阅:

getNavigationBreadCrumb(String, int, int, boolean)

getNavigationBreadCrumb

public java.util.List<CmsJspNavElement> getNavigationBreadCrumb(int startlevel,
                                                       boolean currentFolder)

Build a "bread crumb" path navigation to the current folder.

参数:

startlevel - the start level, if negative, go down |n| steps from selected folder

currentFolder - include the selected folder in navigation or not

返回:

sorted list of navigation elements

另请参阅:

getNavigationBreadCrumb(String, int, int, boolean)

getNavigationBreadCrumb

public java.util.List<CmsJspNavElement> getNavigationBreadCrumb(int startlevel,
                                                       int endlevel)

Build a "bread crumb" path navigation to the current folder.

参数:

startlevel - the start level, if negative, go down |n| steps from selected folder

endlevel - the end level, if -1, build navigation to selected folder

返回:

sorted list of navigation elements

另请参阅:

getNavigationBreadCrumb(String, int, int, boolean)

getNavigationBreadCrumb

public java.util.List<CmsJspNavElement> getNavigationBreadCrumb(java.lang.String folder,
                                                       int startlevel,
                                                       int endlevel,
                                                       boolean currentFolder)

Build a "bread crumb" path navigation to the given folder.

The startlevel marks the point where the navigation starts from, if negative, the count of steps to go down from the given folder.

The endlevel is the maximum level of the navigation path, set it to -1 to build the complete navigation to the given folder.

You can include the given folder in the navigation by setting currentFolder to true, otherwise false.

参数:

folder - the selected folder

startlevel - the start level, if negative, go down |n| steps from selected folder

endlevel - the end level, if -1, build navigation to selected folder

currentFolder - include the selected folder in navigation or not

返回:

sorted list of navigation elements

getNavigationForFolder

public java.util.List<CmsJspNavElement> getNavigationForFolder()

Collect all navigation elements from the files of the folder of the current request URI.

返回:

a sorted (ascending to navigation position) list of navigation elements

getNavigationForFolder

public java.util.List<CmsJspNavElement> getNavigationForFolder(int level)

Build a navigation for the folder that is either minus levels up from of the folder of the current request URI, or that is plus levels down from the root folder towards the current request URI.

If level is set to zero the root folder is used by convention.

参数:

level - if negative, walk this many levels up, if positive, walk this many levels down from root folder

返回:

a sorted (ascending to navigation position) list of navigation elements

getNavigationForFolder

public java.util.List<CmsJspNavElement> getNavigationForFolder(java.lang.String folder)

Collect all navigation visible elements from the files in the given folder.

参数:

folder - the selected folder

返回:

A sorted (ascending to navigation position) list of navigation elements

getNavigationForFolder

public java.util.List<CmsJspNavElement> getNavigationForFolder(java.lang.String folder,
                                                      int level)

Build a navigation for the folder that is either minus levels up from the given folder, or that is plus levels down from the root folder towards the given folder.

If level is set to zero the root folder is used by convention.

参数:

folder - the selected folder

level - if negative, walk this many levels up, if positive, walk this many levels down from root folder

返回:

a sorted (ascending to navigation position) list of navigation elements

getNavigationForFolder

public java.util.List<CmsJspNavElement> getNavigationForFolder(java.lang.String folder,
                                                      CmsJspNavBuilder.Visibility visibility,
                                                      CmsResourceFilter resourceFilter)

Collect all navigation elements from the files in the given folder.

参数:

folder - the selected folder

visibility - the visibility mode

resourceFilter - the filter to use reading the resources

返回:

A sorted (ascending to navigation position) list of navigation elements

getNavigationForResource

public CmsJspNavElement getNavigationForResource()

Returns a navigation element for the resource of the current request URI.

返回:

a navigation element for the resource of the current request URI

getNavigationForResource

public CmsJspNavElement getNavigationForResource(java.lang.String sitePath)

Returns a navigation element for the named resource.

参数:

sitePath - the resource name to get the navigation information for, must be a full path name, e.g. "/docs/index.html"

返回:

a navigation element for the given resource

getNavigationForResource

public CmsJspNavElement getNavigationForResource(java.lang.String sitePath,
                                        CmsResourceFilter reourceFilter)

Returns a navigation element for the named resource.

参数:

sitePath - the resource name to get the navigation information for, must be a full path name, e.g. "/docs/index.html"

reourceFilter - the resource filter

返回:

a navigation element for the given resource

getNavigationTreeForFolder

public java.util.List<CmsJspNavElement> getNavigationTreeForFolder(int startlevel,
                                                          int endlevel)

Builds a tree navigation for the folders between the provided start and end level.

参数:

startlevel - the start level

endlevel - the end level

返回:

a sorted list of navigation elements with the navigation tree level property set

另请参阅:

getNavigationTreeForFolder(String, int, int)

getNavigationTreeForFolder

public java.util.List<CmsJspNavElement> getNavigationTreeForFolder(java.lang.String folder,
                                                          int startlevel,
                                                          int endlevel)

Builds a tree navigation for the folders between the provided start and end level.

参数:

folder - the selected folder

startlevel - the start level

endlevel - the end level

返回:

a sorted list of navigation elements with the navigation tree level property set

getSiteNavigation

public java.util.List<CmsJspNavElement> getSiteNavigation()

This method builds a complete site navigation tree with entries of all branches.

返回:

list of navigation elements, in depth first order

另请参阅:

getSiteNavigation(String, int)

getSiteNavigation

public java.util.List<CmsJspNavElement> getSiteNavigation(java.lang.String folder,
                                                 int endLevel)

This method builds a complete navigation tree with entries of all branches from the specified folder.

参数:

folder - folder the root folder of the navigation tree

endLevel - the end level of the navigation

返回:

list of navigation elements, in depth first order

init

public void init(CmsObject cms)

Initializes this bean.

参数:

cms - the current cms context