com.helger.commons.mime

Class MimeTypeInfoManager

java.lang.Object

com.helger.commons.mime.MimeTypeInfoManager

@ThreadSafe
@Singleton
public class MimeTypeInfoManager
extends Object

This is the central manager for all MimeTypeInfo objects.

Author:

Philip Helger

Field Summary

Fields

Modifier and Type	Field and Description
static String	MIME_TYPE_INFO_XML

Constructor Summary

Constructors

Constructor and Description
MimeTypeInfoManager() Create a new empty (!!)

Method Summary

Methods

Modifier and Type	Method and Description
void	addExtension(MimeTypeInfo aInfo, MimeTypeInfo.ExtensionWithSource aExt)
void	addMimeType(MimeTypeInfo aInfo, MimeTypeInfo.MimeTypeWithSource aMimeType)
EChange	clearCache() Remove all registered mime types
boolean	containsMimeTypeForExtension(String sExtension) Check if any mime type is associated with the passed extension
boolean	containsMimeTypeForFilename(String sFilename) Check if any mime type is registered for the extension of the specified filename.
Set<String>	getAllExtensionsOfMimeType(IMimeType aMimeType) Get all extensions associated to the specified mime type
Set<String>	getAllGlobsOfMimeType(IMimeType aMimeType) Get all globs (=filename patterns) associated to the specified mime type
List<MimeTypeInfo>	getAllInfosOfExtension(String sExtension) Get all infos associated with the specified filename extension.
List<MimeTypeInfo>	getAllInfosOfFilename(File aFile)
List<MimeTypeInfo>	getAllInfosOfFilename(String sFilename)
List<MimeTypeInfo>	getAllInfosOfMimeType(IMimeType aMimeType) Get all infos associated with the passed mime type.
List<MimeTypeInfo>	getAllMimeTypeInfos()
Set<IMimeType>	getAllMimeTypes()
Set<IMimeType>	getAllMimeTypesForExtension(String sExtension) Get all mime types that are associated to the specified filename extension.
Set<IMimeType>	getAllMimeTypesForFilename(String sFilename) Get all mime types that are associated to the extension of the specified filename.
Set<String>	getAllMimeTypeStrings()
Set<String>	getAllMimeTypeStringsForExtension(String sExtension) Get all mime types that are associated to the specified filename extension.
Set<String>	getAllMimeTypeStringsForFilename(String sFilename) Get all mime types that are associated to the extension of the specified filename.
IMicroDocument	getAsDocument()
static MimeTypeInfoManager	getDefaultInstance()
String	getPrimaryExtensionOfMimeType(IMimeType aMimeType) Get the primary (=first) extension for the specified mime type.
IMimeType	getPrimaryMimeTypeForExtension(String sExtension) Get the primary (=first) mime type that is associated to the specified filename extension.
IMimeType	getPrimaryMimeTypeForFilename(String sFilename) Get the primary (=first) mime type associated with the specified filename.
String	getPrimaryMimeTypeStringForExtension(String sExtension) Get the primary (=first) mime type that is associated to the specified filename extension.
String	getPrimaryMimeTypeStringForFilename(String sFilename) Get the primary (=first) mime type associated with the specified filename.
static boolean	isDefaultInstantiated()
MimeTypeInfoManager	read(IReadableResource aRes) Read the information from the specified resource.
MimeTypeInfoManager	readDefault() Read the default resource.
void	registerMimeType(MimeTypeInfo aInfo)
void	reinitializeToDefault()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

MIME_TYPE_INFO_XML

public static final String MIME_TYPE_INFO_XML

See Also:

Constant Field Values

Constructor Detail

MimeTypeInfoManager

public MimeTypeInfoManager()

Create a new empty (!!) instance.

Method Detail

isDefaultInstantiated

public static boolean isDefaultInstantiated()

getDefaultInstance

@Nonnull
public static MimeTypeInfoManager getDefaultInstance()

Returns:

The default instance that contains all predefined MimeTypeInfos.

readDefault

@Nonnull
public MimeTypeInfoManager readDefault()

Read the default resource.

Returns:

this

See Also:

MIME_TYPE_INFO_XML

read

@Nonnull
public MimeTypeInfoManager read(@Nonnull
                               IReadableResource aRes)

Read the information from the specified resource.

Parameters:

aRes - The resource to read. May not be null.

Returns:

this

clearCache

@Nonnull
public EChange clearCache()

Remove all registered mime types

Returns:

EChange.

reinitializeToDefault

public void reinitializeToDefault()

getAsDocument

@Nonnull
@ReturnsMutableCopy
public IMicroDocument getAsDocument()

registerMimeType

public void registerMimeType(@Nonnull
                    MimeTypeInfo aInfo)

addExtension

@VisibleForTesting
public final void addExtension(@Nonnull
                                  MimeTypeInfo aInfo,
                                  @Nonnull
                                  MimeTypeInfo.ExtensionWithSource aExt)

addMimeType

@VisibleForTesting
public final void addMimeType(@Nonnull
                                 MimeTypeInfo aInfo,
                                 @Nonnull
                                 MimeTypeInfo.MimeTypeWithSource aMimeType)

getAllInfosOfFilename

@Nullable
@ReturnsMutableCopy
public List<MimeTypeInfo> getAllInfosOfFilename(@Nullable
                                                                   File aFile)

getAllInfosOfFilename

@Nullable
@ReturnsMutableCopy
public List<MimeTypeInfo> getAllInfosOfFilename(@Nullable
                                                                   String sFilename)

getAllInfosOfExtension

@Nullable
@ReturnsMutableCopy
public List<MimeTypeInfo> getAllInfosOfExtension(@Nullable
                                                                    String sExtension)

Get all infos associated with the specified filename extension.

Parameters:

sExtension - The extension to search. May be null or empty.

Returns:

null if the passed extension is null or if no such extension is registered.

getAllInfosOfMimeType

@Nullable
@ReturnsMutableCopy
public List<MimeTypeInfo> getAllInfosOfMimeType(@Nullable
                                                                   IMimeType aMimeType)

Get all infos associated with the passed mime type.

Parameters:

aMimeType - The mime type to search. May be null.

Returns:

null if a null mime type was passed or the passed mime type is unknown.

getAllMimeTypeInfos

@Nonnull
@ReturnsMutableCopy
public List<MimeTypeInfo> getAllMimeTypeInfos()

Returns:

A non-null set with all mime types infos known to this instance.

getAllMimeTypes

@Nonnull
@ReturnsMutableCopy
public Set<IMimeType> getAllMimeTypes()

Returns:

A non-null set with all mime types known to this instance.

getAllMimeTypeStrings

@Nonnull
@ReturnsMutableCopy
public Set<String> getAllMimeTypeStrings()

Returns:

A non-null set with all mime types known to this instance.

containsMimeTypeForFilename

public boolean containsMimeTypeForFilename(@Nonnull@Nonempty
                                  String sFilename)

Check if any mime type is registered for the extension of the specified filename.

Parameters:

sFilename - The filename to search. May neither be null nor empty.

Returns:

true if at least one mime type is associated with the extension of the passed filename, false otherwise.

getAllMimeTypesForFilename

@Nonnull
@ReturnsMutableCopy
public Set<IMimeType> getAllMimeTypesForFilename(@Nonnull@Nonempty
                                                                   String sFilename)

Get all mime types that are associated to the extension of the specified filename.

Parameters:

sFilename - The filename to search. May neither be null nor empty.

Returns:

Never null but maybe empty set if no mime type is associated with the extension of the passed filename.

getAllMimeTypeStringsForFilename

@Nonnull
@ReturnsMutableCopy
public Set<String> getAllMimeTypeStringsForFilename(@Nonnull@Nonempty
                                                                      String sFilename)

Get all mime types that are associated to the extension of the specified filename.

Parameters:

sFilename - The filename to search. May neither be null nor empty.

Returns:

Never null but maybe empty set if no mime type is associated with the extension of the passed filename.

getPrimaryMimeTypeForFilename

@Nullable
public IMimeType getPrimaryMimeTypeForFilename(@Nonnull@Nonempty
                                               String sFilename)

Get the primary (=first) mime type associated with the specified filename.

Parameters:

sFilename - The filename to retrieve the primary mime type from. May neither be null nor empty.

Returns:

null if no mime type is associated with the extension of the passed filename

getPrimaryMimeTypeStringForFilename

@Nullable
public String getPrimaryMimeTypeStringForFilename(@Nonnull@Nonempty
                                                  String sFilename)

Get the primary (=first) mime type associated with the specified filename.

Parameters:

sFilename - The filename to retrieve the primary mime type from. May neither be null nor empty.

Returns:

null if no mime type is associated with the extension of the passed filename

containsMimeTypeForExtension

public boolean containsMimeTypeForExtension(@Nonnull
                                   String sExtension)

Check if any mime type is associated with the passed extension

Parameters:

sExtension - The filename extension to search. May not be null.

Returns:

true if at least one mime type is associated, false if no mime type is associated with the extension

getAllMimeTypesForExtension

@Nonnull
@ReturnsMutableCopy
public Set<IMimeType> getAllMimeTypesForExtension(@Nonnull
                                                                    String sExtension)

Get all mime types that are associated to the specified filename extension.

Parameters:

sExtension - The filename extension to search. May not be null.

Returns:

Never null but maybe empty set if no mime type is associated with the passed extension.

getAllMimeTypeStringsForExtension

@Nonnull
@ReturnsMutableCopy
public Set<String> getAllMimeTypeStringsForExtension(@Nonnull
                                                                       String sExtension)

Get all mime types that are associated to the specified filename extension.

Parameters:

sExtension - The filename extension to search. May not be null.

Returns:

Never null but maybe empty set if no mime type is associated with the passed extension.

getPrimaryMimeTypeForExtension

@Nullable
public IMimeType getPrimaryMimeTypeForExtension(@Nonnull
                                                String sExtension)

Get the primary (=first) mime type that is associated to the specified filename extension.

Parameters:

sExtension - The filename extension to search. May not be null.

Returns:

null if no mime type is associated with the passed extension.

getPrimaryMimeTypeStringForExtension

@Nullable
public String getPrimaryMimeTypeStringForExtension(@Nonnull
                                                   String sExtension)

Get the primary (=first) mime type that is associated to the specified filename extension.

Parameters:

sExtension - The filename extension to search. May not be null.

Returns:

null if no mime type is associated with the passed extension.

getAllExtensionsOfMimeType

@Nonnull
@ReturnsMutableCopy
public Set<String> getAllExtensionsOfMimeType(@Nullable
                                                                IMimeType aMimeType)

Get all extensions associated to the specified mime type

Parameters:

aMimeType - The mime type to search. May be null.

Returns:

Never null but empty set if no extensions are present.

getPrimaryExtensionOfMimeType

@Nullable
public String getPrimaryExtensionOfMimeType(@Nullable
                                            IMimeType aMimeType)

Get the primary (=first) extension for the specified mime type.

Parameters:

aMimeType - The mime type to be searched. May be null.

Returns:

null if the mime type has no file extension assigned

getAllGlobsOfMimeType

@Nonnull
@ReturnsMutableCopy
public Set<String> getAllGlobsOfMimeType(@Nullable
                                                           IMimeType aMimeType)

Get all globs (=filename patterns) associated to the specified mime type

Parameters:

aMimeType - The mime type to search. May be null.

Returns:

Never null but empty set if no globs are present.