com.phloc.commons.mime

Interface IMimeType

All Superinterfaces:

ICloneable<IMimeType>, IHasStringRepresentation, Serializable

All Known Implementing Classes:

MimeType

@MustImplementEqualsAndHashcode
public interface IMimeType
extends IHasStringRepresentation, ICloneable<IMimeType>, Serializable

Interface for the structured representation of a single MIME type.

Author:

Philip Helger

Method Summary

Methods

Modifier and Type	Method and Description
List<MimeTypeParameter>	getAllParameters()
String	getAsString() Get the MIME type including all parameters as a single string.
String	getAsString(EMimeQuoting eQuotingAlgorithm) Get the MIME type including all parameters as a single string.
String	getAsStringWithoutParameters()
String	getContentSubType()
EMimeContentType	getContentType()
IMimeType	getCopyWithoutParameters()
MimeTypeParameter	getParameterAtIndex(int nIndex) Get the parameter at the specified index.
int	getParameterCount()
String	getParametersAsString(EMimeQuoting eQuotingAlgorithm) Get all MIME type parameters as a single string but without the leading content and sub type.
String	getParameterValueWithName(String sParamName) Get the value of the parameter with the specified name.
MimeTypeParameter	getParameterWithName(String sParamName) Get the parameter with the specified name.
boolean	hasAnyParameters()
boolean	hasParameterWithName(String sParamName) Check if a parameter with the specified name is present.

Methods inherited from interface com.phloc.commons.ICloneable

getClone

Method Detail

getContentType

@Nonnull
EMimeContentType getContentType()

Returns:

The content type. Never null.

getContentSubType

@Nonnull
String getContentSubType()

Returns:

The content sub type. Never null.

getAsString

@Nonnull
String getAsString()

Get the MIME type including all parameters as a single string. By default the CMimeType.DEFAULT_QUOTING quoting algorithm is used.

Specified by:

getAsString in interface IHasStringRepresentation

Returns:

The combined string to be used as text representation: contentType '/' subType ( ';' parameterName '=' parameterValue )*

See Also:

getAsString(EMimeQuoting), getAsStringWithoutParameters()

getAsString

@Nonnull
@Nonempty
String getAsString(@Nonnull
                                  EMimeQuoting eQuotingAlgorithm)

Get the MIME type including all parameters as a single string. The specified quoting algorithm is used to quote parameter values (if necessary).

Returns:

The combined string to be used as text representation: contentType '/' subType ( ';' parameterName '=' parameterValue )*

See Also:

getAsStringWithoutParameters(), getParametersAsString(EMimeQuoting)

getAsStringWithoutParameters

@Nonnull
@Nonempty
String getAsStringWithoutParameters()

Returns:

The combined string to be used as text representation but without the parameters: contentType '/' subType

See Also:

getAsString()

getParametersAsString

@Nonnull
String getParametersAsString(@Nonnull
                                   EMimeQuoting eQuotingAlgorithm)

Get all MIME type parameters as a single string but without the leading content and sub type. The specified quoting algorithm is used to quote parameter values.

Returns:

The combined string to be used as text representation: (';' parameterName '=' parameterValue )* . If no parameters are present, an empty String is returned!

See Also:

getAsString(EMimeQuoting), getAsStringWithoutParameters()

hasAnyParameters

boolean hasAnyParameters()

Returns:

true if at least one parameter is present, false if no parameter is present.

getParameterCount

@Nonnegative
int getParameterCount()

Returns:

The number of parameters. Alway ≥ 0.

getAllParameters

@Nonnull
@ReturnsMutableCopy
List<MimeTypeParameter> getAllParameters()

Returns:

All present parameters. May not be null but empty.

getParameterAtIndex

@Nullable
MimeTypeParameter getParameterAtIndex(@Nonnegative
                                             int nIndex)

Get the parameter at the specified index.

Parameters:

nIndex - The index to use. Should be ≥ 0.

Returns:

null if the provided index is illegal.

hasParameterWithName

boolean hasParameterWithName(@Nullable
                           String sParamName)

Check if a parameter with the specified name is present. The names are matched case sensitive!

Parameters:

sParamName - The parameter name to search. May be null.

Returns:

true if such a parameter exists.

getParameterWithName

@Nullable
MimeTypeParameter getParameterWithName(@Nullable
                                              String sParamName)

Get the parameter with the specified name. The names are matched case sensitive!

Parameters:

sParamName - The parameter name to search. May be null.

Returns:

null if no such parameter exists.

getParameterValueWithName

@Nullable
String getParameterValueWithName(@Nullable
                                        String sParamName)

Get the value of the parameter with the specified name. The names are matched case sensitive!

Parameters:

sParamName - The parameter name to search. May be null.

Returns:

null if no such parameter exists.

getCopyWithoutParameters

@Nonnull
IMimeType getCopyWithoutParameters()

Returns:

A copy of this MIME type but only the content type and the sub type. This method must even deliver a copy if no parameter are present! May not return null.