Package org.jvnet.mimepull
Class MIMEPart
java.lang.Object
org.jvnet.mimepull.MIMEPart
- All Implemented Interfaces:
Closeable
,AutoCloseable
Represents an attachment part in a MIME message. MIME message parsing is done
lazily using a pull parser, so the part may not have all the data.
read()
and readOnce()
may trigger the actual parsing the message. In fact,
parsing of an attachment part may be triggered by calling read()
methods
on some other attachment parts. All this happens behind the scenes so the
application developer need not worry about these details.- Author:
- Jitendra Kotamraju, Martin Grebac
-
Method Summary
Modifier and TypeMethodDescriptionvoid
close()
Cleans up any resources that are held by this part (for e.g.Return all the headersReturns Content-ID MIME header for this attachment partReturns Content-Transfer-Encoding MIME header for this attachment partReturns Content-Type MIME header for this attachment partReturn all the values for the specified header.boolean
isClosed()
Returntrue
if this part has already been closed,false
otherwise.void
Send the content to the Fileread()
Can get the attachment part's content multiple times.readOnce()
Can get the attachment part's content only once.toString()
-
Method Details
-
read
Can get the attachment part's content multiple times. That means the full content needs to be there in memory or on the file system. Calling this method would trigger parsing for the part's data. So do not call this unless it is required(otherwise, just wrap MIMEPart into a object that returns InputStream for e.g DataHandler)- Returns:
- data for the part's content
-
close
public void close()Cleans up any resources that are held by this part (for e.g. deletes the temp file that is used to serve this part's content). After calling this, one shouldn't callread()
orreadOnce()
- Specified by:
close
in interfaceAutoCloseable
- Specified by:
close
in interfaceCloseable
-
readOnce
Can get the attachment part's content only once. The content will be lost after the method. Content data is not be stored on the file system or is not kept in the memory for the following case: - Attachement parts contents are accessed sequentially In general, take advantage of this when the data is used only once.- Returns:
- data for the part's content
-
moveTo
Send the content to the File- Parameters:
f
- file to store the content
-
getContentId
Returns Content-ID MIME header for this attachment part- Returns:
- Content-ID of the part
-
getContentTransferEncoding
Returns Content-Transfer-Encoding MIME header for this attachment part- Returns:
- Content-Transfer-Encoding of the part
-
getContentType
Returns Content-Type MIME header for this attachment part- Returns:
- Content-Type of the part
-
getHeader
Return all the values for the specified header. Returnsnull
if no headers with the specified name exist.- Parameters:
name
- header name- Returns:
- list of header values, or null if none
-
getAllHeaders
Return all the headers- Returns:
- list of Header objects
-
isClosed
public boolean isClosed()Returntrue
if this part has already been closed,false
otherwise.- Returns:
true
if this part has already been closed,false
otherwise.
-
toString
-