为什么在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>");
%>
运行结果如下: