-
Notifications
You must be signed in to change notification settings - Fork 1
/
Copy pathREADME.txt
252 lines (184 loc) · 8.33 KB
/
README.txt
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
README
======
JavaMail(TM) API 1.4.7 release
------------------------------
Welcome to the JavaMail API 1.4.7 release! This release includes
versions of the JavaMail API implementation, IMAP, SMTP, and POP3
service providers, some examples, and documentation for the JavaMail
API.
Please see the FAQ at http://www.oracle.com/technetwork/java/javamail/faq/
JDK Version notes
-----------------
The JavaMail API supports JDK 1.4 or higher. Note that we have
currently tested this implementation with JDK 1.4, 1.5, and 1.6.
While JavaMail will work with JAF 1.0.2, we recommend the use of JAF 1.1
or newer. JAF 1.1.1 is currently the newest version. Note that JAF 1.1
is included in JDK 1.6 and JAF 1.1.1 is included in JDK 1.6.0_10 and
later.
Protocols supported
-------------------
This release supports the following Internet standard mail protocols:
IMAP - a message Store protocol, for reading messages from a server
POP3 - a message Store protocol, for reading messages from a server
SMTP - a message Transport protocol, for sending messages to a server
The following table lists the names of the supported protocols (as used
in the JavaMail API) and their capabilities:
Protocol Store or Uses Supports
Name Transport? SSL? STARTTLS?
-------------------------------------------------
imap Store No Yes
imaps Store Yes N/A
gimap Store Yes N/A
pop3 Store No Yes
pop3s Store Yes N/A
smtp Transport No Yes
smtps Transport Yes N/A
See our web page at http://www.oracle.com/technetwork/java/javamail/
for the latest information on third party protocol providers.
Contents
--------
Included in this release are the following:
README.txt this file
LICENSE.txt Software license
NOTES.txt Notes, issues and known bugs
SSLNOTES.txt Notes on using SSL/TLS with JavaMail
CHANGES.txt Changes since the previous release
COMPAT.txt Important notes about compatibility
mail.jar The JavaMail API and all service providers,
most users need *only* this jar file
lib/mailapi.jar The JavaMail API with no service providers
lib/imap.jar The IMAP service provider
lib/smtp.jar The SMTP service provider
lib/pop3.jar The POP3 service provider
lib/dsn.jar multipart/report DSN message support
lib/gimap.jar Gmail IMAP provider
docs/JavaMail-1.1-changes.txt
Description of the new APIs that were added in
JavaMail API 1.1
docs/JavaMail-1.2-changes.txt
Description of the new APIs that were added in
JavaMail API 1.2
docs/JavaMail-1.3-changes.txt
Description of the new APIs that were added in
JavaMail API 1.3
docs/JavaMail-1.4-changes.txt
Description of the new APIs that were added in
JavaMail API 1.4
docs/JavaMail-1.2.ps
Postscript version of the JavaMail API 1.2 specification
docs/JavaMail-1.2.pdf
PDF version of the JavaMail API 1.2 specification
docs/Providers.ps
Postscript version of the JavaMail Service Provider
guide.
docs/Providers.pdf
PDF version of the JavaMail Service Provider guide.
docs/javadocs/ The JavaMail API javadocs
demo/README.txt Instructions for running the demo programs
demo/CRLFOutputStream.java
demo OutputStream filter to convert all line terminators
to CRLF
demo/NewlineOutputStream.java
demo OutputStream filter to convert all line terminators
to platform's line terminator
demo/copier.java demo program to copy mail between folders
demo/folderlist.java demo program to list subfolders
demo/monitor.java demo program to monitor for new mail
demo/mover.java demo program to move mail between folders
demo/msgmultisendsample.java
demo program to send a sample multipart message
demo/msgsend.java demo program to send a single part text message
to a specified recipient (ala /bin/mail)
demo/msgsendsample.java
demo program to send a sample single part text message
demo/msgshow.java demo program to read messages from an IMAP store
demo/namespace.java demo program that illustrates use of namespace APIs
demo/populate.java demo program that copies entire folder hierarchies
demo/registry.java demo program that illustrates the registry
demo/search.java demo program to search folders
demo/sendfile.java demo program to send a file as an attachment
demo/sendhtml.java demo program to send html mail
demo/smtpsend.java demo program to illustrate handling SMTP error codes
demo/transport.java demo program to illustrate use of Transport
demo/uidmsgshow.java
demo program to read messages from an IMAP store
demo/client/ source files for cool demo program that implements
a simple mail reader. (Uses Swing)
demo/client/README.txt
README file for running the simple mail-reader demo
demo/servlet/ source for a simple servlet that allows using a
web browser to read and send mail
demo/servlet/README.txt
README file that describes the JavaMailServlet
demo/logging/ source files for demo program showing use of the
com.sun.mail.util.logging.MailHandler class
demo/outlook/ source files for demo classes showing how to handle
old non-MIME messages generated by Outlook
Requirements
------------
Note that the JavaMail API requires the JavaBeans(TM) Activation
Framework package to be installed as well if you're using JDK 1.5
or earlier. Download the latest version of the JavaBeans Activation
Framework from
http://www.oracle.com/technetwork/java/javase/index-jsp-136939.html
and install it in a suitable location.
Installation
------------
UNIX/Linux
----------
1. Unzip the javamail1_4_7.zip archive.
(You may have already done this.)
2. Set your CLASSPATH to include the "mail.jar" file obtained from
the download, as well as the current directory.
Assuming you unzipped javamail1_4_7.zip in /u/me/download/ the
following would work:
export CLASSPATH=$CLASSPATH:/u/me/download/javamail-1.4.7/mail.jar:.
Also, if you're using JDK 1.5 or earlier, include the
"activation.jar" file that you obtained from downloading the
JavaBeans Activation Framework, in your CLASSPATH. For example:
export CLASSPATH=$CLASSPATH:/u/me/download/activation/activation.jar
3. Go to the demo directory
4. Compile any demo using your Java compiler. For example:
javac msgshow.java
5. Run the demo. The '-' option lists the required and optional
command-line options to successfully run any demo. For example:
java msgshow -
lists the available options. And
java msgshow -T imap -H <mailserver> -U <username> -P <passwd> -f INBOX 5
uses the IMAP protocol to display message number 5 from your INBOX.
(Additional instructions on how to run the simple mail reader demo
and servlet demo are provided in demo/client/README.txt and
demo/servlet/README.txt, respectively.)
Windows
-------
1. Unzip the javamail1_4_7.zip archive.
(You may have already done this.)
2. Set your CLASSPATH to include the "mail.jar" file obtained from
the download, as well as the current directory.
Assuming you unzipped javamail1_4_7.zip in c:\download the
following would work:
set CLASSPATH=%CLASSPATH%;c:\download\javamail-1.4.7\mail.jar;.
Also, if you're using JDK 1.5 or earlier, include the
"activation.jar" file that you obtained from downloading the
JavaBeans Activation Framework, in your CLASSPATH.
set CLASSPATH=%CLASSPATH%;c:\download\activation\activation.jar
3. Go to the demo directory
4. Compile any demo using your Java compiler. For example:
javac msgshow.java
5. Run the demo. The '-' option lists the required and optional
command-line options to successfully run any demo. For example:
java msgshow -
lists the available options. And
java msgshow -T imap -H <mailserver> -U <username> -P <passwd> -f INBOX 5
uses the IMAP protocol to display message number 5 from your INBOX.
(Additional instructions on how to run the simple mail reader demo
and servlet demo are provided in demo/client/README.txt and
demo/servlet/README.txt, respectively.)
Problems?
---------
The JavaMail FAQ at http://www.oracle.com/technetwork/java/javamail/faq/
includes information on protocols supported, installation problems,
debugging tips, etc.
See the NOTES.txt file for information on how to report bugs.
Enjoy!
The JavaMail API Team