com.nexmo.client.sms

Class SmsClient

java.lang.Object

com.nexmo.client.sms.SmsClient

public class SmsClient
extends java.lang.Object

A client for talking to the Nexmo Voice API. The standard way to obtain an instance of this class is to use NexmoClient.getSmsClient().

Constructor Summary

Constructors

Constructor and Description
SmsClient(HttpWrapper httpWrapper) Create a new SmsClient.

Method Summary

Modifier and Type	Method and Description
SearchSmsResponse	searchMessages(java.util.Date date, java.lang.String to) Search for completed SMS transactions by date and recipient MSISDN.
SearchSmsResponse	searchMessages(SearchSmsRequest request) Search for completed SMS transactions.
SearchSmsResponse	searchMessages(java.lang.String id, java.lang.String... ids) Search for completed SMS transactions by ID
SearchRejectedMessagesResponse	searchRejectedMessages(java.util.Date date, java.lang.String to) Search for rejected SMS transactions by date and recipient MSISDN.
SearchRejectedMessagesResponse	searchRejectedMessages(SearchRejectedMessagesRequest request) Search for rejected SMS transactions using a SearchRejectedMessagesRequest.
SmsSubmissionResult[]	submitMessage(Message message) Send an SMS message.

Methods inherited from class java.lang.Object

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

Constructor Detail

SmsClient

public SmsClient(HttpWrapper httpWrapper)

Create a new SmsClient.

Method Detail

submitMessage

public SmsSubmissionResult[] submitMessage(Message message)
                                    throws java.io.IOException,
                                           NexmoClientException

Send an SMS message.

This uses the supplied object to construct a request and post it to the Nexmo API.
This method will respond with an array of SmsSubmissionResult objects. Depending on the nature and length of the submitted message, Nexmo may automatically split the message into multiple sms messages in order to deliver to the handset. For example, a long text sms of greater than 160 chars will need to be split into multiple 'concatenated' sms messages. The Nexmo service will handle this automatically for you.
The array of SmsSubmissionResult objects will contain a SmsSubmissionResult object for every actual sms that was required to submit the message. each message can potentially have a different status result, and each message will have a different message id. Delivery notifications will be generated for each sms message within this set and will be posted to your application containing the appropriate message id.

Parameters:

message - The message request object that describes the type of message and the contents to be submitted.

Returns:

SmsSubmissionResult[] an array of results, 1 object for each sms message that was required to submit this message in its entirety

Throws:

NexmoResponseParseException - if the HTTP response could not be parsed.

java.io.IOException - There has been an error attempting to communicate with the Nexmo service (e.g. Network failure).

NexmoClientException

searchMessages

public SearchSmsResponse searchMessages(SearchSmsRequest request)
                                 throws java.io.IOException,
                                        NexmoClientException

Search for completed SMS transactions.

You should probably use the helper methods searchMessages(String, String...) or searchMessages(String, String...) instead.

Throws:

java.io.IOException

NexmoClientException

searchMessages

public SearchSmsResponse searchMessages(java.lang.String id,
                                        java.lang.String... ids)
                                 throws java.io.IOException,
                                        NexmoClientException

Search for completed SMS transactions by ID

Parameters:

id - the first ID to look up

ids - optional extra IDs to look up

Returns:

SMS data matching the provided criteria

Throws:

java.io.IOException

NexmoClientException

searchMessages

public SearchSmsResponse searchMessages(java.util.Date date,
                                        java.lang.String to)
                                 throws java.io.IOException,
                                        NexmoClientException

Search for completed SMS transactions by date and recipient MSISDN.

Parameters:

date - the date of the SMS message to be looked up

to - the MSISDN number of the SMS recipient

Returns:

SMS data matching the provided criteria

Throws:

java.io.IOException

NexmoClientException

searchRejectedMessages

public SearchRejectedMessagesResponse searchRejectedMessages(SearchRejectedMessagesRequest request)
                                                      throws java.io.IOException,
                                                             NexmoClientException

Search for rejected SMS transactions using a SearchRejectedMessagesRequest.

You should probably use searchRejectedMessages(Date, String) instead.

Returns:

rejection data matching the provided criteria

Throws:

java.io.IOException

NexmoClientException

searchRejectedMessages

public SearchRejectedMessagesResponse searchRejectedMessages(java.util.Date date,
                                                             java.lang.String to)
                                                      throws java.io.IOException,
                                                             NexmoClientException

Search for rejected SMS transactions by date and recipient MSISDN.

Parameters:

date - the date of the rejected SMS message to be looked up

to - the MSISDN number of the SMS recipient

Returns:

rejection data matching the provided criteria

Throws:

java.io.IOException

NexmoClientException