org.apache.james.mime4j.message

Class MessageBuilder

java.lang.Object

org.apache.james.mime4j.message.MessageBuilder

All Implemented Interfaces:

ContentHandler

public class MessageBuilder
extends java.lang.Object
implements ContentHandler

A ContentHandler for building an Entity to be used in conjunction with a MimeStreamParser.

Constructor Summary

Constructors

Constructor and Description
MessageBuilder(Entity entity)
MessageBuilder(Entity entity, StorageProvider storageProvider)

Method Summary

Methods

Modifier and Type	Method and Description
void	body(BodyDescriptor bd, java.io.InputStream is) Called when the body of a discrete (non-multipart) entity is about to be parsed.
void	endBodyPart() Called when a body part ends.
void	endHeader() Called when there are no more header fields in a message or body part.
void	endMessage() Called when a message ends.
void	endMultipart() Called when the body of an entity has been parsed.
void	epilogue(java.io.InputStream is) Called for the epilogue (whatever comes after the final body part) of a multipart/* entity.
void	field(Field field) Called for each field of a header.
void	preamble(java.io.InputStream is) Called for the preamble (whatever comes before the first body part) of a multipart/* entity.
void	raw(java.io.InputStream is) Unsupported.
void	startBodyPart() Called when a new body part starts inside a multipart/* entity.
void	startHeader() Called when a header (of a message or body part) is about to be parsed.
void	startMessage() Called when a new message starts (a top level message or an embedded rfc822 message).
void	startMultipart(BodyDescriptor bd) Called when the body of a multipart entity is about to be parsed.

Methods inherited from class java.lang.Object

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

Constructor Detail

MessageBuilder

public MessageBuilder(Entity entity)

MessageBuilder

public MessageBuilder(Entity entity,
              StorageProvider storageProvider)

Method Detail

startMessage

public void startMessage()
                  throws MimeException

Description copied from interface: ContentHandler

Called when a new message starts (a top level message or an embedded rfc822 message).

Specified by:

startMessage in interface ContentHandler

Throws:

MimeException - on processing errors

See Also:

ContentHandler.startMessage()

endMessage

public void endMessage()
                throws MimeException

Description copied from interface: ContentHandler

Called when a message ends.

Specified by:

endMessage in interface ContentHandler

Throws:

MimeException - on processing errors

See Also:

ContentHandler.endMessage()

startHeader

public void startHeader()
                 throws MimeException

Description copied from interface: ContentHandler

Called when a header (of a message or body part) is about to be parsed.

Specified by:

startHeader in interface ContentHandler

Throws:

MimeException - on processing errors

See Also:

ContentHandler.startHeader()

field

public void field(Field field)
           throws MimeException

Description copied from interface: ContentHandler

Called for each field of a header.

Specified by:

field in interface ContentHandler

Parameters:

field - the MIME field.

Throws:

MimeException - on processing errors

See Also:

ContentHandler.field(Field)

endHeader

public void endHeader()
               throws MimeException

Description copied from interface: ContentHandler

Called when there are no more header fields in a message or body part.

Specified by:

endHeader in interface ContentHandler

Throws:

MimeException - on processing errors

See Also:

ContentHandler.endHeader()

startMultipart

public void startMultipart(BodyDescriptor bd)
                    throws MimeException

Description copied from interface: ContentHandler

Called when the body of a multipart entity is about to be parsed.

Specified by:

startMultipart in interface ContentHandler

Parameters:

bd - encapsulates the values (either read from the message stream or, if not present, determined implictly as described in the MIME rfc:s) of the Content-Type and Content-Transfer-Encoding header fields.

Throws:

MimeException - on processing errors

See Also:

ContentHandler.startMultipart(org.apache.james.mime4j.descriptor.BodyDescriptor)

body

public void body(BodyDescriptor bd,
        java.io.InputStream is)
          throws MimeException,
                 java.io.IOException

Description copied from interface: ContentHandler

Called when the body of a discrete (non-multipart) entity is about to be parsed.

Specified by:

body in interface ContentHandler

Parameters:

bd - see ContentHandler.startMultipart(BodyDescriptor)

is - the contents of the body. NOTE: this is the raw body contents - it will not be decoded if encoded. The bd parameter should be used to determine how the stream data should be decoded.

Throws:

MimeException - on processing errors

java.io.IOException - should be thrown on I/O errors.

See Also:

ContentHandler.body(org.apache.james.mime4j.descriptor.BodyDescriptor, java.io.InputStream)

endMultipart

public void endMultipart()
                  throws MimeException

Description copied from interface: ContentHandler

Called when the body of an entity has been parsed.

Specified by:

endMultipart in interface ContentHandler

Throws:

MimeException - on processing errors

See Also:

ContentHandler.endMultipart()

startBodyPart

public void startBodyPart()
                   throws MimeException

Description copied from interface: ContentHandler

Called when a new body part starts inside a multipart/* entity.

Specified by:

startBodyPart in interface ContentHandler

Throws:

MimeException - on processing errors

See Also:

ContentHandler.startBodyPart()

endBodyPart

public void endBodyPart()
                 throws MimeException

Description copied from interface: ContentHandler

Called when a body part ends.

Specified by:

endBodyPart in interface ContentHandler

Throws:

MimeException - on processing errors

See Also:

ContentHandler.endBodyPart()

epilogue

public void epilogue(java.io.InputStream is)
              throws MimeException,
                     java.io.IOException

Description copied from interface: ContentHandler

Called for the epilogue (whatever comes after the final body part) of a multipart/* entity.

Specified by:

epilogue in interface ContentHandler

Parameters:

is - used to get the contents of the epilogue.

Throws:

MimeException - on processing errors

java.io.IOException - should be thrown on I/O errors.

See Also:

ContentHandler.epilogue(java.io.InputStream)

preamble

public void preamble(java.io.InputStream is)
              throws MimeException,
                     java.io.IOException

Description copied from interface: ContentHandler

Called for the preamble (whatever comes before the first body part) of a multipart/* entity.

Specified by:

preamble in interface ContentHandler

Parameters:

is - used to get the contents of the preamble.

Throws:

MimeException - on processing errors

java.io.IOException - should be thrown on I/O errors.

See Also:

ContentHandler.preamble(java.io.InputStream)

raw

public void raw(java.io.InputStream is)
         throws MimeException,
                java.io.IOException

Unsupported.

Specified by:

raw in interface ContentHandler

Parameters:

is - the raw contents of the entity.

Throws:

MimeException - on processing errors

java.io.IOException - should be thrown on I/O errors.

See Also:

ContentHandler.raw(java.io.InputStream)