Field Detail

• INITIAL_BUF_SIZE

  public static final int INITIAL_BUF_SIZE

  See Also:

  Constant Field Values

Constructor Detail

• XTalkToSAX

  public XTalkToSAX()

• XTalkToSAX

  public XTalkToSAX(int bufSize)

Method Detail

• bufferSize

  public int bufferSize()

  Initially, the XTalkToSAX processor creates a byte buffer and char buffer of size INITIAL_BUF_SIZE. These buffer may grow during parsing to handle very large strings. Users can determine the size of these arrays with this method. This method in conjunction with resetBuffers lets application implement their own buffer management. Buffers can be reset during parsing, but not from another thread.

• resizeBuffers

  public void resizeBuffers(int toSize)

  Resets buffers to their initial size... this is useful because buffers can grow during parsing and this allows the space to be reclaimed without having to undo references to the parser object.

• parse

  public void parse(InputStream is,
           ContentHandler handler)
             throws IOException,
                    SAXException

  Parse one document off of the incoming XTalk stream into SAX events. A side effect of parsing is that internal arrays will grow to the size of the largest character string encountered in the document. Use bufferSize() and resizeBuffers to manage memory in applications where very large strings may be encountered and the same object is used to parse many incoming documents.

  Throws:

  IOException - if underlying IOException from the stream or if XTalk format is invalid.

  SAXException - if SAXException thrown by the handler