第二十五章添加和使用XSLT扩展函数

原创

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

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

文章目录

第二十五章添加和使用XSLT扩展函数
自定义错误处理
指定样式表使用的参数
添加和使用XSLT扩展函数
- 实现evaluate()方法
- 在样式表中使用计算
- 使用ISC：计算缓存
使用XSL转换向导

第二十五章添加和使用XSLT扩展函数自定义错误处理

当出现错误时，XSLT处理器(Xalan或Saxon)执行当前错误处理程序的error()方法，将消息作为参数发送到该方法。类似地，当发生致命错误或警告时，XSLT处理器会根据需要执行datalError()或Warning()方法。

对于所有这三种方法，默认行为是将消息写入当前设备。

要自定义错误处理，请执行以下操作：

对于Xalan或Saxon处理器，在创建%XML.XSLT.ErrorHandler的子类。在这个子类中，根据需要实现Error()、FatealError()和Warning()方法。

这些方法中的每一个都接受单个参数，即包含由XSLT处理器发送的消息的字符串。

这些方法不返回值。

要在编译样式表时使用此错误处理程序，请创建子类的实例，并在编译样式表时在参数列表中使用它。
若要在执行XSLT转换时使用此错误处理程序，请创建子类的实例，并在使用的Transform方法的参数列表中使用它。

指定样式表使用的参数

要指定样式表使用的参数，请执行以下操作：

创建%ArrayOfDataTypes的实例在。
调用此实例的SetAt()方法将参数及其值添加到此实例。对于SetAt()，将第一个参数指定为参数值，将第二个参数指定为参数名称。

根据需要添加任意多个参数。

    Set tParameters=##class(%ArrayOfDataTypes).%New()
    Set tSC=tParameters.SetAt(1,"myparameter")
    Set tSC=tParameters.SetAt(2,"anotherparameter")

将此实例用作Transform方法的pParms参数。

可以不使用%ArrayOfDataType，而是使用 IRIS多维数组，该数组可以具有任意数量的具有以下结构和值的节点：

Node	Value
arrayname(“parameter_name”)	Value of the parameter named by parameter_name

添加和使用XSLT扩展函数

可以在InterSystems IRIS中创建XSLT扩展函数，然后在样式表中使用它们，如下所示：

对于XSLT2.0(Saxon处理器)，可以使用名称空间com.intersystems.xsltgateway.XSLTGateway中的evaluate函数或名称空间http://extension-functions.intersystems.com中的evaluate函数
对于XSLT1.0(Xalan处理器)，只能在名称空间http://extension-functions.intersystems.com中使用evaluate函数

默认情况下(举个例子)，后一个函数反转它接收到的字符。但是，通常不使用默认行为，因为实现了一些其他行为。要模拟多个单独的函数，需要传递一个选择器作为第一个参数，并实现一个开关，该开关使用该值选择要执行的处理。

在内部，evaluate函数作为XSLT回调处理程序中的方法(evaluate())实现。

要添加和使用XSLT扩展函数，请执行以下操作：

对于Xalan或Saxon处理器，在创建%XML.XSLT.CallbackHandler的子类。在这个子类中，根据需要实现evaluate()方法。请参阅下一小节。
在样式表中，声明evaluate函数所属的命名空间，并根据需要使用evaluate函数。请参阅下一小节。
执行XSLT转换时，创建子类的实例，并在使用的Transform方法的参数列表中使用它。请参阅“执行XSLT转换”。

实现evaluate()方法

在内部，调用XSLT处理器的代码可以将任意数量的位置参数传递给当前回调处理程序的evaluate()方法，该方法将它们作为具有以下结构的数组接收：

Node	Value
Args	参数数量
Args(index)	位置索引中参数的值

该方法只有一个返回值。返回值可以是：

标量变量(如字符串或数字)。
流对象。这允许返回超过字符串长度限制的超长字符串。流必须包装在新窗口中的%XML.XSLT.StreamAdapter实例中，使XSLT处理器能够读取流。以下是部分示例：

Method evaluate(Args...) As %String
{
 //create stream
 ///...

 // create instance of %XML.XSLT.StreamAdapter to
 // contain the stream
 Set return=##class(%XML.XSLT.StreamAdapter).%New(tStream)

 Quit return

}

在样式表中使用计算

要在XSLT中使用XSLT扩展函数，必须在XSLT样式表中声明扩展函数的名称空间。对于InterSystems evaluate函数，此命名空间是http://extension-functions.intersystems.com或com.intersystems.xsltgateway.XSLTGateway，如前所述。

下面的示例显示使用evaluate的样式表：

<?xml version="1.0"?>

<xsl:stylesheet 
xmlns:xsl="http://www.w3.org/1999/XSL/Transform" version="1.0" 
xmlns:isc="http://extension-functions.intersystems.com">

  <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:choose>
  <xsl:when test="function-available('isc:evaluate')">
  <xsl:copy>
  <xsl:value-of select="isc:evaluate(.)" disable-output-escaping="yes"/>
  </xsl:copy>
  </xsl:when>
  <xsl:otherwise>
  <xsl:value-of select="."/>
  </xsl:otherwise>
  </xsl:choose>
  </xsl:template> 

</xsl:stylesheet>