# Package com.google.appengine.api.mail

Provides a service to send email messages on behalf of administrators or authenticated users, also accessible via a JavaMail interface.

See: Description

- Interface Summary
  Interface | Description
  --- | ---
  IMailServiceFactory | Factory for creating a `MailService`.
  MailService | The `MailService` provides a way for user code to send emails to arbitrary destinations.

- Class Summary
  Class | Description
  --- | ---
  BounceNotification | The `BounceNotification` object represents an incoming bounce notification.
  BounceNotification.Details | The `BounceNotification.Details` class describes either the original message that caused a bounce, or the notification message describing the bounce.
  BounceNotificationParser | The `BounceNotificationParser` parses an incoming HTTP request into a description of a bounce notification.
  IMailServiceFactoryProvider | Factory provider for `IMailServiceFactory`.
  MailService.Attachment |
  MailService.Header |
  MailService.Message | Messages are prepared by the caller, and then submitted to the Mail service for sending.
  MailServiceFactory | Factory for creating a `MailService`.

## Package com.google.appengine.api.mail Description

Provides a service to send email messages on behalf of administrators or authenticated users, also accessible via a JavaMail interface. Receiving messages is not supported via the JavaMail API but is supported via an HTTP interface.

This low-level API is intended primarily for framework authors. For application developers we provide a custom `javax.mail.Transport` that allows the standard `javax.mail` interface to be used to send emails. No special configuration is required to send emails via this interface.

The `MailService.Message` class represents a message, including sender and recipient information, and possibly attachments as `MailService.Attachment` objects. These can be independently created via their respective constructors.

Sending a message requires a `MailService` object, created by the `MailServiceFactory`. Messages are sent asynchronously, so the `MailService` methods will always succeed immediately. Any errors in the mail message will be returned to the sender's address as "bounce" messages.

See Also:
  `MailService`, The Mail Java API in the Google App Engine Developer's Guide, JavaMail API