SAXResult

public class SAXResult
extends Object implements Result

java.lang.Object
   ↳ javax.xml.transform.sax.SAXResult


Acts as an holder for a transformation Result.

Summary

Constants

String FEATURE

If TransformerFactory.getFeature(String) returns true when passed this value as an argument, the Transformer supports Result output of this type.

Inherited constants

Public constructors

SAXResult()

Zero-argument default constructor.

SAXResult(ContentHandler handler)

Create a SAXResult that targets a SAX2 ContentHandler.

Public methods

ContentHandler getHandler()

Get the ContentHandler that is the Result.

LexicalHandler getLexicalHandler()

Get a SAX2 LexicalHandler for the output.

String getSystemId()

Get the system identifier that was set with setSystemId.

void setHandler(ContentHandler handler)

Set the target to be a SAX2 ContentHandler.

void setLexicalHandler(LexicalHandler handler)

Set the SAX2 LexicalHandler for the output.

void setSystemId(String systemId)

Method setSystemId Set the systemID that may be used in association with the ContentHandler.

Inherited methods

Constants

FEATURE

added in API level 8
public static final String FEATURE

If TransformerFactory.getFeature(String) returns true when passed this value as an argument, the Transformer supports Result output of this type.

Constant Value: "http://javax.xml.transform.sax.SAXResult/feature"

Public constructors

SAXResult

added in API level 8
public SAXResult ()

Zero-argument default constructor.

SAXResult

added in API level 8
public SAXResult (ContentHandler handler)

Create a SAXResult that targets a SAX2 ContentHandler.

Parameters
handler ContentHandler: Must be a non-null ContentHandler reference.

Public methods

getHandler

added in API level 8
public ContentHandler getHandler ()

Get the ContentHandler that is the Result.

Returns
ContentHandler The ContentHandler that is to be transformation output.

getLexicalHandler

added in API level 8
public LexicalHandler getLexicalHandler ()

Get a SAX2 LexicalHandler for the output.

Returns
LexicalHandler A LexicalHandler, or null.

getSystemId

added in API level 8
public String getSystemId ()

Get the system identifier that was set with setSystemId.

Returns
String The system identifier that was set with setSystemId, or null if setSystemId was not called.

setHandler

added in API level 8
public void setHandler (ContentHandler handler)

Set the target to be a SAX2 ContentHandler.

Parameters
handler ContentHandler: Must be a non-null ContentHandler reference.

setLexicalHandler

added in API level 8
public void setLexicalHandler (LexicalHandler handler)

Set the SAX2 LexicalHandler for the output.

This is needed to handle XML comments and the like. If the lexical handler is not set, an attempt should be made by the transformer to cast the ContentHandler to a LexicalHandler.

Parameters
handler LexicalHandler: A non-null LexicalHandler for handling lexical parse events.

setSystemId

added in API level 8
public void setSystemId (String systemId)

Method setSystemId Set the systemID that may be used in association with the ContentHandler.

Parameters
systemId String: The system identifier as a URI string.