第二十四章执行XSLT转换

原创

学无为 2021-07-05 18:06:07 ©著作权

文章标签 Caché XML iris m xml 文章分类 代码人生

©著作权归作者所有：来自51CTO博客作者学无为的原创作品，请联系作者获取转载授权，否则将追究法律责任

文章目录

第二十四章执行XSLT转换
执行XSLT转换
示例
- 示例1：简单替换
- 示例2：内容提取
- 其他示例

第二十四章执行XSLT转换执行XSLT转换

要执行XSLT转换，请执行以下操作：

如果使用的是Xalan处理器(对于XSLT 1.0)，请使用%XML.XSLT.Transformer的以下类方法之一：
- TransformFile()——转换给定XSLT样式表的文件。
- TransformFileWithCompiledXSL()——转换一个文件，给定一个已编译的XSLT样式表。
- TransformStream()——转换给定XSLT样式表的流。
- TransformStreamWithCompiledXSL()——转换一个流，给定一个已编译的XSLT样式表。
- TransformStringWithCompiledXSL()——转换给定已编译XSLT样式表的字符串。
如果使用Saxon处理器(用于XSLT 2.0)，请使用%XML.XSLT2.Transformer的以下类方法之一:
- TransformFile()——转换给定XSLT样式表的文件。
- TransformFileWithCompiledXSL()——转换一个文件，给定一个已编译的XSLT样式表。
- TransformStream()——转换给定XSLT样式表的流。
- TransformStreamWithCompiledXSL()——转换一个流，给定一个已编译的XSLT样式表。

这些方法具有相似的签名。这些方法的参数列表按顺序如下：

pSource—要转换的源XML。请参见此列表后面的表。
pXSL -样式表或编译样式表。请参阅此列表后面的表格。
pOutput -作为输出参数返回的结果XML。请参阅此列表后面的表格。
pErrorHandler -一个可选的自定义错误处理程序。请参阅本章后面的“自定义错误处理”。如果不指定自定义错误处理程序，该方法将使用%XML.XSLT.ErrorHandler的新实例(对于两个类)。
pParms -一个可选的InterSystems IRIS多维数组，包含要传递给样式表的参数。
pCallbackHandler -定义XSLT扩展函数的可选回调处理程序。
pResolver -一个可选的实体解析器。

(仅适用于%XML.XSLT2.Transformer)网关-%Net.Remote.Gateway的可选实例。如果要重用XSLT网关连接以获得更好的性能，请指定此参数；

作为参考，下表显示了这些方法的前三个参数，并进行了对比：

XSLT变换方法的比较

Method	pSource (Input XML)	pXSL (Stylesheet)	pOutput(Output XML)
TransformFile()	String that gives a file name	String that gives a file name	String that gives a file name
TransformFileWithCompiledXSL()	String that gives a file name	Compiled style sheet	String that gives a file name
TransformStream()	Stream	Stream	Stream, returned by reference
TransformStreamWithCompiledXSL()	Stream	Compiled style sheet	Stream, returned by reference
TransformStringWithCompiledXSL()	String	Compiled style sheet	String that gives a file name

示例

本节使用以下代码(但不同的输入文件)展示了几种转换：

  Set in="c:\0test\xslt-example-input.xml"
  Set xsl="c:\0test\xslt-example-stylesheet.xsl"
  Set out="c:\0test\xslt-example-output.xml"
  Set tSC=##class(%XML.XSLT.Transformer).TransformFile(in,xsl,.out)
  Write tSC

示例1：简单替换

在本例中，我们从以下输入XML开始：

<?xml version="1.0" ?>
<s1 title="s1 title attr">
  <s2 title="s2 title attr">
    <s3 title="s3 title attr">Content</s3>
  </s2>
</s1>

我们使用以下样式表：

<?xml version="1.0"?>

<xsl:stylesheet xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0">

<xsl:output method="xml" indent="yes"/>
 
<xsl:template match="//@* | //node()">
  <xsl:copy>
    <xsl:apply-templates select="@*"/>
    <xsl:apply-templates select="node()"/>
  </xsl:copy>
</xsl:template>

<xsl:template match="/s1/s2/s3">
<xsl:apply-templates select="@*"/>
<xsl:copy>
Content Replaced
</xsl:copy>
</xsl:template>  

</xsl:stylesheet>

在这种情况下，输出文件将如下所示：

<?xml version="1.0" encoding="UTF-8"?>
<s1 title="s1 title attr">
  <s2 title="s2 title attr">
    <s3>
Content Replaced
</s3>
  </s2>
</s1>

示例2：内容提取

在本例中，我们从以下输入XML开始：

<?xml version="1.0" encoding="UTF-8"?>
<MyRoot>
   <MyElement No="13">Some text</MyElement>
   <MyElement No="14">Some more text</MyElement>
</MyRoot>

我们使用以下样式表：

<?xml version="1.0" encoding="UTF-8"?>
<xsl:stylesheet version="1.1"   
                xmlns:xsl="http://www.w3.org/1999/XSL/Transform"
                xmlns:xs="http://www.w3.org/2001/XMLSchema">
<xsl:output method="text"
            media-type="text/plain"/>
<xsl:strip-space elements="*"/>

<!-- utilities not associated with specific tags -->
<!-- emit a newline -->
<xsl:template name="NL">
    <xsl:text>&#xa;</xsl:text>
</xsl:template>

<!-- beginning of processing -->

<xsl:template match="/">
    <xsl:apply-templates/>
</xsl:template>

<xsl:template match="MyElement">
    <xsl:value-of select="@No"/>
    <xsl:text>: </xsl:text>
    <xsl:value-of select="."/>
    <xsl:call-template name="NL"/>
</xsl:template>

</xsl:stylesheet>

在这种情况下，输出文件将如下所示：