UnicornIII

Jakarta Commons Email

I. Commons-Email

2005년 9월 27일 드디어 Commons-Email이 version 1.0이 배포되었습니다

Commons-Email은 Java Mail API를 근간으로 좀더 심플하게 메일을 보내는 방안을 제시합니다.

기능상으로는 첨부파일 뿐만 아니라 HTML Email도 쉽게 보낼수 있는 API를 제공합니다

II. Download!

Commons-Email을 사용하기 위해서는 JavaMail의 mail.jar와 JAF의 activation.jar 가 필요합니다

Commons-Email download

http://jakarta.apache.org/site/downloads/downloads_commons-email.cgi

JavaMail 1.3

http://java.sun.com/products/javamail/downloads/index.html

JAF 1.0.2

http://java.sun.com/products/javabeans/glasgow/jaf.html

Commons-Email

http://jakarta.apache.org/commons/email/index.html

Commons-Email API

http://jakarta.apache.org/commons/email/apidocs/index.html

III. Install

다운 받은 3개의 파일을 $tomcat_home/webapps/ROOT/WEB-INF/lib/ 밑에 복사합니다

IV. 샘플 소스

① 간단히 텍스트만 보내기

SimpleEmail email = new SimpleEmail();
email.setHostName("mail.myserver.com");
email.addTo("jdoe@somewhere.org", "John Doe");
email.setFrom("me@apache.org", "Me");
email.setSubject("Test message");
email.setMsg("This is a simple test of commons-email");
email.send();

org.apache.commons.mail.SimpleEmail 은 가장 중심이 되는 org.apache.commons.mail.Email을 상속받아 setMsg(java.lang.String msg)만을 구현한 가장 기본적인 클래스입니다.

setHostName(java.lang.String aHostName)으로 SMTP 서버를 지정하고,

addTo(java.lang.String email) or addTo(java.lang.String email, java.lang.String name)으로 받는 사람의 메일주소를, setFrom(java.lang.String email) or setFrom(java.lang.String email, java.lang.String name)으로 보내는 사람의 메일을 설정합니다

물론 addTo 함수의 추가로 여러 사람에게 메일을 보낼 수 있습니다.

가장 기본적인 setSubject(java.lang.String subject)와 setMsg(java.lang.String msg)로 메일 제목과 내용을 입력한 후 send() 함수로 전송합니다

② 파일 첨부하기

// 첨부할 attachment 정보를 생성합니다
EmailAttachment attachment = new EmailAttachment();
attachment.setPath("mypictures/john.jpg");
attachment.setDisposition(EmailAttachment.ATTACHMENT);
attachment.setDescription("Picture of John");
attachment.setName("John");

// 기본 메일 정보를 생성합니다

MultiPartEmail email = new MultiPartEmail();
email.setHostName("mail.myserver.com");
email.addTo("jdoe@somewhere.org", "John Doe");
email.setFrom("me@apache.org", "Me");
email.setSubject("The picture");
email.setMsg("Here is the picture you wanted");

// 생성한 attachment를 추가합니다
email.attach(attachment);

// 메일을 전송합니다
email.send();

첨부파일과 같이 보낼려면 EmailAttachment 를 생성하여 파일 정보를 입력해 줍니다

파일경로와 파일형태, 파일 설명등을 추가하며 마지막으로 setName(java.lang.String name)을 통해 첨부되는 파일명을 설정합니다

그 후 MultiPartEmail 을 통해 SimpleEmail 처럼 기본 메일정보를 설정합니다

마지막으로 MultiPartEmail의 attach() 함수를 통해 첨부 파일을 추가하여 전송합니다

만약 첨부파일이 두개 이상이라면 EmailAttachment 를 여러개 생성하여 파일 정보를 설정 한 후 attach()를 통해 추가해 주기만 하면 됩니다

③ URL을 통해 첨부하기

// 첨부할 URL정보 및 파일 기본 정보를 설정합니다
EmailAttachment attachment = new EmailAttachment();
attachment.setURL(new URL("http://www.apache.org/images/asf_logo_wide.gif"));
attachment.setDisposition(EmailAttachment.ATTACHMENT);
attachment.setDescription("Apache logo");
attachment.setName("Apache logo");

// 기본 메일 정보를 생성합니다
MultiPartEmail email = new MultiPartEmail();
email.setHostName("mail.myserver.com");
email.addTo("jdoe@somewhere.org", "John Doe");
email.setFrom("me@apache.org", "Me");
email.setSubject("The logo");
email.setMsg("Here is Apache's logo");

// attachment를 추가합니다
email.attach(attachment);

// 메일을 전송합니다
email.send();

파일 경로 정보를 setURL(java.net.URL) 으로 설정할 뿐 위의 첨부파일과 동일합니다

④ HTML 이메일 보내기

// 기본 메일 정보를 생성합니다
HtmlEmail email = new HtmlEmail();
email.setHostName("mail.myserver.com");
email.addTo("jdoe@somewhere.org", "John Doe");
email.setFrom("me@apache.org", "Me");
email.setSubject("Test email with inline image");

// 삽입할 이미지와 그 Content Id를 설정합니다
URL url = new URL("http://www.apache.org/images/asf_logo_wide.gif");
String cid = email.embed(url, "Apache logo");

// HTML 메세지를 설정합니다

email.setHtmlMsg("<html>The apache logo - <img src=\"cid:"+cid+"\"></html>");

// HTML 이메일을 지원하지 않는 클라이언트라면 다음 메세지를 뿌려웁니다
email.setTextMsg("Your email client does not support HTML messages");

// 메일을 전송합니다
email.send();

HtmlEmail 클래스는 setHtmlMsg()로 작성된 html을 보낼 수 있습니다

이미지 처리가 조금 까탈스럽네요

V. 인증처리

만약 SMTP 서버가 인증을 요구한다면 org.apache.commons.mail.Email 의 setAuthentication(java.lang.String username, java.lang.String password)를 통해 해결할 수 있습니다

이 함수는 JavaMail API의 DefaultAuthenticator 클래스를 생성하여 사용합니다

=============================================

본문서는 자유롭게 배포/복사 할수 있지만

이문서의 저자에 대한 언급을 삭제하시면 안됩니다

저자 : GoodBug (unicorn@jakartaproject.com)

최초 : http://www.jakartaproject.com

=============================================

게시판 정말 Goooood~~~! 1	love	2005-03-19
java.util.Vector 흉내내기	GoodBug	2005-03-28
commons Commons-Email~ 7 Tag 2	GoodBug	2005-10-13
다음세대의 인터넷 서비스, 웹2.0	GoodBug	2006-04-20
최근 페도라에 MYSQL 설치시 주의	GoodBug	2005-06-22
로그는 어디에 쌓이는지요?	손님	2005-04-01
[답변] 로그는 어디에 쌓이는지요? 2	GoodBug	2005-04-01

번호	제목	글쓴이	일자	조회
	Hierarchy of the Apache Software Foundation	GoodBug	2005-10-14	10,814
	Jakarta Project 강좌 게시판입니다 8	GoodBug	2005-04-03	11,701
44	Log4J log4j에서 e.printStackTrace() 메시지를 log에 남기는 방법 1	kaiser	2008-10-22	17,613
43	DBUtils DBUtils에서 Clob 사용하기 3 1	GoodBug	2007-08-28	10,633
42	Spring Spring 설정 파일 로딩 1	GoodBug	2007-07-16	11,317
41	POI POI의 HSLF를 이용하여 PowerPoint 문서를 읽어보자 2	GoodBug	2007-05-28	14,910
40	POI POI의 HWPF를 이용하여 MS WORD문서를 읽어보자 2	GoodBug	2007-05-28	16,839
39	Validator Validator 속성들 1	GoodBug	2007-05-11	10,404
38	dd Commons-Fileupload 1.2 1 2	GoodBug	2007-04-23	15,345
37	Apache Apache2 + Tomcat5.5 + mod_jk 4	바이러스天国	2007-01-29	11,066
36	DBUtils DBUtils에서 number 타입의 컬럼이 int형으로 안넘어올때.. 3 1	GoodBug	2006-06-28	10,755
35	흠흠 위험한 static Logger 필드... 2 1	서연아빠	2006-03-16	10,113
34	Installing Tomcat with commons-daemon (jsvc)	GoodBug	2006-01-08	9,067
33	commons Commons DbUtils 몇가지 예제 3 2	GoodBug	2005-11-17	15,221
32	commons Jakarta Commons Net 에서 FTP 사용시 목록이 안보일 경우 2	GoodBug	2005-11-15	21,776
31	listFiles() 에서 null 을 반환 추적..	신만두	2008-11-11	11,866
30	commons 목록이 안보일 경우 해결기 I탄 1 2	GoodBug	2005-12-23	15,932
29	POI POI로 엑셀파일 읽을때, Invalid header signature 에러 1	GoodBug	2005-11-12	16,540
28	log4j log4j, JSP에서 원하는 Appender 골라쓰기 1	GoodBug	2005-11-07	13,894
	commons Commons-Email~ 7 2	GoodBug	2005-10-13	17,860