ubbtaghandler.java

ubb标签转换的程序 用于jsp开发中.

package util;

/**
 * 版权所有 2006(C) 中国Java手机网(www.cnjm.net)。所有版权保留。
 * 作者开放本代码的目的是希望更多人使用它，任何人只要遵从以下条款，就可以传播、使用或修改本代码： 
 * 1. 再发布本代码必须完整保留此版权声明及条款，不得删除。
 * 2. 使用本代码开发的软件必须在版权信息中声明： “本软件在开发中使用了中国Java手机网(www.cnjm.net)编写的UBB转换引擎”。
 * 3. 使用本代码开发的软件应在文档中加入中国Java手机网(www.cnjm.net)的链接。
 * 4. 使用者必须独自承担使用本代码的风险，中国Java手机网不为本代码对其软件或系统可能造成的任何损害承担责任。
 */
public interface UBBTagHandler {

    /**
     * 解析一个可能的UBB标签（扩在[]之间的内容），如果是一个合法的UBB标签，则实现方法
     * 要负责把传入的potentialTag解析成标签符号(tag)和属性(attribute)两部分，并作为
     * 一个字符串数组传回，如果potentialTag并非一个合法的UBB标签，则应返回null。
     * 注意'['和']'是不会作为potentialTag的一部分传给本方法的。
     * @param potentialTag 
     * @param isEmpty 是否是一个空标签，即形式为[.../]，没有内层嵌套文本的UBB标签
     * @return 如果输入是合法UBB标签，则返回经解析后的的标签符号和相应属性，否则返回null
     */
    public String[] parseTag(String potentialTag, boolean isEmpty);

    /**
     * 把给定的UBB标签转换组合成输出形式
     * @param tag 标签符号
     * @param attr 标签属性
     * @param data 标签中的内容（已经转换成输出形式后的）
     * @param isEmpty 是否是一个空标签，即形式为[.../]，没有子标签的UBB标签
     * @return 组合好的字符串
     */
    public String compose(String tag, String attr, String data, boolean isEmpty);
    
}