|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object org.apache.tika.parser.html.HtmlParser
public class HtmlParser
HTML parser. Uses CyberNeko to turn the input document to HTML SAX events, and post-processes the events to produce XHTML and metadata expected by Tika clients.
Constructor Summary | |
---|---|
HtmlParser()
|
Method Summary | |
---|---|
protected boolean |
isDiscardElement(java.lang.String name)
Checks whether all content within the given HTML element should be discarded instead of including it in the parse output. |
protected java.lang.String |
mapSafeElement(java.lang.String name)
Maps "safe" HTML element names to semantic XHTML equivalents. |
void |
parse(java.io.InputStream stream,
org.xml.sax.ContentHandler handler,
Metadata metadata)
Deprecated. This method will be removed in Apache Tika 1.0. |
void |
parse(java.io.InputStream stream,
org.xml.sax.ContentHandler handler,
Metadata metadata,
ParseContext context)
Parses a document stream into a sequence of XHTML SAX events. |
Methods inherited from class java.lang.Object |
---|
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
Constructor Detail |
---|
public HtmlParser()
Method Detail |
---|
public void parse(java.io.InputStream stream, org.xml.sax.ContentHandler handler, Metadata metadata, ParseContext context) throws java.io.IOException, org.xml.sax.SAXException, TikaException
Parser
The given document stream is consumed but not closed by this method. The responsibility to close the stream remains on the caller.
Information about the parsing context can be passed in the context parameter. See the parser implementations for the kinds of context information they expect.
parse
in interface Parser
stream
- the document stream (input)handler
- handler for the XHTML SAX events (output)metadata
- document metadata (input and output)context
- parse context
java.io.IOException
- if the document stream could not be read
org.xml.sax.SAXException
- if the SAX events could not be processed
TikaException
- if the document could not be parsedpublic void parse(java.io.InputStream stream, org.xml.sax.ContentHandler handler, Metadata metadata) throws java.io.IOException, org.xml.sax.SAXException, TikaException
Parser
#parse(InputStream, ContentHandler, Metadata, Map)
method
instead in new code. Calls to this backwards compatibility method
are forwarded to the new parse() method with an empty parse context.
parse
in interface Parser
java.io.IOException
org.xml.sax.SAXException
TikaException
protected java.lang.String mapSafeElement(java.lang.String name)
null
and the element
will be ignored but the content inside it is still processed. See
the isDiscardElement(String)
method for a way to discard
the entire contents of an element.
Subclasses can override this method to customize the default mapping.
name
- HTML element name (upper case)
null
if the element is unsafeprotected boolean isDiscardElement(java.lang.String name)
name
- HTML element name (upper case)
true
if content inside the named element
should be ignored, false
otherwise
|
||||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | |||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |