matlab.io.xml.transform.Transformer class

Package: matlab.io.xml.transform

XML document transformer

Description

Use an object of the matlab.io.xml.transform.Transformer class to define an XML document transformer that transforms an XML document into another type of document. For example, use a transformer to transform an XML document into an HTML document.

The matlab.io.xml.transform.Transformer class is a handle class.

Class Attributes

ConstructOnLoad	true
HandleCompatible	true

For information on class attributes, see Class Attributes.

Creation

Description

transformer = Transformer() creates an XML document transformer.

Properties

ExternalSchemaLocation — Path of external schema when namespaces are used

character vector | string scalar

Path of an external schema to use to validate a document to be transformed, specified as a vector or string scalar. This property applies only to source documents that use namespaces to name elements and attributes.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

ExternalNoNSSchemaLocation — Path of external schema when namespaces are not used

character vector | string scalar

Path of an external schema to use to validate a document to be transformed, specified as a vector or string scalar. This property applies only to source documents that do not use namespaces to name elements and attributes.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

UseValidation — Whether to validate input document and stylesheet

false (default) | true

Whether to validate the input document and stylesheet, specified as true or false. If the value is true, the transform method of this transformer validates the input document and stylesheet.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

OutputEncoding — Character encoding of output document

"UTF-8" (default) | "UTF-16"

Character encoding of the output document, specified as "UTF-8" or "UTF-16".

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

EntityResolver — Object that resolves stylesheet entity references

[] (default) | object of subclass of matlab.io.xml.dom.EntityResolver

Object that resolves stylesheet entity references, specified as an object of a subclass of the matlab.io.xml.dom.EntityResolver class.

Attributes:

GetAccess	public
SetAccess	public
NonCopyable	true

Methods

Public Methods

clearStylesheetParams	clearStylesheetParams(thisTransformer) clears stylesheet parameters from this transformer.
compileStylesheet	compiledStylesheet = compileStylesheet(thisTransformer,source) compiles the specified stylesheet source and returns the result as a matlab.io.xml.transform.CompiledStylesheet object. The source argument can be one of these values: Stylesheet file path, specified as a character vector, string scalar, or matlab.io.xml.transform.StylesheetSourceFile object Stylesheet document, specified as a matlab.io.xml.dom.Document or matlab.io.xml.transform.StylesheetSourceDocument object Stylesheet string, specified as a matlab.io.xml.transform.StylesheetSourceString object
setStylesheetParam	setStylesheetParam(thisTransformer,name,value) sets the stylesheet parameter that has the specified name to the specified value. Specify name as a character vector or string scalar and value as a character vector, string scalar, or double. The parameter value applies to all transformations.
transform	Transform XML document. See transform.
transformToString	Transform XML document and store result in a string. See transformToString.

Examples

Transform XML into HTML

This example transforms the XML markup for countries and their capital cities into an HTML table.

The example uses these files:

• capitals.xml

<Countries>
    <Country><Name>Canada</Name><Capital>Ottawa</Capital></Country>
    <Country><Name>France</Name><Capital>Paris</Capital></Country>
    <Country><Name>Peru</Name><Capital>Lima</Capital></Country>
</Countries>

• capitals.xsl

<?xml version="1.0"?>

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

<xsl:template match="/">
  <html>
  <body>
      <table>
      <tr>
        <th>Country</th>
        <th>Capital</th>
      </tr>
      <xsl:for-each select="Countries/Country">
        <tr>
          <td><xsl:value-of select="Name"/></td>
          <td><xsl:value-of select="Capital"/></td>
        </tr>
      </xsl:for-each>
    </table>
  </body>
  </html>
</xsl:template>

</xsl:stylesheet>

Call the transform method to transform the XML markup in capitals.xml using the stylesheet in the file capitals.xsl and store the result in the file capitals.html.

import matlab.io.xml.transform.*
transform(Transformer,"capitals.xml","capitals.xsl","capitals.html");

Open capitals.html in a browser.

web("capitals.html")

Here is the HTML table: