org.apache.xalan.xslt
Class XSLTResultTarget

java.lang.Object
  |
  +--org.apache.xalan.xslt.XSLTResultTarget

public class XSLTResultTarget
extends java.lang.Object

Contains the result of a transformation that you perform with the XSLTProcessor process() method or one of the StylesheetRoot process() methods. Create an instance of this class to provide the process() method a container for the transformation result tree. You can use a file name or URL, character stream, byte stream, DOM Node, or SAX DocumentHandler to instantiate an XSLTResultTarget object.

See Also:
XSLTProcessor.process(XSLTInputSource, XSLTInputSource, XSLTResultTarget), StylesheetRoot

Constructor Summary
XSLTResultTarget()
          Zero-argument default constructor -- Before you can use the new XSLTResultTarget object in a transformation, you must define the output container by setting its FileName, CharacterStrea, ByteStream, or Node property.
XSLTResultTarget(org.xml.sax.DocumentHandler handler)
          Create a new output target with a SAX Document handler, which will handle result events -- the equivalent of creating an output target with the zero-argument constructor and setting the new object's DocyumentHandler property.
XSLTResultTarget(org.w3c.dom.Node n)
          Create a new output target with a DOM Node -- the equivalent of creating an output target with the zero-argument constructor and setting the new object's Node property.
XSLTResultTarget(java.io.OutputStream byteStream)
          Create a new output target with a byte stream -- the equivalent of creating an output target with the zero-argument constructor and setting the new object's ByteStream property.
XSLTResultTarget(java.lang.String fileName)
          Create a new output target with a file name -- the equivalent of creating an output target with the zero-argument constructor and setting the new object's FileName property.
XSLTResultTarget(java.io.Writer characterStream)
          Create a new output target with a character stream -- the equivalent of creating an output target with the zero-argument constructor and setting the new object's CharacterStream property.
 
Method Summary
 java.io.OutputStream getByteStream()
          Get the byte stream that contains or will contain the transformation result.
 java.io.Writer getCharacterStream()
          Get the character stream for this output target.
 org.xml.sax.DocumentHandler getDocumentHandler()
          Get the SAX DocumentHandler that processes the result tree events.
 java.lang.String getEncoding()
          Get the character encoding that was used.
 java.lang.String getFileName()
          Get the file name where the results are or will be written, or null if none was supplied.
 org.w3c.dom.Node getNode()
          Get the DOM Node that contains or will contain the transformation result.
 void setByteStream(java.io.OutputStream byteStream)
          Set the byte stream to contain the transformation result.
 void setCharacterStream(java.io.Writer characterStream)
          Set the character stream for this output target.
 void setDocumentHandler(org.xml.sax.DocumentHandler handler)
          Set a SAX DocumentHandler to process the result tree events.
 void setEncoding(java.lang.String encoding)
          Set the character encoding, if known.
 void setFileName(java.lang.String fileName)
          Set the file name or URL where the transformation result will be written.
 void setNode(org.w3c.dom.Node node)
          Set the DOM Node that will contain the transformation reasult.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

XSLTResultTarget

public XSLTResultTarget()
Zero-argument default constructor -- Before you can use the new XSLTResultTarget object in a transformation, you must define the output container by setting its FileName, CharacterStrea, ByteStream, or Node property.
See Also:
setFileName(String), setCharacterStream(Writer), setByteStream(OutputStream), setNode(Node), setDocumentHandler(DocumentHandler), setEncoding(String)

XSLTResultTarget

public XSLTResultTarget(java.lang.String fileName)
Create a new output target with a file name -- the equivalent of creating an output target with the zero-argument constructor and setting the new object's FileName property.
Parameters:
fileName - Identifies the file that will contain the transformation result (must be a valid system file name).
See Also:
setFileName(String), setCharacterStream(Writer), setByteStream(OutputStream), setNode(Node), setDocumentHandler(DocumentHandler), setEncoding(String)

XSLTResultTarget

public XSLTResultTarget(java.io.OutputStream byteStream)
Create a new output target with a byte stream -- the equivalent of creating an output target with the zero-argument constructor and setting the new object's ByteStream property.
Parameters:
byteStream - The raw byte stream that will contain the transformation result.
See Also:
setByteStream(OutputStream), setFileName(String), setCharacterStream(Writer), setNode(Node), setDocumentHandler(DocumentHandler), setEncoding(String)

XSLTResultTarget

public XSLTResultTarget(java.io.Writer characterStream)
Create a new output target with a character stream -- the equivalent of creating an output target with the zero-argument constructor and setting the new object's CharacterStream property.
Parameters:
characterStream - The character stream where the transformation result is written.
See Also:
setCharacterStream(Writer), setByteStream(OutputStream), setFileName(String), setNode(Node), setDocumentHandler(DocumentHandler), setEncoding(String)

XSLTResultTarget

public XSLTResultTarget(org.w3c.dom.Node n)
Create a new output target with a DOM Node -- the equivalent of creating an output target with the zero-argument constructor and setting the new object's Node property.
Parameters:
node - The DOM Node that will contain the transformation result.
See Also:
setNode(Node), setCharacterStream(Writer), setByteStream(OutputStream), setFileName(String), setDocumentHandler(DocumentHandler), setEncoding(String)

XSLTResultTarget

public XSLTResultTarget(org.xml.sax.DocumentHandler handler)
Create a new output target with a SAX Document handler, which will handle result events -- the equivalent of creating an output target with the zero-argument constructor and setting the new object's DocyumentHandler property.
Parameters:
handler - The SAX Document handler to which the result is written.
See Also:
setDocumentHandler(DocumentHandler), setNode(Node), setCharacterStream(Writer), setByteStream(OutputStream), setFileName(String), setEncoding(String)
Method Detail

setFileName

public void setFileName(java.lang.String fileName)
Set the file name or URL where the transformation result will be written.
Parameters:
fileName - The system identifier as a string.
See Also:
XSLTResultTarget(String), getFileName()

getFileName

public java.lang.String getFileName()
Get the file name where the results are or will be written, or null if none was supplied.
Returns:
The file name or URL.
See Also:
XSLTResultTarget(String), setFileName(String)

setByteStream

public void setByteStream(java.io.OutputStream byteStream)
Set the byte stream to contain the transformation result.
Parameters:
byteStream - A byte stream that will contain the transformation result.
See Also:
XSLTResultTarget(OutputStream), setByteStream(OutputStream)

getByteStream

public java.io.OutputStream getByteStream()
Get the byte stream that contains or will contain the transformation result.
Returns:
The byte stream, or null if none was supplied.
See Also:
XSLTResultTarget(OutputStream), setByteStream(OutputStream)

setEncoding

public void setEncoding(java.lang.String encoding)
Set the character encoding, if known.
Parameters:
encoding - The character encoding.

getEncoding

public java.lang.String getEncoding()
Get the character encoding that was used.
Returns:
The encoding, or null if none was supplied.

setCharacterStream

public void setCharacterStream(java.io.Writer characterStream)
Set the character stream for this output target.
Parameters:
characterStream - The character stream that will contain the transformation result.
See Also:
XSLTResultTarget(Writer), getCharacterStream()

getCharacterStream

public java.io.Writer getCharacterStream()
Get the character stream for this output target.
Returns:
The character stream, or null if none was supplied.
See Also:
XSLTResultTarget(Writer), setCharacterStream(Writer)

setNode

public void setNode(org.w3c.dom.Node node)
Set the DOM Node that will contain the transformation reasult.
Parameters:
node - DOM Node where the transformation result is placed.
See Also:
XSLTResultTarget(Node), getNode()

getNode

public org.w3c.dom.Node getNode()
Get the DOM Node that contains or will contain the transformation result.
See Also:
XSLTResultTarget(Node), setNode(Node)

setDocumentHandler

public void setDocumentHandler(org.xml.sax.DocumentHandler handler)
Set a SAX DocumentHandler to process the result tree events. You can process events as they occur rather than waiting for the transformation to be completed.
Parameters:
handler - The SAX DocumentHandler to process result tree events.
See Also:
XSLTResultTarget(DocumentHandler), getDocumentHandler()

getDocumentHandler

public org.xml.sax.DocumentHandler getDocumentHandler()
Get the SAX DocumentHandler that processes the result tree events. You can use the DocumentHandler to process events as they occur rather than waiting for the transformation to be completed.
Returns:
The SAX DocumentHandler that processes result tree events.
See Also:
XSLTResultTarget(DocumentHandler), setDocumentHandler(DocumentHandler)