kr.co.hit.live.mail
Class Mail

java.lang.Object
  kr.co.hit.live.mail.Mail

public class Mail
extends Object

메일 자체를 나타내는 클래스로 MultiPartBody를 지원한다.(Text, Image 및 첨부파일등)

Since:

3.0

Version:

$Revision: 1.1 $ $Date: 2006/09/26 08:20:15 $

Author:

김기호(현대정보기술)

Constructor Summary

Mail()

기본생성자이며, 기본적으로 첨부파일 없음 & charset을 euc-kr로 지정한다.

Mail(String hostname, String username, String pwd)

생성시 사용할 메일서버에 대한 정보를 얻어서 생성한다.

Method Summary

Mail	addBCC(String bccAddress) 숨은 참조 이메일 주소를 추가한다.
Mail	addBCC(String bccAddress, String bccName) 숨은 참조 이메일 주소와 숨은 참조 대상의 이름를 추가한다.
Mail	addCC(String ccAddress) 참조 이메일 주소를 추가한다.
Mail	addCC(String ccAddress, String ccName) 참조 이메일 주소를 추가한다.
Mail	addTo(String toAddress) 받는 사람의 메일 주소를 추가한다.
Mail	addTo(String toAddress, String toName) 받는 사람의 메일 주소와 이름을 추가한다.
Mail	attach(byte[] attach, String name, String contentType)
Mail	attach(Collection<MailAttachment> attachList) MailAttachment 개체로 정의한 첨부파일 리스트 Collection 를 이용해서 여러개의 첨부파일을 한번에 첨부한다.
Mail	attach(MailAttachment attachment) MailAttachment 개체로 정의한 첨부파일을 첨주한다.
String	getCharset() 현재 설정된 문자셋을 얻어온다.
void	send() 작성된 메일을 전송한다.
void	setAuthentication(String username, String pwd) 사용할 메일서버에 대한 인증을 설정한다.
Mail	setBCC(Collection<String> bccList) 숨은 참조 이메일 주소 리스트를 셋팅한다.
Mail	setBCC(ValueObject bccListVo) 숨은 참조 이메일 주소와 숨은 참조 대상의 이름을 가지는 ValueObject 로 메일 주소를 설정한다.
Mail	setCC(Collection<String> ccList) 참조 이메일 주소 리스트를 설정한다.
Mail	setCC(ValueObject ccListVo) 참조 이메일 주소와 참조 대상의 이름을 가지는 ValueObject 로 메일 주소를 설정한다.
Mail	setCC(ValueObject ccListVO, String addrKey) 참조 이메일 주소를 가지는 ValueObject 로 참조자의 메일 주소를 설정한다.
Mail	setCC(ValueObject ccListVO, String addrKey, String nameKey) 참조 이메일 주소와 이름을 가지는 ValueObject 로 참조자의 메일 주소를 설정한다.
void	setCharset(String charset) 문자셋을 설정한다.
Mail	setContext(String subject, String msg) 메일의 제목과 내용을 설정한다.
void	setFrom(String fromAddress) 보내는 이의 메일주소를 셋팅한다.
void	setFrom(String fromAddress, String fromName) 보내는 이의 메일주소와 이름을 셋팅한다.
void	setHostName(String hostname) 메일서버로 사용할 호스트를 셋팅한다.
Mail	setHtmlMsg(String msg) HTML 형식의 메일의 내용을 설정한다.
Mail	setMsg(String msg) 메일의 내용을 설정한다.
Mail	setSubject(String subject) 메일의 제목을 설정한다.
Mail	setTo(Collection<String> toList) 받는 사람의 메일 주소 리스트를 설정한다.
Mail	setTo(ValueObject toListVo) 받는 사람의 이메일 주소와 이름을 가지는 ValueObject 로 메일 주소를 설정한다.
Mail	setTo(ValueObject toListVO, String addrKey) 받는 사람의 이메일 주소를 가지는 ValueObject 로 메일 주소를 설정한다.
Mail	setTo(ValueObject toListVO, String addrKey, String nameKey) 받는 사람의 이메일 주소와 이름을 가지는 ValueObject 로 메일 주소를 설정한다.

Methods inherited from class java.lang.Object

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

Constructor Detail

Mail

public Mail()

기본생성자이며, 기본적으로 첨부파일 없음 & charset을 euc-kr로 지정한다.

Mail

public Mail(String hostname,
            String username,
            String pwd)

생성시 사용할 메일서버에 대한 정보를 얻어서 생성한다.
기본적으로 문자셋은 "euc-kr", 첨부파일 없음으로 설정된다.

Parameters:

hostname - String사용할 메일서버 주소

username - String사용할 메일서버의 계정

pwd - String계정에 대한 비밀번호

Method Detail

setHostName

public void setHostName(String hostname)

메일서버로 사용할 호스트를 셋팅한다.

Parameters:

hostname - String사용할 메일서버 주소

setAuthentication

public void setAuthentication(String username,
                              String pwd)

사용할 메일서버에 대한 인증을 설정한다.

Parameters:

username - String사용할 메일서버의 계정

pwd - String게정에 대한 비밀번호

setCharset

public void setCharset(String charset)

문자셋을 설정한다. 기본값은 "euc-kr"이다.

Charset 참고

Parameters:

charset - String문자셋이 종류

getCharset

public String getCharset()

현재 설정된 문자셋을 얻어온다. 기본값은 "euc-kr"이다.

Returns:

String

setFrom

public void setFrom(String fromAddress)
             throws LiveException

보내는 이의 메일주소를 셋팅한다.

Parameters:

fromAddress - String 보내는 이의 이메일 주소

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

setFrom

public void setFrom(String fromAddress,
                    String fromName)
             throws LiveException

보내는 이의 메일주소와 이름을 셋팅한다.

Parameters:

fromAddress - String 보내는 이의 이메일 주소

fromName - String 보내는 이의 이름

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

addTo

public Mail addTo(String toAddress)
           throws LiveException

받는 사람의 메일 주소를 추가한다.

Parameters:

toAddress - String 받는 이의 이메일 주소

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

addTo

public Mail addTo(String toAddress,
                  String toName)
           throws LiveException

받는 사람의 메일 주소와 이름을 추가한다.

Parameters:

toAddress - String 받는 이의 이메일 주소

toName - String 받는 이의 이름

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

setTo

public Mail setTo(Collection<String> toList)
           throws LiveException

받는 사람의 메일 주소 리스트를 설정한다.
Collection 타입으로 메일주소 리스트를 설정하면 내부에서 InternetAddress 형태로 변환해서 처리한다.

Parameters:

toList - Collection 받는 이의 이메일 주소 리스트

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

setTo

public Mail setTo(ValueObject toListVo)
           throws LiveException

받는 사람의 이메일 주소와 이름을 가지는 ValueObject 로 메일 주소를 설정한다.
Collection 타입으로 메일주소 리스트를 설정하면 내부에서 InternetAddress 형태로 변환해서 처리한다. 이 때, ValueObjce의 key는 받는 사람의 이메일주소이며 value는 받는 사람의 이름이다.
예) ValueObject toList = new ValueObject();
toList.set("amugae1@mailserver.com", "아무개1");
toList.set("amugae2@mailserver.com", "아무개2");
toList.set("amugae3@mailserver.com", "아무개3");
Mail m_mail = new Mail();
m_mail.setTo(toList);

Parameters:

toListVo - ValueObject 받는 이의 이메일 주소와 이름

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

setTo

public Mail setTo(ValueObject toListVO,
                  String addrKey)
           throws LiveException

받는 사람의 이메일 주소를 가지는 ValueObject 로 메일 주소를 설정한다.
이 때 받는 사람의 이메일주소가 담긴 Key를 지정해준다.
사용예)

 ValueObject toListVO = new ValueObject();
 toListVO.set(0,"addr","amugae1@mailserver.com");
 toListVO.set(1,"addr","amugae2@mailserver.com");
 toListVO.set(2,"addr","amugae3@mailserver.com");
 Mail m_mail = new Mail();
 m_mail.setTo(toListVO,"addr");
 

Parameters:

toListVo - ValueObject 받는 이의 이메일 주소

addrKey - 받는이의 이메일 주소가 담긴 컬럼의 컬럼명

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

setTo

public Mail setTo(ValueObject toListVO,
                  String addrKey,
                  String nameKey)
           throws LiveException

받는 사람의 이메일 주소와 이름을 가지는 ValueObject 로 메일 주소를 설정한다.
이 때 받는 사람의 이메일주소와 받는 사람의 이름이 담긴 Key를 각각 지정해준다.
사용예)

 ValueObject toListVO = new ValueObject();
 toListVO.set(0,"addr","amugae1@mailserver.com");
 toListVO.set(0,"name","아무개1");
 toListVO.set(1,"addr","amugae2@mailserver.com");
 toListVO.set(1,"name","아무개2");
 toListVO.set(2,"addr","amugae3@mailserver.com");
 toListVO.set(2,"name","아무개3");
 Mail m_mail = new Mail();
 m_mail.setTo(toListVO,"addr","name");
 

Parameters:

toListVo - ValueObject 받는 이의 이메일 주소와 이름

addrKey - 받는이의 이메일 주소가 담긴 컬럼의 컬럼명

nameKey - 받는이의 이름이 담긴 컬럼의 컬럼명

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

addCC

public Mail addCC(String ccAddress)
           throws LiveException

참조 이메일 주소를 추가한다.

Parameters:

ccAddress - String 참조 대상 이메일 주소

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

addCC

public Mail addCC(String ccAddress,
                  String ccName)
           throws LiveException

참조 이메일 주소를 추가한다.

Parameters:

ccAddress - String 참조 대상 이메일 주소

ccName - String 참조 대상자 이름

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

setCC

public Mail setCC(Collection<String> ccList)
           throws LiveException

참조 이메일 주소 리스트를 설정한다.
Collection 타입으로 메일주소 리스트를 설정하면 내부에서 InternetAddress 형태로 변환해서 처리한다.

Parameters:

ccList - Collection 참조 이메일 주소 리스트

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

setCC

public Mail setCC(ValueObject ccListVo)
           throws LiveException

참조 이메일 주소와 참조 대상의 이름을 가지는 ValueObject 로 메일 주소를 설정한다.
Collection 타입으로 메일주소 리스트를 설정하면 내부에서 InternetAddress 형태로 변환해서 처리한다. 이 때, ValueObjce의 key는 참조대상의 이메일주소이며 value는 참조대상의 이름이다.
예) ValueObject ccList = new ValueObject();
ccList.set("amugae1@mailserver.com", "참조1");
ccList.set("amugae2@mailserver.com", "참조2");
ccList.set("amugae3@mailserver.com", "참조3");
Mail m_mail = new Mail();
m_mail.setTo(ccList);

Parameters:

ccListVo - ValueObject 받는 이의 이메일 주소와 이름

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

setCC

public Mail setCC(ValueObject ccListVO,
                  String addrKey)
           throws LiveException

참조 이메일 주소를 가지는 ValueObject 로 참조자의 메일 주소를 설정한다.
이 때 참조자의 이메일주소가 담긴 Key를 지정해준다.
사용예)

 ValueObject ccListVO = new ValueObject();
 ccListVO.set(0,"addr","amugae1@mailserver.com");
 ccListVO.set(1,"addr","amugae2@mailserver.com");
 ccListVO.set(2,"addr","amugae3@mailserver.com");
 Mail m_mail = new Mail();
 m_mail.setCC(ccListVO,"addr");
 

Parameters:

ccListVo - ValueObject 참조 이메일 주소

addrKey - 참조 이메일 주소가 담긴 컬럼의 컬럼명

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

setCC

public Mail setCC(ValueObject ccListVO,
                  String addrKey,
                  String nameKey)
           throws LiveException

참조 이메일 주소와 이름을 가지는 ValueObject 로 참조자의 메일 주소를 설정한다.
이 때 참조자의 이메일주소와 참조자의 이름이 담긴 Key를 각각 지정해준다.
사용예)

 ValueObject ccListVO = new ValueObject();
 ccListVO.set(0,"addr","amugae1@mailserver.com");
 ccListVO.set(0,"name","아무개1");
 ccListVO.set(1,"addr","amugae2@mailserver.com");
 ccListVO.set(1,"name","아무개2");
 ccListVO.set(2,"addr","amugae3@mailserver.com");
 ccListVO.set(2,"name","아무개3");
 Mail m_mail = new Mail();
 m_mail.setCC(ccListVO,"addr","name");
 

Parameters:

ccListVo - ValueObject 참조자의 이메일 주소와 이름

addrKey - 참조 이메일 주소가 담긴 컬럼의 컬럼명

nameKey - 참조자의 이름이 담긴 컬럼의 컬럼명

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

addBCC

public Mail addBCC(String bccAddress)
            throws LiveException

숨은 참조 이메일 주소를 추가한다.

Parameters:

bccAddress - String 숨은 참조 이메일 주소

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

addBCC

public Mail addBCC(String bccAddress,
                   String bccName)
            throws LiveException

숨은 참조 이메일 주소와 숨은 참조 대상의 이름를 추가한다.

Parameters:

bccAddress - String 숨은 참조 이메일 주소

bccName - String 숨은 참조대상의 이름

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

setBCC

public Mail setBCC(Collection<String> bccList)
            throws LiveException

숨은 참조 이메일 주소 리스트를 셋팅한다.
Collection 타입으로 메일주소 리스트를 설정하면 내부에서 InternetAddress 형태로 변환해서 처리한다.

Parameters:

bccList - Collection 숨은 참조 대상의 이메일 리스트

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

setBCC

public Mail setBCC(ValueObject bccListVo)
            throws LiveException

숨은 참조 이메일 주소와 숨은 참조 대상의 이름을 가지는 ValueObject 로 메일 주소를 설정한다.
Collection 타입으로 메일주소 리스트를 설정하면 내부에서 InternetAddress 형태로 변환해서 처리한다. 이 때, ValueObjce의 key는 숨은 참조대상의 이메일주소이며 value는 참조대상의 이름이다.
예) ValueObject bccList = new ValueObject();
bccList.set("amugae1@mailserver.com", "참조1");
bccList.set("amugae2@mailserver.com", "참조2");
bccList.set("amugae3@mailserver.com", "참조3");
Mail m_mail = new Mail();
m_mail.setTo(bccList);

Parameters:

bccListVo - ValueObject 숨은 참조 이메일 주소와 이름

Returns:

Mail

Throws:

LiveException - 주소형식이 옳지 않을 경우 발생

setSubject

public Mail setSubject(String subject)

메일의 제목을 설정한다.

Parameters:

subject - String 메일 제목

Returns:

Mail

setMsg

public Mail setMsg(String msg)
            throws LiveException

메일의 내용을 설정한다.

Parameters:

msg - String 메일 내용

Returns:

Mail

Throws:

LiveException - 메일 본문형식이 옳지 않을 경우 발생
참고 : MimeBodyPart

setHtmlMsg

public Mail setHtmlMsg(String msg)
                throws LiveException

HTML 형식의 메일의 내용을 설정한다.

Parameters:

msg - String 메일 내용

Returns:

Mail

Throws:

LiveException - 메일 본문형식이 옳지 않을 경우 발생
참고 : MimeBodyPart

setContext

public Mail setContext(String subject,
                       String msg)
                throws LiveException

메일의 제목과 내용을 설정한다.

Parameters:

subject - String 메일 제목

msg - String 메일 내용

Returns:

Mail

Throws:

LiveException - 메일 본문형식이 옳지 않을 경우 발생
참고 : MimeBodyPart

send

public void send()
          throws LiveException

작성된 메일을 전송한다.

Throws:

LiveException - 메일 전송중에 오류발생 시

See Also:

MessagingException

attach

public Mail attach(MailAttachment attachment)
            throws LiveException

MailAttachment 개체로 정의한 첨부파일을 첨주한다.

Parameters:

attachment - MailAttachment 미리 정의된 첨부파일 개체

Returns:

Mail

Throws:

LiveException - attachment가 NULL 이거나 파일 첨부 중 오류가 발생했을 경우

attach

public Mail attach(Collection<MailAttachment> attachList)
            throws LiveException

MailAttachment 개체로 정의한 첨부파일 리스트 Collection 를 이용해서 여러개의 첨부파일을 한번에 첨부한다.

Parameters:

attachList - Collection 첨부파일 리스트

Returns:

Mail

Throws:

LiveException - attachList가 NULL이가너 파일 첨부 중 오류가 발생한 경우

attach

public Mail attach(byte[] attach,
                   String name,
                   String contentType)
            throws LiveException

Throws:

LiveException