Intégration de JavaMail avec le service de transmission de messages

Pour activer JavaMail afin de tester la configuration du service de transmission de messages :

1. Assurez-vous que le service de transmission de messages est configuré pour l'envoi de courriels. Voir Introduction.

   Note
   
   

   Les données d'identification SMTP sont requises pour configurer JavaMail afin qu'il puisse utiliser le service de transmission de messages. Veuillez noter le nom d'utilisateur et le mot de passe lorsque vous générez les données d'identification SMTP.

2. Ouvrez un navigateur et allez à https://github.com/javaee/javamail/releases.
3. Sous Téléchargements, sélectionnez javax.mail.jar pour télécharger la dernière version de JavaMail.
4. Créez un projet dans Eclipse en réalisant les opérations suivantes :
   1. Dans Eclipse, ouvrez le menu File (Fichier). Sélectionnez New (Nouveau), puis cliquez sur Java Project (Projet Java).
   2. Dans la boîte de dialogue Create a Java Project (Créer un projet Java), entrez un nom de projet, puis cliquez sur Next (Suivant).
   3. Dans la boîte de dialogue Java Settings (Paramètres Java), sélectionnez l'onglet Java Settings (Bibliothèques).
   4. Cliquez sur Add External JARs (Ajouter des JAR externes).
   5. Dans la boîte de dialogue JAR Selection (Sélection JAR), naviguez jusqu'au dossier de téléchargement de JavaMail. Sélectionnez le fichier javax.mail.jar, puis cliquez sur Open (Ouvrir).
   6. Dans la boîte de dialogue Java Settings (Paramètres Java), cliquez sur Finish (Terminer).
5. À partir d'Eclipse, dans la fenêtre Package Explorer (Explorateur de paquetages), développez votre projet.
6. Dans votre projet, cliquez avec le bouton droit sur le répertoire src, sélectionnez New (Nouveau), puis cliquez sur Class (Classe).
7. Dans la boîte de dialogue New Java Class (Nouvelle classe Java), entrez "OCIemail" dans le champ Name (Nom), puis cliquez sur Finish (Terminer).

8. Entrez le code suivant dans le fichier OCIemail.java pour envoyer un courriel de test avec JavaMail :

   import java.util.Properties;
   import javax.mail.Message;
   import javax.mail.Session;
   import javax.mail.Transport;
   import javax.mail.internet.InternetAddress;
   import javax.mail.internet.MimeMessage;
    
   public class OCIemail {
    
       // Replace FROM with your "From" address.
       // This address must be added to Approved Senders in the console.
       static final String FROM = "<sender email address>";
       static final String FROMNAME = "<sender name>";
    
       // Replace TO with a recipient address.
       static final String TO = "<recipient email address>";
    
       // Replace smtp_username with your Oracle Cloud Infrastructure SMTP username generated in console.
       static final String SMTP_USERNAME = "<username OCID from SMTP credentials>";
    
       // Replace smtp_password with your Oracle Cloud Infrastructure SMTP password generated in console.
       static final String SMTP_PASSWORD = "<SMTP password>";
    
       // Oracle Cloud Infrastructure Email Delivery hostname.
       static final String HOST = "<SMTP endpoint>";
    
       // The port you will connect to on the SMTP endpoint. Port 25 or 587 is allowed.
       static final int PORT = 587;
    
          static final String SUBJECT = "<subject of your email>";
          static final String BODY = String.join(
    
              System.getProperty("line.separator"),
              "<h1>OCI Email Delivery test</h1>",
              "<p>This email was sent with OCI Email Delivery using the ",
              "<a href='Javamail'>https://github.com/javaee/javamail'>Javamail Package</a>",
             " for <a href='Javahttps://www.java.com'>Java</a>."
    
          );
    
       public static void main(String[] args) throws Exception {
    
           // Create a Properties object to contain connection configuration information.
    
          Properties props = System.getProperties();
          props.put("mail.transport.protocol", "smtp");
          props.put("mail.smtp.port", PORT);
    
          //props.put("mail.smtp.ssl.enable", "true"); //the default value is false if not set
          props.put("mail.smtp.auth", "true");
          props.put("mail.smtp.auth.login.disable", "true");  //the default authorization order is "LOGIN PLAIN DIGEST-MD5 NTLM". 'LOGIN' must be disabled since Email Delivery authorizes as 'PLAIN'
          props.put("mail.smtp.starttls.enable", "true");   //TLSv1.2 is required
          props.put("mail.smtp.starttls.required", "true");  //Oracle Cloud Infrastructure required
    
           // Create a Session object to represent a mail session with the specified properties.
          Session session = Session.getDefaultInstance(props);
    
           // Create a message with the specified information.
           MimeMessage msg = new MimeMessage(session);
           msg.setFrom(new InternetAddress(FROM,FROMNAME));
           msg.setRecipient(Message.RecipientType.TO, new InternetAddress(TO));
           msg.setSubject(SUBJECT);
           msg.setContent(BODY,"text/html");
    
           // Create a transport.
           Transport transport = session.getTransport();
              
    
           // Send the message.
    
           try
           {
    
               System.out.println("Sending Email now...standby...");
    
    
               // Connect to OCI Email Delivery using the SMTP credentials specified.
               transport.connect(HOST, SMTP_USERNAME, SMTP_PASSWORD);    
    
               // Send email.
               transport.sendMessage(msg, msg.getAllRecipients());
               System.out.println("Email sent!");
    
           }
    
           catch (Exception ex) {
    
               System.out.println("The email was not sent.");
               System.out.println("Error message: " + ex.getMessage());
    
           }
    
           finally
    
           {
    
               // Close & terminate the connection.
               transport.close();
    
           }
    
       }
    
   }

9. Dans le fichier OCIemail.java, remplacez les valeurs suivantes par vos propres valeurs :

   Note
   
   

   Les adresses de courriel sont sensibles à la casse. Assurez-vous que les adresses sont les mêmes que celles entrées pour les expéditeurs approuvés de la console.

   • FROM (De) - Remplacez la valeur par l'adresse de courriel de votre expéditeur. Cette adresse de courriel doit d'abord être ajoutée à la liste des expéditeurs approuvés du service de transmission de messages.
   • TO (À) - Remplacez la valeur par l'adresse de courriel du destinataire.
   • SMTP credentials (Données d'identification SMTP) - Remplacez les valeurs de smtp_username et de smtp_password par votre nom d'utilisateur et votre mot de passe SMTP générés dans la console pour Oracle Cloud Infrastructure.
   • HOST - Remplacez la valeur par le point d'extrémité SMTP du service de transmission de messages. Par exemple, smtp.us-ashburn-1.oraclecloud.com.

10. Consultez les exigences de configuration de la connexion SMTP à l'aide du service de transmission de messages. La version TLSv1.2 est requise pour le service de transmission de messages. Certains paramètres par défaut de Javamail doivent être désactivés. Par exemple, JavaMail procède à l'autorisation selon un certain ordre. La commande d'autorisation par défaut est "LOGIN PLAIN DIGEST-MD5 NTLM". Comme le service de transmission de messages l'autorise en tant que "PLAIN", la valeur "LOGIN" doit être désactivée. Par exemple, le code suivant est inséré dans le fichier OCIemail.java afin de configurer la connexion SMTP :

    props.put("mail.smtp.auth", "true");
    props.put("mail.smtp.auth.login.disable", "true"); 
    props.put("mail.smtp.starttls.enable", "true"); 
    props.put("mail.smtp.starttls.required", "true"); 

11. Ouvrez le menu File (Fichier) et cliquez sur Save (Enregistrer).
12. Pour créer le projet, ouvrez le menu Project (Projet), puis sélectionnez Build Project (Créer un projet). Si cette option est désactivée, il se peut que la création automatique soit activée.
13. Pour démarrer le programme et envoyer le courriel, ouvrez le menu Run (Exécuter), puis cliquez sur Run (Exécuter).
14. Vérifiez la sortie. Si le courriel a été envoyé, la console affiche un message de réussite. Sinon, un message d'erreur s'affiche.
15. Connectez-vous à la boîte de réception du destinataire afin de vérifier la réception du courriel.

• Pour plus d'informations, voir la documentation relative à JavaMail.
• Il existe un problème connu qui peut causer une erreur. Voir JavaMail si de nombreux destinataires sont définis dans un courriel et qu'une ou plusieurs adresses de courriel sont supprimées.