• Java开发笔记(一百零九)XML报文的定义和解析


    前面介绍了JSON格式的报文解析,虽然json串短小精悍,也能有效表达层次结构,但是每个元素只能找到对应的元素值,不能体现更丰富的样式特征。比如某个元素除了要传输它的字符串文本,还想传输该文本的类型、字体大小、字体颜色等特征,且这些额外的风格样式与业务逻辑无关,自然不适合为它们单独设立参数字段。倘若采用JSON格式定义包括样式特征在内的文本元素,要么摒弃风格样式这种附加属性,要么将风格样式单列为专门的字段参数,然而不管哪种做法,都未能妥善解决附加属性的表达问题。可见轻量级的JSON格式依然存在力不从心的情况,为此人们早早发明了拥有强大表示能力的XML格式,XML的全称是“Extensible Markup Language”(可扩展标记语言),它不但支持结构化数据的描述,还支持各类附加属性的定义,非常适合在网络中传输信息。
    下面先看一个XML报文格式的购物订单样例:

    <?xml version="1.0" encoding="gbk"?>
    <order>
    	<user_info>
    	<name type="string">思无邪</name>
    	<address type="string">桃花岛水帘洞123号</address>
    	<phone type="string">15960238696</phone>
    	</user_info>
    	<goods_list>
    		<goods_item>
    			<goods_name type="string">Mate30</goods_name>
    			<goods_number type="int">1</goods_number>
    			<goods_price type="double">8888</goods_price>
    		</goods_item>
    		<goods_item>
    			<goods_name type="string">格力中央空调</goods_name>
    			<goods_number type="int">1</goods_number>
    			<goods_price type="double">58000</goods_price>
    		</goods_item>
    		<goods_item>
    			<goods_name type="string">红蜻蜓皮鞋</goods_name>
    			<goods_number type="int">3</goods_number>
    			<goods_price type="double">999</goods_price>
    		</goods_item>
    	</goods_list>
    </order>
    

    接着对上面的XML样例庖丁解牛,分析一下XML格式都有哪些特点,分析结果罗列如下:
    1、每个元素依然由参数名称和参数值组成,参数名称为尖括号所包裹,且分为标记头与标记尾两部分,标记尾在尖括号内部多了个斜杆。如此一来,一个字段的完整形式为“<参数名称>参数值</参数名称>”。
    2、因为每个元素都自带标记头与标记尾,很容易区分在哪开始在哪结束,所以元素之间无需额外的分隔符,只要有标记头与标记尾就足够辨别了。
    3、每个结构也需要专门的标记头与标记尾,中间再填入若干元素或者其它结构。
    4、对于数组形式的数据,XML报文采用多个同名的结构标记并排列举,表示这里存在同名结构的数组信息,也可看作是清单信息。
    5、XML格式允许在报文开头的encoding属性处指定当前报文的字符编码类型,常见的有汉字内码规范GBK,以及世界通用编码规范UTF-8。
    6、每个结构或者元素节点,也支持在标记头部分填充附加属性,用于指定参数值以外的特定信息。
    大致了解了XML报文的格式规范,还得在程序中加以解析才行。传统的XML解析方式有DOM和SAX两种,DOM方式会把整个XML报文读进来,并且所有节点全被自动加载到一个树状结构,以后每个节点值都到该树状结构中读取。SAX方式不会事先读入整个XML报文,而是根据节点名称从报文起点开始扫描,一旦找到该节点的标记头位置,即刻往后寻找该节点的标记尾,那么节点标记头尾之间的数据便是节点值了。单就某个节点值的解析过程而言,加载所有节点的DOM方式显然较费功夫,从头顺序查找的SAX方式执行效率更高。但若要求同时获取多个节点的数值,则采取树状结构遍历的DOM方式总体性能更加,而每次都从头找起的SAX方式无疑做了重复劳动。总之两种方式的解析效果各有优劣,需要按照实际场景决定取舍。
    尽管JDK集成了DOM与SAX的解析工具,其中DOM解析工具封装在包org.w3c.dom中,SAX解析工具封装在包javax.xml.parsers中,可是它俩用起来着实费劲,解析过程艰深晦涩,实际开发当中基本不予采用。应用比较多的XML解析工具反而是第三方的Dom4j,Dom4j的解析方式遵循DOM规则,但比起Java自带的DOM工具要易用得多,其性能也很优异,几乎成为Java开发必备的XML解析神器了。通过Dom4j解析XML报文的步骤主要有下列五步:
    1、创建SAXReader阅读器对象;
    2、把字符串形式的XML报文转换为输入流对象;
    3、命令阅读器对象从输入流中读取Document文档对象;
    4、获得文档对象的根节点Element;
    5、从根节点往下依次解析每个层级的节点值;
    在具体的节点解析过程之中,会频繁调用Element的相关方法,它的常用方法说明如下:
    getText:获得当前节点的字符串值。
    element:获得当前节点下面指定名称的子节点对象。
    elementText:获得当前节点下面指定名称的子节点值。
    elements:获得当前节点下面指定名称的子节点清单。
    attribute:获得当前节点自身指定名称的属性对象。
    attributeValue:获得当前节点自身指定名称的属性值。
    attributes:获得当前节点拥有的全部属性清单。

    仍以前述的XML报文为例,下面是采用Dom4j解析该XML串的代码例子:

    	// 通过dom4j解析xml串
    	private static GoodsOrder testParserByDom4j(String xml) {
    		GoodsOrder order = new GoodsOrder(); // 创建一个购物订单对象
    		// 创建SAXReader阅读器对象
    		SAXReader reader = new SAXReader();
    		// 根据字符串构建字节数组输入流
    		try (InputStream is = new ByteArrayInputStream(xml.getBytes(CHARSET))) {
    			// 命令阅读器从输入流中读取文档对象
    			Document document = reader.read(is);
    			// 获得文档对象的根节点
    			Element root = document.getRootElement();
    			// 获取根节点下面名叫user_info的节点
    			Element user_info = root.element("user_info");
    			// 获取user_info节点下面名叫name的节点值
    			order.user_info.name = user_info.element("name").getText();
    			// 获取user_info节点下面名叫address的节点值
    			order.user_info.address = user_info.element("address").getText();
    			// 获取user_info节点下面名叫phone的节点值
    			order.user_info.phone = user_info.element("phone").getText();
    			System.out.println(String.format("用户信息如下:姓名=%s,地址=%s,手机号=%s", 
    					order.user_info.name, order.user_info.address, order.user_info.phone));
    			// 获取根节点下面名叫goods_list的节点清单
    			List<Element> goods_list = root.element("goods_list").elements();
    			for (int i=0; i<goods_list.size(); i++) { // 遍历商品节点清单
    				Element goods_item = goods_list.get(i);
    				GoodsItem item = new GoodsItem(); // 创建一项商品对象
    				// 获取当前商品项节点下面名叫goods_name的节点值
    				item.goods_name = goods_item.element("goods_name").getText();
    				// 获取当前商品项节点下面名叫goods_number的节点值
    				item.goods_number = Integer.parseInt(goods_item.element("goods_number").getText());
    				// 获取当前商品项节点下面名叫goods_price的节点值
    				item.goods_price = Double.parseDouble(goods_item.element("goods_price").getText());
    				System.out.println(String.format("第%d个商品:名称=%s,数量=%d,价格=%f", 
    						i+1, item.goods_name, item.goods_number, item.goods_price));
    				order.goods_list.add(item); // 往商品清单中添加指定商品对象
    			}
    		} catch (Exception e) {
    			e.printStackTrace();
    		}
    		return order; // 返回解析后的购物订单对象
    	}
    

    运行以上的解析代码,观察到以下的购物订单日志,可见成功实现了xml串到对象的解析操作:

    用户信息如下:姓名=思无邪,地址=桃花岛水帘洞123号,手机号=15960238696
    第1个商品:名称=Mate30,数量=1,价格=8888.000000
    第2个商品:名称=格力中央空调,数量=1,价格=58000.000000
    第3个商品:名称=红蜻蜓皮鞋,数量=3,价格=999.000000
    

    除了解析各节点的节点值,Dom4j还能解析各节点的属性值,若想正常解析指定名称的属性值,则需明确下列三个要素:该属性的上级节点对象、该属性所在节点的节点名称,该属性的属性名称。有了这三个要素,即可通过以下方法从指定节点的指定属性成功获取属性值:

    	// 打印指定节点名称的指定属性值
    	private static void printValueAndAttr(Element parent, String node_name, String attr_name) {
    		// 获取父节点下面指定名称的子节点
    		Element element = parent.element(node_name);
    		// 获得子节点的节点值
    		String node_value = element.getText();
    		String attr_value = "";
    		// 根据属性名称获取子节点的对应属性对象
    		Attribute attr = element.attribute(attr_name);
    		if (attr != null) {
    			attr_value = attr.getText(); // 获取该属性的属性值
    		}
    		// 打印子节点的详细信息,包括节点名称、节点值、属性名称、属性值
    		System.out.println(String.format("节点名称=%s, 节点值=%s, 属性名称=%s, 属性值=%s", 
    				node_name, node_value, attr_name, attr_value));
    	}
    

    接下来在原先的XML解析代码里补充如下的一行属性解析代码:

    			// 打印user_info节点的name子节点的type属性值
    			printValueAndAttr(user_info, "name", "type");
    

    再次运行XML解析代码,在输出的购物订单日志中观察到多了下面这行日志,表示解析到了name节点的type属性值:

    节点名称=name, 节点值=思无邪, 属性名称=type, 属性值=string
    

      


    更多Java技术文章参见《Java开发笔记(序)章节目录

  • 相关阅读:
    Android 获取Bitmap方式
    o.a.catalina.core.AprLifecycleListener : An incompatible version [1.2.7] of the APR based Apache Tomcat Native library is installed, while Tomcat requires version [1.2.14]
    idea 全部报错找不到包
    idea Plugin "Maven Integration Extension" was not loaded: required plugin "Maven Integration" is disabled
    okhttp 通过网关请求服务端返回数据
    mongo 过滤查询条件后分组、排序
    OKhttp3
    linux安装consul集群
    spring cloud 订单调用用户
    WebSphere概要文件管理工具
  • 原文地址:https://www.cnblogs.com/pinlantu/p/11000515.html
Copyright © 2020-2023  润新知