ixmlprocess.java

这是本人学习JAVA操作XML文件时编写的小软件

package com.rochoc.xml.Interf;

import java.util.List;

import org.jdom.Document;
import org.jdom.Element;

/**
 * @author luoc
 *
 * To change this generated comment edit the template variable "typecomment":
 * Window>Preferences>Java>Templates.
 * To enable and disable the creation of type comments go to
 * Window>Preferences>Java>Code Generation.
 * 
 * 
 * 功能描述：对XML文件的处理，接口类
 * 
 * 编写时间：2005-02-04
 */
public interface IXMLProcess 
{	
	/**
	 * 方法名称：setDocument
     * 方法功能：设置Document
     * @param doc Document
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-05
	 */
	public void setDocument(Document doc);
	
	/**
	 * 方法名称：setDocument
     * 方法功能：通过XML文件路径设置Document
     * @param  path String
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-05
	 */
	public void setDocument(String path);
	
	/**
	 * 方法名称：getDocument
     * 方法功能：获取该XML文件的Document
     * @return Document
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-04
	 */
	public Document getDocument();
	
	/**
	 * 方法名称：getRoot()
     * 方法功能：获取该XML文件的Document的根结点
     * @return Element
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-21
	 */
	public Element getRoot();
	
	/**
	 * 方法名称：getChildren
     * 方法功能：获取node下的子结点
     * @param node Element
     * @return 子结点集合  List
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-04
	 */
	public List getChildren(Element node);
	
	/**
	 * 方法名称：getChildren
     * 方法功能：获取node下的名为name的子结点
     * @param node Element
     * @param name String 
     * @return 子结点集 List
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-04
	 */
	public List getChildren(Element node,String name);
	
	/**
	 * 方法名称：getChildren
     * 方法功能：获取node下的名为name，命名空间为ns的子结点
     * @param node Element
     * @param name String 
     * @param ns  String
     * @return 子结点集 List
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-04
	 */
	public List getChildren(Element node,String name,String ns);
	
	/**
	 * 方法名称：getChild
     * 方法功能：获取node下的名为name的子结点
     * @param node Element
     * @param name String 
     * @return 子结点 Element
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-04
	 */
	public Element getChild(Element node,String name);
	
	/**
	 * 方法名称：getChild
     * 方法功能：获取node下的名为name，命名空间为ns的子结点
     * @param node Element
     * @param name String 
     * @param ns String
     * @return 子结点 Element
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-04
	 */
	public Element getChild(Element node,String name,String ns);
	
	/**
	 * 方法名称：getTextVal
     * 方法功能：查询node中的Text值
     * @param node Element 
     * @return String 值
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-05 
	 */
	public String getTextVal(Element node);
	
	/**
	 * 方法名称：getAttrVal
     * 方法功能：查询node中指定属性的属性值
     * @param node Element
     * @param attr String 
     * @return String 属性值
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-05 
	 */
	public String getAttrVal(Element node,String attr);
	
	/**
	 * 方法名称：getListByAttr
     * 方法功能：通过Attribute名查询node中Attribute为attrVal的子Element
     * @param node Element
     * @param attr String 
     * @param attrVal String 
     * @return 符合结果的Element集合  List
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-04
	 */
	public List getListByAttr(Element node,String attr,String attrVal);
	
	/**
	 * 方法名称：getListByAttrLike
     * 方法功能：通过Attribute名查询node中Attribute为attrVal的子Element --模糊查询
     * @param node Element
     * @param attr String 
     * @param attrVal String 
     * @return 符合结果的Element集合  List
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-04
	 */
	public List getListByAttrLike(Element node,String attr,String attrVal);	
	
	/**
	 * 方法名称：getListByText
     * 方法功能：通过Element中的值查询，返回对应符合条件的节点
     * @param node Element
     * @param textVal String 
     * @return 符合结果的Element集合  List
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-06
	 */
	public List getListByText(Element node,String textVal);
	
	/**
	 * 方法名称：getListByTextLike
     * 方法功能：通过Element中的值查询，返回对应符合条件的节点 --模糊查询
     * @param node Element
     * @param textVal String 
     * @return 符合结果的Element集合  List
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-06
	 */
	public List getListByTextLike(Element node,String textVal);	
	
	/**
	 * 方法名称：setAttrVal
     * 方法功能：设定node中指定属性的属性值
     * @param node Element
     * @param attr String 
     * @param attrVal String
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-05 
	 */
	public void setAttrVal(Element node,String attr,String attrVal);
	
	/**
	 * 方法名称：setElementText
     * 方法功能：设定node的值
     * @param node Element
     * @param val String 
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-05 
	 */
	public void setElementText(Element node,String val);
	
	/**
	 * 方法名称：addElement
     * 方法功能：在指定的parent下增加指定的child
     * @param parent Element
     * @param child Element
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-05 
	 */
	public void addElement(Element parent,Element child);
	
	/**
	 * 方法名称：addElement
     * 方法功能：在指定的parent下增加指定名称和值的Element
     * @param parent Element
     * @param String nodeName
     * @param String nodeVal
     * @author：luoc
     * @since：1.0<p>
	 */
	public void addElement(Element parent,String nodeName,String nodeVal);
	
	/**
	 * 方法名称：toXSLTransform
     * 方法功能：通过XSL文件sheetname对XML文件docname进行转换，并输出转换结果
     * @param docname String
     * @param sheetname  String
     * @return  Document
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-04
	 */
	public Document toXSLTransform(String docname,String sheetname);
	
	/**
	 * 方法名称：toXSLTransform
     * 方法功能：通过XSL文件sheetname对XML文件docname进行转换，并输出转换结果
     * @param doc Document
     * @param sheetname  String
     * @return Document
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-04
	 */
	public Document toXSLTransform(Document doc,String sheetname);
	
	/**
	 * 方法名称：saveXMLFile
     * 方法功能：将Document保存为XML文件
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-05 
	 */
	public void saveXMLFile();
	
	
	/**
	 * 方法名称：saveXMLFile
     * 方法功能：将指定的Document保存为指定的XML文件
     * @param doc Document
     * @param file String 
     * @author：luoc
     * @since：1.0<p>
     * 编写时间：2005-02-05 
	 */
	public void saveXMLFile(Document doc,String file);
}