javax.activation
Class MimeType

java.lang.Object
  extended by javax.activation.MimeType
All Implemented Interfaces:
Externalizable, Serializable

public class MimeType
extends Object
implements Externalizable

A MIME content type, as defined in RFCs 2045 and 2046.

See Also:
Serialized Form

Constructor Summary
MimeType()
          Constructor for an application/* content type.
MimeType(String rawdata)
          Constructor that parses a raw String.
MimeType(String primary, String sub)
          Constructor for a new MIME type with the given primary and sub types and an empty parameter list.
 
Method Summary
 String getBaseType()
          Returns the string representation of this MIME type without parameters.
 String getParameter(String name)
          Returns the parameter value for the specified name.
 MimeTypeParameterList getParameters()
          Returns the MIME parameters.
 String getPrimaryType()
          Returns the primary type.
 String getSubType()
          Returns the subtype.
 boolean match(MimeType type)
          Returns true if the primary and subtype of this MIME type are the same as in the given MIME type.
 boolean match(String rawdata)
          Returns true if the primary and subtype of this MIME type are the same as in the given MIME type string.
 void readExternal(ObjectInput in)
          This method restores an object's state by reading in the instance data for the object from the passed in stream.
 void removeParameter(String name)
          Removes the parameter value for the specified name.
 void setParameter(String name, String value)
          Sets the parameter value for the specified name.
 void setPrimaryType(String primary)
          Sets the primary type.
 void setSubType(String sub)
          Sets the subtype.
 String toString()
          Returns the complete string representation of this MIME type.
 void writeExternal(ObjectOutput out)
          This method is responsible for writing the instance data of an object to the passed in stream.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

MimeType

public MimeType()
Constructor for an application/* content type.


MimeType

public MimeType(String rawdata)
         throws MimeTypeParseException
Constructor that parses a raw String.

Parameters:
rawdata - the MIME type string
Throws:
MimeTypeParseException

MimeType

public MimeType(String primary,
                String sub)
         throws MimeTypeParseException
Constructor for a new MIME type with the given primary and sub types and an empty parameter list.

Parameters:
primary - the primary type
sub - the subtype
Throws:
MimeTypeParseException
Method Detail

getPrimaryType

public String getPrimaryType()
Returns the primary type.


setPrimaryType

public void setPrimaryType(String primary)
                    throws MimeTypeParseException
Sets the primary type.

Parameters:
primary - the new primary type
Throws:
MimeTypeParseException

getSubType

public String getSubType()
Returns the subtype.


setSubType

public void setSubType(String sub)
                throws MimeTypeParseException
Sets the subtype.

Parameters:
sub - the new subtype
Throws:
MimeTypeParseException

getParameters

public MimeTypeParameterList getParameters()
Returns the MIME parameters.


getParameter

public String getParameter(String name)
Returns the parameter value for the specified name.

Parameters:
name - the parameter name

setParameter

public void setParameter(String name,
                         String value)
Sets the parameter value for the specified name.

Parameters:
name - the parameter name
value - the new value

removeParameter

public void removeParameter(String name)
Removes the parameter value for the specified name.

Parameters:
name - the parameter name

toString

public String toString()
Returns the complete string representation of this MIME type.

Overrides:
toString in class Object
Returns:
the String representing this Object, which may be null
See Also:
Object.getClass(), Object.hashCode(), Class.getName(), Integer.toHexString(int)

getBaseType

public String getBaseType()
Returns the string representation of this MIME type without parameters.


match

public boolean match(MimeType type)
Returns true if the primary and subtype of this MIME type are the same as in the given MIME type.


match

public boolean match(String rawdata)
              throws MimeTypeParseException
Returns true if the primary and subtype of this MIME type are the same as in the given MIME type string.

Throws:
MimeTypeParseException

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException
Description copied from interface: Externalizable
This method is responsible for writing the instance data of an object to the passed in stream. Note that this stream is not a subclass of OutputStream, but rather is a class that implements the ObjectOutput interface. That interface provides a number of methods for writing Java data values to a stream.

Not that the implementation of this method must be coordinated with the implementation of readExternal.

Specified by:
writeExternal in interface Externalizable
Parameters:
out - An ObjectOutput instance for writing the object state
Throws:
IOException - If an error occurs

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException
Description copied from interface: Externalizable
This method restores an object's state by reading in the instance data for the object from the passed in stream. Note that this stream is not a subclass of InputStream, but rather is a class that implements the ObjectInput interface. That interface provides a mechanism for reading in Java data types from a stream.

Note that this method must be compatible with writeExternal. It must read back the exact same types that were written by that method in the exact order they were written.

If this method needs to read back an object instance, then the class for that object must be found and loaded. If that operation fails, then this method throws a ClassNotFoundException

Specified by:
readExternal in interface Externalizable
Parameters:
in - An ObjectInput instance for reading in the object state
Throws:
IOException - If any other error occurs
ClassNotFoundException - If the class of an object being restored cannot be found