transformXML (EmbeddedObject - Java™)

Transforms the contents of an attachment using the specified Domino® EmbeddedObject, Item, MIMEEntity, or RichTextItem style, or any InputSource style, and provides the results to the specified XSLTResultTarget object.

Note: This method is new with Release 5.0.3.

Defined in

EmbeddedObject, Item, MIMEEntity

Syntax

public void transformXML(Object style, XSLTResultTarget result)
    throws NotesException, java.io.IOException, org.xml.sax.SAXException

Parameters

Object style

The stylesheet source that you use to transform the XML data.

XSLTResultTarget result

The object that receives the transformed data.

Usage

For standalone applications, you should include the NCSO.jar or Notes®.jar file in the classpath for the lotus.domino classes. You should also include the XML4j.jar file in your classpath to use the XML parser, and the LotusXSL.jar file to use the XSL processor.

Note: You must include the XML4j.jar file in your classpath even if you only need to use the transformXML methods.

For applets that run in a browser, you should include the XML4j.jar and/or XML4j.cab file with the applet itself, to use the XML parser. To use the XSL processor, you should include the XML4j.jar and/or XML4j.cab file as well as the LotusXSL.jar and/or LotusXSL.cab file with the applet.

Errors generated during transformation are directed to System.err.

If a stream of XML contains relative or partial URLs, the parseXML method or transformXML method resolves the partial URL as a Page on the database where the InputStream originated. For example, when the parseXML or transformXML method encounters the XML stream <!DOCTYPE software-release-note SYSTEM "readme.dtd">, it looks for a Page named "readme.dtd" in the database where the source stream originated.

EmbeddedObject.transformXML creates a temporary file. The file is deleted when EmbeddedObject is recycled.