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: JavaMail API, com.google.appengine.api.mail.MailService, The Mail Java API in the Google App Engine Developer's Guide
Classes
BounceNotification
The BounceNotification
object represents an incoming bounce
notification.
BounceNotification.BounceNotificationBuilder
BounceNotification.Details
The BounceNotification.Details
class describes either the original
message that caused a bounce, or the notification message describing the
bounce.
BounceNotification.DetailsBuilder
BounceNotificationParser
The BounceNotificationParser
parses an incoming HTTP request into
a description of a bounce notification.
IMailServiceFactoryProvider
Factory provider for IMailServiceFactory.
Note: This class is not intended for end users.
MailService.Attachment
MailService.Header
MailService.Message
Messages are prepared by the caller, and then submitted to the Mail service
for sending. Different fields are subject to different constraints, as
enumerated in the send
and sendToAdmins
methods.
MailServiceFactory
Factory for creating a MailService.
MailServicePb
MailServicePb.MailAttachment
MailServicePb.MailAttachment.Builder
MailServicePb.MailHeader
MailServicePb.MailHeader.Builder
MailServicePb.MailMessage
MailServicePb.MailMessage.Builder
MailServicePb.MailServiceError
MailServicePb.MailServiceError.Builder
MailStubServicePb
MailStubServicePb.ClearSentMessagesResponse
MailStubServicePb.ClearSentMessagesResponse.Builder
MailStubServicePb.GetLogMailBodyResponse
MailStubServicePb.GetLogMailBodyResponse.Builder
MailStubServicePb.GetLogMailLevelResponse
MailStubServicePb.GetLogMailLevelResponse.Builder
MailStubServicePb.GetSentMessagesResponse
MailStubServicePb.GetSentMessagesResponse.Builder
MailStubServicePb.SetLogMailBodyRequest
MailStubServicePb.SetLogMailBodyRequest.Builder
MailStubServicePb.SetLogMailLevelRequest
MailStubServicePb.SetLogMailLevelRequest.Builder
Interfaces
IMailServiceFactory
Factory for creating a MailService.
MailService
The MailService
provides a way for user code to send emails
to arbitrary destinations.