javax.activation

Class MimeType

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(String rawdata)
Returns true if the primary and subtype of this MIME type are the same as in the given MIME type string.
boolean
match(MimeType type)
Returns true if the primary and subtype of this MIME type are the same as in the given MIME type.
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, extends Object> getClass, finalize, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

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

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

Method Details

getBaseType

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

getParameter

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

getParameters

public MimeTypeParameterList getParameters()
Returns the MIME parameters.

getPrimaryType

public String getPrimaryType()
Returns the primary type.

getSubType

public String getSubType()
Returns the subtype.

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.

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.

readExternal

public void readExternal(ObjectInput in)
            throws IOException,
                   ClassNotFoundException
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:
ClassNotFoundException - If the class of an object being restored cannot be found
IOException - If any other error occurs

removeParameter

public void removeParameter(String name)
Removes 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

setPrimaryType

public void setPrimaryType(String primary)
            throws MimeTypeParseException
Sets the primary type.
Parameters:
primary - the new primary type

setSubType

public void setSubType(String sub)
            throws MimeTypeParseException
Sets the subtype.
Parameters:
sub - the new subtype

toString

public String toString()
Returns the complete string representation of this MIME type.
Overrides:
toString in interface Object

writeExternal

public void writeExternal(ObjectOutput out)
            throws IOException
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

MimeType.java -- A MIME type as defined in RFC2046 and RFC2047. Copyright (C) 2004 Free Software Foundation, Inc. This file is part of GNU Classpath. GNU Classpath is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2, or (at your option) any later version. GNU Classpath is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details. You should have received a copy of the GNU General Public License along with GNU Classpath; see the file COPYING. If not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA. Linking this library statically or dynamically with other modules is making a combined work based on this library. Thus, the terms and conditions of the GNU General Public License cover the whole combination. As a special exception, the copyright holders of this library give you permission to link this library with independent modules to produce an executable, regardless of the license terms of these independent modules, and to copy and distribute the resulting executable under terms of your choice, provided that you also meet, for each linked independent module, the terms and conditions of the license of that module. An independent module is a module which is not derived from or based on this library. If you modify this library, you may extend this exception to your version of the library, but you are not obligated to do so. If you do not wish to do so, delete this exception statement from your version.