Package org.apache.cocoon.xml.sax
Class SAXBuffer
- java.lang.Object
-
- org.apache.cocoon.xml.sax.SAXBuffer
-
- All Implemented Interfaces:
Serializable
,ContentHandler
,LexicalHandler
@Deprecated(since="2022-01-27") public class SAXBuffer extends Object implements ContentHandler, LexicalHandler, Serializable
Deprecated.This API is deprecated, migrate code to the XML APIs provided by the JDK.A class that can record SAX events and replay them later.Compared to the old Cocoon.XMLByteStreamCompiler, this class is many times faster at sending out the recorded SAX events since it doesn't need to convert between byte and char representations etc. On the other hand, its data structure is more complex then a simple byte array, making XMLByteStreamCompiler better in case the recorded SAX should be stored long-term.
Use this class if you need to frequently generate smaller amounts of SAX events, or replay a set of recorded start events immediately.
Both
ContentHandler
andLexicalHandler
are supported, the only exception is that the setDocumentLocator event is not recorded.- See Also:
- Serialized Form
-
-
Nested Class Summary
Nested Classes Modifier and Type Class Description static class
SAXBuffer.Characters
Deprecated.static class
SAXBuffer.Comment
Deprecated.static class
SAXBuffer.EndCDATA
Deprecated.static class
SAXBuffer.EndDocument
Deprecated.static class
SAXBuffer.EndDTD
Deprecated.static class
SAXBuffer.EndElement
Deprecated.static class
SAXBuffer.EndEntity
Deprecated.static class
SAXBuffer.EndPrefixMapping
Deprecated.static class
SAXBuffer.IgnorableWhitespace
Deprecated.static class
SAXBuffer.PI
Deprecated.static class
SAXBuffer.SkippedEntity
Deprecated.static class
SAXBuffer.StartCDATA
Deprecated.static class
SAXBuffer.StartDocument
Deprecated.static class
SAXBuffer.StartDTD
Deprecated.static class
SAXBuffer.StartElement
Deprecated.static class
SAXBuffer.StartEntity
Deprecated.static class
SAXBuffer.StartPrefixMapping
Deprecated.static class
SAXBuffer.XMLizableBit
Deprecated.
-
Constructor Summary
Constructors Constructor Description SAXBuffer()
Deprecated.Creates empty SaxBufferSAXBuffer(List<org.apache.cocoon.xml.sax.SAXBuffer.SaxBit> bits)
Deprecated.Creates SaxBuffer based on the provided bits list.SAXBuffer(SAXBuffer saxBuffer)
Deprecated.Creates copy of another SaxBuffer
-
Method Summary
All Methods Instance Methods Concrete Methods Deprecated Methods Modifier and Type Method Description void
characters(char[] ch, int start, int length)
Deprecated.void
comment(char[] ch, int start, int length)
Deprecated.void
dump(Writer writer)
Deprecated.Dump buffer contents into the provided writer.void
endCDATA()
Deprecated.void
endDocument()
Deprecated.void
endDTD()
Deprecated.void
endElement(String namespaceURI, String localName, String qName)
Deprecated.void
endEntity(String name)
Deprecated.void
endPrefixMapping(String prefix)
Deprecated.List<org.apache.cocoon.xml.sax.SAXBuffer.SaxBit>
getBits()
Deprecated.void
ignorableWhitespace(char[] ch, int start, int length)
Deprecated.boolean
isEmpty()
Deprecated.void
processingInstruction(String target, String data)
Deprecated.void
recycle()
Deprecated.Clear this buffervoid
saxBuffer(SAXBuffer xml)
Deprecated.Add a another buffervoid
setDocumentLocator(Locator locator)
Deprecated.void
skippedEntity(String name)
Deprecated.void
startCDATA()
Deprecated.void
startDocument()
Deprecated.void
startDTD(String name, String publicId, String systemId)
Deprecated.void
startElement(String namespaceURI, String localName, String qName, Attributes atts)
Deprecated.void
startEntity(String name)
Deprecated.void
startPrefixMapping(String prefix, String uri)
Deprecated.void
toSAX(ContentHandler contentHandler)
Deprecated.Stream this buffer into the provided content handler.String
toString()
Deprecated.
-
-
-
Constructor Detail
-
SAXBuffer
public SAXBuffer()
Deprecated.Creates empty SaxBuffer
-
SAXBuffer
public SAXBuffer(List<org.apache.cocoon.xml.sax.SAXBuffer.SaxBit> bits)
Deprecated.Creates SaxBuffer based on the provided bits list.
-
SAXBuffer
public SAXBuffer(SAXBuffer saxBuffer)
Deprecated.Creates copy of another SaxBuffer
-
-
Method Detail
-
skippedEntity
public void skippedEntity(String name) throws SAXException
Deprecated.- Specified by:
skippedEntity
in interfaceContentHandler
- Throws:
SAXException
-
setDocumentLocator
public void setDocumentLocator(Locator locator)
Deprecated.- Specified by:
setDocumentLocator
in interfaceContentHandler
-
ignorableWhitespace
public void ignorableWhitespace(char[] ch, int start, int length) throws SAXException
Deprecated.- Specified by:
ignorableWhitespace
in interfaceContentHandler
- Throws:
SAXException
-
processingInstruction
public void processingInstruction(String target, String data) throws SAXException
Deprecated.- Specified by:
processingInstruction
in interfaceContentHandler
- Throws:
SAXException
-
startDocument
public void startDocument() throws SAXException
Deprecated.- Specified by:
startDocument
in interfaceContentHandler
- Throws:
SAXException
-
startElement
public void startElement(String namespaceURI, String localName, String qName, Attributes atts) throws SAXException
Deprecated.- Specified by:
startElement
in interfaceContentHandler
- Throws:
SAXException
-
endPrefixMapping
public void endPrefixMapping(String prefix) throws SAXException
Deprecated.- Specified by:
endPrefixMapping
in interfaceContentHandler
- Throws:
SAXException
-
characters
public void characters(char[] ch, int start, int length) throws SAXException
Deprecated.- Specified by:
characters
in interfaceContentHandler
- Throws:
SAXException
-
endElement
public void endElement(String namespaceURI, String localName, String qName) throws SAXException
Deprecated.- Specified by:
endElement
in interfaceContentHandler
- Throws:
SAXException
-
endDocument
public void endDocument() throws SAXException
Deprecated.- Specified by:
endDocument
in interfaceContentHandler
- Throws:
SAXException
-
startPrefixMapping
public void startPrefixMapping(String prefix, String uri) throws SAXException
Deprecated.- Specified by:
startPrefixMapping
in interfaceContentHandler
- Throws:
SAXException
-
endCDATA
public void endCDATA() throws SAXException
Deprecated.- Specified by:
endCDATA
in interfaceLexicalHandler
- Throws:
SAXException
-
comment
public void comment(char[] ch, int start, int length) throws SAXException
Deprecated.- Specified by:
comment
in interfaceLexicalHandler
- Throws:
SAXException
-
startEntity
public void startEntity(String name) throws SAXException
Deprecated.- Specified by:
startEntity
in interfaceLexicalHandler
- Throws:
SAXException
-
endDTD
public void endDTD() throws SAXException
Deprecated.- Specified by:
endDTD
in interfaceLexicalHandler
- Throws:
SAXException
-
startDTD
public void startDTD(String name, String publicId, String systemId) throws SAXException
Deprecated.- Specified by:
startDTD
in interfaceLexicalHandler
- Throws:
SAXException
-
startCDATA
public void startCDATA() throws SAXException
Deprecated.- Specified by:
startCDATA
in interfaceLexicalHandler
- Throws:
SAXException
-
endEntity
public void endEntity(String name) throws SAXException
Deprecated.- Specified by:
endEntity
in interfaceLexicalHandler
- Throws:
SAXException
-
saxBuffer
public void saxBuffer(SAXBuffer xml)
Deprecated.Add a another buffer
-
isEmpty
public boolean isEmpty()
Deprecated.- Returns:
- true if buffer is empty
-
getBits
public List<org.apache.cocoon.xml.sax.SAXBuffer.SaxBit> getBits()
Deprecated.- Returns:
- unmodifiable list of SAX bits
-
toSAX
public void toSAX(ContentHandler contentHandler) throws SAXException
Deprecated.Stream this buffer into the provided content handler. If contentHandler object implements LexicalHandler, it will get lexical events as well.- Throws:
SAXException
-
toString
public String toString()
Deprecated.
-
recycle
public void recycle()
Deprecated.Clear this buffer
-
dump
public void dump(Writer writer) throws IOException
Deprecated.Dump buffer contents into the provided writer.- Throws:
IOException
-
-