public synchronized  void addProvider(Provider provider) 
{
	providers.addElement(provider);
	providersByClassName.put(provider.getClassName(), provider);
	if (!providersByProtocol.containsKey(provider.getProtocol()))
	    providersByProtocol.put(provider.getProtocol(), provider);
}

Add a provider to the session.

 public synchronized boolean getDebug() 
{
	return debug;
}

Get the debug setting for this Session.

 public synchronized PrintStream getDebugOut() 
{
	if (out == null)
	    return System.out;
	else
	    return out;
}

Returns the stream to be used for debugging output. If no stream has been set, System.out is returned.

 public static Session getDefaultInstance(Properties props) 
{
        return getDefaultInstance(props, null);
}

Get the default Session object. If a default has not yet been setup, a new Session object is created and installed as the default.

Note that a default session created with no Authenticator is available to all code executing in the same Java virtual machine, and the session can contain security sensitive information such as user names and passwords.

 public static synchronized Session getDefaultInstance(Properties props,
    Authenticator authenticator) 
{
	if (defaultSession == null)
	    defaultSession = new Session(props, authenticator);
	else {
	    // have to check whether caller is allowed to see default session
	    if (defaultSession.authenticator == authenticator)
		;	// either same object or both null, either way OK
	    else if (defaultSession.authenticator != null &&
		    authenticator != null &&
		    defaultSession.authenticator.getClass().getClassLoader() ==
			authenticator.getClass().getClassLoader())
		;	// both objects came from the same class loader, OK
	    else
		// anything else is not allowed
		throw new SecurityException("Access to default session denied");
	}
	return defaultSession;
}

Get the default Session object. If a default has not yet been setup, a new Session object is created and installed as the default.

Since the default session is potentially available to all code executing in the same Java virtual machine, and the session can contain security sensitive information such as user names and passwords, access to the default session is restricted. The Authenticator object, which must be created by the caller, is used indirectly to check access permission. The Authenticator object passed in when the session is created is compared with the Authenticator object passed in to subsequent requests to get the default session. If both objects are the same, or are from the same ClassLoader, the request is allowed. Otherwise, it is denied.

Note that if the Authenticator object used to create the session is null, anyone can get the default session by passing in null.

Note also that the Properties object is used only the first time this method is called, when a new Session object is created. Subsequent calls return the Session object that was created by the first call, and ignore the passed Properties object. Use the getInstance method to get a new Session object every time the method is called.

In JDK 1.2, additional security Permission objects may be used to control access to the default session.

 public Folder getFolder(URLName url) throws MessagingException 
{
	// First get the Store
	Store store = getStore(url);
	store.connect();
	return store.getFolder(url);
}

Get a closed Folder object for the given URLName. If the requested Folder object cannot be obtained, null is returned.

The "scheme" part of the URL string (Refer RFC 1738) is used to locate the Store protocol. The rest of the URL string (that is, the "schemepart", as per RFC 1738) is used by that Store in a protocol dependent manner to locate and instantiate the appropriate Folder object.

Note that RFC 1738 also specifies the syntax for the "schemepart" for IP-based protocols (IMAP4, POP3, etc.). Providers of IP-based mail Stores should implement that syntax for referring to Folders.

 public static Session getInstance(Properties props) 
{
	return new Session(props, null);
}

Get a new Session object.

 public static Session getInstance(Properties props,
    Authenticator authenticator) 
{
	return new Session(props, authenticator);
}

Get a new Session object.

 public PasswordAuthentication getPasswordAuthentication(URLName url) 
{
	return (PasswordAuthentication)authTable.get(url);
}

Return any saved PasswordAuthentication for this (store or transport) URLName. Normally used only by store or transport implementations.

 public Properties getProperties() 
{
 
   	return props;
}

Returns the Properties object associated with this Session

 public String getProperty(String name) 
{
 
   	return props.getProperty(name);
}

Returns the value of the specified property. Returns null if this property does not exist.

 public synchronized Provider getProvider(String protocol) throws NoSuchProviderException 
{
	if (protocol == null || protocol.length() < = 0) {
	    throw new NoSuchProviderException("Invalid protocol: null");
	}
	Provider _provider = null;
	// check if the mail.< protocol >.class property exists
	String _className = props.getProperty("mail."+protocol+".class");
	if (_className != null) {
	    if (debug) {
		pr("DEBUG: mail."+protocol+
				   ".class property exists and points to " + 
				   _className);
	    }
	    _provider = (Provider)providersByClassName.get(_className);
	} 
	if (_provider != null) {
	    return _provider;
	} else {
	    // returning currently default protocol in providersByProtocol
	    _provider = (Provider)providersByProtocol.get(protocol);
	}
	if (_provider == null) {
	    throw new NoSuchProviderException("No provider for " + protocol);
	} else {
	    if (debug) {
		pr("DEBUG: getProvider() returning " + 
				   _provider.toString());
	    }
	    return _provider;
	}
}

Returns the default Provider for the protocol specified. Checks mail.<protocol>.class property first and if it exists, returns the Provider associated with this implementation. If it doesn't exist, returns the Provider that appeared first in the configuration files. If an implementation for the protocol isn't found, throws NoSuchProviderException

 public synchronized Provider[] getProviders() 
{
	Provider[] _providers = new Provider[providers.size()];
	providers.copyInto(_providers);
	return _providers;
}

This method returns an array of all the implementations installed via the javamail.[default.]providers files that can be loaded using the ClassLoader available to this application.

 public Store getStore() throws NoSuchProviderException 
{
	return getStore(getProperty("mail.store.protocol"));
}

Get a Store object that implements this user's desired Store protocol. The mail.store.protocol property specifies the desired protocol. If an appropriate Store object is not obtained, NoSuchProviderException is thrown

 public Store getStore(String protocol) throws NoSuchProviderException 
{
	return getStore(new URLName(protocol, null, -1, null, null, null));
}

Get a Store object that implements the specified protocol. If an appropriate Store object cannot be obtained, NoSuchProviderException is thrown.

 public Store getStore(URLName url) throws NoSuchProviderException 
{
	String protocol = url.getProtocol();
	Provider p = getProvider(protocol);
	return getStore(p, url);
}

Get a Store object for the given URLName. If the requested Store object cannot be obtained, NoSuchProviderException is thrown. The "scheme" part of the URL string (Refer RFC 1738) is used to locate the Store protocol.

 public Store getStore(Provider provider) throws NoSuchProviderException 
{
	return getStore(provider, null);
}

Get an instance of the store specified by Provider. Instantiates the store and returns it.

 public Transport getTransport() throws NoSuchProviderException 
{
        return getTransport(getProperty("mail.transport.protocol"));
}

Get a Transport object that implements this user's desired Transport protcol. The mail.transport.protocol property specifies the desired protocol. If an appropriate Transport object cannot be obtained, MessagingException is thrown.

 public Transport getTransport(String protocol) throws NoSuchProviderException 
{
	return getTransport(new URLName(protocol, null, -1, null, null, null));
}

Get a Transport object that implements the specified protocol. If an appropriate Transport object cannot be obtained, null is returned.

 public Transport getTransport(URLName url) throws NoSuchProviderException 
{
	String protocol = url.getProtocol();
	Provider p = getProvider(protocol);
	return getTransport(p, url);
}

Get a Transport object for the given URLName. If the requested Transport object cannot be obtained, NoSuchProviderException is thrown. The "scheme" part of the URL string (Refer RFC 1738) is used to locate the Transport protocol.

 public Transport getTransport(Provider provider) throws NoSuchProviderException 
{
	return getTransport(provider, null);
}

Get an instance of the transport specified in the Provider. Instantiates the transport and returns it.

 public Transport getTransport(Address address) throws NoSuchProviderException 
{
	String transportProtocol = (String)addressMap.get(address.getType());
	if (transportProtocol == null) {
	    throw new NoSuchProviderException("No provider for Address type: "+
					      address.getType());
	} else {
	    return getTransport(transportProtocol);
	}
}

Get a Transport object that can transport a Message to the specified address type.

 public PasswordAuthentication requestPasswordAuthentication(InetAddress addr,
    int port,
    String protocol,
    String prompt,
    String defaultUserName) 
{
	if (authenticator != null) {
	    return authenticator.requestPasswordAuthentication(
		addr, port, protocol, prompt, defaultUserName);
	} else {
	    return null;
	}
}

Call back to the application to get the needed user name and password. The application should put up a dialog something like:

Connecting to <protocol> mail service on host <addr>, port <port>.
<prompt>

User Name: <defaultUserName>
Password:

 public synchronized  void setDebug(boolean debug) 
{
	this.debug = debug;
	if (debug)
	    pr("DEBUG: setDebug: JavaMail version " + Version.version);
}

Set the debug setting for this Session.

Since the debug setting can be turned on only after the Session has been created, to turn on debugging in the Session constructor, set the property mail.debug in the Properties object passed in to the constructor to true. The value of the mail.debug property is used to initialize the per-Session debugging flag. Subsequent calls to the setDebug method manipulate the per-Session debugging flag and have no affect on the mail.debug property.

 public synchronized  void setDebugOut(PrintStream out) 
{
	this.out = out;
}

Set the stream to be used for debugging output for this session. If out is null, System.out will be used. Note that debugging output that occurs before any session is created, as a result of setting the mail.debug system property, will always be sent to System.out.

 public  void setPasswordAuthentication(URLName url,
    PasswordAuthentication pw) 
{
	if (pw == null)
	    authTable.remove(url);
	else
	    authTable.put(url, pw);
}

Save a PasswordAuthentication for this (store or transport) URLName. If pw is null the entry corresponding to the URLName is removed.

This is normally used only by the store or transport implementations to allow authentication information to be shared among multiple uses of a session.

 public synchronized  void setProtocolForAddress(String addresstype,
    String protocol) 
{
	if (protocol == null)
	    addressMap.remove(addresstype);
	else
	    addressMap.put(addresstype, protocol);
}

Set the default transport protocol to use for addresses of the specified type. Normally the default is set by the javamail.default.address.map or javamail.address.map files or resources.

 public synchronized  void setProvider(Provider provider) throws NoSuchProviderException 
{
	if (provider == null) {
	    throw new NoSuchProviderException("Can't set null provider");
	}
	providersByProtocol.put(provider.getProtocol(), provider);
	props.put("mail." + provider.getProtocol() + ".class", 
		  provider.getClassName());
}

Set the passed Provider to be the default implementation for the protocol in Provider.protocol overriding any previous values.