libcore.content.type

Class MimeMap.Builder

java.lang.Object

libcore.content.type.MimeMap.Builder

Enclosing class:

MimeMap

public static final class MimeMap.Builder
extends Object

A builder for mapping of MIME types to extensions and back. Use addMimeMapping(String, List) and addMimeMapping(String, String) to add mapping entries and build final MimeMap with build().

Method Summary

Modifier and Type	Method and Description
MimeMap.Builder	addMimeMapping(String mimeSpec, List<String> extensionSpecs) Puts the mapping , and also the mappings for each given extension.
MimeMap.Builder	addMimeMapping(String mimeSpec, String extensionSpec) Convenience method.
MimeMap	build() Builds MimeMap containing all added MIME mappings.
String	toString() Returns a string containing a concise, human-readable description of this object.

Methods inherited from class java.lang.Object

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

Method Detail

addMimeMapping

@NonNull
public MimeMap.Builder addMimeMapping(@NonNull
                                               String mimeSpec,
                                               @NonNull
                                               List<String> extensionSpecs)

Puts the mapping , and also the mappings for each given extension. The values passed to this function are carry an optional prefix of which is stripped off in any case before any such key/value is added to a mapping. The prefix controls whether the mapping from> the corresponding value is added via Map.putIfAbsent(K, V) semantics ( present) vs. Map.put(K, V) semantics (), For example, put("text/html", "?htm", "html") would add the following mappings:

1. MIME type "text/html" -> extension "htm", overwriting any earlier mapping from MIME type "text/html" that might already have existed.
2. extension "htm" -> MIME type "text/html", but only if no earlier mapping for extension "htm" existed.
3. extension "html" -> MIME type "text/html", overwriting any earlier mapping from extension "html" that might already have existed.

put("?text/html", "?htm", "html") would have the same effect except that an earlier mapping from MIME type "text/html" would not be overwritten.

Parameters:

mimeSpec - A MIME type carrying an optional prefix of "?". If present, the "?" is stripped off and mapping for the resulting MIME type is only added to the map if no mapping had yet existed for that type.

extensionSpecs - The extensions from which to add mappings back to the "?" is stripped off and mapping for the resulting extension is only added to the map if no mapping had yet existed for that extension. If extensionSpecs is empty, then calling this method has no effect on the mapping that is being constructed.

Returns:

This builder.

Throws:

IllegalArgumentException - if mimeSpec or any of the extensionSpecs are invalid (null, empty, contain ' ', or '?' after an initial '?' has been stripped off).

addMimeMapping

@NonNull
public MimeMap.Builder addMimeMapping(@NonNull
                                               String mimeSpec,
                                               @NonNull
                                               String extensionSpec)

Convenience method.

build

@NonNull
public MimeMap build()

Builds MimeMap containing all added MIME mappings.

Returns:

MimeMap containing previously added MIME mapping entries

toString

public String toString()

Description copied from class: Object

Returns a string containing a concise, human-readable description of this object. Subclasses are encouraged to override this method and provide an implementation that takes into account the object's type and data. The default implementation is equivalent to the following expression:

   getClass().getName() + '@' + Integer.toHexString(hashCode())

See Writing a useful toString method if you intend implementing your own toString method.

Overrides:

toString in class Object

Returns:

a printable representation of this object.