Login | ViewVC Help
View File | Revision Log | Show Annotations | Download File | View Changeset | Root Listing
root/javautils/ViaThinkSoft Java Utils/lib/javamail-1.4.3/README.txt
Revision: 7
Committed: Mon Jun 14 07:55:39 2010 UTC (10 years ago) by daniel-marschall
Content type: text/plain
File size: 8304 byte(s)
Log Message:
Java Mail komplett hinzugefĆ¼gt

File Contents

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