Package com.google.appengine.api.mail

Class MailService.Message

java.lang.Object
com.google.appengine.api.mail.MailService.Message
Enclosing interface:
MailService
public static class MailService.Message extends Object
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.

  • Constructor Details

    • Message

      public Message()

    • Message

      public Message(String sender, String to, String subject, String textBody)
      Convenience constructor for simple messages
      Parameters:
      sender - The sender's email address.
      to - The recipient's email address or null for empty to address.
      subject - The message subject.
      textBody - The text body of the message.

  • Method Details

    • getSender

      public String getSender()
      Gets the sender of this message.
      Returns:
      The sender of this message.

    • setSender

      public void setSender(String sender)
      sender must correspond to the valid email address of one of the admins for this application, or to the email address of the currently logged-in user. Sender is really the From: field of the email.

    • getReplyTo

      public String getReplyTo()
      Gets the reply to field of this message.
      Returns:
      The reply to field of this message.

    • setReplyTo

      public void setReplyTo(String replyTo)
      replyTo may be null, or must be a valid email address otherwise.

    • getTo

      public Collection<String> getTo()
      Gets the recipients in the 'to' field of this message.
      Returns:
      A collection containing the 'to' field recipients.

    • setTo

      public void setTo(Collection<String> to)
      Sets the 'to' field of this message. Each string in the collection represents exactly one email address. Having null (or invalid addresses) will lead to eventual failure during the send process.
      Parameters:
      to - A collection containing the email addresses to set as the 'to' field.

    • setTo

      public void setTo(String... to)
      Sets the 'to' field of this message. Each string represents exactly one email address. Having null (or invalid addresses) will lead to eventual failure during the send process.
      Parameters:
      to - The email addresses to set as the 'to' field.

    • getCc

      public Collection<String> getCc()
      Gets the recipients in the 'cc' field of this message.
      Returns:
      A collection containing the 'cc' field recipients.

    • setCc

      public void setCc(Collection<String> cc)
      Sets the 'cc' field of this message. Each string in the collection represents exactly one email address. Having null (or invalid addresses) will lead cc eventual failure during the send process.
      Parameters:
      cc - A collection containing the email addresses cc set as the 'cc' field.

    • setCc

      public void setCc(String... cc)
      Sets the 'cc' field of this message. Each string represents exactly one email address. Having null (or invalid addresses) will lead cc eventual failure during the send process.
      Parameters:
      cc - The email addresses cc set as the 'cc' field.

    • getBcc

      public Collection<String> getBcc()
      Gets the recipients in the 'bcc' field of this message.
      Returns:
      A collection containing the 'bcc' field recipients.

    • setBcc

      public void setBcc(Collection<String> bcc)
      Sets the 'bcc' field of this message. Each string in the collection represents exactly one email address. Having null (or invalid addresses) will lead bcc eventual failure during the send process.
      Parameters:
      bcc - A collection containing the email addresses bcc set as the 'bcc' field.

    • setBcc

      public void setBcc(String... bcc)
      Sets the 'bcc' field of this message. Each string represents exactly one email address. Having null (or invalid addresses) will lead bcc eventual failure during the send process.
      Parameters:
      bcc - The email addresses bcc set as the 'bcc' field.

    • getSubject

      public String getSubject()
      Gets the subject of this message.
      Returns:
      The subject of this message.

    • setSubject

      public void setSubject(String subject)
      Sets the subject of this message. A null or empty subject will lead to eventual failure during the send process.
      Parameters:
      subject - A string containing the new subject of this message.

    • getTextBody

      public String getTextBody()
      Gets the text body of this message.
      Returns:
      The text body.

    • setTextBody

      public void setTextBody(String textBody)
      Sets the text body of this message. At least one of textBody and htmlBody must not be null.
      Parameters:
      textBody - A string containing the new text body of this message.

    • getHtmlBody

      public String getHtmlBody()
      Gets the html body of this message.
      Returns:
      The html body.

    • setHtmlBody

      public void setHtmlBody(String htmlBody)
      Sets the html body of this message. At least one of textBody and htmlBody must not be null.
      Parameters:
      htmlBody - A string containing the new html body of this message.

    • getAmpHtmlBody

      public String getAmpHtmlBody()
      Gets the AMP HTML body of this message. See setAmpHtmlBody(java.lang.String) for more details.
      Returns:
      The AMP HTML body.

    • setAmpHtmlBody

      public void setAmpHtmlBody(String ampHtmlBody)
      Sets the AMP HTML body of this message. This field is optional. Setting AMP HTML body makes the email an AMP Email. Plain text or HTML may become fallback content depending on the email client used.
      Parameters:
      ampHtmlBody - A string containing the new AMP HTML body of this message.

    • getAttachments

      public Collection<MailService.Attachment> getAttachments()
      Gets the attachments of this message.
      Returns:
      A collection containing the attachments of this message.

    • setAttachments

      public void setAttachments(Collection<MailService.Attachment> attachments)
      Sets the attachments of this message. attachments may be null, otherwise each attachment must have a corresponding file name with an extension not on the block list.
      Parameters:
      attachments - A collection of attachments.

    • setAttachments

      public void setAttachments(MailService.Attachment... attachments)
      Sets the attachments of this message. attachments may be null, otherwise each attachment must have a corresponding file name with an extension not on the block list.
      Parameters:
      attachments - Attachments to attach to this message.

    • getHeaders

      public Collection<MailService.Header> getHeaders()
      Gets the headers of this message.
      Returns:
      A collection containing the headers of this message.

    • setHeaders

      public void setHeaders(Collection<MailService.Header> headers)
      Sets the headers of this message. headers may be null, otherwise each header name must be one of the allowed names.
      Parameters:
      headers - A collection of headers.

    • setHeaders

      public void setHeaders(MailService.Header... headers)
      Sets the headers of this message. headers may be null, otherwise each header name must be one of the allowed names.
      Parameters:
      headers - A collection of headers.