Package org.apache.tika.parser.strings
Class StringsParser
- java.lang.Object
-
- org.apache.tika.parser.AbstractParser
-
- org.apache.tika.parser.strings.StringsParser
-
- All Implemented Interfaces:
Serializable
,Initializable
,Parser
public class StringsParser extends AbstractParser implements Initializable
Parser that uses the "strings" (or strings-alternative) command to find the printable strings in a object, or other binary, file (application/octet-stream). Useful as "best-effort" parser for files detected as application/octet-stream.- Author:
- gtotaro
- See Also:
- Serialized Form
-
-
Constructor Summary
Constructors Constructor Description StringsParser()
-
Method Summary
All Methods Static Methods Instance Methods Concrete Methods Modifier and Type Method Description void
checkInitialization(InitializableProblemHandler problemHandler)
int
getMinLength()
StringsEncoding
getStringsEncoding()
String
getStringsPath()
static String
getStringsProg()
Set<MediaType>
getSupportedTypes(ParseContext context)
Returns the set of media types supported by this parser when used with the given parse context.int
getTimeoutSeconds()
void
initialize(Map<String,Param> params)
void
parse(InputStream stream, ContentHandler handler, Metadata metadata, ParseContext context)
Parses a document stream into a sequence of XHTML SAX events.void
setEncoding(String encoding)
void
setMinLength(int minLength)
void
setStringsPath(String path)
Sets the "strings" installation folder.void
setTimeoutSeconds(int timeoutSeconds)
-
Methods inherited from class org.apache.tika.parser.AbstractParser
parse
-
-
-
-
Method Detail
-
getStringsProg
public static String getStringsProg()
-
getSupportedTypes
public 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 interfaceParser
- Parameters:
context
- parse context- Returns:
- immutable set of media types
-
parse
public void parse(InputStream stream, ContentHandler handler, Metadata metadata, ParseContext context) throws IOException, 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 interfaceParser
- Parameters:
stream
- the document stream (input)handler
- handler for the XHTML SAX events (output)metadata
- document metadata (input and output)context
- parse context- Throws:
IOException
- if the document stream could not be readSAXException
- if the SAX events could not be processedTikaException
- if the document could not be parsed
-
getStringsPath
public String getStringsPath()
-
setStringsPath
@Field public void setStringsPath(String path)
Sets the "strings" installation folder.- Parameters:
path
- the "strings" installation folder.
-
getMinLength
public int getMinLength()
-
setMinLength
@Field public void setMinLength(int minLength)
-
getTimeoutSeconds
public int getTimeoutSeconds()
-
setTimeoutSeconds
@Field public void setTimeoutSeconds(int timeoutSeconds)
-
getStringsEncoding
public StringsEncoding getStringsEncoding()
-
initialize
public void initialize(Map<String,Param> params) throws TikaConfigException
- Specified by:
initialize
in interfaceInitializable
- Parameters:
params
- params to use for initialization- Throws:
TikaConfigException
-
checkInitialization
public void checkInitialization(InitializableProblemHandler problemHandler) throws TikaConfigException
- Specified by:
checkInitialization
in interfaceInitializable
- Parameters:
problemHandler
- if there is a problem and no custom initializableProblemHandler has been configured via Initializable parameters, this is called to respond.- Throws:
TikaConfigException
-
-