com.permissionnanny.lib.request.simple

Class SmsRequest

java.lang.Object

com.permissionnanny.lib.request.PermissionRequest

com.permissionnanny.lib.request.simple.SimpleRequest

com.permissionnanny.lib.request.simple.SmsRequest

public class SmsRequest
extends SimpleRequest

Factory that creates SmsManager requests.

Field Summary

Fields

Modifier and Type	Field and Description
static String	SEND_DATA_MESSAGE
static String	SEND_MULTIMEDIA_MESSAGE
static String	SEND_MULTIPART_TEXT_MESSAGE
static String	SEND_TEXT_MESSAGE

Fields inherited from class com.permissionnanny.lib.request.PermissionRequest

mParams, mReceiver

Constructor Summary

Constructors

Constructor and Description
SmsRequest(RequestParams params)

Method Summary

Modifier and Type	Method and Description
static SmsRequest	sendDataMessage(String destinationAddress, String scAddress, short destinationPort, byte[] data, android.app.PendingIntent sentIntent, android.app.PendingIntent deliveryIntent) Send a data based SMS to a specific application port.
static SmsRequest	sendMultimediaMessage(android.content.Context context, android.net.Uri contentUri, String locationUrl, android.os.Bundle configOverrides, android.app.PendingIntent sentIntent) Send an MMS message
static SmsRequest	sendMultipartTextMessage(String destinationAddress, String scAddress, ArrayList<String> parts, ArrayList<android.app.PendingIntent> sentIntents, ArrayList<android.app.PendingIntent> deliveryIntents) Send a multi-part text based SMS.
static SmsRequest	sendTextMessage(String destinationAddress, String scAddress, String text, android.app.PendingIntent sentIntent, android.app.PendingIntent deliveryIntent) Send a text based SMS.

Methods inherited from class com.permissionnanny.lib.request.simple.SimpleRequest

listener, startRequest

Methods inherited from class com.permissionnanny.lib.request.PermissionRequest

addFilter, startRequest

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SEND_DATA_MESSAGE

public static final String SEND_DATA_MESSAGE

See Also:

Constant Field Values

SEND_MULTIMEDIA_MESSAGE

public static final String SEND_MULTIMEDIA_MESSAGE

See Also:

Constant Field Values

SEND_MULTIPART_TEXT_MESSAGE

public static final String SEND_MULTIPART_TEXT_MESSAGE

See Also:

Constant Field Values

SEND_TEXT_MESSAGE

public static final String SEND_TEXT_MESSAGE

See Also:

Constant Field Values

Constructor Detail

SmsRequest

public SmsRequest(RequestParams params)

Method Detail

sendDataMessage

public static SmsRequest sendDataMessage(String destinationAddress,
                                         String scAddress,
                                         short destinationPort,
                                         byte[] data,
                                         android.app.PendingIntent sentIntent,
                                         android.app.PendingIntent deliveryIntent)

Send a data based SMS to a specific application port.

Note: Using this method requires that your app has the Manifest.permission.SEND_SMS permission.

Parameters:

destinationAddress - the address to send the message to

scAddress - is the service center address or null to use the current default SMSC

destinationPort - the port to deliver the message to

data - the body of the message to send

sentIntent - if not NULL this PendingIntent is broadcast when the message is successfully sent, or failed. The result code will be Activity.RESULT_OK for success, or one of these errors:
RESULT_ERROR_GENERIC_FAILURE
RESULT_ERROR_RADIO_OFF
RESULT_ERROR_NULL_PDU
For RESULT_ERROR_GENERIC_FAILURE the sentIntent may include the extra "errorCode" containing a radio technology specific value, generally only useful for troubleshooting.
The per-application based SMS control checks sentIntent. If sentIntent is NULL the caller will be checked against all unknown applications, which cause smaller number of SMS to be sent in checking period.

deliveryIntent - if not NULL this PendingIntent is broadcast when the message is delivered to the recipient. The raw pdu of the status report is in the extended data ("pdu").

Throws:

IllegalArgumentException - if destinationAddress or data are empty

sendMultimediaMessage

public static SmsRequest sendMultimediaMessage(android.content.Context context,
                                               android.net.Uri contentUri,
                                               String locationUrl,
                                               android.os.Bundle configOverrides,
                                               android.app.PendingIntent sentIntent)

Send an MMS message

Parameters:

context - application context

contentUri - the content Uri from which the message pdu will be read

locationUrl - the optional location url where message should be sent to

configOverrides - the carrier-specific messaging configuration values to override for sending the message.

sentIntent - if not NULL this PendingIntent is broadcast when the message is successfully sent, or failed

Throws:

IllegalArgumentException - if contentUri is empty

sendMultipartTextMessage

public static SmsRequest sendMultipartTextMessage(String destinationAddress,
                                                  String scAddress,
                                                  ArrayList<String> parts,
                                                  ArrayList<android.app.PendingIntent> sentIntents,
                                                  ArrayList<android.app.PendingIntent> deliveryIntents)

Send a multi-part text based SMS. The callee should have already divided the message into correctly sized parts by calling divideMessage.

Note: Using this method requires that your app has the Manifest.permission.SEND_SMS permission.

Note: Beginning with Android 4.4 (API level 19), if and only if an app is not selected as the default SMS app, the system automatically writes messages sent using this method to the SMS Provider (the default SMS app is always responsible for writing its sent messages to the SMS Provider). For information about how to behave as the default SMS app, see Telephony.

Parameters:

destinationAddress - the address to send the message to

scAddress - is the service center address or null to use the current default SMSC

parts - an ArrayList of strings that, in order, comprise the original message

sentIntents - if not null, an ArrayList of PendingIntents (one for each message part) that is broadcast when the corresponding message part has been sent. The result code will be Activity.RESULT_OK for success, or one of these errors:
RESULT_ERROR_GENERIC_FAILURE
RESULT_ERROR_RADIO_OFF
RESULT_ERROR_NULL_PDU
For RESULT_ERROR_GENERIC_FAILURE each sentIntent may include the extra "errorCode" containing a radio technology specific value, generally only useful for troubleshooting.
The per-application based SMS control checks sentIntent. If sentIntent is NULL the caller will be checked against all unknown applications, which cause smaller number of SMS to be sent in checking period.

deliveryIntents - if not null, an ArrayList of PendingIntents (one for each message part) that is broadcast when the corresponding message part has been delivered to the recipient. The raw pdu of the status report is in the extended data ("pdu").

Throws:

IllegalArgumentException - if destinationAddress or data are empty

sendTextMessage

public static SmsRequest sendTextMessage(String destinationAddress,
                                         String scAddress,
                                         String text,
                                         android.app.PendingIntent sentIntent,
                                         android.app.PendingIntent deliveryIntent)

Send a text based SMS.

Note: Using this method requires that your app has the Manifest.permission.SEND_SMS permission.

Note: Beginning with Android 4.4 (API level 19), if and only if an app is not selected as the default SMS app, the system automatically writes messages sent using this method to the SMS Provider (the default SMS app is always responsible for writing its sent messages to the SMS Provider). For information about how to behave as the default SMS app, see Telephony.

Parameters:

destinationAddress - the address to send the message to

scAddress - is the service center address or null to use the current default SMSC

text - the body of the message to send

sentIntent - if not NULL this PendingIntent is broadcast when the message is successfully sent, or failed. The result code will be Activity.RESULT_OK for success, or one of these errors:
RESULT_ERROR_GENERIC_FAILURE
RESULT_ERROR_RADIO_OFF
RESULT_ERROR_NULL_PDU
For RESULT_ERROR_GENERIC_FAILURE the sentIntent may include the extra "errorCode" containing a radio technology specific value, generally only useful for troubleshooting.
The per-application based SMS control checks sentIntent. If sentIntent is NULL the caller will be checked against all unknown applications, which cause smaller number of SMS to be sent in checking period.

deliveryIntent - if not NULL this PendingIntent is broadcast when the message is delivered to the recipient. The raw pdu of the status report is in the extended data ("pdu").

Throws:

IllegalArgumentException - if destinationAddress or text are empty