blob: 66e2c88e24bda81bd6741154fdc0c8cf5c466cbc [file] [log] [blame]
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<!--
Licensed to the Apache Software Foundation (ASF) under one
or more contributor license agreements. See the NOTICE file
distributed with this work for additional information
regarding copyright ownership. The ASF licenses this file
to you under the Apache License, Version 2.0 (the
"License"); you may not use this file except in compliance
with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing,
software distributed under the License is distributed on an
"AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
KIND, either express or implied. See the License for the
specific language governing permissions and limitations
under the License.
-->
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en" dir="ltr">
<head>
<title>Specify Mail Resource Dialog Box</title>
<link rel="stylesheet" href="ide.css" title="Oracle BLAFDoc" type="text/css"/>
</head>
<body>
<p><a id="org.netbeans.modules.j2ee.earproject.ui.wizards.PanelModuleDetection" name="org.netbeans.modules.j2ee.earproject.ui.wizards.PanelModuleDetection"></a></p>
<div id="NBCSH4653"><!-- infolevel="all" infotype="General" --><a id="sthref669" name="sthref669"></a>
<h1>Specify Mail Resource Dialog Box</h1>
<a name="BEGIN" id="BEGIN"></a>
<p>You use this dialog box to automatically generate code that sends an e-mail from a Java file. The file must be in an EJB module project or a standard web application project. You cannot generate e-mail code in a free-form web application project.</p>
<table summary="User interface elements and descriptions" dir="ltr" border="1" width="100%" frame="hsides" rules="groups" cellpadding="3" cellspacing="0">
<col width="24%" />
<col width="*" />
<thead>
<tr align="left" valign="top">
<th align="left" valign="bottom" id="r1c1-t35">Element</th>
<th align="left" valign="bottom" id="r1c2-t35">Description</th>
</tr>
</thead>
<tbody>
<tr align="left" valign="top">
<td align="left" id="r2c1-t35" headers="r1c1-t35">JNDI Name</td>
<td align="left" headers="r2c1-t35 r1c2-t35">The JNDI name of the resource.</td>
</tr>
<tr align="left" valign="top">
<td align="left" id="r3c1-t35" headers="r1c1-t35">
<p>Service Locator Strategy</p>
</td>
<td align="left" headers="r3c1-t35 r1c2-t35">Choose to generate inline lookup code or use an existing service locator. You can click <b>Browse</b> to search for the existing service locator class name.
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG2709">
<param name="text" value="<html><u>How?</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</td>
</tr>
</tbody>
</table>
<br />
<!-- -->
<p>You use the dialog box as follows:</p>
<p>The IDE creates two methods:</p>
<ul>
<li><b>getSession</b>. Looks up the mail resource and creates a mail session.</li>
<li><b>sendMail</b>. Constructs and send the e-mail.</li>
</ul>
<p>The IDE also registers the resource reference in your module's general deployment descriptor. In your code, call the sendMail method and pass the e-mail address, subject, and body as parameters.</p>
<p><b>Note</b>: You have to configure the mail resource on the application server yourself. If your project's target server is the GlassFish server, the IDE automatically configures the resource reference in the application-specific deployment descriptor. If you are deploying to a different application server, you have to configure the server-specific deployment descriptors yourself.</p>
<a id="NBCSH4655" name="NBCSH4655"></a>
<hr><p><b>Related Topics</b></p>
<p><i>Developing Applications with NetBeans IDE</i>,
<object classid="java:org.netbeans.modules.javahelp.BrowserDisplayer">
<param name="content" value="http://www.oracle.com/pls/topic/lookup?ctx=nb8200&id=NBDAG2700">
<param name="text" value="<html><u>&quot;Creating an Enterprise Bean&quot;</u></html>">
<param name="textFontSize" value="medium">
<param name="textColor" value="blue">
</object>
</p>
<!-- -->
<!-- Start Footer -->
<table summary="" cellspacing="0" cellpadding="0" width="100%">
<tr>
<td align="left" width="86%"><a href="legal_notice.htm">
Licensed to the Apache Software Foundation (ASF) under one or more contributor license agreements; and to You under the Apache License, Version 2.0.</a>
</td>
</tr>
</table>
<!-- -->
</body>
</html>