## 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)`

Copyright © 2000 Apache XML Project. All Rights Reserved.