高速UBB标签转换引擎.
/**
* 版权所有 2006(C) 中国Java手机网(www.cnjm.net)。所有版权保留。
* 作者开放本代码的目的是希望更多人使用它，任何人只要遵从以下条款，就可以传播、使用或修改本代码：
* 1. 再发布本代码必须完整保留此版权声明及条款，不得删除。
* 2. 使用本代码开发的软件必须在版权信息中声明： “本软件在开发中使用了中国Java手机网(www.cnjm.net)编写的UBB转换引擎”。
* 3. 使用本代码开发的软件应在文档中加入中国Java手机网(www.cnjm.net) 的链接。
* 4. 使用者必须独自承担使用本代码的风险，中国Java手机网不为本代码对其软件或系统可能造成的任何损害承担责任。
*/
一个可扩展的高速UBB标签转换引擎 （
中国JAVA手机网
现在UBB标签技术已经广泛的应用于网站开发中，比起直接使用Html标签，UBB标签更安全，也更容易学习。
目前各种服务器端技术，无论是CGI(perl), ASP, PHP还是JSP，在网上都能找到大量的UBB转换代码，但经过笔者的考察，大部分都是采用正则表达式匹配替换的方式实现的，用这种方式比较简单易行，但是有一些明显的缺点：
1. 性能较差，因为这种转换方法对每一种UBB标签都要做一次全文的匹配替换，所以UBB标签种类越多，速度越慢;
2. 对错误的嵌套方式会做出错误的转换处理，比如"[b]你[i]好[/b]啊[/i]"，会被转换为"你好啊"，这显然是错误的HTML语法，因为HTML的标签只能互相嵌套，而是不允许互相跨越的;
3. 不支持同类标签的嵌套使用，比如"[color=red]你[color=blue]好[/color]啊[/color]"，会被转换为"你[color=blue]好啊[/color]";
4. 扩展起来较为困难，因为需要扩展者也要有正则表达式的知识才能正确的添加新的UBB标签，而相对来说，正则表达式的理解和学习还是有一定难度的。
针对这种现状，笔者在开发UBB标签转换系统时使用了全新的思路和算法，即把整个文章转换成一棵由UBB标签和正文组成的树，针对每个UBB标签的树节点进行转换处理，采用这种全新算法的UBB标签转换器有以下的特点：
1. 性能极高，对全文只扫描一遍，且和UBB标签的种类数量无关，因此可以任意添加新的UBB标签而不必担心性能会下降；
2. 容错性非常好，对于上面的错误UBB语法"[b]你[i]好[/b]啊[/i]"，可以选择两种容错模式“忽略(IGNORE)”和“关闭(CLOSE)”，如果采用忽略模式，那么错误的标签会被忽略掉，也就是转换为"你[i]好啊[/i]"；而如果采用关闭模式，则内层的未关闭UBB标签会被自动关闭，即转换成为"你好啊[/i]"。无论哪种模式，产生的HTML代码都是正确的；
3. 支持同类标签的多次嵌套；
4. 支持“空”标签，也就是形如[img=myimg.gif/]这样用"/]"结尾，且没有对应结束标签的UBB代码；
5. 容易扩展，用户只要自定义一个UBB标签处理器，负责可能的UBB标签的鉴别工作，和最后如何对标签的属性和内嵌文本进行处理就可以了。
所谓“可能的UBB标签”，就是任何一对"["和"]"中间的内容，自定义标签处理器要负责判断这段内容是否是合法的UBB标签，并把标签分成UBB标记和标记的属性两部分，比如，引擎调用处理器的方法handler.parseTag("color=red", false)，处理器应把参数分成UBB标记"color"和属性"red"两部分并作为字符串数组返回，而对于非UBB标签，比如"[转贴文章]"，处理器只要简单的返回null，转换引擎就会把它作为普通文本处理。
而最后的处理工作也很简单，转换引擎会调用处理器的compose方法，把UBB标记，标记的属性和内嵌的文本传给该方法，比如handler.compose("color", "red", "你好啊", false)，处理器只要简单的把它们组合成"你好啊"并返回这个字符串就可以了。
本站（中国JAVA手机网
这个简单的例子支持的标签种类不多，你可以继续扩展，另外用一大堆equals挨个进行比较效率比较低，你可以用一个HashMap或Hashtable来进行快速的定位和查找。
=============================== SimpleTagHandler.java源代码 ===============================
package util;
public class SimpleTagHandler implements UBBTagHandler {
// [b]文字加粗体效果[/b]
// [i]文字加倾斜效果[/i]
// [u]文字加下划线效果[/u]
// [size=4]改变文字大小[/size]
// [color=red]改变文字颜色[/color]
// [quote]这个标签是用来做为引用所设置的，如果你有什么内容是引用自别的地方，请加上这个标签！[/quote]
// [url]http://www.cnjm.net/resfetch/JiGbbGz0UF9f....4ZxyD9bhcols[/url]
// [url=http://www.cnjm.net/resfetch/JiGbbGz0UF9f....4ZxyD9bhcols]JAVA手机网[/url]
// [email=webmaster@cnjm.net]写信给我[/email]
// [email]webmaster@cnjm.net[/email]
// [img]mainlogo.gif[/img]
public SimpleTagHandler() { }
public String[] parseTag(String s, boolean isEmpty) {
if (isEmpty) { // 本处理器不支持空标签
return null;
}
// 如果标签中有'='号就把标签分为UBB标记和属性两部分，否则属性为null
String tag = s, attr = null;
int idx = s.indexOf('=');
if (idx >= 0) {
tag = s.substring(0, idx);
attr = s.substring(idx + 1);
}
String tmp = tag.toLowerCase(); // 大小写不敏感
// 只有下面的标记是本处理器支持的
if ("b".equals(tmp) ||
"i".equals(tmp) ||
"u".equals(tmp) ||
"size".equals(tmp) ||
"color".equals(tmp) ||
"quote".equals(tmp) ||
"url".equals(tmp) ||
"email".equals(tmp) ||
"img".equals(tmp)) {
return new String[] { tag, attr };
}
// 不是一个合法的UBB标签，作为普通文本处理
return null;
}
public String compose(String tag, String attr, String data, boolean isEmpty) {
// 针对不同标记进行组合工作
String tmp = tag;
if ("b".equals(tmp) ||
"i".equals(tmp) ||
"u".equals(tmp)) {
return "<" + tag + ">" + data + "";
} else if ("size".equals(tmp) ||
"color".equals(tmp)) {
return "" + data + "";
} else if ("quote".equals(tmp)) {
return "<table cellpadding=0 cellspacing=0 width=94% bgcolor=#000000 align=center style='table-layout:fixed'><tr><td><table width=100% cellpadding=5 cellspacing=1 style='table-layout:fixed'><tr><td bgcolor=#FFFFFF style='left: 0px; width: 100%; word-wrap: break-word'>"
+ data + "</td></tr></table></td></tr></table>";
} else if ("url".equals(tmp)) {
String url = attr != null ? attr : data;
return "" + data + "";
} else if ("email".equals(tmp)) {
String email = attr != null ? attr : data;
return "" + data + "";
} else if ("img".equals(tmp)) {
return "";
}
return data;
}
// 测试代码，可以运行这个类，并把包含UBB标签的文本作为参数传入来测试
// 比如java util.SimpleTagHandler "[color=red]你[color=blue]好[/color]啊[/color]"
public static void main(String[] args) throws Exception {
System.out.println(">>>>" + args[0]);
// 下面采用了忽略模式来容错，你也可以用MODE_CLOSE试验一下关闭模式的容错效果
System.out.println("=========================\n"
+ UBBDecoder.decode(args[0], new SimpleTagHandler(), UBBDecoder.MODE_IGNORE));
}
}
运行结果：
C:\java>java util.SimpleTagHandler [color=red]你[color=blue]好[/color]啊[/color]
>>>>[color=red]你[color=blue]好[/color]啊[/color]
=========================
你好啊
↑返回目录
前一篇: 《小画家》程序源码
后一篇: SAX读取Yahoo Service天气预报数据