核心技术Ⅱ：XML - 版本历史

2022年8月21日 (日) 23:52 Eijux

2022-08-21T23:52:31Z

←上一版本		2022年8月22日 (一) 07:52的版本
第1,082行：		第1,082行：
	把DOM 树写出到输出流中并非一件易事：		把DOM 树写出到输出流中并非一件易事：
	===== XSLT =====		===== XSLT =====
	最容易的方式是：“可扩展的样式表语言转换”（Extensible Stylesheet Language Transformations, '''XSLT'''~~）API。【更多信息参见~~[[~~http://wiki.eijux.com/%E6%A0%B8%E5%BF%83%E6%8A%80%E6%9C%AF%E2%85%A1%EF%BC%9AXML~~#~~XSL_.E8.BD.AC.E6.8D.A2 “XSL转换”一节~~]]】		最容易的方式是：“可扩展的样式表语言转换”（Extensible Stylesheet Language Transformations, '''XSLT'''）API。【更多信息参见：[[#XSL_转换]]】
	:<syntaxhighlight lang="java">		:<syntaxhighlight lang="java">
	// construct the do-nothing transformation		// construct the do-nothing transformation

Eijux：/* XSL 转换 */

2020-11-28T01:54:12Z

XSL 转换

←上一版本		2020年11月28日 (六) 09:54的版本
第1,265行：		第1,265行：

	== XSL 转换 ==		== XSL 转换 ==
			'''XSL''' 转换( XSLT ) 机制可以指定将XML 文档转换为其他格式的规则，通常用于：
			# 将某种机器可读的XML 格式转译为另一种机器可读的XML 格式
			# 将XML 转译为适千人类阅读的表示格式
			* 使用XSL需要提供“'''XSLT样式表'''”，它描述了XML 文档向某种其他格式转换的规则。

			XSLT 处理器将读入XML文档和XSLT样式表，产生所要的输出：
			:[[File:应用XSL 转换.png\|500px]]
			XSLT处理器以检查根元素开始其处理过程：
			# 每当一个节点匹配某个模板时，就会应用该模板（如果匹配多个模板，就会使用最佳匹配的那个）。如果没有匹配的模板，处理器会执行默认操作。
			# 对于文本节点，默认操作是把它的内容囊括到输出中去。对于元素，默认操作是不产生任何输出，但会继续处理其子节点。

			=== 使用 ===
			在Java平台下产生XML的转换极其简单，只需为每个样式表设置一个转换器工厂，然后得到一个转换器对象，并告诉它把一个源转换成结果：
			<syntaxhighlight lang="java">
			File styleSheet = new File(filename);
			StreamSource styleSource = new StreamSource(styleSheet);
			Transformer t = TransformerFactory.newInstance().newTransformer(styleSource);
			t.transform(source，result);
			</syntaxhighlight>
			“transform”方法的参数是“Source”和“Result”接口的实现类的对象。
			# “'''Source'''”接口有4个实现类：
			## DOMSource
			## SAXSource
			## StAXSource
			## StreamSource
			#* 可以从一个文件、流、阅读器或URL中构建StreamSource对象，或者从DOM树节点中构建DOMSource对象。
			#* 将非XML的遗留数据转换成XML：
			#*: <syntaxhighlight lang="java">
			t.transform(new SAXSource(newEmployeeReader(), new InputSource(new FilelnputStream(filename))), result);
			</syntaxhighlight>
			#* 大多数XSLT应用程序都已经有了XML格式的输入数据，只需要在一个StreamSource对象上调用transform方法即可：
			#*: <syntaxhighlight lang="java">
			t.transform(newStrearnSource(file), result);
			</syntaxhighlight>
			# “'''Result'''”接口有3个实现类：
			## DOMResult
			## SAXResult
			## StreamResult
			#* 转换结果存储：
			#*# 存储到DOM树中：
			#*#: 使用“DocumentBuilder”产生一个新的文档节点，并将其包装到“DOMResult”中；
			#*#: <syntaxhighlight lang="java">
			Document doc= builder.newDocument();
			t.transform(source, new DOMResult(doc));
			</syntaxhighlight>
			#*# 保存到文件中：
			#*#: 使用“StreamResult”；
			#*#: <syntaxhighlight lang="java">
			t.transform(source, new StreamResult(file));
			</syntaxhighlight>

			=== 相关方法 ===
			javax.xml.transform.TransfonnerFactory 1.4
			* Transformer newTransformer(Source styleSheet)
			*: 返回一个transformer类的实例，用来从指定的源中读取样式表。
			javax.xml.transform.stream.StreamSource 1.4
			* StreamSource(File f)
			* StreamSource(InputStream in)
			* StreamSource(Reader in)
			* StreamSource(String system ID)
			*: 自一个文件、流、阅读器或系统ID（通常是相对或绝对URL）构建一个数据流源。
			javax.xml.transform.sax.SAXSource 1.4
			* SAXSource (XMLReaderreader, InputSource source)
			*: 构建一个SAX数据源，以便从给定输入源中获取数据，并使用给定的阅读器来解析输入数据。
			org.xml.sax.XMLReader 1.4
			* void setContentHandler(ContentHandler handler)
			*: 设置在输入被解析时会被告知解析事件的处理器。
			* void parse(InputSource DOMResult)
			*: 解析来自给定输入源的输入数据，并将解析事件发送到内容处理器。
			javax.xml.transform.dom.SAXSource 1.4
			* DOMResult(Node n) 自给定节点构建一个数据源。通常，n是一个新文档节点。
			org.xml.sax.helpers.AttributesImpl 1.4
			* void addAttribute(String uri, String lname, String qname, String type, String value)
			*: 将一个属性添加到该属性集合。
			*: 参数：uri 名字空间的URI回
			*: 1name 元前缀的本地名
			*: qname 带前缀的限定名
			*: type 类型，“CDATA”、“ID”、“IDREF”、“IDREFS”、“NMTOKEN”、“NMTOKENS”、“ENTITY”、“ENTITIES”或“NOTATION”之一
			*: value 属性值
			* void clear()
			*: 删除属性集合中的所有属性。

Eijux：/* 使用StAX 写出XML文档 */

2020-11-28T00:59:57Z

使用StAX 写出XML文档

@@ 第1,171行： / 第1,171行： @@
 === 使用StAX 写出XML文档 ===
+* 与使用DOM/XSLT 的方式一样，不必担心属性值和字符数据中的转义字符。
+* 仍旧有可能会产生非良构的XML（例如具有多个根节点的文档）。
+* StAX 没有任何对产生缩进输出的支持。
 ==== 相关方法 ====
+javax.xml.stream.XMLOutputFactory 6
+* static XMLOutputFactory newlnstance()
+*: 返回XMLOutputFactory 类的一个实例。
+* XMLStreamWri ter createXMLStreamWri ter(OutputStream in)
+* XMLStreamWri ter createXMLStreamWri ter(Output Stream in , String characterEncoding)
+* XMLStreamWri ter createXMLStreamWri ter(Writer in)
+* XMLStreamWriter createXMLStreamWriter(Result in)
+*: 创建写出到给定流、写出器或JAXP 结果的写出器。
+javax.xml.stream.XMLStreamWriter 6
 === 示例 ===

Eijux：/* 生成XML文档 */

2020-11-28T00:36:20Z

生成XML文档

显示更改

Eijux：/* 流机制解析器 */

2020-11-27T23:18:11Z

流机制解析器

显示更改

Eijux：/* 使用命名空间 */

2020-11-27T22:23:34Z

使用命名空间

←上一版本		2020年11月28日 (六) 06:23的版本
第430行：		第430行：

	=== 使用命名空间 ===		=== 使用命名空间 ===
			==== 关于 ====
			命名空间(namespace) 机制，用于元素名和属性名，可以避免名字冲突：
			# 名字空间是由统一资源标识符(Uniform Resource Identifier, URI ) 来标识的：
			#: <syntaxhighlight lang="xml">
			http://www.w3.org/2001/XMLSchema
			uuid:lc759aed-b748-47Sc-ab68-10679700c4f2
			urn:com:books-r-us
			</syntaxhighlight>
			# HTTP 的URL 格式是最常见的标识符。

			* URL 只用作标识符字符串，而不是一个文件的定位符。
			*: 如下，表示了不同的Namespace，但在Web服务器中对应于同一个文档：
			*: <syntaxhighlight lang="xml">
			http://www.horstmann.com/corejava
			http://www.horstmann.com/corejava/index.html
			</syntaxhighlight>
			* 在命名空间的URL 所表示的位性上不需要有任何文档，XML 解析器不会尝试去该处查找任何东西。


			Namespace机制：（xml中用“'''xmlns'''”标识Namespace）
			# 嵌套的Namespace：
			#: <syntaxhighlight lang="xml">
			<element xmlns="namespaceURil">
			<child xmlns="namespaceURI2">
			grandchildren
			</child>
			more children
			</element>

			第一个子元素和孙元索都是第二个命名空间的一部分
			</syntaxhighlight>
			# 前缀表示Namespace：
			#: <syntaxhighlight lang="xml">
			<xsd:schema xm1ns:xsd="http://www.w3.org/2001/XMLSchema">
			<xsd:element name="gridbag" type="GridBagType"/>
			...
			</xsd:schema>

			前缀“xsd”标识“http://www.w3.org/2001/XMLSchema”中的元素，如“xsd:schema”
			</syntaxhighlight>
			* 有子元素继承了它们父元素的命名空间，而不带显式前缀的属性并不是命名空间的一部分：
			*: <syntaxhighlight lang="xml">
			<configuration xmlns="http://www.horstmann.com/corejava"
			xmlns:si="http://www.bipm.fr/enus/3_SI/si.html">
			<size value="210" si:unit="mm"/>
			...
			</configuration>

			1、元素“configuration”和“size”是URI 为“http://www.horstmann.com/corejava”的命名空间的一部分；
			2、属性“si:unit”是URI 为“http://www.bipm.fr/enus/3_ SI/si.html”的命名空间的一部分。
			3、属性“value”不是任何命名空间的一部分
			</syntaxhighlight>

			==== 使用 ====
			* 默认悄况下，Java XML 库的DOM 解析器并非“命名空间感知的”。
			调用“DocumentBuilderFactory”类的“setNamespaceAware”方法，打开命名空间处理特性：
			<syntaxhighlight lang="java">
			factory.setNamespaceAware(true);
			</syntaxhighlight>

			这样，该工厂产生的所有生成器便都支持命名空间了。每个节点有三个属性：
			# 带有前缀的'''限定名'''（qualified），由“'''getNodeName'''”和“'''getTagName'''”等方法返回。
			# 命名空间'''URI'''，由“'''getNamespaceURI'''”方法返回。
			# 不带前缀和命名空间的'''本地名'''（localname），由“'''getlocalName'''”方法返回。
			* 如果对命名空间的感知特性被关闭，“getLocalName”和“getNamespaceURI”方法将返回“null”；

			如：
			<syntaxhighlight lang="xml">
			<xsd:schema xmlns:xsd="http://www.w3.org/2001/XMLSchema">
			</syntaxhighlight>
			会报告如下信息：
			# 限定名 = “xsd:schema”；
			# 命名空间URI = “http://www.w3.org/2001/XMLSchema”；
			# 本地名 = “schema”；

			==== 相关方法 ====
			org.w3c.dom.Node 1.4
			* String getLocalName()
			*: 返回本地名（不带前缀），或者在解析器不感知命名空间时，返回null 。
			* String getNamespaceURI()
			*: 返回命名空间URI, 或者在解析器不感知命名空间时，返回null 。
			javax.xml.parsers.DocumentBuilderFactory 1.4
			* boolean isNamespaceAware( )
			* void setNamespaceAware(boolean value)
			*: 获取或设置工厂的namespaceAware 属性。当设为true 时，工厂产生的解析器是命名空间感知的。

	== 验证XML文档 ==		== 验证XML文档 ==

Eijux：/* 使用XPath */

2020-11-27T21:51:18Z

使用XPath

←上一版本		2020年11月28日 (六) 05:51的版本
第394行：		第394行：
	# 然后，调用“evaluate”方法来计算XPath 表达式：		# 然后，调用“evaluate”方法来计算XPath 表达式：
	#*（可以用同一个XPath 对象来计算多个表达式）		#*（可以用同一个XPath 对象来计算多个表达式）
	## ~~如果返回一个字符串，不用指定“XPathConstants”：~~		## 如果返回一个字符串，不用指定“resultType”（“XPathConstants”常量）：
	##: <syntaxhighlight lang="java">		##: <syntaxhighlight lang="java">
	String username = path.evaluate("/configuration/database/username", doc);		String username = path.evaluate("/configuration/database/username", doc);
第415行：		第415行：
	result = path.evaluate(expression, node);		result = path.evaluate(expression, node);
	</syntaxhighlight>		</syntaxhighlight>

			==== 相关方法 ====
			javax.xml.xpath.XPathFactory 5.0
			* static XPathFactory newinstance()
			*: 返同用千创建XPath 对象的XPathFactory 实例。
			* XPath newXpath()
			*: 构建用于计算XPath 表达式的XPath 对象。
			javax.xml.xpath.XPath 5.0
			* String evaluate(String expression, Object startingPoint)
			*: 从给定的起点计算表达式。起点可以是一个节点或节点列表。如果结果是一个节点或节点集，则返回的字符串由所有文本节点子元素的数据构成。
			* Object eva1uate(String expression , Object startingPoint, QName resultType)
			*: 从给定的起点计算表达式。起点可以是一个节点或节点列表。resultType 是XPathConstants 类的常量STRING 、NODE 、NODESET 、NUMBER 或BOOLEAN 之一。
			*: 返回值是String 、Node 、Nodelist 、Number 或Boolean 。

	=== 使用命名空间 ===		=== 使用命名空间 ===

Eijux：/* XML Schema */

2020-11-27T21:47:59Z

XML Schema

←上一版本		2020年11月28日 (六) 05:47的版本
第570行：		第570行：

	=== XML Schema ===		=== XML Schema ===
			==== XML Schema规则 ====
	:【XML Schema比DTD复杂得多，需要另外了解】		:【XML Schema比DTD复杂得多，需要另外了解】
	* 前缀“xsd:”（或“xs:”）来表示XSLSchema 定义的命名空间。		* 前缀“xsd:”（或“xs:”）来表示XSLSchema 定义的命名空间。
第673行：		第674行：
	</syntaxhighlight>		</syntaxhighlight>

			==== 使用XML Schema ====
	解析带有Schema 的XML 文件和解析带有DTD 的文件相似，但有3 点差别：		解析带有Schema 的XML 文件和解析带有DTD 的文件相似，但有3 点差别：
	# 必须打开对命名空间的支待：		# 必须打开对命名空间的支待：
	#:（即使在XML 文件里你可能不会用到它）		#:（即使在XML 文件里你可能不会用到它）
	#: <syntaxhighlight lang="~~xml~~">		#: <syntaxhighlight lang="java">
	factory.setNamespaceAware(true);		factory.setNamespaceAware(true);
	</syntaxhighlight>		</syntaxhighlight>
	# 必须通过如下的“魔咒”来准备好处理Schema 的工厂：		# 必须通过如下的“魔咒”来准备好处理Schema 的工厂：
	#: <syntaxhighlight lang="~~xml~~">		#: <syntaxhighlight lang="java">
	final String JAXP_SCHEMA_LANGUAGE = "http://java.sun.com/xml/jaxp/properties/schemaLanguage";		final String JAXP_SCHEMA_LANGUAGE = "http://java.sun.com/xml/jaxp/properties/schemaLanguage";
	final String W3C_XML_SCHEMA = "http://www.w3.org/2001/XMLSchema";		final String W3C_XML_SCHEMA = "http://www.w3.org/2001/XMLSchema";

Eijux：/* “XPath”定位信息 */

2020-11-27T21:46:00Z

“XPath”定位信息

←上一版本		2020年11月28日 (六) 05:46的版本
第345行：		第345行：


	=== ~~“XPath”定位信息~~ ===		=== 使用“XPath” ===
	XPath 语言使得访问树节点变得很容易，而不必遍历DOM树。<br/>		XPath 语言使得访问树节点变得很容易，而不必遍历DOM树。<br/>

Eijux：/* 使用命名空间 */

2020-11-27T21:45:19Z

使用命名空间

←上一版本		2020年11月28日 (六) 05:45的版本
第344行：		第344行：
	==== 使用“StAX”解析器 ====		==== 使用“StAX”解析器 ====


			=== “XPath”定位信息 ===
			XPath 语言使得访问树节点变得很容易，而不必遍历DOM树。<br/>

			如，对于以下XML文档：
			<syntaxhighlight lang="xml">
			<configuration>
			...
			<database>
			<username>dbuser</username>
			<password>secret</password>
			...
			</database>
			</configuration>
			</syntaxhighlight>
			可以通过对XPath 表达式“/configuration/database/username”求值，来得到database中的username的值。

			==== XPath表达式 ====
			# XPath 可以描述XML 文档中的个节点集：
			#: <syntaxhighlight lang="xml">
			/gridbag/row
			描述了根元素gridbag 的子元素中所有的row 元素
			</syntaxhighlight>
			# 可以用“[]”操作符来选择特定元素：
			#: <syntaxhighlight lang="xml">
			/gridbag/row[l]
			表示的是第一行（索引号从1 开始）
			</syntaxhighlight>
			# 使用“@”操作符可以得到属性值：
			#: <syntaxhighlight lang="xml">
			/gridbag/row(1)/ce11[1]/@anchor
			描述了作为根元索gridbag 的子元素的那些row 元素中的所有单元格的anchor 属性节点
			</syntaxhighlight>
			# XPath 有很多有用的函数：
			#* 参见[http://www.w3c.org/TR/xpath http://www.w3c.org/TR/xpath]的规范；
			#* 或者[http://www.zvon.org/xxl/XPatbTutorial/General/exampleshtml http://www.zvon.org/xxl/XPatbTutorial/General/exampleshtml]上的在线指南；
			#: <syntaxhighlight lang="xml">
			count(/gridbag/row)
			返回gridbag 根元素的row 子元素的数量
			</syntaxhighlight>

			==== 使用XPath ====
			Java SE 5.0 增加了一个API 来计算XPath 表达式：
			# 首先需要从“XPathFactory”创建一个“XPath”对象：
			#: <syntaxhighlight lang="java">
			XPathFactory xpfactory = XPathFactory.newlnstance();
			path = xpfactory.newXPath();
			</syntaxhighlight>
			# 然后，调用“evaluate”方法来计算XPath 表达式：
			#*（可以用同一个XPath 对象来计算多个表达式）
			## 如果返回一个字符串，不用指定“XPathConstants”：
			##: <syntaxhighlight lang="java">
			String username = path.evaluate("/configuration/database/username", doc);
			</syntaxhighlight>
			## 如果结果是一组节点，则使用“XPathConstants.NODESIT”：
			##: <syntaxhighlight lang="java">
			NodeList nodes = (NodeList) path.evaluate("/gridbag/row", doc, XPathConstants.NODESIT);
			</syntaxhighlight>
			## 如果结果只有一个节点，则以“XPathConstants.NODE”代替：
			##: <syntaxhighlight lang="java">
			Node node = (Node) path.evaluate("/gridbag/row[l)", doc, XPathConstants.NODE);
			</syntaxhighlight>
			## 如果结果是一个数字，则使用“XPathConstants.NUMBER”：
			##: <syntaxhighlight lang="java">
			int count = ((Number) path.eva1uate("count(/gridbag/row)", doc, XPathConstants.NUMBER)).intVa1ue();
			</syntaxhighlight>
			#* 不必从文档的根节点开始搜索，可以从任意一个节点或节点列表开始。
			#*: 如果有前一次计算得到的节点，那么就可以调用：
			#*: <syntaxhighlight lang="java">
			result = path.evaluate(expression, node);
			</syntaxhighlight>

	=== 使用命名空间 ===		=== 使用命名空间 ===

核心技术Ⅱ：XML - 版本历史

2022年8月21日 (日) 23:52 Eijux

Eijux：​/* XSL 转换 */

Eijux：​/* 使用StAX 写出XML文档 */

Eijux：​/* 生成XML文档 */

Eijux：​/* 流机制解析器 */

Eijux：​/* 使用命名空间 */

Eijux：​/* 使用XPath */

Eijux：​/* XML Schema */

Eijux：​/* “XPath”定位信息 */

Eijux：​/* 使用命名空间 */

Eijux：/* XSL 转换 */

Eijux：/* 使用StAX 写出XML文档 */

Eijux：/* 生成XML文档 */

Eijux：/* 流机制解析器 */

Eijux：/* 使用命名空间 */

Eijux：/* 使用XPath */

Eijux：/* XML Schema */

Eijux：/* “XPath”定位信息 */

Eijux：/* 使用命名空间 */