/** 
* Copyright &#169? 2006 廣州樂言信息科技有限公司. 
* All right reserved. 
* Created at 2006-8-18
*/ 

package com.hiany.xml;

/**
 * XML節點解析器
 */
public interface StanzaParser {
	/**
	 * 把字符串解析成XML節
	 * 字符串可以是以下四種形式：<br /> 1.完整的一段式XML：<name
	 * attr1='value1' attr2='value2' /> 2.完整的兩段式XML：<name attr1='value1'
	 * attr2='value2'>text</name> 3.兩段式XML的前半部分：<name attr1='value1'
	 * attr2='value2'>text 4.兩段式XML的后半部分：text</name> @param str
	 * 輸入字符串，解析完畢后該字符串已成功被解析的部分會被刪除，剩下未解析部分。
	 * @param sb 源字符串，解析后把已解析的字符部分刪除
	 * @return XML節對象
	 */
	public abstract Stanza parse(StringBuffer sb);
	
	/**
	 * 把XML節轉換成XML字符串形式
	 * @return
	 */
	public abstract String buildString(Stanza stanza);
	
	/**
	 * 把XML節的指定部分轉換成XML字符串形式
	 * @param part 指定部分（前、中、后）
	 * @return
	 */
	public abstract String buildString(Stanza stanza, int part);
}