org.modeshape.jcr.api.mimetype
Interface MimeTypeDetector

All Known Implementing Classes:

ApertureMimeTypeDetector, ExtensionBasedMimeTypeDetector, MimeTypeDetectors

public interface MimeTypeDetector

MIME-type detection libraries must provide thread-safe implementations of this interface to enable ModeShape to use the libraries to return MIME-types for data sources. Implementors are expected to have a public, no-arg constructor.

Method Summary

String

mimeTypeOf(String name, InputStream content) Returns the MIME-type of a data source, using its supplied content and/or its supplied name, depending upon the implementation.

Method Detail

mimeTypeOf

String mimeTypeOf(String name,
                  InputStream content)
                  throws IOException

Returns the MIME-type of a data source, using its supplied content and/or its supplied name, depending upon the implementation. If the MIME-type cannot be determined, either a "default" MIME-type or null may be returned, where the former will prevent earlier registered MIME-type detectors from being consulted.

Note that detector implementations should not close the supplied input stream and should try their best to reset the stream.

Parameters:

name - The name of the data source; may be null.

content - The content of the data source; may be null.

Returns:

The MIME-type of the data source, or optionally null if the MIME-type could not be determined.

Throws:

IOException - If an error occurs reading the supplied content.