站内搜索: 请输入搜索关键词
当前页面: 在线文档首页 > Java Platform, Enterprise Edition v1.4 API Specifications

MimeType (Java 2 Platform Ent. Ed. v1.4) - Java Platform, Enterprise Edition v1.4 API Specifications

JavaTM 2 Platform
Ent. Ed. v1.4

javax.activation
Class MimeType

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

public class MimeType
extends Object
implements Externalizable

A Multipurpose Internet Mail Extension (MIME) type, as defined in RFC 2045 and 2046.

See Also:
Serialized Form

Constructor Summary
MimeType()
          Default constructor.
MimeType(String rawdata)
          Constructor that builds a MimeType from a String.
MimeType(String primary, String sub)
          Constructor that builds a MimeType with the given primary and sub type but has an empty parameter list.
 
Method Summary
 String getBaseType()
          Return a String representation of this object without the parameter list.
 String getParameter(String name)
          Retrieve the value associated with the given name, or null if there is no current association.
 MimeTypeParameterList getParameters()
          Retrieve this object's parameter list.
 String getPrimaryType()
          Retrieve the primary type of this object.
 String getSubType()
          Retrieve the sub type of this object.
 boolean match(MimeType type)
          Determine if the primary and sub type of this object is the same as what is in the given type.
 boolean match(String rawdata)
          Determine if the primary and sub type of this object is the same as the content type described in rawdata.
 void readExternal(ObjectInput in)
          The object implements the readExternal method to restore its contents by calling the methods of DataInput for primitive types and readObject for objects, strings and arrays.
 void removeParameter(String name)
          Remove any value associated with the given name.
 void setParameter(String name, String value)
          Set the value to be associated with the given name, replacing any previous association.
 void setPrimaryType(String primary)
          Set the primary type for this object to the given String.
 void setSubType(String sub)
          Set the sub type for this object to the given String.
 String toString()
          Return the String representation of this object.
 void writeExternal(ObjectOutput out)
          The object implements the writeExternal method to save its contents by calling the methods of DataOutput for its primitive values or calling the writeObject method of ObjectOutput for objects, strings and arrays.
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

MimeType

public MimeType()
Default constructor.


MimeType

public MimeType(String rawdata)
         throws MimeTypeParseException
Constructor that builds a MimeType from a String.

Parameters:
rawdata - the MIME type string

MimeType

public MimeType(String primary,
                String sub)
         throws MimeTypeParseException
Constructor that builds a MimeType with the given primary and sub type but has an empty parameter list.

Parameters:
primary - the primary MIME type
sub - the MIME sub-type
Method Detail

getPrimaryType

public String getPrimaryType()
Retrieve the primary type of this object.

Returns:
the primary MIME type

setPrimaryType

public void setPrimaryType(String primary)
                    throws MimeTypeParseException
Set the primary type for this object to the given String.

Parameters:
primary - the primary MIME type
Throws:
MimeTypeParseException

getSubType

public String getSubType()
Retrieve the sub type of this object.

Returns:
the MIME sub-type

setSubType

public void setSubType(String sub)
                throws MimeTypeParseException
Set the sub type for this object to the given String.

Parameters:
sub - the MIME sub-type
Throws:
MimeTypeParseException

getParameters

public MimeTypeParameterList getParameters()
Retrieve this object's parameter list.

Returns:
a MimeTypeParameterList object representing the parameters

getParameter

public String getParameter(String name)
Retrieve the value associated with the given name, or null if there is no current association.

Parameters:
name - the parameter name
Returns:
the paramter's value

setParameter

public void setParameter(String name,
                         String value)
Set the value to be associated with the given name, replacing any previous association.

Parameters:
name - the parameter name
value - the paramter's value

removeParameter

public void removeParameter(String name)
Remove any value associated with the given name.

Parameters:
name - the parameter name

toString

public String toString()
Return the String representation of this object.


getBaseType

public String getBaseType()
Return a String representation of this object without the parameter list.

Returns:
the MIME type and sub-type

match

public boolean match(MimeType type)
Determine if the primary and sub type of this object is the same as what is in the given type.

Parameters:
type - the MimeType object to compare with
Returns:
true if they match

match

public boolean match(String rawdata)
              throws MimeTypeParseException
Determine if the primary and sub type of this object is the same as the content type described in rawdata.

Parameters:
rawdata - the MIME type string to compare with
Returns:
true if they match
Throws:
MimeTypeParseException

writeExternal

public void writeExternal(ObjectOutput out)
                   throws IOException
The object implements the writeExternal method to save its contents by calling the methods of DataOutput for its primitive values or calling the writeObject method of ObjectOutput for objects, strings and arrays.

Specified by:
writeExternal in interface Externalizable
Parameters:
out - the ObjectOutput object to write to
Throws:
IOException - Includes any I/O exceptions that may occur

readExternal

public void readExternal(ObjectInput in)
                  throws IOException,
                         ClassNotFoundException
The object implements the readExternal method to restore its contents by calling the methods of DataInput for primitive types and readObject for objects, strings and arrays. The readExternal method must read the values in the same sequence and with the same types as were written by writeExternal.

Specified by:
readExternal in interface Externalizable
Parameters:
in - the IbjectInput object to read from
Throws:
ClassNotFoundException - If the class for an object being restored cannot be found.
IOException

JavaTM 2 Platform
Ent. Ed. v1.4

Submit a bug or feature

Copyright 2003 Sun Microsystems, Inc. All rights reserved.