73 lines
4.1 KiB
HTML
73 lines
4.1 KiB
HTML
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
|
||
|
|
<html>
|
||
|
|
<head>
|
||
|
|
<META http-equiv="Content-Type" content="text/html; charset=utf-8">
|
||
|
|
<LINK rel="stylesheet" type="text/css" href="../../../rzahg/ic.css">
|
||
|
|
|
||
|
|
<title>Example: JavaMail code</title>
|
||
|
|
</head>
|
||
|
|
|
||
|
|
<BODY>
|
||
|
|
<!-- Java sync-link -->
|
||
|
|
<SCRIPT LANGUAGE="Javascript" SRC="../../../rzahg/synch.js" TYPE="text/javascript"></SCRIPT>
|
||
|
|
|
||
|
|
<h5><a name="jmlexcode"></a>Example: JavaMail code</h5>
|
||
|
|
|
||
|
|
<p>The following code illustrates how an application component sends a message and saves it to the mail account's Sent folder:</p>
|
||
|
|
|
||
|
|
<pre>
|
||
|
|
...
|
||
|
|
// obtain JNDI initial context
|
||
|
|
javax.naming.InitialContext ctx = new javax.naming.InitialContext();
|
||
|
|
// use JNDI lookup to obtain Session
|
||
|
|
mail_session = (javax.mail.Session) ctx.lookup
|
||
|
|
("java:comp/env/mail/MailSession");
|
||
|
|
|
||
|
|
// create new mail message object using Session
|
||
|
|
MimeMessage msg = new MimeMessage(mail_session);
|
||
|
|
|
||
|
|
// set message properties
|
||
|
|
msg.setRecipients(Message.RecipientType.TO, InternetAddress.parse
|
||
|
|
("somebody@some_domain.net"));
|
||
|
|
msg.setFrom(new InternetAddress("me@my_company.com"));
|
||
|
|
msg.setSubject("Important message from me");
|
||
|
|
String msg_text = new String("Hello!");
|
||
|
|
msg.setText(msg_text);
|
||
|
|
|
||
|
|
// get Session object's store
|
||
|
|
Store store = mail_session.getStore();
|
||
|
|
// connect to store
|
||
|
|
store.connect();
|
||
|
|
// obtain reference to "Sent" folder
|
||
|
|
Folder f = store.getFolder("Sent");
|
||
|
|
// create "Sent" folder if it does not exist
|
||
|
|
if (!f.exists()) f.create(Folder.HOLDS_MESSAGES);
|
||
|
|
// add message to "Sent" folder
|
||
|
|
f.appendMessages(new Message[] {msg});
|
||
|
|
</pre>
|
||
|
|
|
||
|
|
<ul>
|
||
|
|
<li><p>The J2EE specification considers a mail session instance as a resource (a factory where mail transport and store connections can be obtained). You should never hard-code mail sessions. Instead, you must follow the J2EE programming model of configuring resources through the system facilities and then locating them through JNDI lookups.</p>
|
||
|
|
|
||
|
|
<p>In the sample code above, the line <tt>javax.mail.Session mail_session = (javax.mail.Session) ctx.lookup("java:comp/env/mail/MailSession3");</tt> is an example of using a resource name located through JNDI rather than hard-coding a mail session. You can consider the lookup name <tt>mail/MailSession3</tt> a soft link to the real resource.</p></li>
|
||
|
|
|
||
|
|
<li><p>You must define a resource reference for the mail resource in the deployment descriptor of the component, because a mail session is referenced in the JNDI lookup.</p>
|
||
|
|
|
||
|
|
<p>When you create this reference, Make sure that the name of the reference matches the name used in the code. For example, the code above uses <tt>java:comp/env/mail/MailSession3</tt> in the lookup; therefore, the name of this reference must be <tt>mail/Session3</tt> and the type of the resource must be <tt>javax.mail.Session</tt>. After being defined, the deployment descriptor contains the following entry for the mail resource reference:</p>
|
||
|
|
|
||
|
|
<pre><resource-reference>
|
||
|
|
<description>description</description>
|
||
|
|
<res-ref-name>mail/MailSession3</res-ref-name>
|
||
|
|
<res-type>javax.mail.Session</res-type>
|
||
|
|
<res-auth>Container</res-auth>
|
||
|
|
</pre>
|
||
|
|
</li>
|
||
|
|
|
||
|
|
<li><p>You must configure the mail resource that is referenced by your application component. The mail session you configure must have both the transport and mail access portions defined. Transport settings are required because the code is sending a message; mail access settings are required because they also save a copy to the local mail store. When you configure the mail session, you are asked to specify a JNDI name. This name is important and is required when you install your application (to link up the resource references in your application with the real resources that you have configured).</p></li>
|
||
|
|
</ul>
|
||
|
|
|
||
|
|
<p><strong>Note:</strong> The preceding example uses the IMAP protocol for receiving e-mail messages. On the iSeries platform, it is supported by the Domino e-mail server, but not the TCP/IP Connectivity Utilities e-mail services, which only provides access to received messages through the POP3 protocol.</p>
|
||
|
|
|
||
|
|
</body>
|
||
|
|
</html>
|