Class Reference
IRIS for UNIX 2019.2
InterSystems: The power behind what matters   
Documentation  Search
  [ENSLIB] >  [%XML] >  [XSLT2] >  [Transformer]
Private  Storage   

class %XML.XSLT2.Transformer extends %RegisteredObject

Implements an interface to the XSLT 2.0 Parser. XML contained in a file or binary stream may be transformed

Inventory

Parameters Properties Methods Queries Indices ForeignKeys Triggers
18


Summary

Methods
%AddToSaveSet %ClassIsLatestVersion %ClassName
%ConstructClone %DispatchClassMethod %DispatchGetModified
%DispatchGetProperty %DispatchMethod %DispatchSetModified
%DispatchSetMultidimProperty %DispatchSetProperty %Extends
%GetParameter %IsA %IsModified
%New %NormalizeObject %ObjectModified
%OriginalNamespace %PackageName %RemoveFromSaveSet
%SerializeObject %SetModified %ValidateObject
AddToEvaluateCacheFilterList ClearEvaluateCache ClearEvaluateCacheFilterList
DumpEvaluateCacheToList LoadEvaluateCacheFromList RemoveFromEvaluateCacheFilterList
SetCacheEverythingBoolean SetEvaluateCacheSize SetupErrorHandler
SetupOutput StartGateway StopGateway
TransformFile TransformFileWithCompiledXSL TransformStream
TransformStreamWithCompiledXSL TransformStringWithCompiledXSL


Methods

• classmethod AddToEvaluateCacheFilterList(filterListEntry As %String = "", pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method adds a function name to the evaluate cache filter list. Note that this does not limit the cache size in any way. There may be any number of calls to the same function, but with different arguments and return values. Each combination of function name + arguments would be a separate entry in the cache. If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler.
• classmethod ClearEvaluateCache(pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method clears the evaluate cache. If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler.
• classmethod ClearEvaluateCacheFilterList(pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method clears the evaluate cache filter list. If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler.
• classmethod DumpEvaluateCacheToList(Output evaluateCache As %List, pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method dumps the evaluate cache to a list, with the following format: total number of cache entries for each entry: total number of evaluate arguments = function name + up to 9 arguments all evaluate arguments evaluate value If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler.
• classmethod LoadEvaluateCacheFromList(evaluateCache As %List = "", pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method loads (or pre-populates) the evaluate cache from a list, with the following format: total number of cache entries for each entry: total number of evaluate arguments = function name + up to 9 arguments all evaluate arguments evaluate value If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler.
• classmethod RemoveFromEvaluateCacheFilterList(filterListEntry As %String = "", pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method removes a function name from the evaluate cache filter list. If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler.
• classmethod SetCacheEverythingBoolean(cacheEverything As %Boolean = 0, pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method sets the cache everything boolean for the evaluate cache. This overrides the filter list and allows calls to all functions to be cached. If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler.
• classmethod SetEvaluateCacheSize(size As %Integer = 1000, pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method sets the maximum size of the evaluate cache. The default size is 1000. If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler.
• classmethod SetupErrorHandler(ByRef errorHandler As %XML.XSLT.ErrorHandler) as %Status
• classmethod SetupOutput(ByRef output As %BinaryStream, Output translateTable As %ObjectHandle) as %Status
• classmethod StartGateway(Output gateway As %Net.Remote.Gateway = $$$NULLOREF, useSharedMemoryIfPossible As %Boolean = 0) as %Status
This method starts a gateway if there's not already one started, connects to it, and returns the gateway by reference. This method does not change the current device.
• classmethod StopGateway(gateway As %Net.Remote.Gateway) as %Status
This method disconnects from the gateway. It does not stop the gateway.
• classmethod TransformFile(pSource As %String, pXSL As %String, pOutput As %String, pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, ByRef pParams=$$$NULLOREF, pCallbackHandler=$$$NULLOREF, pResolver As %XML.SAX.EntityResolver = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method transforms a source file according to an XSL stylesheet and writes the output to the specified output file. If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler. The pParams argument is either a CoS array, or %ArrayOfDataTypes of name/value pairs to be passed as $ variables.
• classmethod TransformFileWithCompiledXSL(pSource As %String, pXSL As %XML.XSLT2.CompiledStyleSheet, pOutput As %String, pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, ByRef pParams=$$$NULLOREF, pCallbackHandler=$$$NULLOREF, pResolver As %XML.SAX.EntityResolver = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method transforms a source file according to an XSL stylesheet and writes the output to the specified output file. If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler. The pParams argument is either a CoS array, or %ArrayOfDataTypes of name/value pairs to be passed as $ variables.
• classmethod TransformStream(pSource As %Stream.Object, pXSL As %Stream.Object, ByRef pOutput As %BinaryStream = $$$NULLOREF, pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, ByRef pParams=$$$NULLOREF, pCallbackHandler=$$$NULLOREF, pResolver As %XML.SAX.EntityResolver = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method transforms a source stream according to an XSL stylesheet and writes the output to the supplied binary stream. If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler. The pParams argument is either a CoS array, or %ArrayOfDataTypes of name/value pairs to be passed as $ variables. Note that that the XSLT transform engine will produce a stream with line terminator $c(10), regardless of the line terminator of the input stream. If an existing output stream is passed to this method, its LineTerminator property will be set to $c(10), so anything written to the stream before calling this method should also use $c(10) as its line terminator.
• classmethod TransformStreamWithCompiledXSL(pSource As %Stream.Object, pXSL As %XML.XSLT2.CompiledStyleSheet, ByRef pOutput As %BinaryStream = $$$NULLOREF, pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, ByRef pParams=$$$NULLOREF, pCallbackHandler=$$$NULLOREF, pResolver As %XML.SAX.EntityResolver = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method transforms a source stream according to an XSL stylesheet and writes the output to the supplied binary stream. If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler. The pParams argument is either a CoS array, or %ArrayOfDataTyoes of name/value pairs to be passed as $ variables. Note that that the XSLT transform engine will produce a stream with line terminator $c(10), regardless of the line terminator of the input stream. If an existing output stream is passed to this method, its LineTerminator property will be set to $c(10), so anything written to the stream before calling this method should also use $c(10) as its line terminator.
• classmethod TransformStringWithCompiledXSL(pSource As %String, pXSL As %XML.XSLT2.CompiledStyleSheet, ByRef pOutput As %String = "", pErrorHandler As %XML.XSLT.ErrorHandler = $$$NULLOREF, ByRef pParams=$$$NULLOREF, pCallbackHandler=$$$NULLOREF, pResolver As %XML.SAX.EntityResolver = $$$NULLOREF, gateway As %Net.Remote.Gateway = $$$NULLOREF) as %Status
This method transforms a source string according to an XSL stylesheet and returns the output to the supplied string. If errors occur during processing, callbacks will be made to the supplied error handler. If an error handler is not supplied then the default is to use a newly created instance of %XML.XSLT.ErrorHandler. The pParams argument is either a CoS array, or %ArrayOfDataTyoes of name/value pairs to be passed as $ variables.


Copyright (c) 2019 by InterSystems Corporation. Cambridge, Massachusetts, U.S.A. All rights reserved. Confidential property of InterSystems Corporation.