Subversion Repositories javautils

Rev

Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
7 daniel-mar 1
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
2
<!--NewPage-->
3
<HTML>
4
<HEAD>
5
<!-- Generated by javadoc (build 1.6.0_10) on Tue Nov 17 12:13:39 PST 2009 -->
6
<META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
7
<TITLE>
8
MimeBodyPart (JavaMail API documentation)
9
</TITLE>
10
 
11
<META NAME="date" CONTENT="2009-11-17">
12
 
13
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style">
14
 
15
<SCRIPT type="text/javascript">
16
function windowTitle()
17
{
18
    if (location.href.indexOf('is-external=true') == -1) {
19
        parent.document.title="MimeBodyPart (JavaMail API documentation)";
20
    }
21
}
22
</SCRIPT>
23
<NOSCRIPT>
24
</NOSCRIPT>
25
 
26
</HEAD>
27
 
28
<BODY BGCOLOR="white" onload="windowTitle();">
29
<HR>
30
 
31
 
32
<!-- ========= START OF TOP NAVBAR ======= -->
33
<A NAME="navbar_top"><!-- --></A>
34
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
35
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
36
<TR>
37
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
38
<A NAME="navbar_top_firstrow"><!-- --></A>
39
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
40
  <TR ALIGN="center" VALIGN="top">
41
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
42
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
43
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
44
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/MimeBodyPart.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
45
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
46
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
47
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
48
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
49
  </TR>
50
</TABLE>
51
</TD>
52
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
53
</EM>
54
</TD>
55
</TR>
56
 
57
<TR>
58
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
59
&nbsp;<A HREF="../../../javax/mail/internet/MailDateFormat.html" title="class in javax.mail.internet"><B>PREV CLASS</B></A>&nbsp;
60
&nbsp;<A HREF="../../../javax/mail/internet/MimeMessage.html" title="class in javax.mail.internet"><B>NEXT CLASS</B></A></FONT></TD>
61
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
62
  <A HREF="../../../index.html?javax/mail/internet/MimeBodyPart.html" target="_top"><B>FRAMES</B></A>  &nbsp;
63
&nbsp;<A HREF="MimeBodyPart.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
64
&nbsp;<SCRIPT type="text/javascript">
65
  <!--
66
  if(window==top) {
67
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
68
  }
69
  //-->
70
</SCRIPT>
71
<NOSCRIPT>
72
  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
73
</NOSCRIPT>
74
 
75
 
76
</FONT></TD>
77
</TR>
78
<TR>
79
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
80
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
81
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
82
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
83
</TR>
84
</TABLE>
85
<A NAME="skip-navbar_top"></A>
86
<!-- ========= END OF TOP NAVBAR ========= -->
87
 
88
<HR>
89
<!-- ======== START OF CLASS DATA ======== -->
90
<H2>
91
<FONT SIZE="-1">
92
javax.mail.internet</FONT>
93
<BR>
94
Class MimeBodyPart</H2>
95
<PRE>
96
<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">java.lang.Object</A>
97
  <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><A HREF="../../../javax/mail/BodyPart.html" title="class in javax.mail">javax.mail.BodyPart</A>
98
      <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>javax.mail.internet.MimeBodyPart</B>
99
</PRE>
100
<DL>
101
<DT><B>All Implemented Interfaces:</B> <DD><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A>, <A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></DD>
102
</DL>
103
<DL>
104
<DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../javax/mail/internet/PreencodedMimeBodyPart.html" title="class in javax.mail.internet">PreencodedMimeBodyPart</A></DD>
105
</DL>
106
<HR>
107
<DL>
108
<DT><PRE>public class <B>MimeBodyPart</B><DT>extends <A HREF="../../../javax/mail/BodyPart.html" title="class in javax.mail">BodyPart</A><DT>implements <A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></DL>
109
</PRE>
110
 
111
<P>
112
This class represents a MIME body part. It implements the
113
 <code>BodyPart</code> abstract class and the <code>MimePart</code>
114
 interface. MimeBodyParts are contained in <code>MimeMultipart</code>
115
 objects. <p>
116
 
117
 MimeBodyPart uses the <code>InternetHeaders</code> class to parse
118
 and store the headers of that body part. <p>
119
 
120
 <hr><strong>A note on RFC 822 and MIME headers</strong><p>
121
 
122
 RFC 822 header fields <strong>must</strong> contain only
123
 US-ASCII characters. MIME allows non ASCII characters to be present
124
 in certain portions of certain headers, by encoding those characters.
125
 RFC 2047 specifies the rules for doing this. The MimeUtility
126
 class provided in this package can be used to to achieve this.
127
 Callers of the <code>setHeader</code>, <code>addHeader</code>, and
128
 <code>addHeaderLine</code> methods are responsible for enforcing
129
 the MIME requirements for the specified headers.  In addition, these
130
 header fields must be folded (wrapped) before being sent if they
131
 exceed the line length limitation for the transport (1000 bytes for
132
 SMTP).  Received headers may have been folded.  The application is
133
 responsible for folding and unfolding headers as appropriate. <p>
134
<P>
135
 
136
<P>
137
<DL>
138
<DT><B>See Also:</B><DD><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail"><CODE>Part</CODE></A>,
139
<A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet"><CODE>MimePart</CODE></A>,
140
<A HREF="../../../javax/mail/internet/MimeUtility.html" title="class in javax.mail.internet"><CODE>MimeUtility</CODE></A></DL>
141
<HR>
142
 
143
<P>
144
<!-- =========== FIELD SUMMARY =========== -->
145
 
146
<A NAME="field_summary"><!-- --></A>
147
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
148
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
149
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
150
<B>Field Summary</B></FONT></TH>
151
</TR>
152
<TR BGCOLOR="white" CLASS="TableRowColor">
153
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
154
<CODE>protected &nbsp;byte[]</CODE></FONT></TD>
155
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#content">content</A></B></CODE>
156
 
157
<BR>
158
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Byte array that holds the bytes of the content of this Part.</TD>
159
</TR>
160
<TR BGCOLOR="white" CLASS="TableRowColor">
161
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
162
<CODE>protected &nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</A></CODE></FONT></TD>
163
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#contentStream">contentStream</A></B></CODE>
164
 
165
<BR>
166
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;If the data for this body part was supplied by an
167
 InputStream that implements the SharedInputStream interface,
168
 <code>contentStream</code> is another such stream representing
169
 the content of this body part.</TD>
170
</TR>
171
<TR BGCOLOR="white" CLASS="TableRowColor">
172
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
173
<CODE>protected &nbsp;<A HREF="http://java.sun.com/javase/technologies/desktop/javabeans/glasgow/javadocs/javax/activation/DataHandler.html?is-external=true" title="class or interface in javax.activation">DataHandler</A></CODE></FONT></TD>
174
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#dh">dh</A></B></CODE>
175
 
176
<BR>
177
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The DataHandler object representing this Part's content.</TD>
178
</TR>
179
<TR BGCOLOR="white" CLASS="TableRowColor">
180
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
181
<CODE>protected &nbsp;<A HREF="../../../javax/mail/internet/InternetHeaders.html" title="class in javax.mail.internet">InternetHeaders</A></CODE></FONT></TD>
182
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#headers">headers</A></B></CODE>
183
 
184
<BR>
185
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;The InternetHeaders object that stores all the headers
186
 of this body part.</TD>
187
</TR>
188
</TABLE>
189
&nbsp;<A NAME="fields_inherited_from_class_javax.mail.BodyPart"><!-- --></A>
190
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
191
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
192
<TH ALIGN="left"><B>Fields inherited from class javax.mail.<A HREF="../../../javax/mail/BodyPart.html" title="class in javax.mail">BodyPart</A></B></TH>
193
</TR>
194
<TR BGCOLOR="white" CLASS="TableRowColor">
195
<TD><CODE><A HREF="../../../javax/mail/BodyPart.html#parent">parent</A></CODE></TD>
196
</TR>
197
</TABLE>
198
&nbsp;<A NAME="fields_inherited_from_class_javax.mail.Part"><!-- --></A>
199
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
200
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
201
<TH ALIGN="left"><B>Fields inherited from interface javax.mail.<A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></B></TH>
202
</TR>
203
<TR BGCOLOR="white" CLASS="TableRowColor">
204
<TD><CODE><A HREF="../../../javax/mail/Part.html#ATTACHMENT">ATTACHMENT</A>, <A HREF="../../../javax/mail/Part.html#INLINE">INLINE</A></CODE></TD>
205
</TR>
206
</TABLE>
207
&nbsp;
208
<!-- ======== CONSTRUCTOR SUMMARY ======== -->
209
 
210
<A NAME="constructor_summary"><!-- --></A>
211
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
212
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
213
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
214
<B>Constructor Summary</B></FONT></TH>
215
</TR>
216
<TR BGCOLOR="white" CLASS="TableRowColor">
217
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#MimeBodyPart()">MimeBodyPart</A></B>()</CODE>
218
 
219
<BR>
220
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;An empty MimeBodyPart object is created.</TD>
221
</TR>
222
<TR BGCOLOR="white" CLASS="TableRowColor">
223
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#MimeBodyPart(java.io.InputStream)">MimeBodyPart</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</A>&nbsp;is)</CODE>
224
 
225
<BR>
226
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Constructs a MimeBodyPart by reading and parsing the data from
227
 the specified input stream.</TD>
228
</TR>
229
<TR BGCOLOR="white" CLASS="TableRowColor">
230
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#MimeBodyPart(javax.mail.internet.InternetHeaders, byte[])">MimeBodyPart</A></B>(<A HREF="../../../javax/mail/internet/InternetHeaders.html" title="class in javax.mail.internet">InternetHeaders</A>&nbsp;headers,
231
             byte[]&nbsp;content)</CODE>
232
 
233
<BR>
234
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Constructs a MimeBodyPart using the given header and
235
 content bytes.</TD>
236
</TR>
237
</TABLE>
238
&nbsp;
239
<!-- ========== METHOD SUMMARY =========== -->
240
 
241
<A NAME="method_summary"><!-- --></A>
242
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
243
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
244
<TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
245
<B>Method Summary</B></FONT></TH>
246
</TR>
247
<TR BGCOLOR="white" CLASS="TableRowColor">
248
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
249
<CODE>&nbsp;void</CODE></FONT></TD>
250
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#addHeader(java.lang.String, java.lang.String)">addHeader</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name,
251
          <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;value)</CODE>
252
 
253
<BR>
254
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Add this value to the existing values for this header_name.</TD>
255
</TR>
256
<TR BGCOLOR="white" CLASS="TableRowColor">
257
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
258
<CODE>&nbsp;void</CODE></FONT></TD>
259
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#addHeaderLine(java.lang.String)">addHeaderLine</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;line)</CODE>
260
 
261
<BR>
262
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Add a header line to this body part</TD>
263
</TR>
264
<TR BGCOLOR="white" CLASS="TableRowColor">
265
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
266
<CODE>&nbsp;void</CODE></FONT></TD>
267
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#attachFile(java.io.File)">attachFile</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io">File</A>&nbsp;file)</CODE>
268
 
269
<BR>
270
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Use the specified file to provide the data for this part.</TD>
271
</TR>
272
<TR BGCOLOR="white" CLASS="TableRowColor">
273
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
274
<CODE>&nbsp;void</CODE></FONT></TD>
275
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#attachFile(java.lang.String)">attachFile</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;file)</CODE>
276
 
277
<BR>
278
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Use the specified file to provide the data for this part.</TD>
279
</TR>
280
<TR BGCOLOR="white" CLASS="TableRowColor">
281
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
282
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A></CODE></FONT></TD>
283
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getAllHeaderLines()">getAllHeaderLines</A></B>()</CODE>
284
 
285
<BR>
286
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get all header lines as an Enumeration of Strings.</TD>
287
</TR>
288
<TR BGCOLOR="white" CLASS="TableRowColor">
289
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
290
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A></CODE></FONT></TD>
291
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getAllHeaders()">getAllHeaders</A></B>()</CODE>
292
 
293
<BR>
294
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return all the headers from this Message as an Enumeration of
295
 Header objects.</TD>
296
</TR>
297
<TR BGCOLOR="white" CLASS="TableRowColor">
298
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
299
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></CODE></FONT></TD>
300
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getContent()">getContent</A></B>()</CODE>
301
 
302
<BR>
303
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the content as a Java object.</TD>
304
</TR>
305
<TR BGCOLOR="white" CLASS="TableRowColor">
306
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
307
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
308
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getContentID()">getContentID</A></B>()</CODE>
309
 
310
<BR>
311
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the value of the "Content-ID" header field.</TD>
312
</TR>
313
<TR BGCOLOR="white" CLASS="TableRowColor">
314
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
315
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[]</CODE></FONT></TD>
316
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getContentLanguage()">getContentLanguage</A></B>()</CODE>
317
 
318
<BR>
319
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the languages specified in the Content-Language header
320
 of this MimePart.</TD>
321
</TR>
322
<TR BGCOLOR="white" CLASS="TableRowColor">
323
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
324
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
325
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getContentMD5()">getContentMD5</A></B>()</CODE>
326
 
327
<BR>
328
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the value of the "Content-MD5" header field.</TD>
329
</TR>
330
<TR BGCOLOR="white" CLASS="TableRowColor">
331
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
332
<CODE>protected &nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</A></CODE></FONT></TD>
333
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getContentStream()">getContentStream</A></B>()</CODE>
334
 
335
<BR>
336
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Produce the raw bytes of the content.</TD>
337
</TR>
338
<TR BGCOLOR="white" CLASS="TableRowColor">
339
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
340
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
341
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getContentType()">getContentType</A></B>()</CODE>
342
 
343
<BR>
344
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the value of the RFC 822 "Content-Type" header field.</TD>
345
</TR>
346
<TR BGCOLOR="white" CLASS="TableRowColor">
347
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
348
<CODE>&nbsp;<A HREF="http://java.sun.com/javase/technologies/desktop/javabeans/glasgow/javadocs/javax/activation/DataHandler.html?is-external=true" title="class or interface in javax.activation">DataHandler</A></CODE></FONT></TD>
349
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getDataHandler()">getDataHandler</A></B>()</CODE>
350
 
351
<BR>
352
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return a DataHandler for this body part's content.</TD>
353
</TR>
354
<TR BGCOLOR="white" CLASS="TableRowColor">
355
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
356
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
357
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getDescription()">getDescription</A></B>()</CODE>
358
 
359
<BR>
360
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the "Content-Description" header field of this body part.</TD>
361
</TR>
362
<TR BGCOLOR="white" CLASS="TableRowColor">
363
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
364
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
365
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getDisposition()">getDisposition</A></B>()</CODE>
366
 
367
<BR>
368
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the value of the "Content-Disposition" header field.</TD>
369
</TR>
370
<TR BGCOLOR="white" CLASS="TableRowColor">
371
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
372
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
373
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getEncoding()">getEncoding</A></B>()</CODE>
374
 
375
<BR>
376
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns the content transfer encoding from the
377
 "Content-Transfer-Encoding" header
378
 field.</TD>
379
</TR>
380
<TR BGCOLOR="white" CLASS="TableRowColor">
381
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
382
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
383
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getFileName()">getFileName</A></B>()</CODE>
384
 
385
<BR>
386
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get the filename associated with this body part.</TD>
387
</TR>
388
<TR BGCOLOR="white" CLASS="TableRowColor">
389
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
390
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[]</CODE></FONT></TD>
391
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getHeader(java.lang.String)">getHeader</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name)</CODE>
392
 
393
<BR>
394
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get all the headers for this header_name.</TD>
395
</TR>
396
<TR BGCOLOR="white" CLASS="TableRowColor">
397
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
398
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A></CODE></FONT></TD>
399
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getHeader(java.lang.String, java.lang.String)">getHeader</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name,
400
          <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;delimiter)</CODE>
401
 
402
<BR>
403
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get all the headers for this header name, returned as a single
404
 String, with headers separated by the delimiter.</TD>
405
</TR>
406
<TR BGCOLOR="white" CLASS="TableRowColor">
407
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
408
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</A></CODE></FONT></TD>
409
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getInputStream()">getInputStream</A></B>()</CODE>
410
 
411
<BR>
412
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return a decoded input stream for this body part's "content".</TD>
413
</TR>
414
<TR BGCOLOR="white" CLASS="TableRowColor">
415
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
416
<CODE>&nbsp;int</CODE></FONT></TD>
417
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getLineCount()">getLineCount</A></B>()</CODE>
418
 
419
<BR>
420
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the number of lines for the content of this Part.</TD>
421
</TR>
422
<TR BGCOLOR="white" CLASS="TableRowColor">
423
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
424
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A></CODE></FONT></TD>
425
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getMatchingHeaderLines(java.lang.String[])">getMatchingHeaderLines</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[]&nbsp;names)</CODE>
426
 
427
<BR>
428
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get matching header lines as an Enumeration of Strings.</TD>
429
</TR>
430
<TR BGCOLOR="white" CLASS="TableRowColor">
431
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
432
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A></CODE></FONT></TD>
433
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getMatchingHeaders(java.lang.String[])">getMatchingHeaders</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[]&nbsp;names)</CODE>
434
 
435
<BR>
436
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return matching headers from this Message as an Enumeration of
437
 Header objects.</TD>
438
</TR>
439
<TR BGCOLOR="white" CLASS="TableRowColor">
440
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
441
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A></CODE></FONT></TD>
442
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getNonMatchingHeaderLines(java.lang.String[])">getNonMatchingHeaderLines</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[]&nbsp;names)</CODE>
443
 
444
<BR>
445
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Get non-matching header lines as an Enumeration of Strings.</TD>
446
</TR>
447
<TR BGCOLOR="white" CLASS="TableRowColor">
448
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
449
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A></CODE></FONT></TD>
450
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getNonMatchingHeaders(java.lang.String[])">getNonMatchingHeaders</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[]&nbsp;names)</CODE>
451
 
452
<BR>
453
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return non-matching headers from this Message as an
454
 Enumeration of Header objects.</TD>
455
</TR>
456
<TR BGCOLOR="white" CLASS="TableRowColor">
457
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
458
<CODE>&nbsp;<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</A></CODE></FONT></TD>
459
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getRawInputStream()">getRawInputStream</A></B>()</CODE>
460
 
461
<BR>
462
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return an InputStream to the raw data with any Content-Transfer-Encoding
463
 intact.</TD>
464
</TR>
465
<TR BGCOLOR="white" CLASS="TableRowColor">
466
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
467
<CODE>&nbsp;int</CODE></FONT></TD>
468
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getSize()">getSize</A></B>()</CODE>
469
 
470
<BR>
471
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Return the size of the content of this body part in bytes.</TD>
472
</TR>
473
<TR BGCOLOR="white" CLASS="TableRowColor">
474
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
475
<CODE>&nbsp;boolean</CODE></FONT></TD>
476
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#isMimeType(java.lang.String)">isMimeType</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;mimeType)</CODE>
477
 
478
<BR>
479
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Is this Part of the specified MIME type?  This method
480
 compares <strong>only the <code>primaryType</code> and
481
 <code>subType</code></strong>.</TD>
482
</TR>
483
<TR BGCOLOR="white" CLASS="TableRowColor">
484
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
485
<CODE>&nbsp;void</CODE></FONT></TD>
486
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#removeHeader(java.lang.String)">removeHeader</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name)</CODE>
487
 
488
<BR>
489
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Remove all headers with this name.</TD>
490
</TR>
491
<TR BGCOLOR="white" CLASS="TableRowColor">
492
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
493
<CODE>&nbsp;void</CODE></FONT></TD>
494
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#saveFile(java.io.File)">saveFile</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io">File</A>&nbsp;file)</CODE>
495
 
496
<BR>
497
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Save the contents of this part in the specified file.</TD>
498
</TR>
499
<TR BGCOLOR="white" CLASS="TableRowColor">
500
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
501
<CODE>&nbsp;void</CODE></FONT></TD>
502
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#saveFile(java.lang.String)">saveFile</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;file)</CODE>
503
 
504
<BR>
505
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Save the contents of this part in the specified file.</TD>
506
</TR>
507
<TR BGCOLOR="white" CLASS="TableRowColor">
508
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
509
<CODE>&nbsp;void</CODE></FONT></TD>
510
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setContent(javax.mail.Multipart)">setContent</A></B>(<A HREF="../../../javax/mail/Multipart.html" title="class in javax.mail">Multipart</A>&nbsp;mp)</CODE>
511
 
512
<BR>
513
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This method sets the body part's content to a Multipart object.</TD>
514
</TR>
515
<TR BGCOLOR="white" CLASS="TableRowColor">
516
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
517
<CODE>&nbsp;void</CODE></FONT></TD>
518
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setContent(java.lang.Object, java.lang.String)">setContent</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;o,
519
           <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;type)</CODE>
520
 
521
<BR>
522
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;A convenience method for setting this body part's content.</TD>
523
</TR>
524
<TR BGCOLOR="white" CLASS="TableRowColor">
525
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
526
<CODE>&nbsp;void</CODE></FONT></TD>
527
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setContentID(java.lang.String)">setContentID</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;cid)</CODE>
528
 
529
<BR>
530
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the "Content-ID" header field of this body part.</TD>
531
</TR>
532
<TR BGCOLOR="white" CLASS="TableRowColor">
533
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
534
<CODE>&nbsp;void</CODE></FONT></TD>
535
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setContentLanguage(java.lang.String[])">setContentLanguage</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[]&nbsp;languages)</CODE>
536
 
537
<BR>
538
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the Content-Language header of this MimePart.</TD>
539
</TR>
540
<TR BGCOLOR="white" CLASS="TableRowColor">
541
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
542
<CODE>&nbsp;void</CODE></FONT></TD>
543
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setContentMD5(java.lang.String)">setContentMD5</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;md5)</CODE>
544
 
545
<BR>
546
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the "Content-MD5" header field of this body part.</TD>
547
</TR>
548
<TR BGCOLOR="white" CLASS="TableRowColor">
549
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
550
<CODE>&nbsp;void</CODE></FONT></TD>
551
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setDataHandler(javax.activation.DataHandler)">setDataHandler</A></B>(<A HREF="http://java.sun.com/javase/technologies/desktop/javabeans/glasgow/javadocs/javax/activation/DataHandler.html?is-external=true" title="class or interface in javax.activation">DataHandler</A>&nbsp;dh)</CODE>
552
 
553
<BR>
554
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;This method provides the mechanism to set this body part's content.</TD>
555
</TR>
556
<TR BGCOLOR="white" CLASS="TableRowColor">
557
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
558
<CODE>&nbsp;void</CODE></FONT></TD>
559
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setDescription(java.lang.String)">setDescription</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;description)</CODE>
560
 
561
<BR>
562
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the "Content-Description" header field for this body part.</TD>
563
</TR>
564
<TR BGCOLOR="white" CLASS="TableRowColor">
565
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
566
<CODE>&nbsp;void</CODE></FONT></TD>
567
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setDescription(java.lang.String, java.lang.String)">setDescription</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;description,
568
               <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;charset)</CODE>
569
 
570
<BR>
571
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the "Content-Description" header field for this body part.</TD>
572
</TR>
573
<TR BGCOLOR="white" CLASS="TableRowColor">
574
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
575
<CODE>&nbsp;void</CODE></FONT></TD>
576
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setDisposition(java.lang.String)">setDisposition</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;disposition)</CODE>
577
 
578
<BR>
579
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the "Content-Disposition" header field of this body part.</TD>
580
</TR>
581
<TR BGCOLOR="white" CLASS="TableRowColor">
582
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
583
<CODE>&nbsp;void</CODE></FONT></TD>
584
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setFileName(java.lang.String)">setFileName</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;filename)</CODE>
585
 
586
<BR>
587
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the filename associated with this body part, if possible.</TD>
588
</TR>
589
<TR BGCOLOR="white" CLASS="TableRowColor">
590
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
591
<CODE>&nbsp;void</CODE></FONT></TD>
592
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setHeader(java.lang.String, java.lang.String)">setHeader</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name,
593
          <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;value)</CODE>
594
 
595
<BR>
596
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Set the value for this header_name.</TD>
597
</TR>
598
<TR BGCOLOR="white" CLASS="TableRowColor">
599
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
600
<CODE>&nbsp;void</CODE></FONT></TD>
601
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setText(java.lang.String)">setText</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;text)</CODE>
602
 
603
<BR>
604
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Convenience method that sets the given String as this
605
 part's content, with a MIME type of "text/plain".</TD>
606
</TR>
607
<TR BGCOLOR="white" CLASS="TableRowColor">
608
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
609
<CODE>&nbsp;void</CODE></FONT></TD>
610
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setText(java.lang.String, java.lang.String)">setText</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;text,
611
        <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;charset)</CODE>
612
 
613
<BR>
614
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Convenience method that sets the given String as this part's
615
 content, with a MIME type of "text/plain" and the specified
616
 charset.</TD>
617
</TR>
618
<TR BGCOLOR="white" CLASS="TableRowColor">
619
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
620
<CODE>&nbsp;void</CODE></FONT></TD>
621
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setText(java.lang.String, java.lang.String, java.lang.String)">setText</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;text,
622
        <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;charset,
623
        <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;subtype)</CODE>
624
 
625
<BR>
626
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Convenience method that sets the given String as this part's
627
 content, with a primary MIME type of "text" and the specified
628
 MIME subtype.</TD>
629
</TR>
630
<TR BGCOLOR="white" CLASS="TableRowColor">
631
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
632
<CODE>protected &nbsp;void</CODE></FONT></TD>
633
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#updateHeaders()">updateHeaders</A></B>()</CODE>
634
 
635
<BR>
636
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Examine the content of this body part and update the appropriate
637
 MIME headers.</TD>
638
</TR>
639
<TR BGCOLOR="white" CLASS="TableRowColor">
640
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
641
<CODE>&nbsp;void</CODE></FONT></TD>
642
<TD><CODE><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html#writeTo(java.io.OutputStream)">writeTo</A></B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</A>&nbsp;os)</CODE>
643
 
644
<BR>
645
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Output the body part as an RFC 822 format stream.</TD>
646
</TR>
647
</TABLE>
648
&nbsp;<A NAME="methods_inherited_from_class_javax.mail.BodyPart"><!-- --></A>
649
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
650
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
651
<TH ALIGN="left"><B>Methods inherited from class javax.mail.<A HREF="../../../javax/mail/BodyPart.html" title="class in javax.mail">BodyPart</A></B></TH>
652
</TR>
653
<TR BGCOLOR="white" CLASS="TableRowColor">
654
<TD><CODE><A HREF="../../../javax/mail/BodyPart.html#getParent()">getParent</A></CODE></TD>
655
</TR>
656
</TABLE>
657
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
658
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
659
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
660
<TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A></B></TH>
661
</TR>
662
<TR BGCOLOR="white" CLASS="TableRowColor">
663
<TD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#clone()" title="class or interface in java.lang">clone</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#equals(java.lang.Object)" title="class or interface in java.lang">equals</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#finalize()" title="class or interface in java.lang">finalize</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#toString()" title="class or interface in java.lang">toString</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD>
664
</TR>
665
</TABLE>
666
&nbsp;
667
<P>
668
 
669
<!-- ============ FIELD DETAIL =========== -->
670
 
671
<A NAME="field_detail"><!-- --></A>
672
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
673
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
674
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
675
<B>Field Detail</B></FONT></TH>
676
</TR>
677
</TABLE>
678
 
679
<A NAME="dh"><!-- --></A><H3>
680
dh</H3>
681
<PRE>
682
protected <A HREF="http://java.sun.com/javase/technologies/desktop/javabeans/glasgow/javadocs/javax/activation/DataHandler.html?is-external=true" title="class or interface in javax.activation">DataHandler</A> <B>dh</B></PRE>
683
<DL>
684
<DD>The DataHandler object representing this Part's content.
685
<P>
686
<DL>
687
</DL>
688
</DL>
689
<HR>
690
 
691
<A NAME="content"><!-- --></A><H3>
692
content</H3>
693
<PRE>
694
protected byte[] <B>content</B></PRE>
695
<DL>
696
<DD>Byte array that holds the bytes of the content of this Part.
697
<P>
698
<DL>
699
</DL>
700
</DL>
701
<HR>
702
 
703
<A NAME="contentStream"><!-- --></A><H3>
704
contentStream</H3>
705
<PRE>
706
protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</A> <B>contentStream</B></PRE>
707
<DL>
708
<DD>If the data for this body part was supplied by an
709
 InputStream that implements the SharedInputStream interface,
710
 <code>contentStream</code> is another such stream representing
711
 the content of this body part.  In this case, <code>content</code>
712
 will be null.
713
<P>
714
<DL>
715
<DT><B>Since:</B></DT>
716
  <DD>JavaMail 1.2</DD>
717
</DL>
718
</DL>
719
<HR>
720
 
721
<A NAME="headers"><!-- --></A><H3>
722
headers</H3>
723
<PRE>
724
protected <A HREF="../../../javax/mail/internet/InternetHeaders.html" title="class in javax.mail.internet">InternetHeaders</A> <B>headers</B></PRE>
725
<DL>
726
<DD>The InternetHeaders object that stores all the headers
727
 of this body part.
728
<P>
729
<DL>
730
</DL>
731
</DL>
732
 
733
<!-- ========= CONSTRUCTOR DETAIL ======== -->
734
 
735
<A NAME="constructor_detail"><!-- --></A>
736
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
737
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
738
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
739
<B>Constructor Detail</B></FONT></TH>
740
</TR>
741
</TABLE>
742
 
743
<A NAME="MimeBodyPart()"><!-- --></A><H3>
744
MimeBodyPart</H3>
745
<PRE>
746
public <B>MimeBodyPart</B>()</PRE>
747
<DL>
748
<DD>An empty MimeBodyPart object is created.
749
 This body part maybe filled in by a client constructing a multipart
750
 message.
751
<P>
752
</DL>
753
<HR>
754
 
755
<A NAME="MimeBodyPart(java.io.InputStream)"><!-- --></A><H3>
756
MimeBodyPart</H3>
757
<PRE>
758
public <B>MimeBodyPart</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</A>&nbsp;is)
759
             throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
760
<DL>
761
<DD>Constructs a MimeBodyPart by reading and parsing the data from
762
 the specified input stream. The parser consumes data till the end
763
 of the given input stream.  The input stream must start at the
764
 beginning of a valid MIME body part and must terminate at the end
765
 of that body part. <p>
766
 
767
 Note that the "boundary" string that delimits body parts must
768
 <strong>not</strong> be included in the input stream. The intention
769
 is that the MimeMultipart parser will extract each body part's bytes
770
 from a multipart stream and feed them into this constructor, without
771
 the delimiter strings.
772
<P>
773
<DL>
774
<DT><B>Parameters:</B><DD><CODE>is</CODE> - the body part Input Stream
775
<DT><B>Throws:</B>
776
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
777
</DL>
778
<HR>
779
 
780
<A NAME="MimeBodyPart(javax.mail.internet.InternetHeaders, byte[])"><!-- --></A><H3>
781
MimeBodyPart</H3>
782
<PRE>
783
public <B>MimeBodyPart</B>(<A HREF="../../../javax/mail/internet/InternetHeaders.html" title="class in javax.mail.internet">InternetHeaders</A>&nbsp;headers,
784
                    byte[]&nbsp;content)
785
             throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
786
<DL>
787
<DD>Constructs a MimeBodyPart using the given header and
788
 content bytes. <p>
789
 
790
 Used by providers.
791
<P>
792
<DL>
793
<DT><B>Parameters:</B><DD><CODE>headers</CODE> - The header of this part<DD><CODE>content</CODE> - bytes representing the body of this part.
794
<DT><B>Throws:</B>
795
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
796
</DL>
797
 
798
<!-- ============ METHOD DETAIL ========== -->
799
 
800
<A NAME="method_detail"><!-- --></A>
801
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
802
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
803
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
804
<B>Method Detail</B></FONT></TH>
805
</TR>
806
</TABLE>
807
 
808
<A NAME="getSize()"><!-- --></A><H3>
809
getSize</H3>
810
<PRE>
811
public int <B>getSize</B>()
812
            throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
813
<DL>
814
<DD>Return the size of the content of this body part in bytes.
815
 Return -1 if the size cannot be determined. <p>
816
 
817
 Note that this number may not be an exact measure of the
818
 content size and may or may not account for any transfer
819
 encoding of the content. <p>
820
 
821
 This implementation returns the size of the <code>content</code>
822
 array (if not null), or, if <code>contentStream</code> is not
823
 null, and the <code>available</code> method returns a positive
824
 number, it returns that number as the size.  Otherwise, it returns
825
 -1.
826
<P>
827
<DD><DL>
828
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getSize()">getSize</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
829
</DD>
830
<DD><DL>
831
 
832
<DT><B>Returns:</B><DD>size in bytes, or -1 if not known
833
<DT><B>Throws:</B>
834
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
835
</DD>
836
</DL>
837
<HR>
838
 
839
<A NAME="getLineCount()"><!-- --></A><H3>
840
getLineCount</H3>
841
<PRE>
842
public int <B>getLineCount</B>()
843
                 throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
844
<DL>
845
<DD>Return the number of lines for the content of this Part.
846
 Return -1 if this number cannot be determined. <p>
847
 
848
 Note that this number may not be an exact measure of the
849
 content length and may or may not account for any transfer
850
 encoding of the content. <p>
851
 
852
 This implementation returns -1.
853
<P>
854
<DD><DL>
855
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getLineCount()">getLineCount</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
856
</DD>
857
<DD><DL>
858
 
859
<DT><B>Returns:</B><DD>number of lines, or -1 if not known
860
<DT><B>Throws:</B>
861
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
862
</DD>
863
</DL>
864
<HR>
865
 
866
<A NAME="getContentType()"><!-- --></A><H3>
867
getContentType</H3>
868
<PRE>
869
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getContentType</B>()
870
                      throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
871
<DL>
872
<DD>Returns the value of the RFC 822 "Content-Type" header field.
873
 This represents the content type of the content of this
874
 body part. This value must not be null. If this field is
875
 unavailable, "text/plain" should be returned. <p>
876
 
877
 This implementation uses <code>getHeader(name)</code>
878
 to obtain the requisite header field.
879
<P>
880
<DD><DL>
881
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getContentType()">getContentType</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
882
</DD>
883
<DD><DL>
884
 
885
<DT><B>Returns:</B><DD>Content-Type of this body part
886
<DT><B>Throws:</B>
887
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE><DT><B>See Also:</B><DD><A HREF="http://java.sun.com/javase/technologies/desktop/javabeans/glasgow/javadocs/javax/activation/DataHandler.html?is-external=true" title="class or interface in javax.activation"><CODE>DataHandler</CODE></A></DL>
888
</DD>
889
</DL>
890
<HR>
891
 
892
<A NAME="isMimeType(java.lang.String)"><!-- --></A><H3>
893
isMimeType</H3>
894
<PRE>
895
public boolean <B>isMimeType</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;mimeType)
896
                   throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
897
<DL>
898
<DD>Is this Part of the specified MIME type?  This method
899
 compares <strong>only the <code>primaryType</code> and
900
 <code>subType</code></strong>.
901
 The parameters of the content types are ignored. <p>
902
 
903
 For example, this method will return <code>true</code> when
904
 comparing a Part of content type <strong>"text/plain"</strong>
905
 with <strong>"text/plain; charset=foobar"</strong>. <p>
906
 
907
 If the <code>subType</code> of <code>mimeType</code> is the
908
 special character '*', then the subtype is ignored during the
909
 comparison.
910
<P>
911
<DD><DL>
912
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#isMimeType(java.lang.String)">isMimeType</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
913
</DD>
914
<DD><DL>
915
 
916
<DT><B>Throws:</B>
917
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
918
</DD>
919
</DL>
920
<HR>
921
 
922
<A NAME="getDisposition()"><!-- --></A><H3>
923
getDisposition</H3>
924
<PRE>
925
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getDisposition</B>()
926
                      throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
927
<DL>
928
<DD>Returns the value of the "Content-Disposition" header field.
929
 This represents the disposition of this part. The disposition
930
 describes how the part should be presented to the user. <p>
931
 
932
 If the Content-Disposition field is unavailable,
933
 null is returned. <p>
934
 
935
 This implementation uses <code>getHeader(name)</code>
936
 to obtain the requisite header field.
937
<P>
938
<DD><DL>
939
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getDisposition()">getDisposition</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
940
</DD>
941
<DD><DL>
942
 
943
<DT><B>Returns:</B><DD>disposition of this part, or null if unknown
944
<DT><B>Throws:</B>
945
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE><DT><B>See Also:</B><DD><A HREF="../../../javax/mail/internet/MimeBodyPart.html#headers"><CODE>headers</CODE></A></DL>
946
</DD>
947
</DL>
948
<HR>
949
 
950
<A NAME="setDisposition(java.lang.String)"><!-- --></A><H3>
951
setDisposition</H3>
952
<PRE>
953
public void <B>setDisposition</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;disposition)
954
                    throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
955
<DL>
956
<DD>Set the "Content-Disposition" header field of this body part.
957
 If the disposition is null, any existing "Content-Disposition"
958
 header field is removed.
959
<P>
960
<DD><DL>
961
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#setDisposition(java.lang.String)">setDisposition</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
962
</DD>
963
<DD><DL>
964
<DT><B>Parameters:</B><DD><CODE>disposition</CODE> - disposition of this part
965
<DT><B>Throws:</B>
966
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
967
                        implementation does not support modification
968
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html?is-external=true" title="class or interface in java.lang">IllegalStateException</A></CODE> - if this body part is
969
                        obtained from a READ_ONLY folder.
970
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE><DT><B>See Also:</B><DD><A HREF="../../../javax/mail/Part.html#ATTACHMENT"><CODE>Part.ATTACHMENT</CODE></A>,
971
<A HREF="../../../javax/mail/Part.html#INLINE"><CODE>Part.INLINE</CODE></A>,
972
<A HREF="../../../javax/mail/Part.html#setFileName(java.lang.String)"><CODE>Part.setFileName(java.lang.String)</CODE></A></DL>
973
</DD>
974
</DL>
975
<HR>
976
 
977
<A NAME="getEncoding()"><!-- --></A><H3>
978
getEncoding</H3>
979
<PRE>
980
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getEncoding</B>()
981
                   throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
982
<DL>
983
<DD>Returns the content transfer encoding from the
984
 "Content-Transfer-Encoding" header
985
 field. Returns <code>null</code> if the header is unavailable
986
 or its value is absent. <p>
987
 
988
 This implementation uses <code>getHeader(name)</code>
989
 to obtain the requisite header field.
990
<P>
991
<DD><DL>
992
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#getEncoding()">getEncoding</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
993
</DD>
994
<DD><DL>
995
 
996
<DT><B>Returns:</B><DD>content-transfer-encoding
997
<DT><B>Throws:</B>
998
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE><DT><B>See Also:</B><DD><A HREF="../../../javax/mail/internet/MimeBodyPart.html#headers"><CODE>headers</CODE></A></DL>
999
</DD>
1000
</DL>
1001
<HR>
1002
 
1003
<A NAME="getContentID()"><!-- --></A><H3>
1004
getContentID</H3>
1005
<PRE>
1006
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getContentID</B>()
1007
                    throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1008
<DL>
1009
<DD>Returns the value of the "Content-ID" header field. Returns
1010
 <code>null</code> if the field is unavailable or its value is
1011
 absent. <p>
1012
 
1013
 This implementation uses <code>getHeader(name)</code>
1014
 to obtain the requisite header field.
1015
<P>
1016
<DD><DL>
1017
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#getContentID()">getContentID</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
1018
</DD>
1019
<DD><DL>
1020
 
1021
<DT><B>Returns:</B><DD>content-ID
1022
<DT><B>Throws:</B>
1023
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1024
</DD>
1025
</DL>
1026
<HR>
1027
 
1028
<A NAME="setContentID(java.lang.String)"><!-- --></A><H3>
1029
setContentID</H3>
1030
<PRE>
1031
public void <B>setContentID</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;cid)
1032
                  throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1033
<DL>
1034
<DD>Set the "Content-ID" header field of this body part.
1035
 If the <code>cid</code> parameter is null, any existing
1036
 "Content-ID" is removed.
1037
<P>
1038
<DD><DL>
1039
</DL>
1040
</DD>
1041
<DD><DL>
1042
 
1043
<DT><B>Throws:</B>
1044
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1045
                        implementation does not support modification
1046
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html?is-external=true" title="class or interface in java.lang">IllegalStateException</A></CODE> - if this body part is
1047
                        obtained from a READ_ONLY folder.
1048
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE><DT><B>Since:</B></DT>
1049
  <DD>JavaMail 1.3</DD>
1050
</DL>
1051
</DD>
1052
</DL>
1053
<HR>
1054
 
1055
<A NAME="getContentMD5()"><!-- --></A><H3>
1056
getContentMD5</H3>
1057
<PRE>
1058
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getContentMD5</B>()
1059
                     throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1060
<DL>
1061
<DD>Return the value of the "Content-MD5" header field. Returns
1062
 <code>null</code> if this field is unavailable or its value
1063
 is absent. <p>
1064
 
1065
 This implementation uses <code>getHeader(name)</code>
1066
 to obtain the requisite header field.
1067
<P>
1068
<DD><DL>
1069
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#getContentMD5()">getContentMD5</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
1070
</DD>
1071
<DD><DL>
1072
 
1073
<DT><B>Returns:</B><DD>content-MD5
1074
<DT><B>Throws:</B>
1075
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1076
</DD>
1077
</DL>
1078
<HR>
1079
 
1080
<A NAME="setContentMD5(java.lang.String)"><!-- --></A><H3>
1081
setContentMD5</H3>
1082
<PRE>
1083
public void <B>setContentMD5</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;md5)
1084
                   throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1085
<DL>
1086
<DD>Set the "Content-MD5" header field of this body part.
1087
<P>
1088
<DD><DL>
1089
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#setContentMD5(java.lang.String)">setContentMD5</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
1090
</DD>
1091
<DD><DL>
1092
<DT><B>Parameters:</B><DD><CODE>md5</CODE> - the MD5 value
1093
<DT><B>Throws:</B>
1094
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1095
                        implementation does not support modification
1096
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html?is-external=true" title="class or interface in java.lang">IllegalStateException</A></CODE> - if this body part is
1097
                        obtained from a READ_ONLY folder.
1098
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1099
</DD>
1100
</DL>
1101
<HR>
1102
 
1103
<A NAME="getContentLanguage()"><!-- --></A><H3>
1104
getContentLanguage</H3>
1105
<PRE>
1106
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[] <B>getContentLanguage</B>()
1107
                            throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1108
<DL>
1109
<DD>Get the languages specified in the Content-Language header
1110
 of this MimePart. The Content-Language header is defined by
1111
 RFC 1766. Returns <code>null</code> if this header is not
1112
 available or its value is absent. <p>
1113
 
1114
 This implementation uses <code>getHeader(name)</code>
1115
 to obtain the requisite header field.
1116
<P>
1117
<DD><DL>
1118
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#getContentLanguage()">getContentLanguage</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
1119
</DD>
1120
<DD><DL>
1121
 
1122
<DT><B>Throws:</B>
1123
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1124
</DD>
1125
</DL>
1126
<HR>
1127
 
1128
<A NAME="setContentLanguage(java.lang.String[])"><!-- --></A><H3>
1129
setContentLanguage</H3>
1130
<PRE>
1131
public void <B>setContentLanguage</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[]&nbsp;languages)
1132
                        throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1133
<DL>
1134
<DD>Set the Content-Language header of this MimePart. The
1135
 Content-Language header is defined by RFC 1766.
1136
<P>
1137
<DD><DL>
1138
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#setContentLanguage(java.lang.String[])">setContentLanguage</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
1139
</DD>
1140
<DD><DL>
1141
<DT><B>Parameters:</B><DD><CODE>languages</CODE> - array of language tags
1142
<DT><B>Throws:</B>
1143
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1144
                        implementation does not support modification
1145
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1146
</DD>
1147
</DL>
1148
<HR>
1149
 
1150
<A NAME="getDescription()"><!-- --></A><H3>
1151
getDescription</H3>
1152
<PRE>
1153
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getDescription</B>()
1154
                      throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1155
<DL>
1156
<DD>Returns the "Content-Description" header field of this body part.
1157
 This typically associates some descriptive information with
1158
 this part. Returns null if this field is unavailable or its
1159
 value is absent. <p>
1160
 
1161
 If the Content-Description field is encoded as per RFC 2047,
1162
 it is decoded and converted into Unicode. If the decoding or
1163
 conversion fails, the raw data is returned as is. <p>
1164
 
1165
 This implementation uses <code>getHeader(name)</code>
1166
 to obtain the requisite header field.
1167
<P>
1168
<DD><DL>
1169
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getDescription()">getDescription</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1170
</DD>
1171
<DD><DL>
1172
 
1173
<DT><B>Returns:</B><DD>content description
1174
<DT><B>Throws:</B>
1175
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1176
</DD>
1177
</DL>
1178
<HR>
1179
 
1180
<A NAME="setDescription(java.lang.String)"><!-- --></A><H3>
1181
setDescription</H3>
1182
<PRE>
1183
public void <B>setDescription</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;description)
1184
                    throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1185
<DL>
1186
<DD>Set the "Content-Description" header field for this body part.
1187
 If the description parameter is <code>null</code>, then any
1188
 existing "Content-Description" fields are removed. <p>
1189
 
1190
 If the description contains non US-ASCII characters, it will
1191
 be encoded using the platform's default charset. If the
1192
 description contains only US-ASCII characters, no encoding
1193
 is done and it is used as is. <p>
1194
 
1195
 Note that if the charset encoding process fails, a
1196
 MessagingException is thrown, and an UnsupportedEncodingException
1197
 is included in the chain of nested exceptions within the
1198
 MessagingException.
1199
<P>
1200
<DD><DL>
1201
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#setDescription(java.lang.String)">setDescription</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1202
</DD>
1203
<DD><DL>
1204
<DT><B>Parameters:</B><DD><CODE>description</CODE> - content description
1205
<DT><B>Throws:</B>
1206
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1207
                        implementation does not support modification
1208
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html?is-external=true" title="class or interface in java.lang">IllegalStateException</A></CODE> - if this body part is
1209
                        obtained from a READ_ONLY folder.
1210
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE> - otherwise; an
1211
                  UnsupportedEncodingException may be included
1212
                  in the exception chain if the charset
1213
                  conversion fails.</DL>
1214
</DD>
1215
</DL>
1216
<HR>
1217
 
1218
<A NAME="setDescription(java.lang.String, java.lang.String)"><!-- --></A><H3>
1219
setDescription</H3>
1220
<PRE>
1221
public void <B>setDescription</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;description,
1222
                           <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;charset)
1223
                    throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1224
<DL>
1225
<DD>Set the "Content-Description" header field for this body part.
1226
 If the description parameter is <code>null</code>, then any
1227
 existing "Content-Description" fields are removed. <p>
1228
 
1229
 If the description contains non US-ASCII characters, it will
1230
 be encoded using the specified charset. If the description
1231
 contains only US-ASCII characters, no encoding  is done and
1232
 it is used as is. <p>
1233
 
1234
 Note that if the charset encoding process fails, a
1235
 MessagingException is thrown, and an UnsupportedEncodingException
1236
 is included in the chain of nested exceptions within the
1237
 MessagingException.
1238
<P>
1239
<DD><DL>
1240
</DL>
1241
</DD>
1242
<DD><DL>
1243
<DT><B>Parameters:</B><DD><CODE>description</CODE> - Description<DD><CODE>charset</CODE> - Charset for encoding
1244
<DT><B>Throws:</B>
1245
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1246
                        implementation does not support modification
1247
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html?is-external=true" title="class or interface in java.lang">IllegalStateException</A></CODE> - if this body part is
1248
                        obtained from a READ_ONLY folder.
1249
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE> - otherwise; an
1250
                  UnsupportedEncodingException may be included
1251
                  in the exception chain if the charset
1252
                  conversion fails.</DL>
1253
</DD>
1254
</DL>
1255
<HR>
1256
 
1257
<A NAME="getFileName()"><!-- --></A><H3>
1258
getFileName</H3>
1259
<PRE>
1260
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getFileName</B>()
1261
                   throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1262
<DL>
1263
<DD>Get the filename associated with this body part. <p>
1264
 
1265
 Returns the value of the "filename" parameter from the
1266
 "Content-Disposition" header field of this body part. If its
1267
 not available, returns the value of the "name" parameter from
1268
 the "Content-Type" header field of this body part.
1269
 Returns <code>null</code> if both are absent. <p>
1270
 
1271
 If the <code>mail.mime.encodefilename</code> System property
1272
 is set to true, the <A HREF="../../../javax/mail/internet/MimeUtility.html#decodeText(java.lang.String)"><CODE>MimeUtility.decodeText</CODE></A> method will be used to decode the
1273
 filename.  While such encoding is not supported by the MIME
1274
 spec, many mailers use this technique to support non-ASCII
1275
 characters in filenames.  The default value of this property
1276
 is false.
1277
<P>
1278
<DD><DL>
1279
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getFileName()">getFileName</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1280
</DD>
1281
<DD><DL>
1282
 
1283
<DT><B>Returns:</B><DD>filename
1284
<DT><B>Throws:</B>
1285
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1286
</DD>
1287
</DL>
1288
<HR>
1289
 
1290
<A NAME="setFileName(java.lang.String)"><!-- --></A><H3>
1291
setFileName</H3>
1292
<PRE>
1293
public void <B>setFileName</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;filename)
1294
                 throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1295
<DL>
1296
<DD>Set the filename associated with this body part, if possible. <p>
1297
 
1298
 Sets the "filename" parameter of the "Content-Disposition"
1299
 header field of this body part.  For compatibility with older
1300
 mailers, the "name" parameter of the "Content-Type" header is
1301
 also set. <p>
1302
 
1303
 If the <code>mail.mime.encodefilename</code> System property
1304
 is set to true, the <A HREF="../../../javax/mail/internet/MimeUtility.html#encodeText(java.lang.String)"><CODE>MimeUtility.encodeText</CODE></A> method will be used to encode the
1305
 filename.  While such encoding is not supported by the MIME
1306
 spec, many mailers use this technique to support non-ASCII
1307
 characters in filenames.  The default value of this property
1308
 is false.
1309
<P>
1310
<DD><DL>
1311
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#setFileName(java.lang.String)">setFileName</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1312
</DD>
1313
<DD><DL>
1314
<DT><B>Parameters:</B><DD><CODE>filename</CODE> - Filename to associate with this part
1315
<DT><B>Throws:</B>
1316
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1317
                        implementation does not support modification
1318
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html?is-external=true" title="class or interface in java.lang">IllegalStateException</A></CODE> - if this body part is
1319
                        obtained from a READ_ONLY folder.
1320
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1321
</DD>
1322
</DL>
1323
<HR>
1324
 
1325
<A NAME="getInputStream()"><!-- --></A><H3>
1326
getInputStream</H3>
1327
<PRE>
1328
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</A> <B>getInputStream</B>()
1329
                           throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A>,
1330
                                  <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1331
<DL>
1332
<DD>Return a decoded input stream for this body part's "content". <p>
1333
 
1334
 This implementation obtains the input stream from the DataHandler.
1335
 That is, it invokes getDataHandler().getInputStream();
1336
<P>
1337
<DD><DL>
1338
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getInputStream()">getInputStream</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1339
</DD>
1340
<DD><DL>
1341
 
1342
<DT><B>Returns:</B><DD>an InputStream
1343
<DT><B>Throws:</B>
1344
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE>
1345
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A></CODE> - this is typically thrown by the
1346
                        DataHandler. Refer to the documentation for
1347
                        javax.activation.DataHandler for more details.<DT><B>See Also:</B><DD><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getContentStream()"><CODE>getContentStream()</CODE></A>,
1348
<A HREF="http://java.sun.com/javase/technologies/desktop/javabeans/glasgow/javadocs/javax/activation/DataHandler.html?is-external=true#getInputStream()" title="class or interface in javax.activation"><CODE>DataHandler.getInputStream()</CODE></A></DL>
1349
</DD>
1350
</DL>
1351
<HR>
1352
 
1353
<A NAME="getContentStream()"><!-- --></A><H3>
1354
getContentStream</H3>
1355
<PRE>
1356
protected <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</A> <B>getContentStream</B>()
1357
                                throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1358
<DL>
1359
<DD>Produce the raw bytes of the content. This method is used
1360
 when creating a DataHandler object for the content. Subclasses
1361
 that can provide a separate input stream for just the Part
1362
 content might want to override this method. <p>
1363
<P>
1364
<DD><DL>
1365
</DL>
1366
</DD>
1367
<DD><DL>
1368
 
1369
<DT><B>Throws:</B>
1370
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE><DT><B>See Also:</B><DD><A HREF="../../../javax/mail/internet/MimeBodyPart.html#content"><CODE>content</CODE></A>,
1371
<A HREF="../../../javax/mail/internet/MimeMessage.html#getContentStream()"><CODE>MimeMessage.getContentStream()</CODE></A></DL>
1372
</DD>
1373
</DL>
1374
<HR>
1375
 
1376
<A NAME="getRawInputStream()"><!-- --></A><H3>
1377
getRawInputStream</H3>
1378
<PRE>
1379
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/InputStream.html?is-external=true" title="class or interface in java.io">InputStream</A> <B>getRawInputStream</B>()
1380
                              throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1381
<DL>
1382
<DD>Return an InputStream to the raw data with any Content-Transfer-Encoding
1383
 intact.  This method is useful if the "Content-Transfer-Encoding"
1384
 header is incorrect or corrupt, which would prevent the
1385
 <code>getInputStream</code> method or <code>getContent</code> method
1386
 from returning the correct data.  In such a case the application may
1387
 use this method and attempt to decode the raw data itself. <p>
1388
 
1389
 This implementation simply calls the <code>getContentStream</code>
1390
 method.
1391
<P>
1392
<DD><DL>
1393
</DL>
1394
</DD>
1395
<DD><DL>
1396
 
1397
<DT><B>Throws:</B>
1398
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE><DT><B>Since:</B></DT>
1399
  <DD>JavaMail 1.2</DD>
1400
<DT><B>See Also:</B><DD><A HREF="../../../javax/mail/internet/MimeBodyPart.html#getInputStream()"><CODE>getInputStream()</CODE></A>,
1401
<A HREF="../../../javax/mail/internet/MimeBodyPart.html#getContentStream()"><CODE>getContentStream()</CODE></A></DL>
1402
</DD>
1403
</DL>
1404
<HR>
1405
 
1406
<A NAME="getDataHandler()"><!-- --></A><H3>
1407
getDataHandler</H3>
1408
<PRE>
1409
public <A HREF="http://java.sun.com/javase/technologies/desktop/javabeans/glasgow/javadocs/javax/activation/DataHandler.html?is-external=true" title="class or interface in javax.activation">DataHandler</A> <B>getDataHandler</B>()
1410
                           throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1411
<DL>
1412
<DD>Return a DataHandler for this body part's content. <p>
1413
 
1414
 The implementation provided here works just like the
1415
 the implementation in MimeMessage.
1416
<P>
1417
<DD><DL>
1418
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getDataHandler()">getDataHandler</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1419
</DD>
1420
<DD><DL>
1421
 
1422
<DT><B>Returns:</B><DD>DataHandler for the content
1423
<DT><B>Throws:</B>
1424
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE><DT><B>See Also:</B><DD><A HREF="../../../javax/mail/internet/MimeMessage.html#getDataHandler()"><CODE>MimeMessage.getDataHandler()</CODE></A></DL>
1425
</DD>
1426
</DL>
1427
<HR>
1428
 
1429
<A NAME="getContent()"><!-- --></A><H3>
1430
getContent</H3>
1431
<PRE>
1432
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A> <B>getContent</B>()
1433
                  throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A>,
1434
                         <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1435
<DL>
1436
<DD>Return the content as a Java object. The type of the object
1437
 returned is of course dependent on the content itself. For
1438
 example, the native format of a text/plain content is usually
1439
 a String object. The native format for a "multipart"
1440
 content is always a Multipart subclass. For content types that are
1441
 unknown to the DataHandler system, an input stream is returned
1442
 as the content. <p>
1443
 
1444
 This implementation obtains the content from the DataHandler.
1445
 That is, it invokes getDataHandler().getContent();
1446
 If the content is a Multipart or Message object and was created by
1447
 parsing a stream, the object is cached and returned in subsequent
1448
 calls so that modifications to the content will not be lost.
1449
<P>
1450
<DD><DL>
1451
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getContent()">getContent</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1452
</DD>
1453
<DD><DL>
1454
 
1455
<DT><B>Returns:</B><DD>Object
1456
<DT><B>Throws:</B>
1457
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE>
1458
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A></CODE> - this is typically thrown by the
1459
                        DataHandler. Refer to the documentation for
1460
                        javax.activation.DataHandler for more details.<DT><B>See Also:</B><DD><A HREF="http://java.sun.com/javase/technologies/desktop/javabeans/glasgow/javadocs/javax/activation/DataHandler.html?is-external=true#getContent()" title="class or interface in javax.activation"><CODE>DataHandler.getContent()</CODE></A></DL>
1461
</DD>
1462
</DL>
1463
<HR>
1464
 
1465
<A NAME="setDataHandler(javax.activation.DataHandler)"><!-- --></A><H3>
1466
setDataHandler</H3>
1467
<PRE>
1468
public void <B>setDataHandler</B>(<A HREF="http://java.sun.com/javase/technologies/desktop/javabeans/glasgow/javadocs/javax/activation/DataHandler.html?is-external=true" title="class or interface in javax.activation">DataHandler</A>&nbsp;dh)
1469
                    throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1470
<DL>
1471
<DD>This method provides the mechanism to set this body part's content.
1472
 The given DataHandler object should wrap the actual content.
1473
<P>
1474
<DD><DL>
1475
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#setDataHandler(javax.activation.DataHandler)">setDataHandler</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1476
</DD>
1477
<DD><DL>
1478
<DT><B>Parameters:</B><DD><CODE>dh</CODE> - The DataHandler for the content
1479
<DT><B>Throws:</B>
1480
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1481
                        implementation does not support modification
1482
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html?is-external=true" title="class or interface in java.lang">IllegalStateException</A></CODE> - if this body part is
1483
                        obtained from a READ_ONLY folder.
1484
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1485
</DD>
1486
</DL>
1487
<HR>
1488
 
1489
<A NAME="setContent(java.lang.Object, java.lang.String)"><!-- --></A><H3>
1490
setContent</H3>
1491
<PRE>
1492
public void <B>setContent</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/Object.html?is-external=true" title="class or interface in java.lang">Object</A>&nbsp;o,
1493
                       <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;type)
1494
                throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1495
<DL>
1496
<DD>A convenience method for setting this body part's content. <p>
1497
 
1498
 The content is wrapped in a DataHandler object. Note that a
1499
 DataContentHandler class for the specified type should be
1500
 available to the JavaMail implementation for this to work right.
1501
 That is, to do <code>setContent(foobar, "application/x-foobar")</code>,
1502
 a DataContentHandler for "application/x-foobar" should be installed.
1503
 Refer to the Java Activation Framework for more information.
1504
<P>
1505
<DD><DL>
1506
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#setContent(java.lang.Object, java.lang.String)">setContent</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1507
</DD>
1508
<DD><DL>
1509
<DT><B>Parameters:</B><DD><CODE>o</CODE> - the content object<DD><CODE>type</CODE> - Mime type of the object
1510
<DT><B>Throws:</B>
1511
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1512
                        implementation does not support modification of
1513
                        existing values
1514
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html?is-external=true" title="class or interface in java.lang">IllegalStateException</A></CODE> - if this body part is
1515
                        obtained from a READ_ONLY folder.
1516
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1517
</DD>
1518
</DL>
1519
<HR>
1520
 
1521
<A NAME="setText(java.lang.String)"><!-- --></A><H3>
1522
setText</H3>
1523
<PRE>
1524
public void <B>setText</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;text)
1525
             throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1526
<DL>
1527
<DD>Convenience method that sets the given String as this
1528
 part's content, with a MIME type of "text/plain". If the
1529
 string contains non US-ASCII characters, it will be encoded
1530
 using the platform's default charset. The charset is also
1531
 used to set the "charset" parameter. <p>
1532
 
1533
 Note that there may be a performance penalty if
1534
 <code>text</code> is large, since this method may have
1535
 to scan all the characters to determine what charset to
1536
 use. <p>
1537
 
1538
 If the charset is already known, use the
1539
 <code>setText</code> method that takes the charset parameter.
1540
<P>
1541
<DD><DL>
1542
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#setText(java.lang.String)">setText</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE><DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#setText(java.lang.String)">setText</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1543
</DD>
1544
<DD><DL>
1545
<DT><B>Parameters:</B><DD><CODE>text</CODE> - the text content to set
1546
<DT><B>Throws:</B>
1547
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE> - if an error occurs<DT><B>See Also:</B><DD><A HREF="../../../javax/mail/internet/MimeBodyPart.html#setText(java.lang.String, java.lang.String)"><CODE>setText(String text, String charset)</CODE></A></DL>
1548
</DD>
1549
</DL>
1550
<HR>
1551
 
1552
<A NAME="setText(java.lang.String, java.lang.String)"><!-- --></A><H3>
1553
setText</H3>
1554
<PRE>
1555
public void <B>setText</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;text,
1556
                    <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;charset)
1557
             throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1558
<DL>
1559
<DD>Convenience method that sets the given String as this part's
1560
 content, with a MIME type of "text/plain" and the specified
1561
 charset. The given Unicode string will be charset-encoded
1562
 using the specified charset. The charset is also used to set
1563
 the "charset" parameter.
1564
<P>
1565
<DD><DL>
1566
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#setText(java.lang.String, java.lang.String)">setText</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
1567
</DD>
1568
<DD><DL>
1569
<DT><B>Parameters:</B><DD><CODE>text</CODE> - the text content to set<DD><CODE>charset</CODE> - the charset to use for the text
1570
<DT><B>Throws:</B>
1571
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE> - if an error occurs</DL>
1572
</DD>
1573
</DL>
1574
<HR>
1575
 
1576
<A NAME="setText(java.lang.String, java.lang.String, java.lang.String)"><!-- --></A><H3>
1577
setText</H3>
1578
<PRE>
1579
public void <B>setText</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;text,
1580
                    <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;charset,
1581
                    <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;subtype)
1582
             throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1583
<DL>
1584
<DD>Convenience method that sets the given String as this part's
1585
 content, with a primary MIME type of "text" and the specified
1586
 MIME subtype.  The given Unicode string will be charset-encoded
1587
 using the specified charset. The charset is also used to set
1588
 the "charset" parameter.
1589
<P>
1590
<DD><DL>
1591
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#setText(java.lang.String, java.lang.String, java.lang.String)">setText</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
1592
</DD>
1593
<DD><DL>
1594
<DT><B>Parameters:</B><DD><CODE>text</CODE> - the text content to set<DD><CODE>charset</CODE> - the charset to use for the text<DD><CODE>subtype</CODE> - the MIME subtype to use (e.g., "html")
1595
<DT><B>Throws:</B>
1596
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE> - if an error occurs<DT><B>Since:</B></DT>
1597
  <DD>JavaMail 1.4</DD>
1598
</DL>
1599
</DD>
1600
</DL>
1601
<HR>
1602
 
1603
<A NAME="setContent(javax.mail.Multipart)"><!-- --></A><H3>
1604
setContent</H3>
1605
<PRE>
1606
public void <B>setContent</B>(<A HREF="../../../javax/mail/Multipart.html" title="class in javax.mail">Multipart</A>&nbsp;mp)
1607
                throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1608
<DL>
1609
<DD>This method sets the body part's content to a Multipart object.
1610
<P>
1611
<DD><DL>
1612
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#setContent(javax.mail.Multipart)">setContent</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1613
</DD>
1614
<DD><DL>
1615
<DT><B>Parameters:</B><DD><CODE>mp</CODE> - The multipart object that is the Message's content
1616
<DT><B>Throws:</B>
1617
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1618
                        implementation does not support modification of
1619
                        existing values.
1620
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/IllegalStateException.html?is-external=true" title="class or interface in java.lang">IllegalStateException</A></CODE> - if this body part is
1621
                        obtained from a READ_ONLY folder.
1622
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1623
</DD>
1624
</DL>
1625
<HR>
1626
 
1627
<A NAME="attachFile(java.io.File)"><!-- --></A><H3>
1628
attachFile</H3>
1629
<PRE>
1630
public void <B>attachFile</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io">File</A>&nbsp;file)
1631
                throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A>,
1632
                       <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1633
<DL>
1634
<DD>Use the specified file to provide the data for this part.
1635
 The simple file name is used as the file name for this
1636
 part and the data in the file is used as the data for this
1637
 part.  The encoding will be chosen appropriately for the
1638
 file data.
1639
<P>
1640
<DD><DL>
1641
</DL>
1642
</DD>
1643
<DD><DL>
1644
<DT><B>Parameters:</B><DD><CODE>file</CODE> - the File object to attach
1645
<DT><B>Throws:</B>
1646
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A></CODE> - errors related to accessing the file
1647
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE> - message related errors<DT><B>Since:</B></DT>
1648
  <DD>JavaMail 1.4</DD>
1649
</DL>
1650
</DD>
1651
</DL>
1652
<HR>
1653
 
1654
<A NAME="attachFile(java.lang.String)"><!-- --></A><H3>
1655
attachFile</H3>
1656
<PRE>
1657
public void <B>attachFile</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;file)
1658
                throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A>,
1659
                       <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1660
<DL>
1661
<DD>Use the specified file to provide the data for this part.
1662
 The simple file name is used as the file name for this
1663
 part and the data in the file is used as the data for this
1664
 part.  The encoding will be chosen appropriately for the
1665
 file data.
1666
<P>
1667
<DD><DL>
1668
</DL>
1669
</DD>
1670
<DD><DL>
1671
<DT><B>Parameters:</B><DD><CODE>file</CODE> - the name of the file to attach
1672
<DT><B>Throws:</B>
1673
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A></CODE> - errors related to accessing the file
1674
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE> - message related errors<DT><B>Since:</B></DT>
1675
  <DD>JavaMail 1.4</DD>
1676
</DL>
1677
</DD>
1678
</DL>
1679
<HR>
1680
 
1681
<A NAME="saveFile(java.io.File)"><!-- --></A><H3>
1682
saveFile</H3>
1683
<PRE>
1684
public void <B>saveFile</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/File.html?is-external=true" title="class or interface in java.io">File</A>&nbsp;file)
1685
              throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A>,
1686
                     <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1687
<DL>
1688
<DD>Save the contents of this part in the specified file.  The content
1689
 is decoded and saved, without any of the MIME headers.
1690
<P>
1691
<DD><DL>
1692
</DL>
1693
</DD>
1694
<DD><DL>
1695
<DT><B>Parameters:</B><DD><CODE>file</CODE> - the File object to write to
1696
<DT><B>Throws:</B>
1697
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A></CODE> - errors related to accessing the file
1698
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE> - message related errors<DT><B>Since:</B></DT>
1699
  <DD>JavaMail 1.4</DD>
1700
</DL>
1701
</DD>
1702
</DL>
1703
<HR>
1704
 
1705
<A NAME="saveFile(java.lang.String)"><!-- --></A><H3>
1706
saveFile</H3>
1707
<PRE>
1708
public void <B>saveFile</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;file)
1709
              throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A>,
1710
                     <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1711
<DL>
1712
<DD>Save the contents of this part in the specified file.  The content
1713
 is decoded and saved, without any of the MIME headers.
1714
<P>
1715
<DD><DL>
1716
</DL>
1717
</DD>
1718
<DD><DL>
1719
<DT><B>Parameters:</B><DD><CODE>file</CODE> - the name of the file to write to
1720
<DT><B>Throws:</B>
1721
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A></CODE> - errors related to accessing the file
1722
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE> - message related errors<DT><B>Since:</B></DT>
1723
  <DD>JavaMail 1.4</DD>
1724
</DL>
1725
</DD>
1726
</DL>
1727
<HR>
1728
 
1729
<A NAME="writeTo(java.io.OutputStream)"><!-- --></A><H3>
1730
writeTo</H3>
1731
<PRE>
1732
public void <B>writeTo</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/OutputStream.html?is-external=true" title="class or interface in java.io">OutputStream</A>&nbsp;os)
1733
             throws <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A>,
1734
                    <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1735
<DL>
1736
<DD>Output the body part as an RFC 822 format stream.
1737
<P>
1738
<DD><DL>
1739
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#writeTo(java.io.OutputStream)">writeTo</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1740
</DD>
1741
<DD><DL>
1742
 
1743
<DT><B>Throws:</B>
1744
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE>
1745
<DD><CODE><A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/io/IOException.html?is-external=true" title="class or interface in java.io">IOException</A></CODE> - if an error occurs writing to the
1746
                                stream or if an error is generated
1747
                                by the javax.activation layer.<DT><B>See Also:</B><DD><A HREF="http://java.sun.com/javase/technologies/desktop/javabeans/glasgow/javadocs/javax/activation/DataHandler.html?is-external=true#writeTo(java.io.OutputStream)" title="class or interface in javax.activation"><CODE>DataHandler.writeTo(java.io.OutputStream)</CODE></A></DL>
1748
</DD>
1749
</DL>
1750
<HR>
1751
 
1752
<A NAME="getHeader(java.lang.String)"><!-- --></A><H3>
1753
getHeader</H3>
1754
<PRE>
1755
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[] <B>getHeader</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name)
1756
                   throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1757
<DL>
1758
<DD>Get all the headers for this header_name. Note that certain
1759
 headers may be encoded as per RFC 2047 if they contain
1760
 non US-ASCII characters and these should be decoded.
1761
<P>
1762
<DD><DL>
1763
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getHeader(java.lang.String)">getHeader</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1764
</DD>
1765
<DD><DL>
1766
<DT><B>Parameters:</B><DD><CODE>name</CODE> - name of header
1767
<DT><B>Returns:</B><DD>array of headers
1768
<DT><B>Throws:</B>
1769
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE><DT><B>See Also:</B><DD><A HREF="../../../javax/mail/internet/MimeUtility.html" title="class in javax.mail.internet"><CODE>MimeUtility</CODE></A></DL>
1770
</DD>
1771
</DL>
1772
<HR>
1773
 
1774
<A NAME="getHeader(java.lang.String, java.lang.String)"><!-- --></A><H3>
1775
getHeader</H3>
1776
<PRE>
1777
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A> <B>getHeader</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name,
1778
                        <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;delimiter)
1779
                 throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1780
<DL>
1781
<DD>Get all the headers for this header name, returned as a single
1782
 String, with headers separated by the delimiter. If the
1783
 delimiter is <code>null</code>, only the first header is
1784
 returned.
1785
<P>
1786
<DD><DL>
1787
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#getHeader(java.lang.String, java.lang.String)">getHeader</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
1788
</DD>
1789
<DD><DL>
1790
<DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of this header<DD><CODE>delimiter</CODE> - delimiter between fields in returned string
1791
<DT><B>Returns:</B><DD>the value fields for all headers with
1792
                                this name
1793
<DT><B>Throws:</B>
1794
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1795
</DD>
1796
</DL>
1797
<HR>
1798
 
1799
<A NAME="setHeader(java.lang.String, java.lang.String)"><!-- --></A><H3>
1800
setHeader</H3>
1801
<PRE>
1802
public void <B>setHeader</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name,
1803
                      <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;value)
1804
               throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1805
<DL>
1806
<DD>Set the value for this header_name. Replaces all existing
1807
 header values with this new value. Note that RFC 822 headers
1808
 must contain only US-ASCII characters, so a header that
1809
 contains non US-ASCII characters must be encoded as per the
1810
 rules of RFC 2047.
1811
<P>
1812
<DD><DL>
1813
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#setHeader(java.lang.String, java.lang.String)">setHeader</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1814
</DD>
1815
<DD><DL>
1816
<DT><B>Parameters:</B><DD><CODE>name</CODE> - header name<DD><CODE>value</CODE> - header value
1817
<DT><B>Throws:</B>
1818
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE>
1819
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1820
                                implementation does not support modification
1821
                                of existing values<DT><B>See Also:</B><DD><A HREF="../../../javax/mail/internet/MimeUtility.html" title="class in javax.mail.internet"><CODE>MimeUtility</CODE></A></DL>
1822
</DD>
1823
</DL>
1824
<HR>
1825
 
1826
<A NAME="addHeader(java.lang.String, java.lang.String)"><!-- --></A><H3>
1827
addHeader</H3>
1828
<PRE>
1829
public void <B>addHeader</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name,
1830
                      <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;value)
1831
               throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1832
<DL>
1833
<DD>Add this value to the existing values for this header_name.
1834
 Note that RFC 822 headers must contain only US-ASCII
1835
 characters, so a header that contains non US-ASCII characters
1836
 must be encoded as per the rules of RFC 2047.
1837
<P>
1838
<DD><DL>
1839
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#addHeader(java.lang.String, java.lang.String)">addHeader</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1840
</DD>
1841
<DD><DL>
1842
<DT><B>Parameters:</B><DD><CODE>name</CODE> - header name<DD><CODE>value</CODE> - header value
1843
<DT><B>Throws:</B>
1844
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE>
1845
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1846
                                implementation does not support modification
1847
                                of existing values<DT><B>See Also:</B><DD><A HREF="../../../javax/mail/internet/MimeUtility.html" title="class in javax.mail.internet"><CODE>MimeUtility</CODE></A></DL>
1848
</DD>
1849
</DL>
1850
<HR>
1851
 
1852
<A NAME="removeHeader(java.lang.String)"><!-- --></A><H3>
1853
removeHeader</H3>
1854
<PRE>
1855
public void <B>removeHeader</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;name)
1856
                  throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1857
<DL>
1858
<DD>Remove all headers with this name.
1859
<P>
1860
<DD><DL>
1861
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#removeHeader(java.lang.String)">removeHeader</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1862
</DD>
1863
<DD><DL>
1864
<DT><B>Parameters:</B><DD><CODE>name</CODE> - the name of this header
1865
<DT><B>Throws:</B>
1866
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE>
1867
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1868
                                implementation does not support modification
1869
                                of existing values</DL>
1870
</DD>
1871
</DL>
1872
<HR>
1873
 
1874
<A NAME="getAllHeaders()"><!-- --></A><H3>
1875
getAllHeaders</H3>
1876
<PRE>
1877
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A> <B>getAllHeaders</B>()
1878
                          throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1879
<DL>
1880
<DD>Return all the headers from this Message as an Enumeration of
1881
 Header objects.
1882
<P>
1883
<DD><DL>
1884
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getAllHeaders()">getAllHeaders</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1885
</DD>
1886
<DD><DL>
1887
 
1888
<DT><B>Returns:</B><DD>enumeration of Header objects
1889
<DT><B>Throws:</B>
1890
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1891
</DD>
1892
</DL>
1893
<HR>
1894
 
1895
<A NAME="getMatchingHeaders(java.lang.String[])"><!-- --></A><H3>
1896
getMatchingHeaders</H3>
1897
<PRE>
1898
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A> <B>getMatchingHeaders</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[]&nbsp;names)
1899
                               throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1900
<DL>
1901
<DD>Return matching headers from this Message as an Enumeration of
1902
 Header objects. <p>
1903
<P>
1904
<DD><DL>
1905
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getMatchingHeaders(java.lang.String[])">getMatchingHeaders</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1906
</DD>
1907
<DD><DL>
1908
 
1909
<DT><B>Returns:</B><DD>enumeration of Header objects
1910
<DT><B>Throws:</B>
1911
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1912
</DD>
1913
</DL>
1914
<HR>
1915
 
1916
<A NAME="getNonMatchingHeaders(java.lang.String[])"><!-- --></A><H3>
1917
getNonMatchingHeaders</H3>
1918
<PRE>
1919
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A> <B>getNonMatchingHeaders</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[]&nbsp;names)
1920
                                  throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1921
<DL>
1922
<DD>Return non-matching headers from this Message as an
1923
 Enumeration of Header objects.
1924
<P>
1925
<DD><DL>
1926
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/Part.html#getNonMatchingHeaders(java.lang.String[])">getNonMatchingHeaders</A></CODE> in interface <CODE><A HREF="../../../javax/mail/Part.html" title="interface in javax.mail">Part</A></CODE></DL>
1927
</DD>
1928
<DD><DL>
1929
 
1930
<DT><B>Returns:</B><DD>enumeration of Header objects
1931
<DT><B>Throws:</B>
1932
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1933
</DD>
1934
</DL>
1935
<HR>
1936
 
1937
<A NAME="addHeaderLine(java.lang.String)"><!-- --></A><H3>
1938
addHeaderLine</H3>
1939
<PRE>
1940
public void <B>addHeaderLine</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>&nbsp;line)
1941
                   throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1942
<DL>
1943
<DD>Add a header line to this body part
1944
<P>
1945
<DD><DL>
1946
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#addHeaderLine(java.lang.String)">addHeaderLine</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
1947
</DD>
1948
<DD><DL>
1949
 
1950
<DT><B>Throws:</B>
1951
<DD><CODE><A HREF="../../../javax/mail/IllegalWriteException.html" title="class in javax.mail">IllegalWriteException</A></CODE> - if the underlying
1952
                        implementation does not support modification
1953
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1954
</DD>
1955
</DL>
1956
<HR>
1957
 
1958
<A NAME="getAllHeaderLines()"><!-- --></A><H3>
1959
getAllHeaderLines</H3>
1960
<PRE>
1961
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A> <B>getAllHeaderLines</B>()
1962
                              throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1963
<DL>
1964
<DD>Get all header lines as an Enumeration of Strings. A Header
1965
 line is a raw RFC 822 header line, containing both the "name"
1966
 and "value" field.
1967
<P>
1968
<DD><DL>
1969
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#getAllHeaderLines()">getAllHeaderLines</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
1970
</DD>
1971
<DD><DL>
1972
 
1973
<DT><B>Throws:</B>
1974
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1975
</DD>
1976
</DL>
1977
<HR>
1978
 
1979
<A NAME="getMatchingHeaderLines(java.lang.String[])"><!-- --></A><H3>
1980
getMatchingHeaderLines</H3>
1981
<PRE>
1982
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A> <B>getMatchingHeaderLines</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[]&nbsp;names)
1983
                                   throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
1984
<DL>
1985
<DD>Get matching header lines as an Enumeration of Strings.
1986
 A Header line is a raw RFC 822 header line, containing both
1987
 the "name" and "value" field.
1988
<P>
1989
<DD><DL>
1990
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#getMatchingHeaderLines(java.lang.String[])">getMatchingHeaderLines</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
1991
</DD>
1992
<DD><DL>
1993
 
1994
<DT><B>Throws:</B>
1995
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
1996
</DD>
1997
</DL>
1998
<HR>
1999
 
2000
<A NAME="getNonMatchingHeaderLines(java.lang.String[])"><!-- --></A><H3>
2001
getNonMatchingHeaderLines</H3>
2002
<PRE>
2003
public <A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/util/Enumeration.html?is-external=true" title="class or interface in java.util">Enumeration</A> <B>getNonMatchingHeaderLines</B>(<A HREF="http://java.sun.com/j2se/1.4.2/docs/api/java/lang/String.html?is-external=true" title="class or interface in java.lang">String</A>[]&nbsp;names)
2004
                                      throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
2005
<DL>
2006
<DD>Get non-matching header lines as an Enumeration of Strings.
2007
 A Header line is a raw RFC 822 header line, containing both
2008
 the "name"  and "value" field.
2009
<P>
2010
<DD><DL>
2011
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/mail/internet/MimePart.html#getNonMatchingHeaderLines(java.lang.String[])">getNonMatchingHeaderLines</A></CODE> in interface <CODE><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></CODE></DL>
2012
</DD>
2013
<DD><DL>
2014
 
2015
<DT><B>Throws:</B>
2016
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
2017
</DD>
2018
</DL>
2019
<HR>
2020
 
2021
<A NAME="updateHeaders()"><!-- --></A><H3>
2022
updateHeaders</H3>
2023
<PRE>
2024
protected void <B>updateHeaders</B>()
2025
                      throws <A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></PRE>
2026
<DL>
2027
<DD>Examine the content of this body part and update the appropriate
2028
 MIME headers.  Typical headers that get set here are
2029
 <code>Content-Type</code> and <code>Content-Transfer-Encoding</code>.
2030
 Headers might need to be updated in two cases:
2031
 
2032
 <br>
2033
 - A message being crafted by a mail application will certainly
2034
 need to activate this method at some point to fill up its internal
2035
 headers.
2036
 
2037
 <br>
2038
 - A message read in from a Store will have obtained
2039
 all its headers from the store, and so doesn't need this.
2040
 However, if this message is editable and if any edits have
2041
 been made to either the content or message structure, we might
2042
 need to resync our headers.
2043
 
2044
 <br>
2045
 In both cases this method is typically called by the
2046
 <code>Message.saveChanges</code> method.
2047
<P>
2048
<DD><DL>
2049
</DL>
2050
</DD>
2051
<DD><DL>
2052
 
2053
<DT><B>Throws:</B>
2054
<DD><CODE><A HREF="../../../javax/mail/MessagingException.html" title="class in javax.mail">MessagingException</A></CODE></DL>
2055
</DD>
2056
</DL>
2057
<!-- ========= END OF CLASS DATA ========= -->
2058
<HR>
2059
 
2060
 
2061
<!-- ======= START OF BOTTOM NAVBAR ====== -->
2062
<A NAME="navbar_bottom"><!-- --></A>
2063
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
2064
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
2065
<TR>
2066
<TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
2067
<A NAME="navbar_bottom_firstrow"><!-- --></A>
2068
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
2069
  <TR ALIGN="center" VALIGN="top">
2070
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
2071
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
2072
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
2073
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="class-use/MimeBodyPart.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
2074
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
2075
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
2076
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
2077
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
2078
  </TR>
2079
</TABLE>
2080
</TD>
2081
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
2082
</EM>
2083
</TD>
2084
</TR>
2085
 
2086
<TR>
2087
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
2088
&nbsp;<A HREF="../../../javax/mail/internet/MailDateFormat.html" title="class in javax.mail.internet"><B>PREV CLASS</B></A>&nbsp;
2089
&nbsp;<A HREF="../../../javax/mail/internet/MimeMessage.html" title="class in javax.mail.internet"><B>NEXT CLASS</B></A></FONT></TD>
2090
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
2091
  <A HREF="../../../index.html?javax/mail/internet/MimeBodyPart.html" target="_top"><B>FRAMES</B></A>  &nbsp;
2092
&nbsp;<A HREF="MimeBodyPart.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
2093
&nbsp;<SCRIPT type="text/javascript">
2094
  <!--
2095
  if(window==top) {
2096
    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
2097
  }
2098
  //-->
2099
</SCRIPT>
2100
<NOSCRIPT>
2101
  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
2102
</NOSCRIPT>
2103
 
2104
 
2105
</FONT></TD>
2106
</TR>
2107
<TR>
2108
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
2109
  SUMMARY:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
2110
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
2111
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
2112
</TR>
2113
</TABLE>
2114
<A NAME="skip-navbar_bottom"></A>
2115
<!-- ======== END OF BOTTOM NAVBAR ======= -->
2116
 
2117
<HR>
2118
Copyright &#169; 2009 <a href="http://www.sun.com">Sun Microsystems, Inc.</a>. All Rights Reserved.
2119
</BODY>
2120
</HTML>