Package com.nexmo.client.sms.messages

Class BinaryMessage

java.lang.Object

com.nexmo.client.sms.messages.Message

com.nexmo.client.sms.messages.BinaryMessage

public class BinaryMessage
extends Message

A binary message to be submitted via the Nexmo SMS API.

Nested Class Summary

Nested classes/interfaces inherited from class com.nexmo.client.sms.messages.Message

Message.MessageClass, Message.MessageType

Constructor Summary

Constructors

Constructor	Description
BinaryMessage(java.lang.String from, java.lang.String to, byte[] messageBody, byte[] udh)	Instantiate a new binary sms message request.

Method Summary

Modifier and Type	Method	Description
void	addParams(org.apache.http.client.methods.RequestBuilder request)
byte[]	getMessageBody()
int	getProtocolId()
byte[]	getUdh()
void	setProtocolId(int protocolId)

Methods inherited from class com.nexmo.client.sms.messages.Message

getCallbackUrl, getClientReference, getFrom, getMessageClass, getStatusReportRequired, getTimeToLive, getTo, getType, setCallbackUrl, setClientReference, setMessageClass, setStatusReportRequired, setTimeToLive

Methods inherited from class java.lang.Object

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

Constructor Detail

BinaryMessage

public BinaryMessage(java.lang.String from,
                     java.lang.String to,
                     byte[] messageBody,
                     byte[] udh)

Instantiate a new binary sms message request.

Parameters:

from - the 'from' address that will be seen on the handset when this message arrives, typically either a valid short-code / long code that can be replied to, or a short text description of the application sending the message (Max 11 chars)

to - the phone number of the handset that you wish to send the message to

messageBody - The raw binary message data to be sent to a handset. This api, and the Nexmo sms service will send this data 'as-is' (in conjunction with the binary UDH) and will not make any corrections. so you should ensure that it is a correctly constructed message

udh - Most binary content will require a UserDataHeader portion of the message containing commands to enable the handset to interpret the binary data (for example, a binary ringtone, a wap-push, OverTheAir configuration, etc). Additionally, if you are sending a long text message as multiple concatenated messages and are performing this operation manually rather than using the automated long sms handling in the Nexmo sms service, then you will need to construct and include here an appropriate UserDataHeader field that describes the segmentation/re-assembly fields required to successfully concatenate multiple short messages.

Method Detail

getMessageBody

public byte[] getMessageBody()

Returns:

byte[] The raw binary message data to be sent to a handset. This api, and the Nexmo sms service will send this data 'as-is' (in conjunction with the binary UDH) and will not make any corrections. so you should ensure that it is a correctly constructed message

getUdh

public byte[] getUdh()

Returns:

byte[] Most binary content will require a UserDataHeader portion of the message containing commands to enable the handset to interpret the binary data (for example, a binary ringtone, a wap-push, OverTheAir configuration, etc). Additionally, if you are sending a long text message as multiple concatenated messages and are performing this operation manually rather than using the automated long sms handling in the Nexmo sms service, then you will need to construct and include here an appropriate UserDataHeader field that describes the segmentation/re-assembly fields required to successfully concatenate multiple short messages.

getProtocolId

public int getProtocolId()

Returns:

Integer The value of the GSM Protocol ID field to be submitted with this message. Ordinarily this should be left as the default value of 0

setProtocolId

public void setProtocolId(int protocolId)

addParams

public void addParams(org.apache.http.client.methods.RequestBuilder request)

Overrides:

addParams in class Message