com.jmail.core.mailer
Class Mail

java.lang.Object
  |
  +--com.jmail.core.mailer.Mail

public class Mail

extends java.lang.Object

Title: JMail

Description: Java Based Mail Client/Application

Copyright: Copyright (c) 2002

Company: GeraSunil.com

See the Sample Class below for Usage:
** See additional classpath setup in JMailReadme.txt available at same same location of this jar/zip file JMail.jar or JMail.zip

 //import these 4 classes
 import com.jmail.core.mailer.Mail;
 import com.jmail.core.exception.JMailMessageException;
 import com.jmail.core.exception.JMailSendException;
 import com.jmail.core.exception.NoFileException;
 public class TestClass {
 public static void main(String[] args) {
    //set Host Name of String type like smtp.your-server.com (Remember this version supports only SMTP)
    //Uncomment next line if you want to use your own mail server (Optional)
    //Mail.setHost(hostName)
    //Mail.setFooter(false)  //If you don't like the default footer in message body
    //Mail.setBodyFont("Times New Roman"); //(Optional, when body is File and you want to override the default Courier New)
    //Mail.setBodyFontSize(4); //(Optional, when body is File and you want to override the default size 2)
    //Instantiate the Mail Con with required parameters
    //(see available public Constructor's List)
    String from = "abc@abc.com";
    String replyTO = "xyz@xyz.com";
    String to = "abc@abc.com,nbc@cnbc.com,fox@fox.com";  // comma seperated string for multiple emails
    String cc = "abc@abc.com,you@you.com,me@me.com";  // comma seperated string for multiple emails
    String bcc = "abc@abc.com,abz@abz.com";  // comma seperated string for multiple emails
    String subject = "Mail from your buddy";
    String body = "This is the Big String Body of the mail. This supports all HTML tags";
    //Comment the above line and uncomment next line to display File as Body
    //File body = new File(C:\\myfolder\\sampleFile.txt"); //This will preserve white spaces and indent in file
    String[] attachments = {"C:\\tmp\\sample.txt", "D:\\wrk\\Test.java"};

    Mail mail = new Mail(from,to,subject, body, attachments);
    //this is an optional public method to override the default reply to address
    //of the message from From Address to another different address
    mail.setReplyTO(replyTO);
    //catch NoFileException in only in case of File parameter for message body, passed to Constructor
    //catch the JMailMessageException to see the detailed exceptions

    try {
      mail.send();
    } catch (NoFileException nfex) {
        System.out.println("NoFileException...." + NoFileException.message());
    } catch (JMailMessageException jmx) {
      Exception ex = jmx;
      if (ex instanceof JMailSendException) {
        System.out.println("JMailSendException...." + JMailSendException.message());
        String[] invAddrList = JMailSendException.invalidAddresses();
        if (invAddrList != null)
          for (int i = 0; i < invAddrList.length; i++) {
            System.out.println("Invalid Address: " + invAddrList[i]);
          }
        String[] valSentAddrList = JMailSendException.validSentAddresses();
        if (valSentAddrList != null)
          for (int i = 0; i < valSentAddrList.length; i++) {
            System.out.println("Valid Sent Address: " + valSentAddrList[i]);
          }
        String[] valUnSentAddrList = JMailSendException.validUnsentAddresses();
        if (valUnSentAddrList != null)
          for (int i = 0; i < valUnSentAddrList.length; i++) {
            System.out.println("Valid Unsent Address: " + valUnSentAddrList[i]);
          }
      }
    }
  }
 }

Version:

1.0

Author:

Sunil K. Gera

Field Summary

protected int

_mFlag

Constructor Summary

protected	Mail(Message msg) Mail constructor that takes Message Object ** NOTE: Not Implemented in this version
	Mail(java.lang.String fromEmail, java.lang.String toEmail, java.lang.String subject, java.io.File body) Mail con that takes String fromEmail, String toEmail, String subject, File body
	Mail(java.lang.String fromEmail, java.lang.String toEmail, java.lang.String subject, java.io.File body, java.lang.String[] attachment) Mail con that takes String fromEmail, String toEmail, String subject, File body, String[] attachment
	Mail(java.lang.String fromEmail, java.lang.String toEmail, java.lang.String subject, java.lang.String body) Mail con that takes String fromEmail, String toEmail, String subject, String body
	Mail(java.lang.String fromEmail, java.lang.String toEmail, java.lang.String ccEmail, java.lang.String subject, java.io.File body) Mail con that takes String fromEmail, String toEmail, String ccEmail, String subject, File body
	Mail(java.lang.String fromEmail, java.lang.String toEmail, java.lang.String ccEmail, java.lang.String subject, java.io.File body, java.lang.String[] attachment) Mail con that takes String fromEmail, String toEmail, String subject, File body, String[] attachment
	Mail(java.lang.String fromEmail, java.lang.String toEmail, java.lang.String ccEmail, java.lang.String subject, java.lang.String body) Mail con that takes String fromEmail, String toEmail, String ccEmail, String subject, String body
	Mail(java.lang.String fromEmail, java.lang.String toEmail, java.lang.String subject, java.lang.String body, java.lang.String[] attachment) Mail con that takes String fromEmail, String toEmail, String subject, String body, String[] attachment
	Mail(java.lang.String fromEmail, java.lang.String toEmail, java.lang.String ccEmail, java.lang.String bccEmail, java.lang.String subject, java.io.File body) Mail con that takes String fromEmail, String toEmail, String ccEmail, String bccEmail, String subject, File body
	Mail(java.lang.String fromEmail, java.lang.String toEmail, java.lang.String ccEmail, java.lang.String bccEmail, java.lang.String subject, java.io.File body, java.lang.String[] attachment) Mail con that takes String fromEmail, String toEmail, String ccEmail, String bccEmail, String subject, File body, String[] attachment
	Mail(java.lang.String fromEmail, java.lang.String toEmail, java.lang.String ccEmail, java.lang.String bccEmail, java.lang.String subject, java.lang.String body) Mail con that takes String fromEmail, String toEmail, String ccEmail, String bccEmail, String subject, String body
	Mail(java.lang.String fromEmail, java.lang.String toEmail, java.lang.String ccEmail, java.lang.String subject, java.lang.String body, java.lang.String[] attachment) Mail con that takes String fromEmail, String toEmail, String subject, String body, String[] attachment
	Mail(java.lang.String fromEmail, java.lang.String toEmail, java.lang.String ccEmail, java.lang.String bccEmail, java.lang.String subject, java.lang.String body, java.lang.String[] attachment) Mail con that takes String fromEmail, String toEmail, String ccEmail, String bccEmail, String subject, String body, String[] attachment

Method Summary

(package private) static void	()
boolean	getDebug() getDebug - debug property from properties file
java.lang.String	getHost() getHost - returns the host
void	send() Only public method to send your mail message
static void	setBodyFont(java.lang.String fontType) Set custom type font to keep your Message Body size unchanged when you pass File as con parameter
static void	setBodyFontSize(int fontSize) Set Font Size to keep your Message Body size unchanged when you pass File as con parameter
void	setDebug(boolean debug) setDebug - setter for debug value, which gives the verbose info on mail sent.
static void	setFooter(boolean value) Set the footer ON/OFF (Default ON)
static void	setHost(java.lang.String host) setHost - setter for host
void	setReplyTO(java.lang.String replyAddress) setReplyTO - public method to set/specify different email address than from email address for this message.
java.lang.String	toString() Returns a String that represents the value of this object.

Methods inherited from class java.lang.Object

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

Field Detail

_mFlag

protected int _mFlag

Constructor Detail

Mail

protected Mail(Message msg)

Mail constructor that takes Message Object
** NOTE: Not Implemented in this version

Parameters:

msg - com.jmail.core.mailer.Message

Mail

public Mail(java.lang.String fromEmail,
            java.lang.String toEmail,
            java.lang.String subject,
            java.lang.String body)

Mail con that takes String fromEmail, String toEmail, String subject, String body

Parameters:

fromEmail - String

toEmail - String

subject - String

body - String

Mail

public Mail(java.lang.String fromEmail,
            java.lang.String toEmail,
            java.lang.String subject,
            java.io.File body)

Mail con that takes String fromEmail, String toEmail, String subject, File body

Parameters:

fromEmail - String

toEmail - String

subject - String

body - File

Mail

public Mail(java.lang.String fromEmail,
            java.lang.String toEmail,
            java.lang.String subject,
            java.lang.String body,
            java.lang.String[] attachment)

Mail con that takes String fromEmail, String toEmail, String subject, String body, String[] attachment

Parameters:

fromEmail - String

toEmail - String

subject - String

body - String

attachment - String[]

Mail

public Mail(java.lang.String fromEmail,
            java.lang.String toEmail,
            java.lang.String subject,
            java.io.File body,
            java.lang.String[] attachment)

Mail con that takes String fromEmail, String toEmail, String subject, File body, String[] attachment

Parameters:

fromEmail - String

toEmail - String

subject - String

body - File

attachment - String[]

Mail

public Mail(java.lang.String fromEmail,
            java.lang.String toEmail,
            java.lang.String ccEmail,
            java.lang.String subject,
            java.lang.String body)

Mail con that takes String fromEmail, String toEmail, String ccEmail, String subject, String body

Parameters:

fromEmail - String

toEmail - String

ccEmail - String

subject - String

body - String

Mail

public Mail(java.lang.String fromEmail,
            java.lang.String toEmail,
            java.lang.String ccEmail,
            java.lang.String subject,
            java.io.File body)

Mail con that takes String fromEmail, String toEmail, String ccEmail, String subject, File body

Parameters:

fromEmail - String

toEmail - String

ccEmail - String

subject - String

body - File

Mail

public Mail(java.lang.String fromEmail,
            java.lang.String toEmail,
            java.lang.String ccEmail,
            java.lang.String subject,
            java.lang.String body,
            java.lang.String[] attachment)

Mail con that takes String fromEmail, String toEmail, String subject, String body, String[] attachment

Parameters:

fromEmail - String

toEmail - String

ccEmail - String

subject - String

body - String

attachment - String[]

Mail

public Mail(java.lang.String fromEmail,
            java.lang.String toEmail,
            java.lang.String ccEmail,
            java.lang.String subject,
            java.io.File body,
            java.lang.String[] attachment)

Mail con that takes String fromEmail, String toEmail, String subject, File body, String[] attachment

Parameters:

fromEmail - String

toEmail - String

ccEmail - String

subject - String

body - File

attachment - String[]

Mail

public Mail(java.lang.String fromEmail,
            java.lang.String toEmail,
            java.lang.String ccEmail,
            java.lang.String bccEmail,
            java.lang.String subject,
            java.lang.String body)

Mail con that takes String fromEmail, String toEmail, String ccEmail, String bccEmail, String subject, String body

Parameters:

fromEmail - String

toEmail - String

ccEmail - String

bccEmail - String

subject - String

body - String

Mail

public Mail(java.lang.String fromEmail,
            java.lang.String toEmail,
            java.lang.String ccEmail,
            java.lang.String bccEmail,
            java.lang.String subject,
            java.io.File body)

Mail con that takes String fromEmail, String toEmail, String ccEmail, String bccEmail, String subject, File body

Parameters:

fromEmail - String

toEmail - String

ccEmail - String

bccEmail - String

subject - String

body - File

Mail

public Mail(java.lang.String fromEmail,
            java.lang.String toEmail,
            java.lang.String ccEmail,
            java.lang.String bccEmail,
            java.lang.String subject,
            java.lang.String body,
            java.lang.String[] attachment)

Mail con that takes String fromEmail, String toEmail, String ccEmail, String bccEmail, String subject, String body, String[] attachment

Parameters:

fromEmail - String

toEmail - String

ccEmail - String

bccEmail - String

subject - String

body - String

attachment - String[]

Mail

public Mail(java.lang.String fromEmail,
            java.lang.String toEmail,
            java.lang.String ccEmail,
            java.lang.String bccEmail,
            java.lang.String subject,
            java.io.File body,
            java.lang.String[] attachment)

Mail con that takes String fromEmail, String toEmail, String ccEmail, String bccEmail, String subject, File body, String[] attachment

Parameters:

fromEmail - String

toEmail - String

ccEmail - String

bccEmail - String

subject - String

body - File

attachment - String[]

Method Detail

static void ()

getHost

public java.lang.String getHost()

getHost - returns the host

Returns:

String host

setHost

public static void setHost(java.lang.String host)

setHost - setter for host

Parameters:

host - String

getDebug

public boolean getDebug()

getDebug - debug property from properties file

Returns:

boolean true/false value for debug

setDebug

public void setDebug(boolean debug)

setDebug - setter for debug value, which gives the verbose info on mail sent.

Parameters:

debug - true/false

setFooter

public static void setFooter(boolean value)

Set the footer ON/OFF (Default ON)

Parameters:

value -

setBodyFont

public static void setBodyFont(java.lang.String fontType)

Set custom type font to keep your Message Body size unchanged when you pass File as con parameter

Parameters:

fontType - String default is Courier New

setBodyFontSize

public static void setBodyFontSize(int fontSize)

Set Font Size to keep your Message Body size unchanged when you pass File as con parameter

Parameters:

fontSize - int default is '2'

send

public void send()
          throws JMailMessageException,
                 NoFileException

Only public method to send your mail message

Throws:

JMailMessageException -

NoFileException -

See Also:

Mail(String fromEmail, String toEmail, String subject, String body), Mail(String fromEmail, String toEmail, String subject, File body), Mail(String fromEmail, String toEmail, String ccEmail, String subject, String body), Mail(String fromEmail, String toEmail, String ccEmail, String subject, File body), Mail(String fromEmail, String toEmail, String subject, String body, String[] attachment), Mail(String fromEmail, String toEmail, String subject, File body, String[] attachment), Mail(String fromEmail, String toEmail, String ccEmail, String bccEmail, String subject, String body), Mail(String fromEmail, String toEmail, String ccEmail, String bccEmail, String subject, File body), Mail(String fromEmail, String toEmail, String ccEmail, String subject, String body, String[] attachment), Mail(String fromEmail, String toEmail, String ccEmail, String subject, File body, String[] attachment), Mail(String fromEmail, String toEmail, String ccEmail, String bccEmail, String subject, String body, String[] attachment), Mail(String fromEmail, String toEmail, String ccEmail, String bccEmail, String subject, File body, String[] attachment)

setReplyTO

public void setReplyTO(java.lang.String replyAddress)

setReplyTO - public method to set/specify different email address than from email address for this message. You can also specify multiple emails with comma seperation.

Parameters:

replyAddress -

toString

public java.lang.String toString()

Returns a String that represents the value of this object.

Overrides:

toString in class java.lang.Object

Returns:

a string representation of the receiver