Package org.apache.vinci.transport.document

Class XTalkToSAX

java.lang.Object
org.apache.vinci.transport.document.XTalkToSAX
public class XTalkToSAX extends Object
Class for converting XTalk streams into SAX events.

  • Field Summary

    Fields
    Modifier and Type
    Field
    Description
    static final int
    INITIAL_BUF_SIZE
     

  • Constructor Summary

    Constructors
    Constructor
    Description
    XTalkToSAX()
     
    XTalkToSAX(int bufSize)
     

  • Method Summary

    Modifier and Type
    Method
    Description
    int
    bufferSize()
    Initially, the XTalkToSAX processor creates a byte buffer and char buffer of size INITIAL_BUF_SIZE.
    void
    parse(InputStream aIs, ContentHandler handler)
    Parse one document off of the incoming XTalk stream into SAX events.
    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.

    Methods inherited from class java.lang.Object

    clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

  • Field Details

  • Constructor Details

    • XTalkToSAX

      public XTalkToSAX()

    • XTalkToSAX

      public XTalkToSAX(int bufSize)

  • Method Details

    • 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.
      Returns:
      -

    • 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.
      Parameters:
      toSize - -

    • parse

      public void parse(InputStream aIs, 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.
      Parameters:
      aIs - -
      handler - -
      Throws:
      IOException - if underlying IOException from the stream or if XTalk format is invalid.
      SAXException - if SAXException thrown by the handler