org.apache.tika.parser.mp3
Class Mp3Parser

java.lang.Object
  org.apache.tika.parser.mp3.Mp3Parser

All Implemented Interfaces:

Parser

public class Mp3Parser
extends java.lang.Object
implements Parser

The Mp3Parser is used to parse ID3 Version 1 Tag information from an MP3 file, if available.

See Also:

MP3 ID3 Version 1 specification, MP3 ID3 Version 2.4 Structure Specification, MP3 ID3 Version 2.4 Frames Specification

Nested Class Summary

protected static class

Mp3Parser.ID3TagsAndAudio

Constructor Summary

Mp3Parser()

Method Summary

protected static Mp3Parser.ID3TagsAndAudio	getAllTagHandlers(java.io.InputStream stream, org.xml.sax.ContentHandler handler) Scans the MP3 frames for ID3 tags, and creates ID3Tag Handlers for each supported set of tags.
java.util.Set<MediaType>	getSupportedTypes(ParseContext context) Returns the set of media types supported by this parser when used with the given parse context.
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

Mp3Parser

public Mp3Parser()

Method Detail

getSupportedTypes

public java.util.Set<MediaType> getSupportedTypes(ParseContext context)

Description copied from interface: Parser

Returns the set of media types supported by this parser when used with the given parse context.

Specified by:

getSupportedTypes in interface Parser

Parameters:

context - parse context

Returns:

immutable set of media types

parse

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

Description copied from interface: Parser

Parses a document stream into a sequence of XHTML SAX events. Fills in related document metadata in the given metadata object.

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.

Specified by:

parse in interface Parser

Parameters:

stream - the document stream (input)

handler - handler for the XHTML SAX events (output)

metadata - document metadata (input and output)

context - parse context

Throws:

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 parsed

parse

public void parse(java.io.InputStream stream,
                  org.xml.sax.ContentHandler handler,
                  Metadata metadata)
           throws java.io.IOException,
                  org.xml.sax.SAXException,
                  TikaException

Deprecated. This method will be removed in Apache Tika 1.0.

Description copied from interface: Parser

The parse() method from Tika 0.4 and earlier. Please use the Parser.parse(InputStream, ContentHandler, Metadata, ParseContext) method instead in new code. Calls to this backwards compatibility method are forwarded to the new parse() method with an empty parse context.

Specified by:

parse in interface Parser

Throws:

java.io.IOException

org.xml.sax.SAXException

TikaException

getAllTagHandlers

protected static Mp3Parser.ID3TagsAndAudio getAllTagHandlers(java.io.InputStream stream,
                                                             org.xml.sax.ContentHandler handler)
                                                      throws java.io.IOException,
                                                             org.xml.sax.SAXException,
                                                             TikaException

Scans the MP3 frames for ID3 tags, and creates ID3Tag Handlers for each supported set of tags.

Throws:

java.io.IOException

org.xml.sax.SAXException

TikaException