org.ws4d.java.communication.protocol.mime

Class MIMEUtil

java.lang.Object

org.ws4d.java.communication.protocol.mime.MIMEUtil

public class MIMEUtil
extends java.lang.Object

Utility class for MIME handling.

Field Summary

Fields

Modifier and Type	Field and Description
static int	DEFAULT_MIME_BUFFER
protected static java.lang.String	FAULT_MALFORMED_HEADERFIELD
protected static java.lang.String	FAULT_NOT_FINISHED
protected static java.lang.String	FAULT_UNEXPECTED_END

Constructor Summary

Constructors

Constructor and Description
MIMEUtil()

Method Summary

Modifier and Type	Method and Description
static java.lang.String	contentToFileExtension(java.lang.String mimeType) Returns a file extension that is most likely with given Content-Type
static java.lang.String	contentToFileExtension(java.lang.String mediatype, java.lang.String subtype) Returns a file extension that is most likely with given Content-Type
static ContentType	createContentType(java.lang.String mimeType) Create a new media type object from the information given.
static ContentType	estimateContentType(java.lang.String filename) Gets estimated Content-Type via filename.
static ContentType	extensionContentType(java.lang.String fileExt) Gets Content-Type via file extension.
static java.lang.String	getMimeType(ContentType contentType) Returns the complete media type.
static java.lang.String	getMimeTypeWithParameters(ContentType contentType) Returns a string representation of this media type.
static boolean	readBoundary(java.io.InputStream in, byte[] boundary) Reads the boundary string.
static void	readHeaderFields(java.io.InputStream in, HashMap headerfields) Reads MIME header fields from the input stream.
static void	serializeAttachment(java.io.OutputStream out, IncomingAttachment attachment)
static void	writeBoundary(java.io.OutputStream out, byte[] boundary, boolean crlf, boolean last) Writes a MIME boundary.
static void	writeHeaderFields(java.io.OutputStream out, HashMap headerfields) Writes MIME header fields to the output stream.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

FAULT_UNEXPECTED_END

protected static final java.lang.String FAULT_UNEXPECTED_END

See Also:

Constant Field Values

FAULT_MALFORMED_HEADERFIELD

protected static final java.lang.String FAULT_MALFORMED_HEADERFIELD

See Also:

Constant Field Values

FAULT_NOT_FINISHED

protected static final java.lang.String FAULT_NOT_FINISHED

See Also:

Constant Field Values

DEFAULT_MIME_BUFFER

public static final int DEFAULT_MIME_BUFFER

See Also:

Constant Field Values

Constructor Detail

MIMEUtil

public MIMEUtil()

Method Detail

readBoundary

public static boolean readBoundary(java.io.InputStream in,
                                   byte[] boundary)
                            throws java.io.IOException

Reads the boundary string.

Parameters:

in - input stream to read from.

boundary - the given boundary information.

Returns:

the read element.

Throws:

java.io.IOException

writeBoundary

public static void writeBoundary(java.io.OutputStream out,
                                 byte[] boundary,
                                 boolean crlf,
                                 boolean last)
                          throws java.io.IOException

Writes a MIME boundary.

Parameters:

out -

boundary -

crlf -

last -

Throws:

java.io.IOException

serializeAttachment

public static void serializeAttachment(java.io.OutputStream out,
                                       IncomingAttachment attachment)
                                throws java.io.IOException,
                                       AttachmentException

Throws:

java.io.IOException

AttachmentException

writeHeaderFields

public static void writeHeaderFields(java.io.OutputStream out,
                                     HashMap headerfields)
                              throws java.io.IOException

Writes MIME header fields to the output stream.

Parameters:

out -

headerfields -

Throws:

java.io.IOException

readHeaderFields

public static void readHeaderFields(java.io.InputStream in,
                                    HashMap headerfields)
                             throws java.io.IOException,
                                    ProtocolException

Reads MIME header fields from the input stream. To learn more about MIME header fields, take a look at RFC2045 3.

Parameters:

in - the input stream to read from.

headerfields - Hashtable to store the fields in.

Throws:

java.io.IOException

ProtocolException

estimateContentType

public static ContentType estimateContentType(java.lang.String filename)

Gets estimated Content-Type via filename.

Parameters:

filename - fileName with extension.

Returns:

Content-Type estimated Content-Type based on the file extension.

contentToFileExtension

public static java.lang.String contentToFileExtension(java.lang.String mimeType)

Returns a file extension that is most likely with given Content-Type

Parameters:

mimeType - MIME Type

Returns:

File extension (e.g. "png"), null if Content- Type is unknown

contentToFileExtension

public static java.lang.String contentToFileExtension(java.lang.String mediatype,
                                                      java.lang.String subtype)

Returns a file extension that is most likely with given Content-Type

Parameters:

mediatype -

subtype -

Returns:

File extension (e.g. "png"), null if Content- Type is unknown

extensionContentType

public static ContentType extensionContentType(java.lang.String fileExt)

Gets Content-Type via file extension.

Parameters:

fileExt - file extension.

Returns:

Content-Type (type and subtype).

getMimeType

public static java.lang.String getMimeType(ContentType contentType)

Returns the complete media type.

Returns:

the media type, e.g.\ "application/xml" for media type "application/xml"

getMimeTypeWithParameters

public static java.lang.String getMimeTypeWithParameters(ContentType contentType)

Returns a string representation of this media type.

createContentType

public static ContentType createContentType(java.lang.String mimeType)

Create a new media type object from the information given.

Parameters:

mimeType - the string describing the media type.