首页 > 代码库 > XML学习笔记(五):使用 jdom和dom4j 解析XML
XML学习笔记(五):使用 jdom和dom4j 解析XML
XML解析的详细分析与jaxp解析XML详见:XML学习笔记(四):使用 DOM和SAX 解析XML
一、JDom
1、创建XML文件:
1)Document类即代表整个XML文档,把生成的 Document 利用 XMLOutputter 类输出即可。
2)映射关系:元素:Element;属性:Attribute;注解:Comment;文本信息:Text;
3)注意:addContent()是追加,setContent()会覆盖。
/** * 创建XML * * @throws IOException */ private void createXML() { ArrayList<Element> eleList = new ArrayList<Element>(); Document doc = null; try { // 新建一个Document doc = new Document(); // 新建一个根元素 <root> Element root = new Element("root"); // 给根元素添加文本内容 root.setText("this is a root el"); // 修改根元素 的名字 root.setName("rootElement"); // 给根元素添加属性 root.setAttribute("name", "属性"); // 新建一个元素<APPNT> Element appntEle = new Element("APPNT"); // 定义一个属性对象 Attribute appntAttr = new Attribute("name", "SAM-SHO"); // 给<APPNT>元素添加属性 appntEle.setAttribute(appntAttr); appntEle.setAttribute("age", "28"); // 给<APPNT>元素添加文本内容 appntEle.setText("我是投保人"); // 给<APPNT>元素添加注解 Comment comment = new Comment("我是注解"); appntEle.addContent(comment); // 新建一个元素<INSURED> Element insuredEle = new Element("INSURED"); // 定义一个属性对象 Attribute insuredAttr = new Attribute("name", "SAMMY"); // 给<INSURED>元素添加属性 insuredEle.setAttribute(insuredAttr); insuredEle.setAttribute("age", "49"); // 给<INSURED>元素添加文本内容 Text text = new Text("我是被保人,可以这样加文本"); // insuredEle.setText("我是被保人"); insuredEle.addContent(text); insuredEle.addContent(" ||我是追加"); // addContent()是追加,setContent()会覆盖 // insuredEle.setContent(new Text("....我会覆盖")); // 把新建的元素放入集合 eleList.add(appntEle); eleList.add(insuredEle); // 把新建的元素添加到 根元素 <root> root.setContent(eleList); // 也可以使用addContent()一个一个加 // root.addContent(appntEle); // root.addContent(insuredEle); // 把根元素添加到 Document doc.setRootElement(root); // doc = new // Document(root);//可以直接这样新建xml文档,同doc.setRootElement(root) String xmlStr = out.outputString(doc); System.out.println(xmlStr);// 打印到控制台 out.output(doc, System.out);// 输出到控制台 out.output(doc, new FileOutputStream("resources/root.xml"));// 输出到文件 } catch (IOException e) { e.printStackTrace(); } }
2、解析整个XML文档:
1)只要有一点Dom解析的基础,JDom的使用就会变得比较简单。
2)得到解析器、解析XML文件的步骤都是固定的。
3)我们获取到元素与属性后,可以直接输出,也可以set到预先定义好的JavaBean中。
/** * 解析XML * * @throws IOException */ private void getXML() { try { // 1-获取解析器 SAXBuilder dBuilder = new SAXBuilder(); // 2-获取xml文件的流 InputStream is = JDomXML.class.getClassLoader().getResourceAsStream("Request.xml"); // 3- 解析XML文件 Document doc = dBuilder.build(is); // 4-获取元素 // 4-1 获取根元素<request> Element root = doc.getRootElement();// 拿到request // 4-2获取子元素<appnt> Element appntEle = root.getChild("appnt"); // 4-2-1 获取<appnt>的<name>元素 Element appntName = appntEle.getChild("name"); logger.debug("<name>元素名称: " + appntName.getName()); logger.debug("<name>元素文本信息: " + appntName.getText()); // 4-2-2 获取<appnt>的<age>元素 Element ageName = appntEle.getChild("age"); logger.debug("ageName: " + ageName.getName()); logger.debug("ageText: " + ageName.getText()); // 4-3 获取子元素<insured> Element insuredEle = root.getChild("insured"); // 4-3-1 获取<insured>的name属性 Attribute nameAttr = insuredEle.getAttribute("name"); logger.debug("nameAttr: " + nameAttr.getValue()); // 4-3-2 获取<insured>的age属性 Attribute ageAttr = insuredEle.getAttribute("age"); logger.debug("ageAttr: " + ageAttr.getValue()); logger.debug("直接拿ageAttr: " + insuredEle.getAttributeValue("age")); // 4-4 获取子元素<product> Element productEle = root.getChild("product"); // 4-4 获取子元素<Service> List<Element> serviceLists = root.getChildren("Service");// 拿到<Service>元素 for (Element servlce : serviceLists) { // 获取<Service>的两个属性: name和type logger.debug(servlce.getAttributeValue("name")); logger.debug(servlce.getAttributeValue("type")); // 获取<Service>的子元素 <RequestHandle>,可以有多个 List<Element> requestLists = servlce.getChildren("RequestHandle"); for (Element Request : requestLists) { // 获取 <RequestHandle>的子元素 <Handle>,可以多个 List<Element> handleLists = Request.getChildren("Handle"); for (Element handle : handleLists) { // 获取<Handle>的属性 : name 和 type logger.debug(handle.getAttributeValue("name")); logger.debug(handle.getAttributeValue("type")); // 获取<Handle> 的子元素<init-param> 可以有多个 List<Element> paramLists = handle.getChildren("init-param"); for (Element init_param : paramLists) { // 获取<init-param>的两个子元素 <param-name>和<param-value> Element param_name = init_param.getChild("param-name"); logger.debug("param-name: " + param_name.getTextTrim()); Element param_value = http://www.mamicode.com/init_param.getChild("param-value");>二、Dom4j
1、简介:
1)Dom4j是以上各api中效率最好的,javm内部使用的也是Dom4j。
2)Dom4j的文档写的非常好,介绍的很详细。它的文档位于下载包下:如dom4j-1.6.1\docs\guide.html 。
3)使用Dom4j解析XML文档,可以使用强大XPath语法。语法地址:http://www.zvon.org/xxl/XPathTutorial/General_chi/examples.html
2、创建XML文档以及对其CRUD
1)Dom4j创建Document和Element都需要用到 DocumentHelper 类。如
// 创建一篇文档 Document doc = DocumentHelper.createDocument(); // 创建元素 Element ele = DocumentHelper.createElement("插入新元素");2)Dom4j的语法设计,使得链式编程得到很大的便利。如添加一个新元素:
// 3-在<insured>下添加新元素,注意,addText\addAttribute都是操作在元素<DESC>上 document.getRootElement().element("insured").addElement("DESC").addText("新加的元素").addAttribute("属性", "值");3)Dom4j的解析语法有一个很大的不足,就是作CRUD的时候必须一层一层的从根元素开始获取。(可以使用XPath语法解决)。如下面添加、删除、更新元素时,必须从根节点开始获取,然后操作:
// 3-2 指定位置上添加新元素:如<product>元素下子元素 <price>下添加<插入新元素> // 这个插入很恶心,一点都不爽。 Element product = document.getRootElement().element("product"); List<Element> list = product.elements(); list.add(2, DocumentHelper.createElement("插入新元素").addText("这个插入很恶心")); // 3-3 删除指定节点,如删除<appnt>的<age>子元素 Element ageEle = document.getRootElement().element("appnt").element("age");//得到<age>元素 // ageEle.remove(ageEle);//是否可以删除自己?? 答案是不行 ageEle.getParent().remove(ageEle);//只能利用父亲元素的remove()方法 // 3-4 更新 修改<appnt>的<name>子元素 document.getRootElement().element("appnt").element("name").addAttribute("修改属性", "修改的属性值").setText("修改文本域:SAM");4)生成文档的输出:
①、尽量配合格式化 OutputFormat 类一起使用,这样可以避免编码错误的发生。
②、使用字符流转码,如:new OutputStreamWriter(new FileOutputStream("resources/Request.xml"), "utf-8")
③、直接使用字节流配合 OutputFormat 格式化一起使用。
// 4-输出到文档 // 注意:这边有可能会有编码问题:其实用于读取写入sting化的xml文件(称为报文)时,都存在转码问题。 // 以前有个项目,和天猫对接,天猫的报文编码为 GBK 的,我们的系统统一UTF-8.这样很明显需要转码。 // 先用 GBK 读取后需要转成 UTF-8 才能使用。 // 问题分析: // 1) 这边控制编码的是IO流的 FileWriter 。 // 2) FileWriter默认会使用本地平台的码表,如你的平台编码为GB2312。而你的xml文档的编码为utf-8,这样写入中文会乱码,即写入的为GB2312 。 // 3) XMLWriter这边只接受 Writer ,我们可以使用 OutputStreamWriter 指定写入的编码为utf-8即可。 OutputFormat format = OutputFormat.createPrettyPrint();// 格式化编辑器 XMLWriter writer = new XMLWriter(new FileWriter("resources/Request.xml"), format); // XMLWriter writer = new XMLWriter(new OutputStreamWriter(new FileOutputStream("resources/Request.xml"), "utf-8")); writer.write(document); writer.close(); // 编码扩展:修改xml的编码为 GBK 。 // document这边默认会转成utf-8,写出的时候需要指定格式化输出器的编码为 GBK, // 然后利用字节流 FileOutputStream 直接输出 // 或者利用字节流转成字符流 OutputStreamWriter,但是需要指定转的编码 // OutputFormat format = OutputFormat.createPrettyPrint();//格式化编辑器 // format.setEncoding("GBK"); // 字符流 // XMLWriter writer = new XMLWriter(new OutputStreamWriter(new FileOutputStream("resources/Request.xml"), "GBK"),format); // 自节流 // XMLWriter writer = new XMLWriter(new FileOutputStream("resources/Request.xml"), format); // writer.write(document); // writer.close(); // 漂亮的格式输出到控制台 OutputFormat format2 = OutputFormat.createPrettyPrint(); // format2.setEncoding("GBK"); writer = new XMLWriter(System.out, format2); writer.write(document);
5)其实Dom4j的语法,在文档中非常详细,这边就不多说了。注意输出编码问题即可。详细代码如下:
/** * 创建XML文档以及CRUD * * @throws DocumentException * @throws IOException */ public void createDocument() { /******* 在原有文档上添加 **********/ try { // 1- 获取解析器 SAXReader reader = new SAXReader(); // 2-读取文档 Document document = reader.read(new File("resources/Request.xml")); // Document document = reader.read(new InputStreamReader(new FileInputStream("resources/Request.xml"),"GBK")); // 3-在<insured>下添加新元素,注意,addText\addAttribute都是操作在元素<DESC>上 document.getRootElement().element("insured").addElement("DESC").addText("新加的元素").addAttribute("属性", "值"); // 3-2 指定位置上添加新元素:如<product>元素下子元素 <price>下添加<插入新元素> // 这个插入很恶心,一点都不爽。 Element product = document.getRootElement().element("product"); List<Element> list = product.elements(); list.add(2, DocumentHelper.createElement("插入新元素").addText("这个插入很恶心")); // 3-3 删除指定节点,如删除<appnt>的<age>子元素 Element ageEle = document.getRootElement().element("appnt").element("age");//得到<age>元素 // ageEle.remove(ageEle);//是否一删除自己?? 答案是不行 ageEle.getParent().remove(ageEle);//只能利用父亲元素的remove()方法 // 3-4 更新 修改<appnt>的<name>子元素 document.getRootElement().element("appnt").element("name").addAttribute("修改属性", "修改的属性值").setText("修改文本域:SAM"); // 4-输出到文档 // 注意:这边有可能会有编码问题:其实用于读取写入sting化的xml文件(称为报文)时,都存在转码问题。 // 以前有个项目,和天猫对接,天猫的报文编码为 GBK 的,我们的系统统一UTF-8.这样很明显需要转码。 // 先用 GBK 读取后需要转成 UTF-8 才能使用。 // 问题分析: // 1) 这边控制编码的是IO流的 FileWriter 。 // 2) FileWriter默认会使用本地平台的码表,如你的平台编码为GB2312。而你的xml文档的编码为utf-8,这样写入中文会乱码,即写入的为GB2312 。 // 3) XMLWriter这边只接受 Writer ,我们可以使用 OutputStreamWriter 指定写入的编码为utf-8即可。 OutputFormat format = OutputFormat.createPrettyPrint();// 格式化编辑器 XMLWriter writer = new XMLWriter(new FileWriter("resources/Request.xml"), format); // XMLWriter writer = new XMLWriter(new OutputStreamWriter(new FileOutputStream("resources/Request.xml"), "utf-8")); writer.write(document); writer.close(); // 编码扩展:修改xml的编码为 GBK 。 // document这边默认会转成utf-8,写出的时候需要指定格式化输出器的编码为 GBK, // 然后利用字节流 FileOutputStream 直接输出 // 或者利用字节流转成字符流 OutputStreamWriter,但是需要指定转的编码 // OutputFormat format = OutputFormat.createPrettyPrint();//格式化编辑器 // format.setEncoding("GBK"); // 字符流 // XMLWriter writer = new XMLWriter(new OutputStreamWriter(new FileOutputStream("resources/Request.xml"), "GBK"),format); // 自节流 // XMLWriter writer = new XMLWriter(new FileOutputStream("resources/Request.xml"), format); // writer.write(document); // writer.close(); // 漂亮的格式输出到控制台 OutputFormat format2 = OutputFormat.createPrettyPrint(); // format2.setEncoding("GBK"); writer = new XMLWriter(System.out, format2); writer.write(document); /******************** 创建新文档 ********************/ // 创建一篇文档 Document doc = DocumentHelper.createDocument(); // 添加一个元素 Element root = doc.addElement("catalog"); // 为root元素添加注释 root.addComment("An XML Catalog"); // 添加标记 root.addProcessingInstruction("target", "instruction"); // 创建元素 Element journalEl = new BaseElement("journal"); // 添加属性 journalEl.addAttribute("title", "XML Zone"); journalEl.addAttribute("publisher", "IBM developerWorks"); root.add(journalEl); // 添加元素 Element articleEl = journalEl.addElement("article"); articleEl.addAttribute("level", "Intermediate"); articleEl.addAttribute("date", "December-2001"); Element titleEl = articleEl.addElement("title"); // 设置文本内容 titleEl.setText("Java configuration with XML Schema"); // titleEl.addText("Java configuration with XML Schema"); Element authorEl = articleEl.addElement("author"); authorEl.addElement("firstname").setText("Marcello"); authorEl.addElement("lastname").addText("Vitaletti"); // 可以使用 addDocType() 方法添加文档类型说明。 doc.addDocType("catalog", null, "file://c:/Dtds/catalog.dtd"); // 将xml转换成文本 doc.asXML(); OutputFormat format3 = OutputFormat.createPrettyPrint(); writer = new XMLWriter(System.out, format3); writer.write(doc); } catch (DocumentException e) { e.printStackTrace(); } catch (IOException e) { e.printStackTrace(); } }3、使用Dom4j的语法解析XML文档。一般来说,比较麻烦,使用xpath更加简便。
/** * 使用Dom4j解析xml文档 */ public void readXml() { try { // 1- 获取解析器 SAXReader reader = new SAXReader(); // 2-读取文档 InputStream in = this.getClass().getClassLoader().getResourceAsStream("Request.xml"); Document document = reader.read(in); // 3-读取根节点 Element root = document.getRootElement(); QName qName = root.getQName(); String name = qName.getName(); logger.debug("根节点的名称: " + name); name = root.getName(); logger.debug("根节点的名称2 : " + name); // 4-获取子节点 Element appneEle = root.element("appnt");// 只有一个 String appntName = appneEle.element("name").getTextTrim(); String appntAge = appneEle.element("age").getTextTrim(); logger.debug("appnt节点的name为 : " + appntName + " |age为 " + appntAge); // 5-获取有多个子节点 Element serviceEle = (Element) root.elements("Service").get(1); // 5-1 获取属性值 String attrName = serviceEle.attribute("name").getName(); String attrNameValue = http://www.mamicode.com/serviceEle.attribute("name").getValue();>/** * 递归方法 * * @param element */ public void treeWalk(Element element) { System.out.println(element.getName()); for (int i = 0, size = element.nodeCount(); i < size; i++) { Node node = element.node(i); if (node instanceof Element) { treeWalk((Element) node); } else { // do something.... } } }4、XML与String的相互转换:
1)XML转String:Document.asXML()方法即可。
2)String转XML:需要使用DocumentHelper.parseText("")方法。
/** * XML与String的相互转换 */ public void ConverXmlAndString() { try { Document document = DocumentHelper.createDocument(); String text = document.asXML(); String text2 = "<person> <name>James</name> </person>"; Document document2 = DocumentHelper.parseText(text2); } catch (DocumentException e) { e.printStackTrace(); } }5、使用XPath解析XML文档。
1)必须添加 jaxen.jar 包,在下载Dom4j包中就有,添加即可。
2)XPath的语法规范有中文版本,具体地址为:http://www.zvon.org/xxl/XPathTutorial/General_chi/examples.html
3)Dom4j中与XPath有关的主要方法为
//得到单个元素,如果为多个,默认取第一个 document.selectSingleNode(""); //得到符合条件的元素集合 document.selectNodes("");4)XPath语法最主要的为:"/":绝对路径,需要层次分明;"//":相对路径,获取多个值;"@"进行条件筛选。
5)具体语法代码如下:
<?xml version="1.0" encoding="UTF-8"?> <rootElement name="属性"> <user id="a1" name="33">用户1</user> <user id="a2" name="33">用户2</user> <APPNT id="1" name="SAM-SHO" age="28">我是投保人<!--我是注解--></APPNT> <INSURED id="2" name="SAMMY" age="49"><user id="a3">用户3</user></INSURED> </rootElement>/** * 利用强大的XPath 语法:http://www.zvon.org/xxl/XPathTutorial/General/examples.html * 需要导入jaxen.jar包 */ public void xPathTest() { try { // 1- 获取解析器 SAXReader reader = new SAXReader(); // 2-读取文档 Document document = reader.read(new File("resources/xpath.xml")); // 3-利用XPath // 3-1 以斜线 / 开始, 那么该路径就表示到一个元素的绝对路径 Element rootEle = (Element) document.selectSingleNode("/rootElement");// 得到根元素<rootElement>元素 System.out.println(rootEle.attributeValue("name"));// 属性 // 3-2 得到<APPNT>元素: "/"绝对路径,层次必须清楚 Node appntNode = document.selectSingleNode("/rootElement/APPNT"); System.out.println(appntNode.getText());// 我是投保人 // 3-3 双斜线 // 开头, 则表示选择文档中所有满足双斜线//之后规则的元素,相对路径 // 得到所有的user元素,不论层级,"用户3"也会在范围内 List<Node> list = document.selectNodes("//user"); for (Iterator<Node> iterator = list.iterator(); iterator.hasNext();) { Node node = (Node) iterator.next(); System.out.println(node.getText()); } // 3-4 删选元素:"@",如id='a1'的<user>元素,需要有单引号'' Node userNode = document.selectSingleNode("//user[@id='a1']"); System.out.println(userNode.getText());// 用户1 // @ 中可以使用 and 和or等逻辑:如 获取id='a1'或者id='a3'的<user>元素 List<Node> listNodes = document.selectNodes("//user[@id='a1' or @id='a3']"); for (Iterator<Node> iterator = listNodes.iterator(); iterator.hasNext();) { Node node = (Node) iterator.next(); System.out.println("获取id='a1'或者id='a3'的<user>元素 : "+node.getText()); } // @:获取id='a1'and name='33'的<user>元素 userNode = document.selectSingleNode("//user[@id='a1' and @name='33']"); System.out.println("获取id='a1'and name='33'的<user>元素: " + userNode.getText()); } catch (DocumentException e) { // TODO Auto-generated catch block e.printStackTrace(); } }三、小结:
1、jaxp的api使用还是比较麻烦的,功能和效率都不是很好,直接可以被JDom和Dom4J代替。意见是如果不是万不得已,还是不要使用。
2、Dom4j 比 JDom 的使用更加简便,且效率更高。
2、其实Java 内部的 jaxm 用的就是 Dom4j,所以一般我们使用Dom4j即可。而在解析xml时推荐使用更加强大简便的XPath语法。
XML学习笔记(五):使用 jdom和dom4j 解析XML