stanzaparser.java

XML 解释器（字符串变量）： 通常的XML解释

/** 
* 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);
}