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