The javax.xml.transform.Transformer Class

Super Class : java.lang.Object.

Members

Overview

This core abstract class provides XML transformation facility through TrAX and JAXP. This instance may then be used to process XML from a variety of sources and write the transformation output to a variety of sinks.

An object of this class may not be used in multiple threads running concurrently. Different Transformers may be used concurrently by different threads.

A Transformer may be used multiple times. Parameters and output properties are preserved across transformations.

Method Overviews

Important methods of this class are transform() and  setParameter()

Example of transform (source,result)

transform (source,result) method is used to process the source tree to the output result.

/**

   * Method to create a result file from source file. It copies content of source file into

   * result file. This method used java.io.File for transformation.

   */

  public void simpleTransform()

  {

      initializeTransformerFactory();

    try{

    File sourceFile = new File(sourcefileURI);

    File resultFile = new File(resultfileURI);

    StreamResult result = new StreamResult(resultFile);

    StreamSource source = new StreamSource(sourceFile);

    transformer = tFactory.newTransformer();

    transformer.transform(source,result);

    }catch(TransformerException te)

    {

      te.printStackTrace();

    }

  }

Example of setParameter(String name, Object value)

setParameter(String name, Object value) is used to add a parameter for the transformation.

Pass a qualified name as a two-part string, the namespace URI enclosed in curly braces ({}), followed by the local name. If the name has a null URL, the String only contain the local name. An application can safely check for a non-null URI by testing to see if the first character of the name is a '{' character.

For example, if a URI and local name were obtained from an element defined with <xyz:foo xmlns:xyz="http://xyz.foo.com/yada/baz.html"/>, then the qualified name would be "{http://xyz.foo.com/yada/baz.html}foo". Note that no prefix is used.

/**

   * This method uses stylesheel to create a Transformer. Applies the stylesheet to the input

   * xml source and creates result html.

   */

  public void transformUsingStylesheet()

  {

    try{

    File sourceFile = new File(sourceFileURI);

    File resultFile = new File(resultFileURI);

    StreamResult result = new StreamResult(resultFile);

    StreamSource source = new StreamSource(sourceFile);

    Templates template = tFactory.newTemplates(new StreamSource(stylesheetURI));

    transformer = template.newTransformer();

    transformer.setParameter("heading","This is A Parameter Heading");

    transformer.transform(source,result);

    }catch(TransformerConfigurationException tce)

    {

      tce.printStackTrace();

    }catch(TransformerException te)

    {

      te.printStackTrace();

    }

  }