前段时间无意间看到一个博客的RSS可以用XSL格式输出并且能在Firefox里浏览,想到自己以前写的一个XML留言簿因为不兼容Firefox所不了了之了,现在看到他的能在Firefox浏览就觉得很好奇,看了一下代码,一句一句的比对,最后终于找到了原因,也就把这个留言簿给完成了。因为是一个简单的XML留言簿,所以取名SXGB(Simple XML GuestBook)。
留言本演示,管理密码为test:http://home.goofar.com/hotheart/gbook/gbook.asp
首先定义留言簿的XML文档的格式。作为一个留言簿,不需要太复杂的内容,于是我就给留言内容分为3个部分:留言者姓名、留言者主页和留言内容。另外,一个留言簿还需要有使用者的一些信息,包括用户名和用户主页。再有,在留言比较多时还需要分页信息。大致结构完成后就可以开始写XML文档模板了。
XML文档根元素定义为gbook
XML文档模板gbook.xml
CODE:
xml version="1.0" encoding="utf-8"?>
<!-- DTD file -->
<!DOCTYPE gbook SYSTEM "sxgb.dtd">
<!-- XSL file -->
<?xml-stylesheet type="text/xsl" href="gbook.xsl"?>
<gbook>
<!-- 留言簿相关信息 -->
<info>
<!-- 用户名 -->
<user>HotHeart</user>
<!-- 用户主页 -->
<home>http://www.xujiwei.cn</home>
<!-- 分页信息,分别为目前所在页,总页数,上一页,下一页 -->
<pagenow>1</pagenow>
<pagetotal>1</pagetotal>
<pageprev>1</pageprev>
<pagenext>2</pagenext>
<!-- 是否已经登陆,用来处理是否显示登陆框 -->
<logined>NO</logined>
</info>
<!-- 留言列表 -->
<messages>
<!-- 一个留言 -->
<message>
<!-- 留言ID -->
<id>1</id>
<!-- 留言者姓名 -->
<username>Admin</username>
<!-- 留言时间 -->
<time>2005-08-09 12:00</time>
<!-- 留言者主页 -->
<homepage>http://www.xujiwei.cn/</homepage>
<!-- 留言内容 -->
<content><![CDATA[ 留言内容 ]]></content>
</message>
</messages>
</gbook>
要注意在引用XSL时不能用
<?xml:stylesheet type="text/xsl" href="gbook.xsl"?>
xml和stylesheet之间应该用一杠(-)而不能用冒号(:),在Firefox里是不支持用冒号的。
一个好的XML文档,除了要有结构性,还应该要有有效性,所以在XML文档的一开头就定义了文档类型定义(DTD) sxgb.dtd,下面就来把这个文档类型定义给完成。因为已经设计好留言簿XML文档的结构,所以写出DTD是很方便的。
文档类型定义sxgb.dtd
CODE:
<?xml version="1.0" encoding="utf-8"?>
<!ELEMENT gbook (info,messages)>
<!ELEMENT info (user,home,msgtotal,pagenow,pagetotal,pageprev,pagenext,logined)>
<!ELEMENT messages (message+)>
<!ELEMENT message (id,username,time,homepage,content)>
<!ELEMENT user (#PCDATA)>
<!ELEMENT home (#PCDATA)>
<!ELEMENT msgtotal (#PCDATA)>
<!ELEMENT pagenow (#PCDATA)>
<!ELEMENT pagetotal (#PCDATA)>
<!ELEMENT pageprev (#PCDATA)>
<!ELEMENT pagenext (#PCDATA)>
<!ELEMENT logined (#PCDATA)>
<!ELEMENT id (#PCDATA)>
<!ELEMENT title (#PCDATA)>
<!ELEMENT username (#PCDATA)>
<!ELEMENT time (#PCDATA)>
<!ELEMENT homepage (#PCDATA)>
<!ELEMENT content (#PCDATA)>
<!ELEMENT messages (message+)>中+号表示留言列表中至少有一条留言,但实际应用可能会出现没有留言的情况,为了应对这种情况,我在输出XML文档的ASP程序输出一条系统产生的留言,提示目前还没有留言。
接下来是很重要的部分,XSL的编写了。
XSL文档gbook.xsl
点击这里查看XSL文档gbook.xsl
在定义XSL名称空间时,应该用http://www.w3.org/1999/XSL/Transform,即
CODE:
xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">
而不能用http://www.w3.org/TR/WD-xsl,不知为什么如果使用这个名称空间,在Firefox会显示错误:分析 XSLT 样式表单失败。
在XSL里,一个很重要的概念就是模板。一个模板就对应一块内容的格式化输出,在构建模板时,可以从大到小,即先构建全局的模板,然后再处理每一块细分的内容,也可以从小到大,先构建好细分内容的模板,然后将它们组合起来形成整体的模板。在XSL里,创建一个模板使用下面的标记:
[code[<xsl:template match="/gbook">
<!-- 模板内容 -->
</xsl:template>[/code]
其中match表示的是这个模板对应那个标记。
使用模板有两种方法:
第一种是直接应用:
CODE:
<xsl:apply-templates select="info"/>
这种方法是选择当前标记下的info标记并使用match为info的模板进行处理
第二种是循环选择:
CODE:
<xsl:for-each select="message">
<!-- 模板内容 -->
</xsl:for-eace>
在循环选择中,模板直接写在for-each之中,但是当前上下文已经转到message。
至于在select中使用的表达式,属于XPath部分,可以参考W3C的XPath文档(XML Path Language) 。在gbook.xsl中还使用到的标记有:
<xsl:value-of select="content"/>
这是在XSL中常用的标记之一,输出结果是选择节点的值,通过用它来输出节点的值,在这个留言本中,它用来输出用户名、留言者姓名、留言内容等。
<xsl:attribute name="href">gbook.asp?page=1</xsl:attribute>
用来给当前标签添加一个属性,在留言簿中用来给分页导航添加网址。其中name]属性表示要添加属性的名字,标记包含的内容为要添加属性的值。
<xsl:if test="id!=''"><!-- 处理内容 --></xsl:if>
判断test中的表达示结果,如果为真则处理包含的内容,假则忽略。要注意是,如果是判断小于,就不能用“<”,而应该用“<”,因为“<”是标签起始标志,如果不进行转换则在浏览器中会出现错误。
然后就是ASP输出留言簿需要的XML文档了,这个只要按照前面定义的格式,从数据库中读取记录按照模板输出即可,不过需要在输出之前定义MIME类型:
Response.ContentType="application/xml"
指明这是一个XML文档。另外,因为整个留言簿都使用的UTF-8编码,需要在ASP中指定编码:
CodePage="65001"
这句应该放在ASP文件的开头。
最后还有CSS,这个属于定义留言簿的显示效果了,具体可以查看CSS的内容。另外,为了防止用户误操作提交了空表单,我在客户端加了一段JS代码来检查留言姓名和留言内容是否为空,如果为空则提示用户并停止提交表单,具体内容可以查看JS脚本文件。
完整留言簿系统SXGB打包下载
参考资料:
1. XML及WAP开发手册(李建国等编著)
2. xml ,xsl,css 之乱搞