org.cyclos.impl.utils.sms

Class GatewaySmsSender

java.lang.Object

org.cyclos.impl.utils.sms.GatewaySmsSender

All Implemented Interfaces:

org.cyclos.impl.utils.sms.SmsSender

public class GatewaySmsSender
extends java.lang.Object
implements org.cyclos.impl.utils.sms.SmsSender

An SMS sender which sends a request to a gateway, according to the given SMS configuration

Author:

luis

Field Summary

Fields

Modifier and Type	Field and Description
protected static int	TIMEOUT

Constructor Summary

Constructors

Constructor and Description
GatewaySmsSender()

Method Summary

Modifier and Type	Method and Description
protected void	applyAuthentication(ConfigurationAccessor configuration, MobilePhone phone, java.lang.String phoneNumber, java.lang.String message, org.apache.http.client.methods.HttpUriRequest request) May be overridden in order to use some custom authentication scheme
protected void	applyPostBody(ConfigurationAccessor configuration, MobilePhone phone, java.lang.String phoneNumber, java.lang.String message, org.apache.http.client.methods.HttpPost request, java.lang.String postBody)
protected org.apache.http.client.methods.HttpUriRequest	buildRequest(ConfigurationAccessor configuration, java.lang.String gatewayUrl, MobilePhone phone, java.lang.String phoneNumber, java.lang.String message) Creates the request, either a GET or post, and sets the content type header on it
protected OutboundSmsStatus	doSend(ConfigurationAccessor configuration, MobilePhone phone, java.lang.String phoneNumber, java.lang.String message, org.apache.http.client.methods.HttpUriRequest request) May be overriden in order to customize the SMS sending
protected java.lang.String	preProcessMessage(ConfigurationAccessor configuration, java.lang.String message) By default, according to the outbound sms configuration, makes the message only have ASC-II characters
protected java.lang.String	resolveGatewayUrl(ConfigurationAccessor configuration, MobilePhone phone, java.lang.String phoneNumber, java.lang.String message, java.util.Map<java.lang.String,java.lang.String> variables) May be overridden in order to resolve the final gateway URL.
protected java.lang.String	resolvePostBody(ConfigurationAccessor configuration, MobilePhone phone, java.lang.String phoneNumber, java.lang.String message, java.util.Map<java.lang.String,java.lang.String> variables) May be overridden in order to resolve the POST body from the given context and variables
protected OutboundSmsStatus	resolveStatus(ConfigurationAccessor configuration, MobilePhone phone, java.lang.String message, org.apache.http.client.methods.HttpUriRequest request, int statusCode, org.apache.http.HttpEntity entity) May be overridden to actually resolve the SMS status from the given response
protected java.util.Map<java.lang.String,java.lang.String>	resolveVariables(ConfigurationAccessor configuration, MobilePhone phone, java.lang.String phoneNumber, java.lang.String message) May be overridden in order to resolve custom variables
OutboundSmsStatus	send(ConfigurationAccessor configuration, MobilePhone phone, java.lang.String phoneNumber, java.lang.String message)

Methods inherited from class java.lang.Object

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

Field Detail

TIMEOUT

protected static final int TIMEOUT

See Also:

Constant Field Values

Constructor Detail

GatewaySmsSender

public GatewaySmsSender()

Method Detail

send

public OutboundSmsStatus send(ConfigurationAccessor configuration,
                              @Nullable
                              MobilePhone phone,
                              java.lang.String phoneNumber,
                              java.lang.String message)

Specified by:

send in interface org.cyclos.impl.utils.sms.SmsSender

applyAuthentication

protected void applyAuthentication(ConfigurationAccessor configuration,
                                   @Nullable
                                   MobilePhone phone,
                                   java.lang.String phoneNumber,
                                   java.lang.String message,
                                   org.apache.http.client.methods.HttpUriRequest request)
                            throws java.lang.Exception

May be overridden in order to use some custom authentication scheme

Throws:

java.lang.Exception

applyPostBody

protected void applyPostBody(ConfigurationAccessor configuration,
                             @Nullable
                             MobilePhone phone,
                             java.lang.String phoneNumber,
                             java.lang.String message,
                             org.apache.http.client.methods.HttpPost request,
                             java.lang.String postBody)

buildRequest

protected org.apache.http.client.methods.HttpUriRequest buildRequest(ConfigurationAccessor configuration,
                                                                     java.lang.String gatewayUrl,
                                                                     @Nullable
                                                                     MobilePhone phone,
                                                                     java.lang.String phoneNumber,
                                                                     java.lang.String message)

Creates the request, either a GET or post, and sets the content type header on it

doSend

protected OutboundSmsStatus doSend(ConfigurationAccessor configuration,
                                   @Nullable
                                   MobilePhone phone,
                                   java.lang.String phoneNumber,
                                   java.lang.String message,
                                   org.apache.http.client.methods.HttpUriRequest request)
                            throws java.lang.Exception

May be overriden in order to customize the SMS sending

Throws:

java.lang.Exception

preProcessMessage

protected java.lang.String preProcessMessage(ConfigurationAccessor configuration,
                                             java.lang.String message)

By default, according to the outbound sms configuration, makes the message only have ASC-II characters

resolveGatewayUrl

protected java.lang.String resolveGatewayUrl(ConfigurationAccessor configuration,
                                             @Nullable
                                             MobilePhone phone,
                                             java.lang.String phoneNumber,
                                             java.lang.String message,
                                             java.util.Map<java.lang.String,java.lang.String> variables)
                                      throws java.lang.Exception

May be overridden in order to resolve the final gateway URL. The variables are already URL encoded, so are safe to concatenate on the URL

Throws:

java.lang.Exception

resolvePostBody

protected java.lang.String resolvePostBody(ConfigurationAccessor configuration,
                                           @Nullable
                                           MobilePhone phone,
                                           java.lang.String phoneNumber,
                                           java.lang.String message,
                                           java.util.Map<java.lang.String,java.lang.String> variables)
                                    throws java.lang.Exception

May be overridden in order to resolve the POST body from the given context and variables

Throws:

java.lang.Exception

resolveStatus

protected OutboundSmsStatus resolveStatus(ConfigurationAccessor configuration,
                                          @Nullable
                                          MobilePhone phone,
                                          java.lang.String message,
                                          org.apache.http.client.methods.HttpUriRequest request,
                                          int statusCode,
                                          org.apache.http.HttpEntity entity)

May be overridden to actually resolve the SMS status from the given response

resolveVariables

protected java.util.Map<java.lang.String,java.lang.String> resolveVariables(ConfigurationAccessor configuration,
                                                                            @Nullable
                                                                            MobilePhone phone,
                                                                            java.lang.String phoneNumber,
                                                                            java.lang.String message)
                                                                     throws java.lang.Exception

May be overridden in order to resolve custom variables

Throws:

java.lang.Exception