JDOM基础
JDOM Java Document Object Model
JDOM使用对象树来表示XML.
JDOM使用SAX解析器来解析XML文档,构建JDOM树.JDOM本身没有解析器.
JDOM主要API以类为主,而非接口.简化了编程,但限制了灵活性.JDOM使用集合类作为对象存储的容器.
JDOM共有七个包
org.jdom包中包含了表示XML文档及其组成部分的类.如Document,Element,Attribute和CDATA.
org.jdom.xpath 包含 XPath 查找类.
org.jom.transform 包含 XSTL 转换类.
org.jdom.adapters 包含 几种主要解析器的适配器类.
org.jdom.filter 包含 过滤文档节点的类.
org.jdom.input包下提供了如下两个类用于构建JDOM树.
DOMBuilder:将一份已有的W3C的Document对象转换为JDOM的Document.
SAXBuilder:工具类,可以将来自输入流,磁盘或指定URL所代表的XML文档转换为JDOM的Document.
org.jdom. Output包下提供三个输出工具类.
DOMOutputter 将内存中的JDOM树输出成W3C的DOM树.
SAXOutputter 将内存中的JDOM树输出到SAX2流中,用于出发SAX2事件监听器.
XMLOutputter 将内存中的JDOM树输出成XML文档.
org.jdom
常用API中只有Parent是接口.
Parent接口代表所有能包含子内容的节点.有连个实现类,Element类,和Document类.
Parent接口中常用方法:
List getContent() 返回当前元素所包含的所有子内容.
Int getContentSize() 返回该元素所包含的所有子内容的大小.
Iterator getDescendants() 获取该元素所包含的所有后代节点.
Document getDocument() 返回该元素所在的XML文档所对应的Document.
Parent getParent() 返回父元素.
Int indexOf() 返回指定子内容在当前元素的子内容列表中的索引.
List removeContent() 删除当前元素的指定子内容,并返回被删除的内容.
常用类
Document 代表XML文档.它不能是其他对象的内容.所以只是实现了Parent接口.
Content 所有JDOM对象的抽象父类.
Content的派生类:
Element XML 元素.
Text XML文档中的文本内容.
CDATA XML文档中的CDATA段.
DocType XML文档中的DOCTYPE声明.
ProcessingInstruction XML文档里的处理指令.
EntityRef XML文档中的实体引用.
Comment XML文档中的注释内容.
Attribute XML文档中的属性.属性是附属于某个元素的.所以Attribute单独的一个类.
创建XML文档
Document doc=new Document(); //创建文档.
Element eltRoot=new Element(“student”); //创建一个元素.
doc.setRootElement(eltRoot); //把元素作为文档的根元素.
或者在构造Document时,传入根元素
Element eltRoot=new Element(“student”); //创建一个元素.
Document doc=new Document(eltRoot); //创建文档,且把元素作为文档的根元素.
添加属性
eltRoot.setAttribute(“sn”,”10”);
添加子元素并设置元素内容
Element eltName=new Element(“name”) //创建元素,子元素.
Element eltAge=new Element(“age”) //创建元素,子元素.
eltName.setText(“剑圣”); //给元素添加内容.
eltAge.setText(“128”); //给元素添加内容.
eltRoot.addContent(eltName); //给元素添加子元素
eltRoot.addContent(eltAge); //给元素添加子元素
输出文档
org.jdom. Output包下
DOMOutputter 将内存中的JDOM树输出成W3C的DOM树.
SAXOutputter 将内存中的JDOM树输出到SAX2流,用于出发SAX2事件监听器.
XMLOutputter 将内存中的JDOM树输出为字节流.
例如,
XMLOutputter xmlOut=new XMLOutputter();
xmlOut.output(doc,System.out);
输出可以选择输出到文件或套接字流,或控制台输出流中.
xmlOut.output(doc,new FileOutputStream(“student.xml”));
格式化输出
Format类,用于设置输出文档的字符编码,设置行分隔符,以及设置缩进字符串.
public static Format getCompactFormat()
采用紧凑格式.即对文档中的空白进行规范化,使用UTF-8编码,不展开空元素,包含声明和编码,以及使用默认的实体转义策略.
public static Format getRowFormat()
采用原始格式.即对文档中的空白保持不变,使用UTF-8编码,不展开空元素,包含声明和编码, 以及使用默认的实体转义策略.
public static Format getPrettyFormat()
采用美化的格式.即使用两个空格作为缩进来输出文档, 不展开空元素,包含声明和编码,以及使用默认的实体转义策略.
下面采用美化的格式输出文档至控制台输出流,设置字符编码为GB2312.
Format fmt=Format.getPrettyFormat(); //得到格式对象.
fmt.setEncoding(“GB2312”); //设置格式对象的编码
fmt.setIndent(“ ”); //设置格式对象的缩进
xmlOut.setFormat(fmt); //输出对象设置格式(即把格式对象绑定到输出对象)
xmlOut.output(doc,System.out); //输出对象把文档对象传至输出流.
构建JDOM树
org.jdom.input包下提供了如下两个类用于构建JDOM树.
DOMBuilder:将已有的W3C DOM的Document对象或Element对象转换为JDOM的对象.
SAXBuilder: 使用一个第三方的SAX解析器,将不同输入源(输入流,磁盘或指定URL所代表的XML文档)转换为JDOM的Document.
以DOMBuilder类构造JDOM文档对象.
DocumentBuilderFactory dbf= DocumentBuilderFactory.newInstance(); //构建W3C DOM解析器工厂
DocumentBuilder db= dbf.newDocumentBuilder(); //构建解析器
File file=new File(“students.xml”); //引用文件
org.w3c.dom.Document document=db.parse(file); //得到W3C DOM document
DOMBuilder domBuilder=new DOMBuilder(); //创建JDOM的domBuilder
org.jdom.Document doc=domBuilder.builder(document); // W3C DOM document
转为 JDOM document.
访问根元素
使用Document类的getRootElement()方法,用于返回文档的根元素.
Element root=doc.getRootElement();
访问子元素
在Element类中定义了获取子元素的方法.
要得到某个元素的所有子元素.
java.util.List childrenList=element.getChildren(); //
要得到某个元素的指定名称的子元素
java.util.List childrenList=element.getChildren(“student”); //
要得到指定名称元素的第一个子元素
java.util.List childrenList=element.getChild (“student”); //
要删除某个元素的指定名称的所有子元素
element.removeChildren (“student”); //
要删除某个元素的指定名称的第一个元素
element. removeChildren (“student”); //
访问属性
在Element类中定义了访问元素属性的方法.
要得到某元素的所有属性
java.util.List attrList=element.getAttributes(); //
要得到指定的属性
Attribute attr=element.getAttribute(“sn”); //
要得到指定的属性的值
String attrValue=element.getAttributeValue(“sn”); //
要删除指定的属性
element.removeAttribute (“sn”); //
验证XML文档
使用DTD验证
在构造SAXBuilder对象时传入参数true.
使用Scheme验证