Class MIMEMessage

java.lang.Object

org.jvnet.mimepull.MIMEMessage

All Implemented Interfaces:

Closeable, AutoCloseable

public class MIMEMessage
extends Object
implements Closeable

Represents MIME message. MIME message parsing is done lazily using a pull parser.

Field Summary

Fields

Modifier and Type	Field	Description
(package private) MIMEConfig	config
private int	currentIndex
private MIMEPart	currentPart
private final InputStream	in
private final Iterator<MIMEEvent>	it
private static final Logger	LOGGER
private boolean	parsed
private final List<MIMEPart>	partsList
private final Map<String,MIMEPart>	partsMap

Constructor Summary

Constructors

Constructor	Description
MIMEMessage(InputStream in, String boundary)
MIMEMessage(InputStream in, String boundary, MIMEConfig config)	Creates a MIME message from the content's stream.

Method Summary

Modifier and Type	Method	Description
void	close()	Closes all parsed parts and cleans up any resources that are held by this MIMEMessage (for e.g.
private void	close(Collection<MIMEPart> parts)
List<MIMEPart>	getAttachments()	Gets all the attachments by parsing the entire MIME message.
private MIMEPart	getDecodedCidPart(String cid)
MIMEPart	getPart(int index)	Creates nth attachment lazily.
MIMEPart	getPart(String contentId)	Creates a lazy attachment for a given Content-ID.
boolean	makeProgress()	Parses the MIME message in a pull fashion.
final void	parseAll()	Parses the whole MIME message eagerly

Methods inherited from class Object

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

Field Details

LOGGER

private static final Logger LOGGER

config

MIMEConfig config

in

private final InputStream in

it

private final Iterator<MIMEEvent> it

parsed

private boolean parsed

currentPart

private MIMEPart currentPart

currentIndex

private int currentIndex

partsList

private final List<MIMEPart> partsList

partsMap

private final Map<String,MIMEPart> partsMap

Constructor Details

MIMEMessage

public MIMEMessage(InputStream in,
 String boundary)

Parameters:

in - MIME message stream

boundary - the separator for parts(pass it without --)

See Also:

• MIMEMessage(InputStream, String, MIMEConfig)

MIMEMessage

public MIMEMessage(InputStream in,
 String boundary,
 MIMEConfig config)

Creates a MIME message from the content's stream. The content stream is closed when EOF is reached.

Parameters:

in - MIME message stream

boundary - the separator for parts(pass it without --)

config - various configuration parameters

Method Details

getAttachments

public List<MIMEPart> getAttachments()

Gets all the attachments by parsing the entire MIME message. Avoid this if possible since it is an expensive operation.

Returns:

list of attachments.

getPart

public MIMEPart getPart(int index)

Creates nth attachment lazily. It doesn't validate if the message has so many attachments. To do the validation, the message needs to be parsed. The parsing of the message is done lazily and is done while reading the bytes of the part.

Parameters:

index - sequential order of the part. starts with zero.

Returns:

attachemnt part

getPart

public MIMEPart getPart(String contentId)

Creates a lazy attachment for a given Content-ID. It doesn't validate if the message contains an attachment with the given Content-ID. To do the validation, the message needs to be parsed. The parsing of the message is done lazily and is done while reading the bytes of the part.

Parameters:

contentId - Content-ID of the part, expects Content-ID without <, >

Returns:

attachemnt part

getDecodedCidPart

private MIMEPart getDecodedCidPart(String cid)

parseAll

public final void parseAll()

Parses the whole MIME message eagerly

close

public void close()

Closes all parsed parts and cleans up any resources that are held by this MIMEMessage (for e.g. deletes temp files). This method is safe to call even if parsing of message failed.

Does not throw MIMEParsingException if an error occurred during closing a MIME part. The exception (if any) is still logged.

Specified by:

close in interface AutoCloseable

Specified by:

close in interface Closeable

close

private void close(Collection<MIMEPart> parts)

makeProgress

public boolean makeProgress()

Parses the MIME message in a pull fashion.

Returns:

false if the parsing is completed.