OpenCms JSP基础文档——在JSP中访问OpenCms特性

为什么在JSP中使用OpenCms特性？
　　OpenCms提供了很多特性帮助你加速开发进度，如模板、用户管理和权限设置和缓存管理，同样你也可以根据OpenCms的文件结构创建动态的导航，OpenCms虚拟文件系统（VFS）中所有的文件都保存在数据库中，为了访问任何的OpenCms VFS信息你都必须使用OpenCms提供的JSP API。
两种基本方式
　　在JSP文件中有两种方式来访问OpenCms系统：
　　1、使用OpenCms标签库，通常以“<cms:>”开始
　　2、在你的脚本中使用“OpenCms org.opencms.jsp.CmsJspActionElement”
　　通学的功能使用这两种方法都可以完成，这通常就是个人经验和喜好的问题了，JSP标签对于JAVA新手来说更易用些，甚至不懂JAVA但HTML经验很丰富，就可以像用HTML标签一样来使用这些标签，另一方面，JAVA丰富的老手可能更热衷于使用脚本代码（使用JavaBeans来处理业务逻辑）来获得更灵活的控制和更高的性能。
　　如果你正在使用OpenCms标签，你应该考虑与通常的JSP标签结合使用来完成某些功能，如loop，if-then，enumerations等。建议使用JSP2.0标准中的JSTL（Java标准标签库），在Alkacon文档（OpenCms安装成功后的系统帮助文档）中有一些JSTL的例子。
 　　如果你想要实现更高级的功能，如导航或表单，你就必须使用API来写脚本了。

OpenCms <cms:>标签
　　如果要使用OpenCms标签库，在你的JSP中必须按如下声明：

<% ... @ taglib prefix="cms" uri="http://www.opencms.org/taglib/cms"  %>  

< h1 > Simple taglib example </ h1 >  

The installed OpenCms version is  < cms:info  property ="opencms.version" /> . < p >  

The "title" property of this file is " < cms:property  name = "title" /> ". < p >  

Link to a file in the OpenCms VFS  < a  href ="<cms:link>/alkacon-documentation/index.html</cms:link>" > like this </ a > . < p >

　　执行结果如下：

  OpenCms 脚本 API

　　在你的脚本中访问OpenCms API，首先要创建一个 JavaBean org.opencms.jsp.CmsJspActionElement的实例，如下： 

<% @ page  import = " java.util.*,org.opencms.jsp.* "   %><%     

//  Create a JSP action element
CmsJspActionElement cms  =   new  CmsJspActionElement(pageContext, request, response);

//  Get a simple navigation of all pages / subfolders in the current folder 
List list  =  cms.getNavigation().getNavigationForFolder();
Iterator i  =  list.iterator();

out.println( " <h3>A simple sample navigation</h3><ul> " );
while  (i.hasNext())  ... {
    CmsJspNavElement ne = (CmsJspNavElement)i.next();
    out.println("<li><a href="" + cms.link(ne.getResourceName()) + "">");
    out.println(ne.getTitle() + "</a>");
}     
out.println( " </ul> " );
%>

　　运行结果如下：