A content description object contains information about the nature of arbitrary data.
A content description object will always include the content type for the examined contents, and may also include information on:
- charset;
- byte order mark;
- other custom properties provided by third-party plug-ins.
Content describers provided by plug-ins will fill in most of the properties in a content description object, except for the content type, what is done by the platform. After a content description is filled in by a content interpreter, it is marked as immutable by the platform, so calling any of the mutator methods defined in this interface will cause an IllegalStateException
to be thrown.
Default values for properties can be contributed by plug-ins as part of the content type definition markup.
This interface is not intended to be implemented by clients.
@see IContentDescriber
@since 3.0