jadeutils.net.email

Class MailUtil

java.lang.Object

jadeutils.net.email.MailUtil

public class MailUtil
extends Object

使用IMAP协议接收邮件 POP3和IMAP协议的区别: POP3协议允许电子邮件客户端下载服务器上的邮件,但是在客户端的操作(如移动邮件、标记已读等),不会反馈到服务器上, 比如通过客户端收取了邮箱中的3封邮件并移动到其它文件夹,邮箱服务器上的这些邮件是没有同时被移动的。 IMAP协议提供webmail与电子邮件客户端之间的双向通信,客户端的操作都会同步反应到服务器上,对邮件进行的操作,服务 上的邮件也会做相应的动作。比如在客户端收取了邮箱中的3封邮件,并将其中一封标记为已读,将另外两封标记为删除,这些操作会 即时反馈到服务器上。 两种协议相比,IMAP 整体上为用户带来更为便捷和可靠的体验。POP3更易丢失邮件或多次下载相同的邮件,但IMAP通过邮件客户端 与webmail之间的双向同步功能很好地避免了这些问题。

Field Summary

Fields

Modifier and Type	Field and Description
static String	MAIL_TYPE_MSG_RFC822
static String	MAIL_TYPE_TEXT_HTML
static String	MAIL_TYPE_TEXT_PAIN

Constructor Summary

Constructors

Constructor and Description
MailUtil()

Method Summary

Modifier and Type	Method and Description
static String	decodeText(String encodedText) decode test
static String	getFrom(javax.mail.Message msg) get mail from
static String	getPriority(javax.mail.Message msg) priority
static String	getReceiveAddress(javax.mail.Message msg, javax.mail.Message.RecipientType type) RecipientType.
static String	getSender(javax.mail.internet.MimeMessage msg) get sender
static String	getSentDate(javax.mail.Message msg, String pattern) get send date
static String	getSubject(javax.mail.Message msg) get the topic of mail
static boolean	hasAttachment(javax.mail.Part part) mail has attachment or not
static boolean	isReplySign(javax.mail.Message msg) is mail need reply
static boolean	isSeen(javax.mail.Message msg) mail is seen or not
static void	parseAttachment(javax.mail.Message msg, javax.mail.Part part, MailAttachmentHandler athmHandler)
static void	parseMailTextContent(javax.mail.Part part, Map<String,StringBuffer> content) get mail content by text
static void	parseMessage(MailBodyHandler bodyHandler, MailAttachmentHandler athmHandler, javax.mail.Message... messages) parse mail
static void	receiveMail(Properties emailProps, String email, String password, boolean isReadOnly, MailFolderHandler folderHandler, MailBodyHandler bodyHandler, MailAttachmentHandler athmHandler)
static void	sendHtmlMail(Properties emailProps, String email, String password, String[] toArr, String[] ccArr, String[] bccArr, String subject, String html, Map<String,DataSource> related, Map<String,DataSource> attachments) send email
static void	sendTextMail(Properties emailProps, String email, String password, String[] toArr, String[] ccArr, String[] bccArr, String subject, String text) send email
static void	sendTextMail(Properties emailProps, String email, String password, String[] toArr, String[] ccArr, String[] bccArr, String subject, String text, Map<String,DataSource> attachments) send email

Methods inherited from class java.lang.Object

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

Field Detail

MAIL_TYPE_TEXT_PAIN

public static final String MAIL_TYPE_TEXT_PAIN

See Also:

Constant Field Values

MAIL_TYPE_TEXT_HTML

public static final String MAIL_TYPE_TEXT_HTML

See Also:

Constant Field Values

MAIL_TYPE_MSG_RFC822

public static final String MAIL_TYPE_MSG_RFC822

See Also:

Constant Field Values

Constructor Detail

MailUtil

public MailUtil()

Method Detail

sendTextMail

public static void sendTextMail(Properties emailProps,
                                String email,
                                String password,
                                String[] toArr,
                                String[] ccArr,
                                String[] bccArr,
                                String subject,
                                String text)
                         throws Exception

send email

Parameters:

emailProps - email props

email - email

password - password

toArr - toArr

ccArr - ccArr

bccArr - bccArr

subject - subject

text - text

Throws:

Exception - exception

sendTextMail

public static void sendTextMail(Properties emailProps,
                                String email,
                                String password,
                                String[] toArr,
                                String[] ccArr,
                                String[] bccArr,
                                String subject,
                                String text,
                                Map<String,DataSource> attachments)
                         throws Exception

send email

Parameters:

emailProps - email props

email - email

password - password

toArr - toArr

ccArr - ccArr

bccArr - bccArr

subject - subject

text - text

attachments - attachments

Throws:

Exception - exception

sendHtmlMail

public static void sendHtmlMail(Properties emailProps,
                                String email,
                                String password,
                                String[] toArr,
                                String[] ccArr,
                                String[] bccArr,
                                String subject,
                                String html,
                                Map<String,DataSource> related,
                                Map<String,DataSource> attachments)
                         throws Exception

send email

Parameters:

emailProps - email props

email - email

password - password

toArr - toArr

ccArr - ccArr

bccArr - bccArr

subject - subject

html - html

related - related attachments

attachments - attachments

Throws:

Exception - exception

receiveMail

public static void receiveMail(Properties emailProps,
                               String email,
                               String password,
                               boolean isReadOnly,
                               MailFolderHandler folderHandler,
                               MailBodyHandler bodyHandler,
                               MailAttachmentHandler athmHandler)
                        throws Exception

Parameters:

emailProps - mail server connection props

email - email address

password - email passward

isReadOnly - is read only

folderHandler - handle every mail folder in mail account

bodyHandler - handle mail body in every mail folder

athmHandler - handle mail attachment in every mail

Throws:

Exception - something err

parseMessage

public static void parseMessage(MailBodyHandler bodyHandler,
                                MailAttachmentHandler athmHandler,
                                javax.mail.Message... messages)
                         throws javax.mail.MessagingException,
                                IOException

parse mail

Parameters:

bodyHandler - handle mail body

athmHandler - handle mail attachement

messages - message ( could be one or many) to parse

Throws:

javax.mail.MessagingException - something err

IOException - something err

getSubject

public static String getSubject(javax.mail.Message msg)
                         throws UnsupportedEncodingException,
                                javax.mail.MessagingException

get the topic of mail

Parameters:

msg - mail body

Returns:

subject of mail

Throws:

UnsupportedEncodingException - io err

javax.mail.MessagingException - io err

getSender

public static String getSender(javax.mail.internet.MimeMessage msg)
                        throws javax.mail.MessagingException,
                               UnsupportedEncodingException

get sender

Parameters:

msg - mail

Returns:

sender

Throws:

javax.mail.MessagingException - something err

UnsupportedEncodingException - something err

getFrom

public static String getFrom(javax.mail.Message msg)
                      throws javax.mail.MessagingException,
                             UnsupportedEncodingException

get mail from

Parameters:

msg - mail

Returns:

name < mail_address >

Throws:

javax.mail.MessagingException - something err

UnsupportedEncodingException - something err

getReceiveAddress

public static String getReceiveAddress(javax.mail.Message msg,
                                       javax.mail.Message.RecipientType type)
                                throws javax.mail.MessagingException

RecipientType.

Parameters:

msg - mail

type - recipient type / Message.RecipientType.TO / Message.RecipientType.CC / Message.RecipientType.BCC. Return all by default.

Returns:

name1 < mail_address1 > , name2 < mail_address2 >, ...

Throws:

javax.mail.MessagingException - something err

getSentDate

public static String getSentDate(javax.mail.Message msg,
                                 String pattern)
                          throws javax.mail.MessagingException

get send date

Parameters:

msg - mail

pattern - String for java date format

Returns:

yyyy-MM-dd_E_HH:mm:ss

Throws:

javax.mail.MessagingException - something err

hasAttachment

public static boolean hasAttachment(javax.mail.Part part)
                             throws javax.mail.MessagingException,
                                    IOException

mail has attachment or not

Parameters:

part - mail

Returns:

true or false

Throws:

javax.mail.MessagingException - something err

IOException - something err

isSeen

public static boolean isSeen(javax.mail.Message msg)
                      throws javax.mail.MessagingException

mail is seen or not

Parameters:

msg - mail

Returns:

true or false

Throws:

javax.mail.MessagingException - something err

isReplySign

public static boolean isReplySign(javax.mail.Message msg)
                           throws javax.mail.MessagingException

is mail need reply

Parameters:

msg - mail

Returns:

true or false

Throws:

javax.mail.MessagingException - something err

getPriority

public static String getPriority(javax.mail.Message msg)
                          throws javax.mail.MessagingException

priority

Parameters:

msg - mail

Returns:

1(High):紧急 3:普通(Normal) 5:低(Low)

Throws:

javax.mail.MessagingException - something err

parseMailTextContent

public static void parseMailTextContent(javax.mail.Part part,
                                        Map<String,StringBuffer> content)
                                 throws javax.mail.MessagingException,
                                        IOException

get mail content by text

Parameters:

part - mail body part

content - content of mail body

Throws:

javax.mail.MessagingException - something err

IOException - something err

parseAttachment

public static void parseAttachment(javax.mail.Message msg,
                                   javax.mail.Part part,
                                   MailAttachmentHandler athmHandler)
                            throws UnsupportedEncodingException,
                                   javax.mail.MessagingException,
                                   FileNotFoundException,
                                   IOException

Parameters:

msg - mail

part - part of email

athmHandler - attachment handler

Throws:

UnsupportedEncodingException - something err

javax.mail.MessagingException - something err

FileNotFoundException - something err

IOException - something err

decodeText

public static String decodeText(String encodedText)
                         throws UnsupportedEncodingException

decode test

Parameters:

encodedText - MimeUtility.encodeText(String text)

Returns:

text

Throws:

UnsupportedEncodingException - something err