?package com.yeqiangwei.club.view.util;

/**
 * this code form www.cnjm.net
 * Last modified by gamvan
 */
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);
    
}