<4D F736F F D204A D61696C20C6D0C5B0C1F6B8A620C0CCBFEBC7D120B8DEC0CFC0C720C0FCBCDBB0FA20BCF6BDC52E646F63>

Transcription

1 작성자 : 김성박 ( 삼성SDS 멀티캠퍼스전임강사 ) urstory@nownuri.net Homepage : urstory@nownuri.net 본문서의배포처 : 작성일 : 2001년 12월 18일 - 해당문서에서잘못된부분을발견하신분은 urstory@nownuri.net 에게메일보내주신다면감사하겠습니다. - 본문서를이해하기위하여는 JAVA기본문법에대하여알고있어야만합니다. JavaMail 패키지를이용한메일의전송 인터넷에서가장많이사용되는서비스중에서가장중요하다고말할수있는것이 e- mail 입니다. 이번강좌는 JAVA에서 어떻게메일을보낼수있고, 메일을받을수있을것인가? 에대한내용을다루고자합니다. JAVA에서는메일을주고받기위하여는 JavaMail이라는패키지를이용하면됩니다. Socket 프로그래밍을이용하여, 메일을주고받는클래스를작성할수도있지만, 객체지향에서의재사용이라는관점을보면이미있는 JavaMail패키지를이용하는것이훨씬유용합니다. 1. 을보내고받기위한기본상식. 인터넷상에서문서를교환하기위하여는특정한프로토콜이필요하다는것을알고있을것입니다. 을주고받기위하여도특정한프로토콜이필요합니다. 을주고받기위하여대표적인프로토콜로는 SMTP, IMAP, POP3 등이있습니다. 각각의뜻을알아보면아래와같습니다. ㄱ. SMTP : Simple Mail Transfer Protocol 의약자이며영어뜻그대로메일을전송하 기위한규약입니다. 즉 SMTP 클라이언트와 SMTP 서버간에정보를주고받기위한규약입니다. SMTP는실제로파일이나다양한종류의자료형식을지원해주기위하여 MIME이라는형식을이용합니다. ㄴ. IMAP : Internet Message Access Protocol 의약자이며서버상에저장되어있는 1

2 메일을원격상에서접근하기위한통신규약입니다. ㄷ. POP3 : Post Office Protocol version 3 의약자이며 IMAP 과같이서버상에저장되 어있는메일을원격상에서접근하기위한통신규약입니다. 즉, 메일을전송할때는 SMTP를이용하며, 메일을읽어올때에는 IMAP이나 POP3를이용하여야합니다. 그림1) 은 Outlook Express( 메일클라이언트 ) 에서메일을보내고읽어오기위하여선언된그림입니다. SMTP와 POP3에대한서버를지정해놓은것을알수가있습니다. ( 그림에서는 SMTP 와 POP3가같게선언되어있지만, 서로가다르더라도상관없습니다. ) 그림 1 참고 : 웹메일시스템을만든다는것은, POP3와 SMTP를지원해주는메일서버를설치한후웹상에서해당메일서버를통하여 (SMTP이용) 메일을전송해주는시스템과해당메일서버에저장된메일을읽어오는 (POP3이용) 시스템을만든다는의미입니다. 즉메일서버를각각의시스템에맞도록설치설정할수있어야합니다. 2

3 2. JavaMail 패키지의설치 JavaMail 패키지는 Sun에서제공하여주는패키지로메일을주고받을수있는여러개의 class를제공하여줍니다. ㄱ. JavaMail 1.2 패키지를다운로드받습니다. ( 파일명 : javamail-1_2.zip ) ㄴ. JavaMail 패키지는내부적으로 JavaBeans TM Activation Framework (JAF) 를필요로하므로 jaf 패키지를다운로드받아야합니다. ( 파일명 : jaf1_0_1.zip ) ㄷ. 다운로드받은파일중먼저 jaf1_0_1.zip 파일의압축을풉니다. 압축을풀면 activation.jar파일이있을것입니다. JavaMail 패키지는내부적으로해당패키지의내용을필요로하므로 classpath에추가합니다. ㄹ. 다운로드받은파일중먼저 javamail-1_2.zip 파일의압축을풉니다. 압축을 풀면 mail.jar 파일이있을것입니다. 해당파일을 classpath 로지정합니다. 위와같은과정을마치면 JavaMail 패키지를이용하기위한준비과정은모두끝입니다. 3. JavaMail 는무엇인가? 그림 2 3

4 JavaMail 패키지는 SNTP나 NNTP에게메시지를전달하는기능과 IMAP이나 POP3를통하여메일을읽어올수있는기능을제공하여줍니다. 또한 MIME형식을지원해주므로여러가지형식의데이터를주고받을수있도록하여줍니다. 여기서중요한것은 NNTP 라는 USENET 도 JavaMail을통하여읽어오고작성할수있다는것입니다. 4. JavaMail 패키지를이용한프로그래밍. ㄱ. 간단한메일보내기프로그램의작성 MailSender.java 시작 import javax.mail.*; import javax.mail.internet.*; import java.util.*; import java.io.*; public class MailSender{ public static void main(string argsp[]) throws Exception{ String to = "urstory@ "; String from = "urstory@nownuri.net"; String host = " "; String title = "Simple Mail sender"; Properties props = new Properties(); props.put("mail.smtp.host", host); Session session = Session.getDefaultInstance(props, null); Message msg = new MimeMessage(session); msg.setfrom(new InternetAddress(from)); InternetAddress[] address = { new InternetAddress(to); msg.setrecipients(message.recipienttype.to, address); msg.setsubject(title); String message = "hello world"; msg.settext(message); Transport.send(msg); 4

5 MailSender.java 끝 위의프로그램은 사용자가 사용자에게제목에 Simple Mail sender 그리고본문내용으로는 hello world 라는메시지를전송하는메일프로그램입니다. 해당소스를한줄한줄분석해보도록하겠습니다. Session session = Session.getDefaultInstance(props, null); 위의문장에있는 javax.mail.session 클래스는서비스제공패키지의등록과설정프로퍼티를관리할때사용되는 JavaMail 패키지의중요한클래스입니다. 해당 Session 클래스의인스턴스를생성할수있는대표적인 2가지방법은아래와같습니다. public static Session getdefaultinstance(java.util.properties props, Authenticator authenticator) public static Session getdefaultinstance(java.util.properties props) 인자로지정되는 java.util.properties 클래스는 Session 클래스의설정을지정할때사용되는객체입니다. Session 클래스에는아래와같은설정값을지정할수있습니다. - mail.transport.protocol : 디폴트메시지전송 protocol 의지정 - mail.store.protocol : 디폴트메시지저장소 protocol 의지정 - mail.host : 메시지서버호스트주소 - mail.user : 메시지서버접속시에기본적으로사용할사용자계정명 - mail.<protocol>.host : 지정된 protocol 사용시사용하게될호스트주소 - mail.<protocol>.user : 지정된 protocol 사용시사용하게될사용자계정명 - mail.from : 현재사용자의반송주소 ( 기본적으로는 mail.user + mail.host 값 ) - mail.debug : 디버그모드값 ( 기본적으로 false ) - mail.<protocol>.class : 지정된 protocol 을구현하는서비스제공패키지의클래스명 위의예제에서는아래와같이 mail.smtp.host 설정값만지정하였다는것을알수가있습니다. 즉메일을전송하기위하여 smtp 프로토콜을이용하며 2번째인자로지정된 host 의 SMTP서버를통하여메일을전송한다는의미입니다. 5

6 Properties props = new Properties(); props.put("mail.smtp.host", host); Session session = Session.getDefaultInstance(props, null); 참고 프로퍼티에대한기본값은 classpath 나홈디렉토리의 lib디렉토리아래에 javamail.providers 라는파일명으로지정할수도있습니다. Message msg = new MimeMessage(session); Message 클래스는전송할메시지에대한정보를가질수있는객체입니다. MimeMessage 는 Message로부터상속받은클래스입니다. Message 클래스를사용하는이유는완전한메시지를표현할수있는객체이기때문입니다. Message는메일의헤더, 내용, 속성, 폴더안에서의정보등으로구성이됩니다. 아래의 setfrom, setrecipients, setsubject, settext는각각보내는사람, 받을사람들, 제목, 내용을설정하기위한메소드입니다. 각각의메소드의선언을 API에서찾아보면아래와같습니다. public abstract void setfrom(address address) public abstract void addrecipients(message.recipienttype type, Address[] addresses) public abstract void setsubject(java.lang.string subject) public void settext(java.lang.string text) 이며각각의메소드는 javax.mail.messagingexception 을발생시킨다는것을알수있습니다. 아래의소스는보내는사람, 받는사람, 제목, 본문내용등을 Message 객체가가지고있는메소드를이용하여설정하는부분입니다. msg.setfrom(new InternetAddress(from)); InternetAddress[] address = { new InternetAddress(to); msg.setrecipients(message.recipienttype.to, address); msg.setsubject(title); String message = "hello world"; msg.settext(message); 위와같이메시지에대한객체가생성되고설정되면아래와같이 Transport 클래스가가 6

7 지고있는 static 메소드인 send 메소드를이용하여메일을전송합니다. Send메소드의형식은아래와같습니다. public static void send(message msg) public static void send(message msg, Address[] addresses) Transport.send(msg); 위에서설명하지않은클래스중 InternetAddress 클래스에대하여알아보도록하겠습니다. InternetAddress 클래스는 Address클래스를방속받고있습니다. Address 클래스 : 메시지의송수신주소를지정하기위하여사용됩니다. InternetAddress 클래스 : RFC 822의주소 ( 주소 ) 를지정하기위하여사용됩니다. - 참고 : Message클래스가가지고있는메소드는위에서선언한메소드말고도수많은메소드가존재합니다. API를읽어보고참조하기바랍니다. 5. JavaMail 패키지를이용한 MIME 형식의메일보내기 앞에서우리는 JavaMail패키지를이용하여메일을전송하는예제를실행해보았습니다. 하지만그것만으로는아직부족한것이많다는것을우리는알수있습니다. 인터넷상에메일을보낼때우리는파일을첨부하여보낸다던지, 혹은 HTML형식으로메일을보내기도합니다. 혹은메일을보낼때이미지를함께보내기도합니다. 이렇게다양한형식으로메일을보내기위하여는 Mime 형식으로메일을전송할수있어야합니다. 아래의소스 MimeMessageSend.java 는 Mime 형식으로일반텍스트, 첨부파일, 이미지등을보내는예제입니다. 소스를컴파일하고실행하면 IP에있는메일서버를통하여 kim songpark(urstory@nownuri.net) 이라는이름의사람이 kang(urstory@ ) 의주소로일반텍스트, 첨부파일, 이미지등을보낸다는것을알수있을것입니다. 실제로아래의소스를실행한후 Outlook Express로메일을확인하면그림 3) 과같이보여지는것을알수있습니다. 7

8 그림 3 MimeMessageSend.java 시작 import javax.mail.*; import javax.mail.internet.*; import javax.activation.*; import java.util.*; import java.io.*; public class MimeMessageSend { public static void main(string[] args) throws Exception { String host = " "; String fromreal = "kim songpark"; String from = "urstory@nownuri.net"; String toreal = "kang"; String to = "urstory@ "; 8

9 Properties props = new Properties(); props.put("mail.smtp.host", host); Session session = Session.getDefaultInstance(props, null); Message msg = new MimeMessage(session); msg.setfrom(new InternetAddress(from, fromreal)); Address[] address = { new InternetAddress(to, toreal) ; msg.setrecipients(message.recipienttype.to, address); msg.setsubject("mime Message Send test"); Multipart multipart = new MimeMultipart(); // 텍스트문서 MimeBodyPart part1 = new MimeBodyPart(); part1.settext(" 하나님이보우하사우리나라만세 n무궁화삼천리줄 n"); multipart.addbodypart(part1); // html 문서형식 MimeBodyPart part2 = new MimeBodyPart(); part2.setdatahandler(new DataHandler( new ByteArrayDataSource( "<html><h1>hello World</h1></html> n".getbytes(), "text/html; charset=euc-kr", null))); multipart.addbodypart(part2); // image 파일전송 MimeBodyPart part3 = new MimeBodyPart(); FileInputStream file = new FileInputStream("hery.jpg"); part3.setdatahandler(new DataHandler( new ByteArrayDataSource(file, "image/jpeg", null))); file.close(); multipart.addbodypart(part3); // 첨부화일 9

10 MimeBodyPart part4 = new MimeBodyPart(); FileDataSource filesource = new FileDataSource(" 헤리포터.jpg"); part4.setdatahandler(new DataHandler(fileSource)); part4.setfilename(" 헤리포터.jpg"); multipart.addbodypart(part4); // 화일 MimeBodyPart part5 = new MimeBodyPart(); part5.setdatahandler(new DataHandler(fileSource)); part5.setfilename(" 헤리포터.jpg"); part5.setdisposition(part.inline); multipart.addbodypart(part5); msg.setcontent(multipart); Transport.send(msg); class ByteArrayDataSource implements DataSource { private byte[] data; private String type; private String name; public ByteArrayDataSource(InputStream is, String type, String name) throws IOException { ByteArrayOutputStream os = new ByteArrayOutputStream(); byte[] buf = new byte[1024]; for (int count; (count = is.read(buf))!= -1;) os.write(buf, 0, count); data = os.tobytearray(); this.type = type; this.name = name; public ByteArrayDataSource(byte[] data, String type, String name) { this.data = data; 10

11 this.type = type; this.name = name; public InputStream getinputstream() throws IOException { if (data == null) throw new IOException(); return new ByteArrayInputStream(data); public OutputStream getoutputstream() throws IOException { throw new IOException(); public String getcontenttype() { return type; public String getname() { return name; MimeMessageSend.java 끝 해당소스를한줄한줄분석하도록하겠습니다. 아래의 3줄은앞에서나왔던것처럼서비스제공패키지의등록과설정프로퍼티를지정하기위하여 Session 객체를생성하는부분입니다. Properties props = new Properties(); props.put("mail.smtp.host", host); Session session = Session.getDefaultInstance(props, null); 생성된 Session 객체를 MimeMessage 생성자의인자로전달함으로써 Session객체에등록된프로퍼티를이용하는 Message 객체를생성합니다. Message msg = new MimeMessage(session); 11

12 Message 객체가가지고있는 setfrom, setrecipients, setsubject 등의메서드를이용하여, 보내는사람, 받을사람, 제목등을지정합니다. msg.setfrom(new InternetAddress(from, fromreal)); Address[] address = { new InternetAddress(to, toreal) ; msg.setrecipients(message.recipienttype.to, address); msg.setsubject("mime Message Send test"); 여러개의데이터형식을내포할수있는 Multipart 객체를생성합니다. Multipart클래스는여러개의메시지부분 ( MimeBodyPart ) 으로이루어진메시지몸체를표현할수있는객체입니다. Multipart multipart = new MimeMultipart(); 아래의 3줄은위에서설명한 Multipart의한부분으로지정할 MimeBodyPart를선언하고있습니다. settext메서드를이용하여일반적인텍스트값을지정한후 Multipart 클래스가가지고있는 addbodypart 메서드로추가하는것을알수가있습니다. 즉첫번째로등록되는부분입니다. 그림3을보면 Outlook Express의내용중에 settext로지정된값이저장되어있다는것을알수있습니다. MimeBodyPart part1 = new MimeBodyPart(); part1.settext(" 하나님이보우하사우리나라만세 n무궁화삼천리줄 n"); multipart.addbodypart(part1); 아래부분은메일로전송될데이터중에서 HTML데이터를보내는부분입니다. 일반적인텍스트내용이아닐경우에는 MimeBodyPart 클래스가가지고있는 setdatahandler 클레스를이용합니다. SetDatahandler 메서드는 javax.activation.datahandler 클래스의객체를인자로전달받으며 Datahandler의생성자는 javax.activation.datasource 인터페이스를구현한클래스의객체를지정해야합니다. 즉 ByteArrayDataSource 클래스는 DataSource 인터페이스를구현하고있는객체라는것을알수있습니다. 이렇게 DataSource를구현하고있는 ByteArrayDataSource 에 HTML 데이터, mime 형식값을지정한후 Multipart에추가를하면되는것입니다. 여기에서사용된 ByteArrayDataSource클래스는이미지, 파일등을전송할때도그대로이용할수있습니다. MimeBodyPart part2 = new MimeBodyPart(); part2.setdatahandler(new DataHandler( new ByteArrayDataSource( "<html><h1>hello World</h1></html> n".getbytes(), "text/html; charset=euc-kr", null))); multipart.addbodypart(part2); 12

13 첨부파일을지정할경우에는 javax.activation.filedatasource 클래스를생성함으로써지정할수있습니다. FileDataSource 클래스도역시 DataSource interface 를상속받고있습니다. 실제데이터로헤리포터.jpg 를지정하여준후, 첨부될파일명을 setfilename 메서드로지정을하여주었습니다. MimeBodyPart part4 = new MimeBodyPart(); FileDataSource filesource = new FileDataSource(" 헤리포터.jpg"); part4.setdatahandler(new DataHandler(fileSource)); part4.setfilename(" 헤리포터.jpg"); multipart.addbodypart(part4); 아래부분은 Message의 setcontent메서드를이용하여여러가지형식으로지정된 multipart객체를지정한후전송하는부분입니다. msg.setcontent(multipart); Transport.send(msg); 마치며. 이상으로 JavaMail패키지를이용하여다양한형식의메일을전송하는방법에대하여알아보았습니다. 이러한내용을바탕으로실제로메일을읽어오는부분도공부한후 SWING 등을이용하여 Outlook Express 와같은프로그램을만드는것은어떨까요? 참고로 Usenet 서비스도 JavaMail 패키지를이용하여작성할수있습니다. 13