JDOM 使用標準的 Java 編碼模式。只要有可能,它使用 Java new 操作符而不用複雜的工廠化模式,使對象操作即便對於初學用戶也很方便。例如,讓我們看一下如何隨便使用 JDOM 建立一個簡單的 XML 文檔。我們將要建立的結構如清單 1 所示。
清單 1. 建立 XML 文檔樣本
<?xml version="1.0" encoding="UTF-8"?>
<car vin="123fhg5869705iop90">
<!--Description of a car-->
<make>Toyota</make>
<model>Celica</model>
<year>1997</year>
<color>green</color>
<license state="CA">1ABC234</license>
</car>
注意:我們將建立 示例文檔,在下面的清單 2 到清單 7 中有詳細描述。
開始,讓我們先創建一個根元素,並將其添加到文檔中:
清單 2. 創建一個 Document
Element carElement = new Element("car");
Document myDocument = new Document(carElement);
這一步創建一個新 org.jdom.Element ,並將其作爲 org.jdom.Document myDocument 的根元素。因爲一個 XML 文檔必須一直有一個唯一的根元素,所以 Document 將 Element 放在它的構造器中。
下一步,添加 vin 屬性:
清單 3. 添加一個 Attribute
carElement.addAttribute(new Attribute("vin", "123fhg5869705iop90"));
添加元素也是很簡單的。這裏我們添加 make 元素:
清單 4. 元素和子元素
Element make = new Element("make");
make.addContent("Toyota");
carElement.addContent(make);
由於 Element 的 addContent 方法返回 Element ,我們也可以這樣寫:
清單 5. 用簡潔形式添加元素
carElement.addContent(new Element("make").addContent("Toyota"));
這兩個語句完成了相同的工作。有些人認爲第一個示例可讀性更好,但是如果您一次建立許多元素,您會覺得第二個示例可讀性更好。要完成構建文檔:
清單 6. 添加其餘的元素
carElement.addContent(new Element("model").addContent("Celica"));
carElement.addContent(new Element("year").addContent("1997"));
carElement.addContent(new Element("color").addContent("green"));
carElement.addContent(new Element("license")
.addContent("1ABC234").addAttribute("state", "CA"));
您會注意到對於 license 元素,我們不但添加了元素的內容,還爲其添加了一個屬性,表明許可已被髮出了這個狀態。這是因爲 Element 的 addContent 方法總是返回 Element 本身,而不是一個無效的聲明。
用同樣的方法添加註釋部分或其它標準 XML 類型:
清單 7. 添加一條註釋
carElement.addContent(new Comment("Description of a car"));
操作文檔也是用類似方式。例如,要引用 year 元素,我們使用 Element 的 getChild 方法:
清單 8. 訪問子元素
Element yearElement = carElement.getChild("year");
該語句實際上將返回第一個元素名爲 year 的子 Element 。 如果沒有 year 元素,則調用返回一個空值。注意,我們不必回溯來自任何類似於 DOM Node 接口的返回值 -- Element 的子元素就是 Element 。用類似的方式,我們可把 year 元素從文檔中除去:
清單 9. 除去子元素
boolean removed = carElement.removeChild("year");
這次調用將只除去 year 元素;文檔的其餘部分保持不變。
到目前爲止,我們已經涵蓋了文檔的生成和操作。要將完成的文檔輸出至控制檯,可使用 JDOM 的 XMLOutputter 類:
清單 10. 將 JDOM 轉化爲 XML 文本
try {
XMLOutputter outputter = new XMLOutputter(" ", true);
outputter.output(myDocument, System.out);
} catch (java.io.IOException e) {
e.printStackTrace();
}
XMLOutputter 有幾個格式選項。這裏我們已指定希望子元素從父元素縮進兩個空格,並且希望元素間有空行。 XMLOutputter 可輸出到 Writer 或 OutputStream 。爲輸出到文件,我們可以簡單地將輸出行簡化爲:
清單 11. 使用 FileWriter 輸出 XML
FileWriter writer = new FileWriter("/some/directory/myFile.xml");
outputter.output(myDocument, writer);
writer.close();
JDOM解析XML
JDOM解析xml待解析的xml文件如下:
<?xml version="1.0" encoding="gb2312"?>
<books>
<book [email protected]>
<name>zzjj</name>
<price>60.0</price>
</book>
</books
解析這個XML文件的Java文件:
public class JDomParse {
public JDomParse(){
String xmlpath="library.xml";
SAXBuilder builder=new SAXBuilder(false);
try {
Document doc=builder.build(xmlpath);
Element books=doc.getRootElement();
List booklist=books.getChildren("book");
for (Iterator iter = booklist.iterator(); iter.hasNext();) {
Element book = (Element) iter.next();
String email=book.getAttributeValue("email");
System.out.println(email);
String name=book.getChildTextTrim("name");
System.out.println(name);
book.getChild("name").setText("alterrjzjh");
}
XMLOutputter outputter=new XMLOutputter();
outputter.output(doc,new FileOutputStream(xmlpath));
} catch (JDOMException e) {
e.printStackTrace();
} catch (IOException e) {
e.printStackTrace();
}
}
public static void main(String[] args) {
new JDomParse();
}
}
使用JDOM首先要指定使用什麼解析器。如:
SAXBuilder builder=new SAXBuilder(false); 這表示使用的是默認的解析器
得到Document,以後要進行的所有操作都是對這個Document操作的:
Document doc=builder.build(xmlpath);
得到根元素:
Element books=doc.getRootElement();
在JDOM中所有的節點(DOM中的概念)都是一個org.jdom.Element類,當然他的子節點也是一個org.jdom.Element類。
得到元素(節點)的集合:
List booklist=books.getChildren("book");
這表示得到“books”元素的所在名稱爲“book”的元素,並把這些元素都放到一個List集合中
遍歷List集合
for (Iterator iter = booklist.iterator(); iter.hasNext();) {
Element book = (Element) iter.next();
}
取得元素的屬性:
String email=book.getAttributeValue("email");
取得元素book的屬性名爲“email”的屬性值。
取得元素的子元素(爲最低層元素)的值:
String name=book.getChildTextTrim("name");
注意的是,必須確定book元素的名爲“name”的子元素只有一個。
改變元素(爲最低層元素)的值:
book.getChild("name").setText("alterrjzjh");
這只是對Document的修改,並沒有在實際的XML文檔中進行修改
保存Document的修改到XML文件中:
XMLOutputter outputter=new XMLOutputter();
outputter.output(doc,new FileOutputStream(xmlpath));