org.apache.naming.factory
Class MailSessionFactory

java.lang.Object
  org.apache.naming.factory.MailSessionFactory

All Implemented Interfaces:

javax.naming.spi.ObjectFactory

public class MailSessionFactory

extends java.lang.Object

implements javax.naming.spi.ObjectFactory

Factory class that creates a JNDI named JavaMail Session factory, which can be used for managing inbound and outbound electronic mail messages via JavaMail APIs. All messaging environment properties described in the JavaMail Specification may be passed to the Session factory; however the following properties are the most commonly used:

• mail.smtp.host - Hostname for outbound transport connections. Defaults to localhost if not specified.

This factory can be configured in a <DefaultContext> or <Context> element in your conf/server.xml configuration file. An example of factory configuration is:

 <Resource name="mail/smtp" auth="CONTAINER"
           type="javax.mail.Session"/>
 <ResourceParams name="mail/smtp">
   <parameter>
     <name>factory</name>
     <value>org.apache.naming.factory.MailSessionFactory</value>
   </parameter>
   <parameter>
     <name>mail.smtp.host</name>
     <value>mail.mycompany.com</value>
   </parameter>
 </ResourceParams>
 

Version:

$Revision: 1.2 $ $Date: 2004/02/27 14:58:54 $

Author:

Craig R. McClanahan

Field Summary

protected static java.lang.String

factoryType The Java type for which this factory knows how to create objects.

Constructor Summary

MailSessionFactory()

Method Summary

java.lang.Object

getObjectInstance(java.lang.Object refObj, javax.naming.Name name, javax.naming.Context context, java.util.Hashtable env) Create and return an object instance based on the specified characteristics.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

factoryType

protected static final java.lang.String factoryType

The Java type for which this factory knows how to create objects.

See Also:

Constant Field Values

Constructor Detail

MailSessionFactory

public MailSessionFactory()

Method Detail

getObjectInstance

public java.lang.Object getObjectInstance(java.lang.Object refObj,
                                          javax.naming.Name name,
                                          javax.naming.Context context,
                                          java.util.Hashtable env)
                                   throws java.lang.Exception

Create and return an object instance based on the specified characteristics.

Specified by:

getObjectInstance in interface javax.naming.spi.ObjectFactory

Parameters:

refObj - Reference information containing our parameters, or null if there are no parameters

name - The name of this object, relative to context, or null if there is no name

context - The context to which name is relative, or null if name is relative to the default initial context

env - Environment variables, or null if there are none

Throws:

java.lang.Exception - if an error occurs during object creation