Java™ Platform
Standard Ed. 6

javax.xml.transform.sax
Class SAXResult

java.lang.Object
  extended by javax.xml.transform.sax.SAXResult
All Implemented Interfaces:
Result
Direct Known Subclasses:
JAXBResult

public class SAXResult
extends Object
implements Result

Acts as an holder for a transformation Result.


Field Summary
static String FEATURE
          If TransformerFactory.getFeature(java.lang.String) returns true when passed this value as an argument, the Transformer supports Result output of this type.
 
Fields inherited from interface javax.xml.transform.Result
PI_DISABLE_OUTPUT_ESCAPING, PI_ENABLE_OUTPUT_ESCAPING
 
Constructor Summary
SAXResult()
          Zero-argument default constructor.
SAXResult(ContentHandler handler)
          Create a SAXResult that targets a SAX2 ContentHandler.
 
Method Summary
 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.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Field Detail

FEATURE

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

See Also:
Constant Field Values
Constructor Detail

SAXResult

public SAXResult()
Zero-argument default constructor.


SAXResult

public SAXResult(ContentHandler handler)
Create a SAXResult that targets a SAX2 ContentHandler.

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

setHandler

public void setHandler(ContentHandler handler)
Set the target to be a SAX2 ContentHandler.

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

getHandler

public ContentHandler getHandler()
Get the ContentHandler that is the Result.

Returns:
The ContentHandler that is to be transformation output.

setLexicalHandler

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 - A non-null LexicalHandler for handling lexical parse events.

getLexicalHandler

public LexicalHandler getLexicalHandler()
Get a SAX2 LexicalHandler for the output.

Returns:
A LexicalHandler, or null.

setSystemId

public void setSystemId(String systemId)
Method setSystemId Set the systemID that may be used in association with the ContentHandler.

Specified by:
setSystemId in interface Result
Parameters:
systemId - The system identifier as a URI string.

getSystemId

public String getSystemId()
Get the system identifier that was set with setSystemId.

Specified by:
getSystemId in interface Result
Returns:
The system identifier that was set with setSystemId, or null if setSystemId was not called.

Java™ Platform
Standard Ed. 6

Submit a bug or feature
For further API reference and developer documentation, see Java SE Developer Documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, workarounds, and working code examples.

Copyright 2008 Sun Microsystems, Inc. All rights reserved. Use is subject to license terms. Also see the documentation redistribution policy.