systextil.mail

Class AppMail

java.lang.Object

systextil.mail.AppMail

public class AppMail
extends java.lang.Object

Simplifica o envio de 1 e-mail. Os passos para envio são praticamente os mesmos de um aplicativo cliente de e-mail comum:

1. Abrir uma mensagem nova, a partir de uma sessão disponível e do endereço do remetente.
2. Informar os destinatários.
3. Preencher o título.
4. Preencher o texto, se houver.
5. Anexar os arquivos, se houver.
6. Definir a prioridade, se desejar.
7. Solicitar recibo de leitura, se desejar.
8. Enviar.

Há ainda a opção de informar se os anexos devem ser empacotados como ZIP.

Author:

sergio

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	AppMail.Arguments

Field Summary

Fields

Modifier and Type	Field and Description
static int	PRIORITY_HIGH
static int	PRIORITY_HIGHEST
static int	PRIORITY_LOW
static int	PRIORITY_LOWEST
static int	PRIORITY_NORMAL

Constructor Summary

Constructors

Constructor and Description
AppMail(javax.mail.Session session, javax.mail.internet.InternetAddress from)

Method Summary

Modifier and Type	Method and Description
void	addBcc(javax.mail.Address bcc)
void	addBcc(java.lang.String bcc)
void	addCc(javax.mail.Address cc)
void	addCc(java.lang.String cc)
void	addTo(javax.mail.Address to)
void	addTo(java.lang.String to)
void	attach(javax.activation.DataSource dataSource)
void	attachBytes(byte[] bytes, java.lang.String fileName)
java.lang.String	attachBytesInline(byte[] bytes, java.lang.String fileName) Anexa um arquivo ao email.
void	attachFile(java.io.File file)
java.lang.String	attachFileInline(java.io.File file) Anexa um arquivo ao email.
java.lang.String	attachInline(InlineAttachmentDataSource dataSource) Anexa um arquivo ao email.
void	clearMessage() Apaga os dados da mensagem atual, permitindo o envio de mais uma mensagem aproveitando as credenciais atuais do remetente.
void	disconect() Desconecta a sessão atual.
static javax.mail.Session	getSession(java.lang.String host, int port, PasswordAuthenticator passwordAuthenticator) Utilidade para obter uma sessão de e-mail diretamente a partir das credenciais SMTP.
static javax.mail.Session	getSession(java.lang.String host, int port, java.lang.String usuario, java.lang.String senha) Utilidade para obter uma sessão de e-mail diretamente a partir das credenciais SMTP.
static boolean	isValidAddress(java.lang.String address)
static void	main(java.lang.String[] args)
void	send() Envia o email para os destinatários.
void	send(boolean keepConnectionOpened) Envia o email para os destinatários.
void	setPriority(int priority)
void	setRequestReadReceipt(boolean request)
void	setSendCopyToSender(boolean send)
void	setSubject(java.lang.String subject)
void	setText(java.lang.String text)
void	setText(java.lang.String text, java.lang.String charset, java.lang.String type)
void	setZipFileName(java.lang.String zipFileName) Define o nome do arquivo ZIP que conterá os anexos, e assim define que os anexos existentes devem ser "zipados".
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

PRIORITY_HIGHEST

public static final int PRIORITY_HIGHEST

See Also:

Constant Field Values

PRIORITY_HIGH

public static final int PRIORITY_HIGH

See Also:

Constant Field Values

PRIORITY_NORMAL

public static final int PRIORITY_NORMAL

See Also:

Constant Field Values

PRIORITY_LOW

public static final int PRIORITY_LOW

See Also:

Constant Field Values

PRIORITY_LOWEST

public static final int PRIORITY_LOWEST

See Also:

Constant Field Values

Constructor Detail

AppMail

public AppMail(javax.mail.Session session,
               javax.mail.internet.InternetAddress from)

Method Detail

addTo

public void addTo(javax.mail.Address to)

addTo

public void addTo(java.lang.String to)
           throws javax.mail.internet.AddressException

Throws:

javax.mail.internet.AddressException

addCc

public void addCc(javax.mail.Address cc)

addCc

public void addCc(java.lang.String cc)
           throws javax.mail.internet.AddressException

Throws:

javax.mail.internet.AddressException

addBcc

public void addBcc(javax.mail.Address bcc)

addBcc

public void addBcc(java.lang.String bcc)
            throws javax.mail.internet.AddressException

Throws:

javax.mail.internet.AddressException

setSubject

public void setSubject(java.lang.String subject)

setText

public void setText(java.lang.String text)

setText

public void setText(java.lang.String text,
                    java.lang.String charset,
                    java.lang.String type)

attachFile

public void attachFile(java.io.File file)

attachBytes

public void attachBytes(byte[] bytes,
                        java.lang.String fileName)

attach

public void attach(javax.activation.DataSource dataSource)

attachFileInline

public java.lang.String attachFileInline(java.io.File file)

Anexa um arquivo ao email. Quando anexado 'inline' o conteudo desse arquivo pode ser mostrado no corpo do email. Por exemplo:

 String cid = appMail.attachFileInline(new File("logo.png"));
 appMail.setText("<html><body><img scr='"+cid+"'/></body></html>");
 

Parameters:

file - o arquivo que deve ser anexado

Returns:

uma String com o contentID desse anexo

attachBytesInline

public java.lang.String attachBytesInline(byte[] bytes,
                                          java.lang.String fileName)

Anexa um arquivo ao email. Quando anexado 'inline' o conteudo desse arquivo pode ser mostrado no corpo do email. Por exemplo:

 String cid = appMail.attachBytesInline(bytes, "logo.png");
 appMail.setText("<html><body><img scr='"+cid+"'/></body></html>");
 

Parameters:

bytes - um array de bytes com o conteudo a ser anexado

Returns:

uma String com o contentID desse anexo

attachInline

public java.lang.String attachInline(InlineAttachmentDataSource dataSource)

Anexa um arquivo ao email. Quando anexado 'inline' o conteudo desse arquivo pode ser mostrado no corpo do email. Por exemplo:

 String cid = appMail.attachInline(dataSource);
 appMail.setText("<html><body><img scr='"+cid+"'/></body></html>");
 

Parameters:

dataSource - um InlineAttachmentDataSource

Returns:

uma String com o contentID desse anexo

setZipFileName

public void setZipFileName(java.lang.String zipFileName)

Define o nome do arquivo ZIP que conterá os anexos, e assim define que os anexos existentes devem ser "zipados". Se for informado um nome nulo, os anexos não serão "zipados".

setPriority

public void setPriority(int priority)

setRequestReadReceipt

public void setRequestReadReceipt(boolean request)

setSendCopyToSender

public void setSendCopyToSender(boolean send)

send

public void send()
          throws javax.mail.AuthenticationFailedException,
                 java.io.FileNotFoundException

Envia o email para os destinatários.

Throws:

javax.mail.AuthenticationFailedException

java.io.FileNotFoundException

send

public void send(boolean keepConnectionOpened)
          throws javax.mail.AuthenticationFailedException,
                 java.io.FileNotFoundException

Envia o email para os destinatários.

Parameters:

keepConnectionOpened - indica se essa conexão deve ou não ficar aberta. Quando você deseja enviar vários emails utilizando a mesma sessão, manter a conexão aberta pode diminuir consideravelmente o tempo de envio dos emails. Caso opte por manter a conexão aberta não esqueça de chamar o método AppMail#disconect()

Throws:

javax.mail.AuthenticationFailedException

java.io.FileNotFoundException

disconect

public void disconect()

Desconecta a sessão atual. Se o método AppMail#send() for chamado após a chamada desse método, uma nova conexão será criada.

clearMessage

public void clearMessage()

Apaga os dados da mensagem atual, permitindo o envio de mais uma mensagem aproveitando as credenciais atuais do remetente.

isValidAddress

public static boolean isValidAddress(java.lang.String address)

getSession

public static javax.mail.Session getSession(java.lang.String host,
                                            int port,
                                            PasswordAuthenticator passwordAuthenticator)

Utilidade para obter uma sessão de e-mail diretamente a partir das credenciais SMTP. Se a porta for diferente de 25, retorna por padrão uma sessão SSL.

getSession

public static javax.mail.Session getSession(java.lang.String host,
                                            int port,
                                            java.lang.String usuario,
                                            java.lang.String senha)

Utilidade para obter uma sessão de e-mail diretamente a partir das credenciais SMTP. Se a porta for diferente de 25, retorna por padrão uma sessão SSL.

Se o usuário estiver vazio ou for nulo, a sessão não vai fornecer credenciais de autenticação.

main

public static void main(java.lang.String[] args)
                 throws javax.mail.internet.AddressException,
                        javax.mail.AuthenticationFailedException,
                        java.io.FileNotFoundException

Throws:

javax.mail.internet.AddressException

javax.mail.AuthenticationFailedException

java.io.FileNotFoundException

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object