xml知识的学习

回顾：
对数据库关闭的问题
   例如rs.close();stmt.close();con.close();要放在finally（）里面，不要放在try（）里面 如果放在try（）里面的话 当rs.close()出现异常之后，下面如果出现异常则不会进行显示！

今天的学习内容：

今天的任务是xml的介绍和操作，还有eclipse调试，junit的使用
Xml学习网址：http://www.w3school.com.cn/x.asp



一．Xml的学习(xml相关的基础知识)
1. XML 标签对大小写敏感
2. xml必须正确的嵌套
    在 HTML 中，常会看到没有正确嵌套的元素：
<b><i>This text is bold and italic</b></i>
在 XML 中，所有元素都必须彼此正确地嵌套：
<b><i>This text is bold and italic</i></b>
在上例中，正确嵌套的意思是：由于 <i> 元素是在 <b> 元素内打开的，那么它必须在 <b> 元素内关闭。
3. xml必须要有根元素
4. xml属性值必须加引号；
5.在 XML 中，有 5 个预定义的实体引用：
&lt; < 小于
&gt; > 大于
&amp; & 和号
&apos; ' 单引号
&quot; " 引号
注释：在 XML 中，只有字符 "<" 和 "&" 确实是非法的。大于号是合法的，但是用实体引用来代替它是一个好习惯。
5. xml中的注释
   在 XML 中编写注释的语法与 HTML 的语法很相似：
<!-- This is a comment -->
6. xml中空格将会被保留
7. xml中以LF存储换行
8. xml命名的规则
   XML 元素必须遵循以下命名规则：
• 名称可以含字母、数字以及其他的字符
• 名称不能以数字或者标点符号开始
• 名称不能以字符 “xml”（或者 XML、Xml）开始
• 名称不能包含空格
可使用任何名称，没有保留的字词。
   最佳命名习惯
   使名称具有描述性。使用下划线的名称也很不错。
名称应当比较简短，比如：<book_title>，而不是：<the_title_of_the_book>。
避免 "-" 字符。如果您按照这样的方式进行命名："first-name"，一些软件会认为你需要提取第一个单词。
避免 "." 字符。如果您按照这样的方式进行命名："first.name"，一些软件会认为 "name" 是对象 "first" 的属性。
避免 ":" 字符。冒号会被转换为命名空间来使用（稍后介绍）。
XML 文档经常有一个对应的数据库，其中的字段会对应 XML 文档中的元素。有一个实用的经验，即使用数据库的名称规则来命名 XML 文档中的元素。
非英语的字母比如 éòá 也是合法的 XML 元素名，不过需要留意当软件开发商不支持这些字符时可能出现的问题。
二． 今天主要是了解对xml的读取，查找，保存的操作。阅读了相关的程序
操作xml的几种方式：
1. dom方式
2. sax方式
3. jdom方式（不怎么使用）
4. dom4j（方式）（最常用）

     今天阅读的相关源代码：
    
package com.yuqiaotech.simplejee.xml;

import java.io.File; 
import java.io.FileOutputStream;
import java.io.IOException;
import java.io.InputStream;
import java.io.OutputStreamWriter;
import java.io.Writer;
import java.util.Iterator; 
 
import javax.xml.parsers.DocumentBuilder; 
import javax.xml.parsers.DocumentBuilderFactory; 
import javax.xml.parsers.ParserConfigurationException;
import javax.xml.parsers.SAXParser; 
import javax.xml.parsers.SAXParserFactory; 
import javax.xml.transform.OutputKeys;
import javax.xml.transform.Transformer;
import javax.xml.transform.TransformerConfigurationException;
import javax.xml.transform.TransformerException;
import javax.xml.transform.TransformerFactory;
import javax.xml.transform.dom.DOMSource;
import javax.xml.transform.stream.StreamResult;
import javax.xml.transform.stream.StreamSource;
 
import org.dom4j.DocumentException;
import org.dom4j.io.OutputFormat;
import org.dom4j.io.SAXReader; 
import org.dom4j.io.XMLWriter;
import org.w3c.dom.Document; 
import org.w3c.dom.NamedNodeMap;
import org.w3c.dom.Node;
import org.w3c.dom.NodeList; 
import org.xml.sax.Attributes; 
import org.xml.sax.SAXException; 
import org.xml.sax.helpers.DefaultHandler; 

import com.sun.org.apache.xpath.internal.XPathAPI;
/**
* 大体代码是从http://www.iteye.com/topic/181865抄来的。
* 下面这个是被广泛抄袭的，关于java里读取xml的概要介绍。
* http://blog.csdn.net/geekwang/archive/2008/05/25/2480504.aspx
*
* 我主要是把从绝对路径读取xml换成了从classpath读取。
* 另外添加了Transformer和xslt，以及XPath的演示，以及相关的一些链接。
*
* 另外可以搜一下jaxp了解这个规范的相关内容。
*
* @author YUQIAOTECH
*
*/
public class SimpleSample  { 
  static String xmlName = "test.xml";
  static String xlst = "xslt.xsl";
  static String dom4jSaveTo = "c:/text.xml";
  static String xsltSaveTo = "c:/text2.html";
 

    /**
     * DOM方式
     */ 
    public void DOM() { 
        long lasting = System.currentTimeMillis(); 
 
        try { 
            InputStream in = SimpleSample.class.getResourceAsStream(xmlName); //有点不懂，为什么能用本身的类；
            DocumentBuilderFactory factory = DocumentBuilderFactory 
                    .newInstance();
            DocumentBuilder builder = factory.newDocumentBuilder(); 
            Document doc = builder.parse(in); //注意这里的Document是org.w3c.dom包下的
            NodeList nl = doc.getElementsByTagName("node"); 
            for (int i = 0; i < nl.getLength(); i++) { 
                System.out.println("|| Name:  |" 
                        + doc.getElementsByTagName("name").item(i) 
                                .getFirstChild().getNodeValue()); 
                System.out.println("||Space:  |" 
                        + doc.getElementsByTagName("space").item(i) 
                                .getFirstChild().getNodeValue()); 
                System.out.println("-------------------------------------------------");            } 
        } catch (Exception e) { 
            e.printStackTrace(); 
        } 
        System.out.println("耗时：" 
                + (System.currentTimeMillis() - lasting) + " MS"); 
    } 
  int i =0;
    class SaxHandler extends DefaultHandler{
    java.util.Stack tags = new java.util.Stack(); 
        public void startElement(String uri, String localName, String qName, 
                Attributes attrs) { 
            tags.push(qName); 
        } 
     
        public void characters(char ch[], int start, int length) 
                throws SAXException { 
        System.out.println(i+++"--------xxxxxxxxx-------------------"); 
            String tag = (String) tags.peek(); 
            if (tag.equals("name")) { 
                System.out.println("|| Name:  |" + new String(ch, start, length)); 
            } 
            if (tag.equals("space")) { 
                System.out.println("||Space:  |" + new String(ch, start, length)); 
            } 
            System.out.println("-------------------------------------------------"); 
        } 
    }
 
    /**
     * SAX方式
     */ 
    //本段程序代码内部具体的实现  不是很懂；
    public void SAX() { 
 
        long lasting = System.currentTimeMillis(); 
        try { 
        InputStream in = SimpleSample.class.getResourceAsStream(xmlName);
            SAXParserFactory sf = SAXParserFactory.newInstance(); 
            SAXParser sp = sf.newSAXParser(); 
            SaxHandler reader = new SaxHandler(); 
            sp.parse(in, reader); 
        } catch (Exception e) { 
            e.printStackTrace(); 
        } 
        System.out.println("SAX 耗时：" 
                + (System.currentTimeMillis() - lasting) + " MS"); 
    } 
 

 
    /**
     * 我懒得去了解JDOM了 :-)。
     * JDOM方式
     */ 
//    public void JDOM() { 
//        long lasting = System.currentTimeMillis(); 
//        try { 
//            SAXBuilder builder = new SAXBuilder(); 
//            org.jdom.Document doc = builder.build(new File("F:/xmltest.xml")); 
//            Element foo = doc.getRootElement(); 
//            List allChildren = foo.getChildren(); 
//            for (int i = 0; i < allChildren.size(); i++) { 
//                System.out.println("|| Name:  |" 
//                        + ((Element) allChildren.get(i)).getChild("name") 
//                                .getText()); 
//                System.out.println("||Space:  |" 
//                        + ((Element) allChildren.get(i)).getChild("space") 
//                                .getText()); 
//                System.out.println("-------------------------------------------------");            } 
//        } catch (Exception e) { 
//            e.printStackTrace(); 
//        } 
//        System.out.println("JDOM RUNTIME：" 
//                + (System.currentTimeMillis() - lasting) + " MS"); 
//    } 
 
    /**
     * DOM4J方式
     */ 
    public void DOM4J() { 
        long lasting = System.currentTimeMillis(); 
        try { 
        InputStream in = SimpleSample.class.getResourceAsStream(xmlName);
            SAXReader reader = new SAXReader(); 
            org.dom4j.Document doc = reader.read(in);  //注意这里的Document是org.dom4j包下的
            org.dom4j.Element root = doc.getRootElement(); 
            org.dom4j.Element foo; 
            for (Iterator i = root.elementIterator("node"); i.hasNext();) { 
                foo = (org.dom4j.Element) i.next(); 
                System.out.println("|| Name:  |" + foo.elementText("name")); 
                System.out.println("||Space:  |" + foo.elementText("space")); 
                System.out.println("-------------------------------------------------"); 
            } 
        } catch (Exception e) { 
            e.printStackTrace(); 
        } 
        System.out.println("DOM4J 耗时：" 
                + (System.currentTimeMillis() - lasting) + " MS"); 
    }
    /**
     * 调用dom4j的保存方法。
     *
     * @throws DocumentException
     * @throws IOException
     */
    public static void saveDocByDom4J() throws DocumentException, IOException{
        Writer out = new OutputStreamWriter(new FileOutputStream(dom4jSaveTo ),"GBK");
        OutputFormat format = OutputFormat.createPrettyPrint();
        XMLWriter writer = new XMLWriter( out, format );
    InputStream in = SimpleSample.class.getResourceAsStream(xmlName);
        SAXReader reader = new SAXReader(); 
        org.dom4j.Document doc = reader.read(in); 
        writer.write( doc );
        out.close();
    }

    /**
     * 使用Transformer和xslt。
     * http://www.ibm.com/developerworks/cn/xml/x-xslt/
     *
     * @throws ParserConfigurationException
     * @throws SAXException
     * @throws IOException
     */
public static void saveByTransformer() throws ParserConfigurationException, SAXException, IOException {
try {
InputStream in = SimpleSample.class.getResourceAsStream(xmlName);
InputStream inXsl = SimpleSample.class.getResourceAsStream(xlst);
        DocumentBuilderFactory factory = DocumentBuilderFactory 
                .newInstance(); 
        DocumentBuilder builder = factory.newDocumentBuilder(); 
        Document doc = builder.parse(in);
        StreamSource style = new StreamSource(inXsl);
TransformerFactory tFactory = TransformerFactory.newInstance();
Transformer transformer = tFactory.newTransformer(style);
transformer.setOutputProperty(OutputKeys.ENCODING, "GBK");
DOMSource source = new DOMSource(doc);
StreamResult result = new StreamResult(new File(xsltSaveTo));
transformer.transform(source, result);
} catch (TransformerConfigurationException e) {
throw new RuntimeException(e.getMessage(), e);
} catch (TransformerException e) {
throw new RuntimeException(e.getMessage(), e);
}
}

//**********************XPath*****************************

/**
* 返回指定的节点。
*
* @param topNode
* @param xPath
* @return
*/
public static Node selectSingleNode(Node topNode, String xPath) {
try {
return XPathAPI.selectSingleNode(topNode, xPath);
} catch (TransformerException e) {
System.out.println(e.getMessage() + " xPath=" + xPath);
throw new RuntimeException(e.getMessage(), e);
}
}

/**
* 根据属性名获取属性节点。
*
* @param node
* @param attributeName
* @return
*/
public static Node getAttributeNode(Node node, String attributeName) {
NamedNodeMap namedNodeMap = node.getAttributes();
return namedNodeMap.getNamedItem(attributeName);
}

/**
* 几个方法的组合。
*
* @param node
* @param xPath
* @param attributeName
* @return
*/
public static String getAttributeNodeByXPath(Node node, String xPath,
String attributeName) {
Node rtn = null;
Node selectedNode = selectSingleNode(node, xPath);
if (selectedNode != null) {
rtn = getAttributeNode(selectedNode, attributeName);
}
if(rtn == null)return null;
return rtn.getNodeValue();
}
/**
* http://www.zvon.org/xxl/XPathTutorial/General_chi/examples.html
* http://www.ibm.com/developerworks/cn/xml/x-wxxm35.html
*
* @throws ParserConfigurationException
* @throws SAXException
* @throws IOException
*/
public static void XPath() throws ParserConfigurationException, SAXException, IOException{
InputStream in = SimpleSample.class.getResourceAsStream(xmlName);
        DocumentBuilderFactory factory = DocumentBuilderFactory 
                .newInstance(); 
        DocumentBuilder builder = factory.newDocumentBuilder(); 
        Document doc = builder.parse(in);
        String attr = getAttributeNodeByXPath(doc,"//node[@id=1]/name","alias");
        System.out.println("alias="+attr);
       
}
    public static void main(String arge[]) throws ParserConfigurationException, SAXException, IOException, DocumentException { 
        SimpleSample myXML = new SimpleSample(); 
        System.out.println("=====================DOM========================="); 
        myXML.DOM(); 
        System.out.println("=====================SAX========================="); 
        myXML.SAX(); 
        //System.out.println("=====================JDOM========================"); 
        //myXML.JDOM(); 
        System.out.println("=====================DOM4J======================="); 
        myXML.DOM4J(); 
        System.out.println("=====================DOM4J的格式化保存=======================");  
        saveDocByDom4J();
        System.out.println("=====================Transformer和xslt的使用======================="); 
        saveByTransformer();
        System.out.println("=====================XPath的演示=======================");
        XPath();
    } 
} 

　　

今天掌握的一些函数方法： (都是在 
/simplejee/src/com/yuqiaotech/simplejee/xml/SimpleSample.java)
1. System 类中的public static long currentTimeMillis()  返回以毫秒为单位的当前时间；
2. class类中的public InputStream getResourceAsStream(String name)  查找具有给定名称的资源
3. org.w3c.com 中的Document接口中的 NodeList getElementsByTagName(String tagname)
按文档顺序返回包含在文档中且具有给定标记名称的所有 Element 的 NodeList。
4.  public interface NodeList    int getLength()  列表中的节点数。有效子节点索引的范围是 0 到 length-1（包含此值）。
5.  Node getFirstChild()    获取节点的第一个子节点；
6.  java.util.Stack  public E peek()  查看堆栈顶部的对象，但不从堆栈中移除它。