The answer to my question isn't here, where else should I look?
In addition to the JavaMail API spec and javadocs (available both fromour main web pageand includedin the download bundle), don't forget to check the README.txt and NOTES.txt files included with theJavaMail API package for additional important information.The javamail-interest mailing list is another source of information. Seeour main web pagefor instructionson how to subscribe and a pointer to the archives.The Java Developer Connection maintains a JavaMail forum, seehttp://forum.java.sun.com. Note that theJavaMail team monitors the javamail-interest mailing list, but does not monitor the JavaMail forum. jGuru also maintains a JavaMail FAQ, which you'll find athttp://www.jguru.com/faq/JavaMail.
Installation and Configuration
How do I install the JavaMail API implementation?
Unzip the distribution zip file and edit your CLASSPATH environment variable to include the mail.jar filethat was included with the JavaMail API distribution. You will also need an implementation of theJavaBeans Activation Framework (see below). See the README file (in the distribution) for additionaldetails and examples.
Does JavaMail include all the necessary mail servers?
No, the JavaMail API package does not include any mail servers. To use the JavaMail API package,you'll need to have access to an IMAP or POP3 mail server (for reading mail) and/or an SMTP mail server(for sending mail). These mail servers are usually provided by your Internet Service Provider or are a partof your organization's networking infrastructure. If you don't have access to such a mail server, see below.
Where can I get the necessary mail servers?
What host name, user name, or password should I use?
We do not provide a mail server for you to use. You must use your own mail server, or one provided byyour Internet Service Provider or the company you work for. Your network administrator can give you theinformation necessary to configure JavaMail to work with your mail server.
How do I configure JavaMail to work through my proxy server?
Most proxy servers support only the HTTP protocol. JavaMail doesn't use the HTTP protocol to read orsend mail. One of the major reasons for using a proxy server is to allow HTTP requests from within acorporate network to pass through a corporate firewall. The firewall will typically block most access to theInternet, but will allow requests from the proxy server to pass through. In addition, a mail server insidethe corporate network will perform a similar function for email, accepting messages via SMTP andforwarding them to their ultimate destination on the Internet, and accepting incoming messages andsending them to the appropriate internal mail server.If your proxy server supports the SOCKS V4 or V5 protocol (http://www.socks.nec.com/aboutsocks.html,RFC1928) and allows anonymous connections, you can tell the Java runtime to direct all TCP socketconnections to the SOCKS server. Seehttp://java.sun.com/j2se/1.4/docs/guide/net/properties.htmlforthe latest documentation of the socksProxyHost and socksProxyPort properties. These are system-levelproperties, not JavaMail session properties. They can be set from the command line when the applicationis invoked, for example: java -DsocksProxyHost=myproxy .... This facility can be used to direct the SMTP,IMAP, and POP3 communication from JavaMail to the SOCKS proxy server. Note that setting theseproperties directs
TCP sockets to the SOCKS proxy, which may have negative impact on other aspectsof your application.