![]() ![]() ![]() ![]() |
Before you begin
Configure a mail server or establish user credentials for an existing mail server. Mail sessions and the JavaMail API do not provide mail server functions; they merely enable applications to send and receive data from an existing mail server.
WebLogic Server includes the JavaMail API reference implementation from Sun Microsystems. JavaMail APIs provide applications and other J2EE modules with access to Internet Message Access Protocol (IMAP)- and Simple Mail Transfer Protocol (SMTP)-capable mail servers on your network or the Internet.
In the reference implementation of JavaMail, applications must
instantiate javax.mail.Session
objects, which designate
mail hosts, transport and store protocols, and a default mail user for
connecting to a mail server. In WebLogic Server, you use the
Administration Console to create a mail session, which configures a
javax.mail.Session
object and registers it in the
WebLogic Server JNDI tree. Applications access the mail session through
JNDI instead of instantiating their own
javax.mail.Session
object.
The Mail Sessions table displays in the right pane showing all the mail sessions defined in your domain.
Note: Once you create a mail session, you cannot rename it. Instead, you must clone it and give the clone the new name.
Applications use the value that you enter to look up the mail session. For example, if you enter myMailSession, applications do the following:
InitialContext ic = new InitialContext();
Session session = (Session) ic.lookup("myMailSession");
The following table describes all valid properties and default values (all of which are derived from the JavaMail API Design Specification).
Specify a property only if you want to override the default value. If you do not specify any properties, this mail session will use the JavaMail default property values.
Express each property as a name=value pair. Separate multiple properties with a semicolon (;).
Property | Description | Default |
---|---|---|
mail.store.protocol | Protocol for retrieving email. Example: mail.store.protocol=imap | imap |
mail.transport.protocol | Protocol for sending email. Example: mail.transport.protocol=smtp | smtp |
mail.host | The name of the mail host machine. Example: mail.host=mailserver | Local machine |
mail.user | Name of the default user for retrieving email. Example:
mail.user=postmaster |
Value of the user.name Java system
property. |
mail.protocol.host | Mail host for a specific protocol. For example, you can
set mail.SMTP.host and
mail.IMAP.host to different machine names.
Examples: mail.smtp.host=mail.mydom.com
mail.imap.host=localhost |
Value of the mail.host
property. |
mail.protocol.user | Protocol-specific default user name for logging into a
mailer server. Examples: mail.smtp.user=weblogic
mail.imap.user=appuser |
Value of the mail.user
property. |
mail.from | The default return address. Examples:
mail.from=master@mydom.com |
username@host |
mail.debug | Set to True to enable JavaMail debug
output. |
False |
Note: Applications can override any properties set in
the mail session by creating a Properties
object
containing the properties you want to override. See Programming JavaMail
with WebLogic Server.
After you finish
![]() |