Recevoir une notification de non-distribution

Afin de recevoir des notifications de non-distribution d'e-mails, vous devez configurer l'application pour activer les notifications de non-distribution et gérer les notifications entrantes dans l'application.

Configurer l'application pour les notifications de non-distribution d'e-mails

Par défaut, les applications ne reçoivent pas de notifications de non-distribution pour les e-mails qui n'ont pas pu être distribués. Pour activer le service de notification de non-distribution entrante, vous devez modifier les fichiers de configuration appengine-web.xml et web.xml de l'application.

Modifiez appengine-web.xml en ajoutant une section inbound-services pour activer le service de non-distribution entrante :

<inbound-services>
  <!-- Used to handle incoming mail. -->
  <service>mail</service>
  <!-- Used to handle bounced mail notifications. -->
  <service>mail_bounce</service>
</inbound-services>

Modifiez web.xml en mappant l'URL de non-distribution /_ah/bounce à votre servlet de gestion de non-distribution, comme suit :

<servlet>
  <servlet-name>bouncehandler</servlet-name>
  <servlet-class>com.example.appengine.mail.BounceHandlerServlet</servlet-class>
</servlet>
<servlet-mapping>
  <servlet-name>bouncehandler</servlet-name>
  <url-pattern>/_ah/bounce</url-pattern>
</servlet-mapping>
<security-constraint>
  <web-resource-collection>
    <web-resource-name>bounce</web-resource-name>
    <url-pattern>/_ah/bounce</url-pattern>
  </web-resource-collection>
  <auth-constraint>
    <role-name>admin</role-name>
  </auth-constraint>
</security-constraint>

Gérer les notifications de non-distribution

L'API JavaMail inclut la classe BounceNotificationParser, utilisée pour analyser les notifications de non-distribution entrantes, comme indiqué ci-dessous :

import com.google.appengine.api.mail.BounceNotification;
import com.google.appengine.api.mail.BounceNotificationParser;

import java.io.IOException;
import java.util.logging.Logger;
import javax.mail.MessagingException;
import javax.servlet.http.HttpServlet;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

public class BounceHandlerServlet extends HttpServlet {

  private static final Logger log = Logger.getLogger(BounceHandlerServlet.class.getName());

  @Override
  public void doPost(HttpServletRequest req, HttpServletResponse resp) throws IOException {
    try {
      BounceNotification bounce = BounceNotificationParser.parse(req);
      log.warning("Bounced email notification.");
      // The following data is available in a BounceNotification object
      // bounce.getOriginal().getFrom()
      // bounce.getOriginal().getTo()
      // bounce.getOriginal().getSubject()
      // bounce.getOriginal().getText()
      // bounce.getNotification().getFrom()
      // bounce.getNotification().getTo()
      // bounce.getNotification().getSubject()
      // bounce.getNotification().getText()
      // ...
    } catch (MessagingException e) {
    // ...
    }
  }
}