OpenCms开发之——自定义结构化类型

来源:互联网 发布:淘宝下单api 编辑:程序博客网 时间:2024/04/30 05:46
 

  OpenCms中很重要的一个特性就是XML内容,通过XML内容,你可以创建自已的结构化内容,如新闻等,下面通过创建一个简单的“测试新闻”类型来介绍一下OpenCms的这一重要特性:
1、新建模块“org.opencms.testnews(模块创建过程详见:http://blog.csdn.net/qianxuncms/archive/2007/04/06/1554192.aspx)。
2、编辑模块,为模块增加导出点,如下图:


3、编辑opencms-modules.xml文件,在模块org.opencms.testnews中增加如下内容,其中“id=7001”是新建资源的ID,为了必免和系统中已有类型的ID冲突,建议这个值设置大一些,最好在1000以上:

        <module>
               
<name>org.opencms.testnewsname>            
                ………………………………………………
            
<parameters/>

            
<resourcetypes>
                
<type class="org.opencms.file.types.CmsResourceTypeXmlContent" name="testnews" id="7001">
                    
<param name="schema">/system/modules/org.opencms.testnews/schemas/testnews.xsdparam>
                
type>
            
resourcetypes>
            
<explorertypes>
                
<explorertype name="testnews" key="fileicon.testnews" icon="testnews.gif" reference="xmlcontent">
                    
<newresource page="structurecontent" uri="newresource_xmlcontent.jsp?newresourcetype=testnews" order="7001" autosetnavigation="false" autosettitle="false"/>
                    
<accesscontrol>
                        
<accessentry principal="GROUP.Administrators" permissions="+r+v+w+c"/>
                        
<accessentry principal="GROUP.Projectmanagers" permissions="+r+v+w+c"/>
                        
<accessentry principal="GROUP.Users" permissions="+r+v+w+c"/>
                    
accesscontrol>
                
explorertype>
            
explorertypes>

        
module>

4、重启Tomcat;
5、在/system/modules/org.opencms.testnews/目录下新建“schemas”文件夹;
6、在新建的“schemas”目录下新建文本文件“testnews.xsd”,内容如下:


<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema" elementFormDefault="qualified">

    
<xsd:include schemaLocation="opencms://opencms-xmlcontent.xsd"/>
        
    
<xsd:element name="TestNewss" type="OpenCmsTestNewss"/>
    
    
<xsd:complexType name="OpenCmsTestNewss">
        
<xsd:sequence>
            
<xsd:element name="TestNews" type="OpenCmsTestNews" minOccurs="0" maxOccurs="unbounded"/>
        
xsd:sequence>
    
xsd:complexType>

    
<xsd:complexType name="OpenCmsTestNews">
        
<xsd:sequence>
            
<xsd:element name="Title" type="OpenCmsString" />
            
<xsd:element name="Date" type="OpenCmsDateTime" />            
            
<xsd:element name="Text" type="OpenCmsHtml" />
        
xsd:sequence>
        
<xsd:attribute name="language" type="OpenCmsLocale" use="required"/>
    
xsd:complexType>

    
<xsd:annotation>
        
<xsd:appinfo>
            
<resourcebundle name="org.opencms.testnews.workplace"/>
            
<preview uri="${previewtempfile}" />
            
<mappings>
                
<mapping element="Title" mapto="property:Title" />
            
mappings>
            
<defaults>
                
<default element="Date" value="${currenttime}"/>
            
defaults>
        
xsd:appinfo>

    
xsd:annotation>  
xsd:schema>

7、在/system/modules/org.opencms.testnews/classes/下分别创建如下目录结构:/org/opencms/testnews/,在此目录下创建本地化文件“workplace.properties”,类型为文本文件,内容如下:

# TestNews nodes
   #用于在“新建”向导中显示的名称
    fileicon.testnews=测试新闻
    #新建“测试新闻”类型时在对话框窗口显示的标题内容
title.newtestnews=添加一条测试新闻
   #编辑器中相应元素显示的名称,以下面编辑新闻的图片中可看到效果
label.TestNews.Title = 标题
label.TestNews.Date=发布时间
label.TestNews.Text=内容

  注意,在新建workplace.properties后,设置此文件的“content-encoding”属性为“ISO-8859-1”,这样在文件中输入中文后,直接保存,系统会自动为其进行编码转换:)

8、发布文件,重启Tomcat;
9、这时在“新建”——>“结构化内容”中就会增加了我们自定义的新类型“测试新闻”,如下图:



  切换到“/sites/default/”默认站点下,创建文件夹:test,在其中新建testnews类型文件,编辑内容,如下图,“标题”、“发布时间”和“内容”就是我们在“workplace.properties”中汉化的内容:



10、在/system/modules/org.opencms.testnews/下创建jsptemplates目录,创建新闻内容页(三级页面):testnews.jsp,内容如下:

<%@ page session="false" import="java.text.SimpleDateFormat,java.util.Date"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jstl/core" %>
<%@ taglib prefix="cms" uri="http://www.opencms.org/taglib/cms"%>


测试新闻内容页


 
 


  
  <%
   long longDate =  Long.valueOf(pageContext.getAttribute("strDate").toString()).longValue();
  SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm");
  String createdDate = sdf.format(new Date(longDate));
  out.print(createdDate);
  %>
  

 
 



11、设置“test”目录template-elements属性为“/system/modules/org.opencms.testnews/jsptemplates/testnews.jsp”,通过此处设置,则test目录下所有“testnews”类型的文件的内容页都由“testnews”来显示,效果如下;


12、创建“testnews”类型文件列表页面,在“test”目录中创建“list.jsp”,内容如下:

<%@ page session="false" import="java.text.SimpleDateFormat,java.util.Date"%>
<%@ taglib prefix="c" uri="http://java.sun.com/jstl/core" %>
<%@ taglib prefix="fmt" uri="http://java.sun.com/jstl/fmt" %>
<%@ taglib prefix="cms" uri="http://www.opencms.org/taglib/cms"%>
<html>
<head>
<title>测试新闻列表页title>
<cms:editable/>
head>

<body>
    
<cms:contentload collector="allInFolderPriorityDateDesc" param="/test/news_%(number).html|testnews" editable="true">
        
<a href=""${opencms.filename}" />" target="_blank"><cms:contentshow element="Title" />a>
        
<c:set var="strDate"><cms:contentshow element="Date" />c:set>
        
<% 
         
long longDate =  Long.valueOf(pageContext.getAttribute("strDate").toString()).longValue(); 
        SimpleDateFormat sdf 
= new SimpleDateFormat("yyyy-MM-dd HH:mm");
        String createdDate 
= sdf.format(new Date(longDate));
        out.print(createdDate);
        
%>
    
cms:contentload>
body>
html>

  显示效果如下图,点击右侧“+”可以添加新闻,点击“X”号可以删除新闻,点击“圆圈”可以编辑新闻:

  通过以上简单的步骤,我们就在OpenCms中创建了自己定义的结构化内容,在XSD中你可以创建更加复杂的结构来满足你的要求,下一篇文章详细介绍XSD的详细配置。
  (谢谢关注OpenCms——中文资源第一博客http://blog.csdn.net/qianxuncms/,欢迎与作者直接交流,共同进步。MSN:qianxuncms@hotmail.com,QQ:9165456)