Message (Codename One API)

java.lang.Object
- com.codename1.messaging.Message

```
public class Message
extends Object
```
Represents a message to be sent using underlying platform e-mail client or the cloud.
The code below demonstrates sending a simple message with attachments using the devices native email client:

The following code demonstrates sending an email via the Codename One cloud, notice that this is a pro specific feature:

Field Summary

Fields
Modifier and Type Field and Description

static String MIME_HTML

static String MIME_IMAGE_JPG

static String MIME_IMAGE_PNG

static String MIME_TEXT

Fields
Modifier and Type	Field and Description
`static String`	`MIME_HTML`
`static String`	`MIME_IMAGE_JPG`
`static String`	`MIME_IMAGE_PNG`
`static String`	`MIME_TEXT`

Constructor Summary

Constructors
Constructor and Description

Message(String content)
Constructor with the message body content

Constructors
Constructor and Description
`Message(String content)` Constructor with the message body content

Method Summary

All Methods Static Methods Instance Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`String`	`getAttachment()` Gets the message attachment file path
`String`	`getAttachmentMimeType()` Gets the attachment mime type
`Map<String,String>`	`getAttachments()` Returns the attachment map which can be used to add multiple attachments.
`String`	`getContent()` Gets the message content
`String`	`getMimeType()` Gets the message mime type
`boolean`	`isCloudMessageFailSilently()` Indicates whether the cloud message should produce an error dialog if sending failed
`static void`	`sendMessage(String[] recipients, String subject, Message msg)` Send an email using the platform mail client
`void`	`sendMessageViaCloud(String sender, String recipient, String recipientName, String subject, String plainTextBody)` Deprecated. this functionality is retired and no longer works. You can use the sendgrid cn1lib or similar libraries
`boolean`	`sendMessageViaCloudSync(String sender, String recipient, String recipientName, String subject, String plainTextBody)` Deprecated. this functionality is retired and no longer works. You can use the sendgrid cn1lib or similar libraries
`void`	`setAttachment(String fileUri)` Sets the message attachment if exists
`void`	`setAttachmentMimeType(String mimeType)` Sets the attachment mime type.
`void`	`setCloudMessageFailSilently(boolean cloudMessageFailSilently)` Indicates whether the cloud message should produce an error dialog if sending failed
`void`	`setMimeType(String mimeType)` Sets the message mime type.

Methods inherited from class java.lang.Object
clone, equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - MIME_TEXT
```
public static final String MIME_TEXT
```
    See Also:
    
    Constant Field Values
  - MIME_HTML
```
public static final String MIME_HTML
```
    See Also:
    
    Constant Field Values
  - MIME_IMAGE_JPG
```
public static final String MIME_IMAGE_JPG
```
    See Also:
    
    Constant Field Values
  - MIME_IMAGE_PNG
```
public static final String MIME_IMAGE_PNG
```
    See Also:
    
    Constant Field Values
- Constructor Detail
  - Message
```
public Message(String content)
```
    Constructor with the message body content
    
    Parameters:
    
    content - the message content
- Method Detail
  - getContent
```
public String getContent()
```
    Gets the message content
    
    Returns:
    
    content
  - setAttachment
```
public void setAttachment(String fileUri)
```
    Sets the message attachment if exists
    
    Parameters:
    
    fileUri - the file to attach to the message
  - getAttachments
```
public Map<String,String> getAttachments()
```
    Returns the attachment map which can be used to add multiple attachments. The path needs to point at a full absolute file URI within FileSystemStorage, it will not work with Storage files!
    
    Returns:
    
    a map of full file paths to mime type that can be used to add attachments
  - setMimeType
```
public void setMimeType(String mimeType)
```
    Sets the message mime type.
    
    Parameters:
    
    mimeType -
  - getMimeType
```
public String getMimeType()
```
    Gets the message mime type
    
    Returns:
    
    the mime type
  - setAttachmentMimeType
```
public void setAttachmentMimeType(String mimeType)
```
    Sets the attachment mime type.
    
    Parameters:
    
    mimeType -
  - getAttachmentMimeType
```
public String getAttachmentMimeType()
```
    Gets the attachment mime type
    
    Returns:
  - getAttachment
```
public String getAttachment()
```
    Gets the message attachment file path
    
    Returns:
    
    the file path of the attachment
  - sendMessage
```
public static void sendMessage(String[] recipients,
                               String subject,
                               Message msg)
```
    Send an email using the platform mail client
    
    Parameters:
    
    recipients - array of e-mail addresses
    
    subject - e-mail subject
    
    msg - the Message to send
  - sendMessageViaCloud
```
public void sendMessageViaCloud(String sender,
                                String recipient,
                                String recipientName,
                                String subject,
                                String plainTextBody)
```
    Deprecated. this functionality is retired and no longer works. You can use the sendgrid cn1lib or similar libraries
    
    Send an email message using the Codename One cloud to send the message, notice that this API will only work for pro accounts.
    
    Parameters:
    
    sender - the name of the sender, notice all email will arrive from Codename One to avoid spam issues
    
    recipient - the email for the recipient
    
    recipientName - the display name for the recipient
    
    subject - e-mail subject
    
    plainTextBody - when sending an HTML message you should also attach a plain text fallback message, this is redundant if the email is a plain text message to begin with
  - sendMessageViaCloudSync
```
public boolean sendMessageViaCloudSync(String sender,
                                       String recipient,
                                       String recipientName,
                                       String subject,
                                       String plainTextBody)
```
    Deprecated. this functionality is retired and no longer works. You can use the sendgrid cn1lib or similar libraries
    
    Send an email message using the Codename One cloud to send the message, notice that this API will only work for pro accounts.
    
    Parameters:
    
    sender - the name of the sender, notice all email will arrive from Codename One to avoid spam issues
    
    recipient - the email for the recipient
    
    recipientName - the display name for the recipient
    
    subject - e-mail subject
    
    plainTextBody - when sending an HTML message you should also attach a plain text fallback message, this is redundant if the email is a plain text message to begin with
    
    Returns:
    
    true if sending succeeded
  - isCloudMessageFailSilently
```
public boolean isCloudMessageFailSilently()
```
    Indicates whether the cloud message should produce an error dialog if sending failed
    
    Returns:
    
    the cloudMessageFailSilently
  - setCloudMessageFailSilently
```
public void setCloudMessageFailSilently(boolean cloudMessageFailSilently)
```
    Indicates whether the cloud message should produce an error dialog if sending failed
    
    Parameters:
    
    cloudMessageFailSilently - the cloudMessageFailSilently to set

Class Message

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

MIME_TEXT

MIME_HTML

MIME_IMAGE_JPG

MIME_IMAGE_PNG

Constructor Detail

Message

Method Detail

getContent

setAttachment

getAttachments

setMimeType

getMimeType

setAttachmentMimeType

getAttachmentMimeType

getAttachment

sendMessage

sendMessageViaCloud

sendMessageViaCloudSync

isCloudMessageFailSilently

setCloudMessageFailSilently