L'API del servizio Mail per Java supporta l'interfaccia JavaMail (javax.mail
) per l'invio di messaggi email.
Prima di iniziare
Registra le tue email dei mittenti come mittenti autorizzati. Per maggiori informazioni, consulta l'articolo su chi può inviare email.
Invio di messaggi email
Per inviare messaggi email, utilizza le classi JavaMail incluse nell'SDK di App Engine.
Quando crei una sessione JavaMail, se non fornisci una configurazione del server SMTP, App Engine utilizza il servizio di posta per l'invio di messaggi. In alternativa, aggiungi la configurazione SMTP per i provider di posta di terze parti supportati come Mailgun, Mailjet o SendGrid.
Per inviare un messaggio:
Crea un messaggio utilizzando un oggetto JavaMail
Session
.Crea un oggetto
MimeMessage
.Per impostare il mittente e il destinatario del messaggio, utilizza il corso
InternetAddress
.Identifica il mittente chiamando il metodo
setFrom()
nell'oggettoMimeMessage
. Se vuoi, puoi fornire un nome personale come stringa nel secondo parametro.Identifica il destinatario passando un tipo di destinatario e un indirizzo al metodo
addRecipient()
. Il tipo di destinatario può essereMessage.RecipientType.TO
,Message.RecipientType.CC
oMessage.RecipientType.BCC
.
Il costruttore
InternetAddress
genera unAddressException
se l'indirizzo email non è valido.Per impostare un indirizzo per le risposte, utilizza il metodo
setReplyTo()
.Stabilisci i contenuti del messaggio chiamando i metodi nell'oggetto
MimeMessage
. Imposta l'oggetto consetSubject()
e il corpo dei contenuti in testo non crittografato consetText()
.Per inviare il messaggio, utilizza il metodo statico
send()
nella classeTransport
.
Il servizio di posta consente di specificare un insieme limitato di intestazioni per i messaggi email in uscita. Per maggiori informazioni, consulta la sezione Intestazioni facoltative che puoi utilizzare.
Il seguente esempio di codice mostra come inviare posta:
Le chiamate al servizio Mail sono asincrone e ritornano immediatamente. Il servizio Mail gestisce il processo di contatto con i server di posta dei destinatari e di recapito del messaggio. Se si verifica un problema durante l'invio del messaggio a qualsiasi destinatario o se il server di posta di un destinatario restituisce un messaggio di "rimbalzo", il messaggio di errore viene inviato al mittente.
Invio di messaggi multiparte
Puoi inviare messaggi in più parti, ad esempio un messaggio con file allegati o un messaggio con corpo del messaggio di testo normale e corpo del messaggio HTML.
Per inviare un messaggio in più parti:
Crea un oggetto
MimeMultipart
che contenga le parti, quindi crea un oggettoMimeBodyPart
per ogni allegato o corpo del messaggio alternativo e aggiungilo al contenitore.Assegna il contenitore ai contenuti di
MimeMessage
.
Il seguente esempio di codice mostra come inviare un messaggio in più parti:
Per motivi di sicurezza, le parti e gli allegati dei messaggi devono essere di uno dei vari tipi consentiti e i nomi file degli allegati devono terminare con un'estensione di nome file riconosciuta per il tipo. Per un elenco dei tipi e delle estensioni dei nomi file consentiti, vedi Posta con allegati.