Subversion Repositories javautils

Rev

Blame | Last modification | View Log | RSS feed

  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:43 PST 2009 -->
  6. <META http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
  7. <TITLE>
  8. javax.mail.internet (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="javax.mail.internet (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="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT>&nbsp;</TD>
  43.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
  44.   <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-use.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/event/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
  60. &nbsp;<A HREF="../../../javax/mail/search/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
  61. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  62.   <A HREF="../../../index.html?javax/mail/internet/package-summary.html" target="_top"><B>FRAMES</B></A>  &nbsp;
  63. &nbsp;<A HREF="package-summary.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. </TABLE>
  79. <A NAME="skip-navbar_top"></A>
  80. <!-- ========= END OF TOP NAVBAR ========= -->
  81.  
  82. <HR>
  83. <H2>
  84. Package javax.mail.internet
  85. </H2>
  86. Classes specific to Internet mail systems.
  87. <P>
  88. <B>See:</B>
  89. <BR>
  90. &nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;<A HREF="#package_description"><B>Description</B></A>
  91. <P>
  92.  
  93. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
  94. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  95. <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
  96. <B>Interface Summary</B></FONT></TH>
  97. </TR>
  98. <TR BGCOLOR="white" CLASS="TableRowColor">
  99. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/MimePart.html" title="interface in javax.mail.internet">MimePart</A></B></TD>
  100. <TD>The MimePart interface models an <strong>Entity</strong> as defined
  101.  by MIME (RFC2045, Section 2.4).</TD>
  102. </TR>
  103. <TR BGCOLOR="white" CLASS="TableRowColor">
  104. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/SharedInputStream.html" title="interface in javax.mail.internet">SharedInputStream</A></B></TD>
  105. <TD>An InputStream that is backed by data that can be shared by multiple
  106.  readers may implement this interface.</TD>
  107. </TR>
  108. </TABLE>
  109. &nbsp;
  110.  
  111. <P>
  112.  
  113. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
  114. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  115. <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
  116. <B>Class Summary</B></FONT></TH>
  117. </TR>
  118. <TR BGCOLOR="white" CLASS="TableRowColor">
  119. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/ContentDisposition.html" title="class in javax.mail.internet">ContentDisposition</A></B></TD>
  120. <TD>This class represents a MIME ContentDisposition value.</TD>
  121. </TR>
  122. <TR BGCOLOR="white" CLASS="TableRowColor">
  123. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/ContentType.html" title="class in javax.mail.internet">ContentType</A></B></TD>
  124. <TD>This class represents a MIME ContentType value.</TD>
  125. </TR>
  126. <TR BGCOLOR="white" CLASS="TableRowColor">
  127. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/HeaderTokenizer.html" title="class in javax.mail.internet">HeaderTokenizer</A></B></TD>
  128. <TD>This class tokenizes RFC822 and MIME headers into the basic
  129.  symbols specified by RFC822 and MIME.</TD>
  130. </TR>
  131. <TR BGCOLOR="white" CLASS="TableRowColor">
  132. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/HeaderTokenizer.Token.html" title="class in javax.mail.internet">HeaderTokenizer.Token</A></B></TD>
  133. <TD>The Token class represents tokens returned by the
  134.  HeaderTokenizer.</TD>
  135. </TR>
  136. <TR BGCOLOR="white" CLASS="TableRowColor">
  137. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/InternetAddress.html" title="class in javax.mail.internet">InternetAddress</A></B></TD>
  138. <TD>This class represents an Internet email address using the syntax
  139.  of <a href="http://www.ietf.org/rfc/rfc822.txt">RFC822</a>.</TD>
  140. </TR>
  141. <TR BGCOLOR="white" CLASS="TableRowColor">
  142. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/InternetHeaders.html" title="class in javax.mail.internet">InternetHeaders</A></B></TD>
  143. <TD>InternetHeaders is a utility class that manages RFC822 style
  144.  headers.</TD>
  145. </TR>
  146. <TR BGCOLOR="white" CLASS="TableRowColor">
  147. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/InternetHeaders.InternetHeader.html" title="class in javax.mail.internet">InternetHeaders.InternetHeader</A></B></TD>
  148. <TD>An individual internet header.</TD>
  149. </TR>
  150. <TR BGCOLOR="white" CLASS="TableRowColor">
  151. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/MailDateFormat.html" title="class in javax.mail.internet">MailDateFormat</A></B></TD>
  152. <TD>Formats and parses date specification based on the
  153.  draft-ietf-drums-msg-fmt-08 dated January 26, 2000.</TD>
  154. </TR>
  155. <TR BGCOLOR="white" CLASS="TableRowColor">
  156. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/MimeBodyPart.html" title="class in javax.mail.internet">MimeBodyPart</A></B></TD>
  157. <TD>This class represents a MIME body part.</TD>
  158. </TR>
  159. <TR BGCOLOR="white" CLASS="TableRowColor">
  160. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/MimeMessage.html" title="class in javax.mail.internet">MimeMessage</A></B></TD>
  161. <TD>This class represents a MIME style email message.</TD>
  162. </TR>
  163. <TR BGCOLOR="white" CLASS="TableRowColor">
  164. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/MimeMessage.RecipientType.html" title="class in javax.mail.internet">MimeMessage.RecipientType</A></B></TD>
  165. <TD>This inner class extends the javax.mail.Message.RecipientType
  166.  class to add additional RecipientTypes.</TD>
  167. </TR>
  168. <TR BGCOLOR="white" CLASS="TableRowColor">
  169. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/MimeMultipart.html" title="class in javax.mail.internet">MimeMultipart</A></B></TD>
  170. <TD>The MimeMultipart class is an implementation of the abstract Multipart
  171.  class that uses MIME conventions for the multipart data.</TD>
  172. </TR>
  173. <TR BGCOLOR="white" CLASS="TableRowColor">
  174. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/MimePartDataSource.html" title="class in javax.mail.internet">MimePartDataSource</A></B></TD>
  175. <TD>A utility class that implements a DataSource out of
  176.  a MimePart.</TD>
  177. </TR>
  178. <TR BGCOLOR="white" CLASS="TableRowColor">
  179. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/MimeUtility.html" title="class in javax.mail.internet">MimeUtility</A></B></TD>
  180. <TD>This is a utility class that provides various MIME related
  181.  functionality.</TD>
  182. </TR>
  183. <TR BGCOLOR="white" CLASS="TableRowColor">
  184. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/NewsAddress.html" title="class in javax.mail.internet">NewsAddress</A></B></TD>
  185. <TD>This class models an RFC1036 newsgroup address.</TD>
  186. </TR>
  187. <TR BGCOLOR="white" CLASS="TableRowColor">
  188. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/ParameterList.html" title="class in javax.mail.internet">ParameterList</A></B></TD>
  189. <TD>This class holds MIME parameters (attribute-value pairs).</TD>
  190. </TR>
  191. <TR BGCOLOR="white" CLASS="TableRowColor">
  192. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/PreencodedMimeBodyPart.html" title="class in javax.mail.internet">PreencodedMimeBodyPart</A></B></TD>
  193. <TD>A MimeBodyPart that handles data that has already been encoded.</TD>
  194. </TR>
  195. </TABLE>
  196. &nbsp;
  197.  
  198. <P>
  199.  
  200. <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
  201. <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
  202. <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
  203. <B>Exception Summary</B></FONT></TH>
  204. </TR>
  205. <TR BGCOLOR="white" CLASS="TableRowColor">
  206. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/AddressException.html" title="class in javax.mail.internet">AddressException</A></B></TD>
  207. <TD>The exception thrown when a wrongly formatted address is encountered.</TD>
  208. </TR>
  209. <TR BGCOLOR="white" CLASS="TableRowColor">
  210. <TD WIDTH="15%"><B><A HREF="../../../javax/mail/internet/ParseException.html" title="class in javax.mail.internet">ParseException</A></B></TD>
  211. <TD>The exception thrown due to an error in parsing RFC822
  212.  or MIME headers</TD>
  213. </TR>
  214. </TABLE>
  215. &nbsp;
  216.  
  217. <P>
  218. <A NAME="package_description"><!-- --></A><H2>
  219. Package javax.mail.internet Description
  220. </H2>
  221.  
  222. <P>
  223. Classes specific to Internet mail systems.
  224. This package supports features that are specific to Internet mail systems
  225. based on the MIME standard
  226. (<A HREF="http://www.ietf.org/rfc/rfc2045.txt" TARGET="_top">RFC 2045</A>,
  227. <A HREF="http://www.ietf.org/rfc/rfc2045.txt" TARGET="_top">RFC 2046</A>, and
  228. <A HREF="http://www.ietf.org/rfc/rfc2045.txt" TARGET="_top">RFC 2047</A>).
  229. The IMAP, SMTP, and POP3 protocols use
  230. <A HREF="../../../javax/mail/internet/MimeMessage.html" title="class in javax.mail.internet"><CODE>MimeMessages</CODE></A>.
  231. <P>
  232. The JavaMail API specification requires support for the following properties,
  233. which must be set in the <code>System</code> properties.
  234. The properties are always set as strings; the Type column describes
  235. how the string is interpreted.  For example, use (in J2SE 1.2 and newer)
  236. <PRE>
  237.         System.setProperty("mail.mime.address.strict", "false");
  238. </PRE>
  239. to set the <CODE>mail.mime.address.strict</CODE> property,
  240. which is of type boolean.
  241. <P>
  242. <TABLE BORDER>
  243. <TR>
  244. <TH>Name</TH>
  245. <TH>Type</TH>
  246. <TH>Description</TH>
  247. </TR>
  248.  
  249. <TR>
  250. <TD>mail.mime.address.strict</TD>
  251. <TD>boolean</TD>
  252. <TD>
  253. The <code>mail.mime.address.strict</code> session property controls
  254. the parsing of address headers.  By default, strict parsing of address
  255. headers is done.  If this property is set to <code>"false"</code>,
  256. strict parsing is not done and many illegal addresses that sometimes
  257. occur in real messages are allowed.  See the <code>InternetAddress</code>
  258. class for details.
  259. </TD>
  260. </TR>
  261.  
  262. <TR>
  263. <TD>mail.mime.charset</TD>
  264. <TD>String</TD>
  265. <TD>
  266. The <code>mail.mime.charset</code> System property can
  267. be used to specify the default MIME charset to use for encoded words
  268. and text parts that don't otherwise specify a charset.  Normally, the
  269. default MIME charset is derived from the default Java charset, as
  270. specified in the <code>file.encoding</code> System property.  Most
  271. applications will have no need to explicitly set the default MIME
  272. charset.  In cases where the default MIME charset to be used for
  273. mail messages is different than the charset used for files stored on
  274. the system, this property should be set.
  275. </TD>
  276. </TR>
  277.  
  278. <TR>
  279. <TD>mail.mime.decodetext.strict</TD>
  280. <TD>boolean</TD>
  281. <TD>
  282. The <code>mail.mime.decodetext.strict</code> property controls
  283. decoding of MIME encoded words.  The MIME spec requires that encoded
  284. words start at the beginning of a whitespace separated word.  Some
  285. mailers incorrectly include encoded words in the middle of a word.
  286. If the <code>mail.mime.decodetext.strict</code> System property is
  287. set to <code>"false"</code>, an attempt will be made to decode these
  288. illegal encoded words. The default is true.
  289. </TD>
  290. </TR>
  291.  
  292. <TR>
  293. <TD>mail.mime.encodeeol.strict</TD>
  294. <TD>boolean</TD>
  295. <TD>
  296. The <code>mail.mime.encodeeol.strict</code> property controls the
  297. choice of Content-Transfer-Encoding for MIME parts that are not of
  298. type "text".  Often such parts will contain textual data for which
  299. an encoding that allows normal end of line conventions is appropriate.
  300. In rare cases, such a part will appear to contain entirely textual
  301. data, but will require an encoding that preserves CR and LF characters
  302. without change.  If the <code>mail.mime.encodeeol.strict</code>
  303. System property is set to <code>"true"</code>, such an encoding will
  304. be used when necessary.  The default is false.
  305. </TD>
  306. </TR>
  307.  
  308. <TR>
  309. <TD>mail.mime.decodefilename</TD>
  310. <TD>boolean</TD>
  311. <TD>
  312. If set to <code>"true"</code>, the <code>getFileName</code> method
  313. uses the <code>MimeUtility</code>
  314. method <code>decodeText</code> to decode any
  315. non-ASCII characters in the filename.  Note that this decoding
  316. violates the MIME specification, but is useful for interoperating
  317. with some mail clients that use this convention.
  318. The default is false.
  319. </TD>
  320. </TR>
  321.  
  322. <TR>
  323. <TD>mail.mime.encodefilename</TD>
  324. <TD>boolean</TD>
  325. <TD>
  326. If set to <code>"true"</code>, the <code>setFileName</code> method
  327. uses the <code>MimeUtility</code>
  328. method <code>encodeText</code> to encode any
  329. non-ASCII characters in the filename.  Note that this encoding
  330. violates the MIME specification, but is useful for interoperating
  331. with some mail clients that use this convention.
  332. The default is false.
  333. </TD>
  334. </TR>
  335.  
  336. <TR>
  337. <TD>mail.mime.decodeparameters</TD>
  338. <TD>boolean</TD>
  339. <TD>
  340. If set to <code>"true"</code>, non-ASCII parameters in a
  341. <code>ParameterList</code>, e.g., in a Content-Type header,
  342. will be decoded as specified by
  343. <A HREF="http://www.ietf.org/rfc/rfc2231.txt" TARGET="_top">RFC 2231</A>.
  344. The default is false.
  345. </TD>
  346. </TR>
  347.  
  348. <TR>
  349. <TD>mail.mime.encodeparameters</TD>
  350. <TD>boolean</TD>
  351. <TD>
  352. If set to <code>"true"</code>, non-ASCII parameters in a
  353. <code>ParameterList</code>, e.g., in a Content-Type header,
  354. will be encoded as specified by
  355. <A HREF="http://www.ietf.org/rfc/rfc2231.txt" TARGET="_top">RFC 2231</A>.
  356. The default is false.
  357. </TD>
  358. </TR>
  359.  
  360. <TR>
  361. <TD>mail.mime.multipart. ignoremissingendboundary</TD>
  362. <TD>boolean</TD>
  363. <TD>
  364. Normally, when parsing a multipart MIME message, a message that is
  365. missing the final end boundary line is not considered an error.
  366. The data simply ends at the end of the input.  Note that messages
  367. of this form violate the MIME specification.  If the property
  368. <code>mail.mime.multipart.ignoremissingendboundary</code> is set
  369. to <code>false</code>, such messages are considered an error and a
  370. <code>MesagingException</code> will be thrown when parsing such a
  371. message.
  372. </TD>
  373. </TR>
  374.  
  375. <TR>
  376. <TD>mail.mime.multipart. ignoremissingboundaryparameter</TD>
  377. <TD>boolean</TD>
  378. <TD>
  379. If the Content-Type header for a multipart content does not have
  380. a <code>boundary</code> parameter, the multipart parsing code
  381. will look for the first line in the content that looks like a
  382. boundary line and extract the boundary parameter from the line.
  383. If this property is set to <code>"false"</code>, a
  384. <code>MessagingException</code> will be thrown if the Content-Type
  385. header doesn't specify a boundary parameter.
  386. The default is true.
  387. </TD>
  388. </TR>
  389.  
  390. </TABLE>
  391.  
  392.  
  393.  
  394. <P>
  395. The following properties are supported by Sun's implementation of
  396. JavaMail, but are not currently a required part of the specification.
  397. As above, these must be set as <CODE>System</CODE> properties.
  398. The names, types, defaults, and semantics of these properties may
  399. change in future releases.
  400. <P>
  401. <TABLE BORDER>
  402. <TR>
  403. <TH>Name</TH>
  404. <TH>Type</TH>
  405. <TH>Description</TH>
  406. </TR>
  407.  
  408. <TR>
  409. <TD>mail.mime.base64.ignoreerrors</TD>
  410. <TD>boolean</TD>
  411. <TD>
  412. If set to <code>"true"</code>, the BASE64 decoder will ignore errors
  413. in the encoded data, returning EOF.  This may be useful when dealing
  414. with improperly encoded messages that contain extraneous data at the
  415. end of the encoded stream.  Note however that errors anywhere in the
  416. stream will cause the decoder to stop decoding so this should be used
  417. with extreme caution.  The default is false.
  418. </TD>
  419. </TR>
  420.  
  421. <TR>
  422. <TD>mail.mime.foldtext</TD>
  423. <TD>boolean</TD>
  424. <TD>
  425. If set to <code>"true"</code>, header fields containing just text
  426. such as the <code>Subject</code> and <code>Content-Description</code>
  427. header fields, and long parameter values in structured headers such
  428. as <code>Content-Type</code> will be folded (broken into 76 character lines)
  429. when set and unfolded when read.  The default is true.
  430. </TD>
  431. </TR>
  432.  
  433. <TR>
  434. <TD>mail.mime.setcontenttypefilename</TD>
  435. <TD>boolean</TD>
  436. <TD>
  437. If set to <code>"true"</code>, the <code>setFileName</code> method
  438. will also set the <code>name</code> parameter on the <code>Content-Type</code>
  439. header to the specified filename.  This supports interoperability with
  440. some old mail clients.  The default is true.
  441. </TD>
  442. </TR>
  443.  
  444. <TR>
  445. <TD>mail.mime.setdefaulttextcharset</TD>
  446. <TD>boolean</TD>
  447. <TD>
  448. When updating the headers of a message, a body
  449. part with a <code>text</code> content type but no <code>charset</code>
  450. parameter will have a <code>charset</code> parameter added to it
  451. if this property is set to <code>"true"</code>.
  452. The default is true.
  453. </TD>
  454. </TR>
  455.  
  456. <TR>
  457. <TD>mail.mime.parameters.strict</TD>
  458. <TD>boolean</TD>
  459. <TD>
  460. If set to false, when reading a message, parameter values in header fields
  461. such as <code>Content-Type</code> and <code>Content-Disposition</code>
  462. are allowed to contain whitespace and other special characters without
  463. being quoted; the parameter value ends at the next semicolon.
  464. If set to true (the default), parameter values are required to conform
  465. to the MIME specification and must be quoted if they contain whitespace
  466. or special characters.
  467. </TD>
  468. </TR>
  469.  
  470. <TR>
  471. <TD>mail.mime.applefilenames</TD>
  472. <TD>boolean</TD>
  473. <TD>
  474. Apple Mail incorrectly encodes filenames that contain spaces,
  475. forgetting to quote the parameter value.  If this property is
  476. set to <code>"true"</code>, JavaMail will try to detect this
  477. situation when parsing parameters and work around it.
  478. The default is false.
  479. Note that this property handles a subset of the cases handled
  480. by setting the mail.mime.parameters.strict property to false.
  481. This property will likely be removed in a future release.
  482. </TD>
  483. </TR>
  484.  
  485. <TR>
  486. <TD>mail.mime. ignoreunknownencoding</TD>
  487. <TD>boolean</TD>
  488. <TD>
  489. If set to <code>"true"</code>, an unknown value in the
  490. <code>Content-Transfer-Encoding</code> header will be ignored
  491. when reading a message and an encoding of "8bit" will be assumed.
  492. If set to <code>"false"</code>, an exception is thrown for an
  493. unknown encoding value.  The default is false.
  494. </TD>
  495. </TR>
  496.  
  497. <TR>
  498. <TD>mail.mime.uudecode. ignoreerrors</TD>
  499. <TD>boolean</TD>
  500. <TD>
  501. If set to <code>"true"</code>, errors in the encoded format of a
  502. uuencoded document will be ignored when reading a message part.
  503. If set to <code>"false"</code>, an exception is thrown for an
  504. incorrectly encoded message part.  The default is false.
  505. </TD>
  506. </TR>
  507.  
  508. <TR>
  509. <TD>mail.mime.uudecode. ignoremissingbeginend</TD>
  510. <TD>boolean</TD>
  511. <TD>
  512. If set to <code>"true"</code>, a missing "being" or "end" line in a
  513. uuencoded document will be ignored when reading a message part.
  514. If set to <code>"false"</code>, an exception is thrown for a
  515. uuencoded message part without the required "begin" and "end" lines.
  516. The default is false.
  517. </TD>
  518. </TR>
  519.  
  520. <TR>
  521. <TD>mail.mime.multipart. allowempty</TD>
  522. <TD>boolean</TD>
  523. <TD>
  524. Normally, when writing out a MimeMultipart that contains no body
  525. parts, or when trying to parse a multipart message with no body parts,
  526. a <code>MessagingException</code> is thrown.  The MIME spec does not allow
  527. multipart content with no body parts.  This
  528. System property may be set to <code>"true"</code> to override this behavior.
  529. When writing out such a MimeMultipart, a single empty part will be
  530. included.  When reading such a multipart, a MimeMultipart will be created
  531. with no body parts.
  532. The default value of this property is false.
  533. </TD>
  534. </TR>
  535.  
  536. <TR>
  537. <TD>mail.mime.multipart. ignoreexistingboundaryparameter</TD>
  538. <TD>boolean</TD>
  539. <TD>
  540. Normally the boundary parameter in the Content-Type header of a multipart
  541. body part is used to specify the separator between parts of the multipart
  542. body.  This System property may be set to <code>"true"</code> to cause
  543. the parser to look for a line in the multipart body that looks like a
  544. boundary line and use that value as the separator between subsequent parts.
  545. This may be useful in cases where a broken anti-virus product has rewritten
  546. the message incorrectly such that the boundary parameter and the actual
  547. boundary value no longer match.
  548. The default value of this property is false.
  549. </TD>
  550. </TR>
  551.  
  552. <TR>
  553. <TD>mail.alternates</TD>
  554. <TD>String</TD>
  555. <TD>
  556. A string containing other email addresses that the current user is known by.
  557. The <code>MimeMessage</code> <code>reply</code> method will eliminate any
  558. of these addresses from the recipient list in the message it constructs,
  559. to avoid sending the reply back to the sender.
  560. </TD>
  561. </TR>
  562.  
  563. <TR>
  564. <TD>mail.replyallcc</TD>
  565. <TD>boolean</TD>
  566. <TD>
  567. If set to <code>"true"</code>, the <code>MimeMessage</code>
  568. <code>reply</code> method will put all recipients except the original
  569. sender in the <code>Cc</code> list of the newly constructed message.
  570. Normally, recipients in the <code>To</code> header of the original
  571. message will also appear in the <code>To</code> list of the newly
  572. constructed message.
  573. </TD>
  574. </TR>
  575.  
  576. </TABLE>
  577. <P>
  578.  
  579. <P>
  580. <DL>
  581. </DL>
  582. <HR>
  583.  
  584.  
  585. <!-- ======= START OF BOTTOM NAVBAR ====== -->
  586. <A NAME="navbar_bottom"><!-- --></A>
  587. <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
  588. <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
  589. <TR>
  590. <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
  591. <A NAME="navbar_bottom_firstrow"><!-- --></A>
  592. <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
  593.  <TR ALIGN="center" VALIGN="top">
  594.  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A>&nbsp;</TD>
  595.  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT>&nbsp;</TD>
  596.  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <FONT CLASS="NavBarFont1">Class</FONT>&nbsp;</TD>
  597.  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-use.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A>&nbsp;</TD>
  598.  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  599.  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  600.  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  601.  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  602.  </TR>
  603. </TABLE>
  604. </TD>
  605. <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
  606. </EM>
  607. </TD>
  608. </TR>
  609.  
  610. <TR>
  611. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  612. &nbsp;<A HREF="../../../javax/mail/event/package-summary.html"><B>PREV PACKAGE</B></A>&nbsp;
  613. &nbsp;<A HREF="../../../javax/mail/search/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
  614. <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  615.  <A HREF="../../../index.html?javax/mail/internet/package-summary.html" target="_top"><B>FRAMES</B></A>  &nbsp;
  616. &nbsp;<A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
  617. &nbsp;<SCRIPT type="text/javascript">
  618.  <!--
  619.  if(window==top) {
  620.    document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>');
  621.  }
  622.  //-->
  623. </SCRIPT>
  624. <NOSCRIPT>
  625.  <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>
  626. </NOSCRIPT>
  627.  
  628.  
  629. </FONT></TD>
  630. </TR>
  631. </TABLE>
  632. <A NAME="skip-navbar_bottom"></A>
  633. <!-- ======== END OF BOTTOM NAVBAR ======= -->
  634.  
  635. <HR>
  636. Copyright &#169; 2009 <a href="http://www.sun.com">Sun Microsystems, Inc.</a>. All Rights Reserved.
  637. </BODY>
  638. </HTML>
  639.