Package org.apache.tika.sax

Class XHTMLContentHandler

java.lang.Object

org.xml.sax.helpers.DefaultHandler

org.apache.tika.sax.ContentHandlerDecorator

org.apache.tika.sax.SafeContentHandler

org.apache.tika.sax.XHTMLContentHandler

All Implemented Interfaces:

ContentHandler, DTDHandler, EntityResolver, ErrorHandler

@Deprecated(since="2026-04-30")
public class XHTMLContentHandler
extends SafeContentHandler

Deprecated.

This version of the Apache Tika library is deprecated. Use your own version of Apache Tika.

Content handler decorator that simplifies the task of producing XHTML events for Tika content parsers.

Field Summary

Fields

Modifier and Type	Field	Description
static final Set<String>	ENDLINE	Deprecated. The elements that get appended with the NL character.
static final String	XHTML	Deprecated. The XHTML namespace URI

Constructor Summary

Constructors

Constructor	Description
XHTMLContentHandler(ContentHandler handler, Metadata metadata)	Deprecated.

Method Summary

Modifier and Type	Method	Description
void	characters(char[] ch, int start, int length)	Deprecated.
void	characters(String characters)	Deprecated.
void	element(String name, String value)	Deprecated. Emits an XHTML element with the given text content.
void	endDocument()	Deprecated. Ends the XHTML document by writing the following footer and clearing the namespace mappings:
void	endElement(String name)	Deprecated.
void	endElement(String uri, String local, String name)	Deprecated. Ends the given element.
void	newline()	Deprecated.
void	startDocument()	Deprecated. Starts an XHTML document by setting up the namespace mappings when called for the first time.
void	startElement(String name)	Deprecated.
void	startElement(String name, String attribute, String value)	Deprecated.
void	startElement(String uri, String local, String name, Attributes attributes)	Deprecated. Starts the given element.
void	startElement(String name, AttributesImpl attributes)	Deprecated.

Methods inherited from class org.apache.tika.sax.SafeContentHandler

ignorableWhitespace

Methods inherited from class org.apache.tika.sax.ContentHandlerDecorator

endPrefixMapping, processingInstruction, setDocumentLocator, skippedEntity, startPrefixMapping, toString

Methods inherited from class org.xml.sax.helpers.DefaultHandler

error, fatalError, notationDecl, resolveEntity, unparsedEntityDecl, warning

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface org.xml.sax.ContentHandler

declaration

Field Details

XHTML

public static final String XHTML

Deprecated.

The XHTML namespace URI

See Also:

• Constant Field Values

ENDLINE

public static final Set<String> ENDLINE

Deprecated.

The elements that get appended with the NL character.

Constructor Details

XHTMLContentHandler

public XHTMLContentHandler(ContentHandler handler,
 Metadata metadata)

Deprecated.

Method Details

startDocument

public void startDocument()
                   throws SAXException

Deprecated.

Starts an XHTML document by setting up the namespace mappings when called for the first time. The standard XHTML prefix is generated lazily when the first element is started.

Specified by:

startDocument in interface ContentHandler

Overrides:

startDocument in class ContentHandlerDecorator

Throws:

SAXException

endDocument

public void endDocument()
                 throws SAXException

Deprecated.

Ends the XHTML document by writing the following footer and clearing the namespace mappings:

   </body>
 </html>
 

Specified by:

endDocument in interface ContentHandler

Overrides:

endDocument in class SafeContentHandler

Throws:

SAXException

startElement

public void startElement(String uri,
 String local,
 String name,
 Attributes attributes)
                  throws SAXException

Deprecated.

Starts the given element. Table cells and list items are automatically indented by emitting a tab character as ignorable whitespace.

Specified by:

startElement in interface ContentHandler

Overrides:

startElement in class SafeContentHandler

Throws:

SAXException

endElement

public void endElement(String uri,
 String local,
 String name)
                throws SAXException

Deprecated.

Ends the given element. Block elements are automatically followed by a newline character.

Specified by:

endElement in interface ContentHandler

Overrides:

endElement in class SafeContentHandler

Throws:

SAXException

characters

public void characters(char[] ch,
 int start,
 int length)
                throws SAXException

Deprecated.

Specified by:

characters in interface ContentHandler

Overrides:

characters in class SafeContentHandler

Throws:

SAXException

See Also:

• TIKA-210

startElement

public void startElement(String name)
                  throws SAXException

Deprecated.

Throws:

SAXException

startElement

public void startElement(String name,
 String attribute,
 String value)
                  throws SAXException

Deprecated.

Throws:

SAXException

startElement

public void startElement(String name,
 AttributesImpl attributes)
                  throws SAXException

Deprecated.

Throws:

SAXException

endElement

public void endElement(String name)
                throws SAXException

Deprecated.

Throws:

SAXException

characters

public void characters(String characters)
                throws SAXException

Deprecated.

Throws:

SAXException

newline

public void newline()
             throws SAXException

Deprecated.

Throws:

SAXException

element

public void element(String name,
 String value)
             throws SAXException

Deprecated.

Emits an XHTML element with the given text content. If the given text value is null or empty, then the element is not written.

Parameters:

name - XHTML element name

value - element value, possibly null

Throws:

SAXException - if the content element could not be written