bayou.mime

Class FileSuffixToContentType

java.lang.Object

bayou.mime.FileSuffixToContentType

public class FileSuffixToContentType
extends Object

Maps file suffix to ContentType.

A FileSuffixToContentType instance is a mapping of {fileSuffix→contentType}. fileSuffix can be any string, usually starting with a separator char. New mappings can be added with method map(fileSuffix, contentType).

Given a filePath, we can find the longest fileSuffix that matches filePath, and return the corresponding ContentType. For example:

     mappings
                   .txt → text/plain;charset=UTF-8
                -en.txt → text/plain;charset=US-ASCII

     file "abc.txt" matches the 1st; file "xyz-en.txt" matches the 2nd.
 

Matching is case sensitive; "\" matches to "/".

You can map an empty fileSuffix to a ContentType as the fall-back mapping.

The mapping may be initially populated using the Apache mime.types file; revision 1506674 is used in this implementation. We add "charset=UTF-8" to all "text/xxx" content types in mime.types.

There is a global instance that is used by StaticHandler etc. App may add mappings to the global instance.

This class is thread-safe.

Constructor Summary

Constructors

Constructor and Description
FileSuffixToContentType(boolean apache) Create a new instance.

Method Summary

Instance Methods
ContentType	find(CharSequence filePath) Find the ContentType of filePath.
ContentType	map(CharSequence fileSuffix, ContentType contentType) Add a mapping fileSuffix→contentType.
Map<String,ContentType>	asMap() Return the mapping {fileSuffix→contentType} as a Map.
Static Method
FileSuffixToContentType	getGlobalInstance() The global instance.

Methods inherited from class java.lang.Object

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

Constructor Detail

FileSuffixToContentType

public FileSuffixToContentType(boolean apache)

Create a new instance.

If apache==true, the instance is populated with Apache mime.types.

Method Detail

getGlobalInstance

public static FileSuffixToContentType getGlobalInstance()

The global instance.

The global instance is initially populated with Apache mime.types. App may add mappings to the global instance.

find

public ContentType find(CharSequence filePath)

Find the ContentType of filePath.

Find the longest fileSuffix that matches filePath, and return the corresponding ContentType; return null if no matching is found.

map

public ContentType map(CharSequence fileSuffix,
                       ContentType contentType)

Add a mapping fileSuffix→contentType.

All "\" chars in fileSuffix will be replaced with "/".

Returns:

previous ContentType that was mapped to fileSuffix

asMap

public Map<String,ContentType> asMap()

Return the mapping {fileSuffix→contentType} as a Map.

The returned Map is read-only; it's mainly for diagnosis purpose.