Difference between revisions of "Java Sending SMS via SOAP"

From SMS Wiki
Jump to: navigation, search
Line 1: Line 1:
 
 
The process of sending an SMS using Java is shown using Eclipse with the XFire plugin. XFire is an opensource Java SOAP interface [http://xfire.codehaus.org/ (download XFire)]
 
The process of sending an SMS using Java is shown using Eclipse with the XFire plugin. XFire is an opensource Java SOAP interface [http://xfire.codehaus.org/ (download XFire)]
  
Line 7: Line 6:
  
 
  WSDL: http://api.upsidewireless.com/soap/Authentication.asmx?WSDL
 
  WSDL: http://api.upsidewireless.com/soap/Authentication.asmx?WSDL
  Output Directory: <Your source directory>
+
   
 +
Output Directory: <Your source directory>
 +
 
 
  Package: <Leave Blank> (By leaving this field blank, the default package of the service will be used)
 
  Package: <Leave Blank> (By leaving this field blank, the default package of the service will be used)
 +
 
  Click Finish and it will build the necessary source files. Repeat the process for: http://api.upsidewireless.com/soap/SMS.asmx?WSDL
 
  Click Finish and it will build the necessary source files. Repeat the process for: http://api.upsidewireless.com/soap/SMS.asmx?WSDL
  
Line 14: Line 16:
  
 
<source lang="java">
 
<source lang="java">
 +
 
SMSClient client = new SMSClient();
 
SMSClient client = new SMSClient();
 +
 
SMSSoap soap = client.getSMSSoap();
 
SMSSoap soap = client.getSMSSoap();
 +
 
soap.send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);
 
soap.send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);
 +
 
</source>
 
</source>
  
Line 33: Line 39:
  
 
import com.upsidewireless.webservice.authentication.AuthenticationClient;
 
import com.upsidewireless.webservice.authentication.AuthenticationClient;
 +
 
import com.upsidewireless.webservice.authentication.AuthenticationParameters;
 
import com.upsidewireless.webservice.authentication.AuthenticationParameters;
 +
 
import com.upsidewireless.webservice.authentication.AuthenticationSoap;
 
import com.upsidewireless.webservice.authentication.AuthenticationSoap;
 +
 
import com.upsidewireless.webservice.sms.SMSClient;
 
import com.upsidewireless.webservice.sms.SMSClient;
 +
 
import com.upsidewireless.webservice.sms.SMSSoap;
 
import com.upsidewireless.webservice.sms.SMSSoap;
 +
 
import com.upsidewireless.webservice.sms.SmsEncoding;
 
import com.upsidewireless.webservice.sms.SmsEncoding;
 +
  
 
/**
 
/**
  * @author cjensen
+
  * Start of your code
 
  *  
 
  *  
 
  */
 
  */
Line 48: Line 60:
 
* @param args
 
* @param args
 
*/
 
*/
 +
 
public static void main(String[] args) {
 
public static void main(String[] args) {
  
/***********************************************************************
+
/***********************************************************************
 +
 
 
* Execute the retrieval of the token and signature only once.
 
* Execute the retrieval of the token and signature only once.
 +
 
* Preferably from the web interface and store them as Constants
 
* Preferably from the web interface and store them as Constants
 
**********************************************************************/
 
**********************************************************************/
  
 
AuthenticationClient authclient = new AuthenticationClient();
 
AuthenticationClient authclient = new AuthenticationClient();
 +
 
AuthenticationSoap authsoap = authclient.getAuthenticationSoap();
 
AuthenticationSoap authsoap = authclient.getAuthenticationSoap();
  
 
AuthenticationParameters authparams = authsoap.getParameters("YourUserName", "YourPassword");
 
AuthenticationParameters authparams = authsoap.getParameters("YourUserName", "YourPassword");
 +
 
String token = authparams.getToken();
 
String token = authparams.getToken();
 +
 
String signature = authparams.getSignature();
 
String signature = authparams.getSignature();
  
 
/***********************************************************************
 
/***********************************************************************
* We now have the credentials, now build a SOAP client and make the
+
* We now have the credentials, now build a SOAP client and make the call.
* call.
+
 
**********************************************************************/
 
**********************************************************************/
  
 
SMSClient client = new SMSClient();
 
SMSClient client = new SMSClient();
 +
 
SMSSoap soap = client.getSMSSoap();
 
SMSSoap soap = client.getSMSSoap();
 +
 
soap.send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);
 
soap.send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);
  
Line 74: Line 93:
  
 
}
 
}
 +
 
</source>
 
</source>
  
 
----
 
----
 
[[APIs | back]]
 
[[APIs | back]]

Revision as of 12:05, 6 December 2011

The process of sending an SMS using Java is shown using Eclipse with the XFire plugin. XFire is an opensource Java SOAP interface (download XFire)

  • Once you have the plugin installed, add the XFire nature to your project by right clicking on the project and selecting "Add XFire Nature"
  • Then, right click on the project and specify "New > Other...". At the bottom of the list should be an option labeled "Code generation from WSDL Document". Select this option and enter the following into the dialog presented:
WSDL: http://api.upsidewireless.com/soap/Authentication.asmx?WSDL

Output Directory: <Your source directory>

Package: <Leave Blank> (By leaving this field blank, the default package of the service will be used)
Click Finish and it will build the necessary source files. Repeat the process for: http://api.upsidewireless.com/soap/SMS.asmx?WSDL
  • Now that you have both sets of XFire client code generated (one for authentication and the other for sending SMS), now it is time to make a call. The essence of making the call is the following 3 lines of code (it can be reduce down to a single line of code, but that would make debugging difficult):
SMSClient client = new SMSClient();
 
SMSSoap soap = client.getSMSSoap();
 
soap.send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);


Here is the one liner:

new SMSClient().getSMSSoap().send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);

If you are sending URL in the text of your message please note that special characters like "-", "+", "/" and others MUST be replaced with their safe equivalents (for example %2f).

A complete "Main" style application would look like:

import org.codehaus.xfire.XFireRuntimeException;
 
import com.upsidewireless.webservice.authentication.AuthenticationClient;
 
import com.upsidewireless.webservice.authentication.AuthenticationParameters;
 
import com.upsidewireless.webservice.authentication.AuthenticationSoap;
 
import com.upsidewireless.webservice.sms.SMSClient;
 
import com.upsidewireless.webservice.sms.SMSSoap;
 
import com.upsidewireless.webservice.sms.SmsEncoding;
 
 
/**
 * Start of your code
 * 
 */
public class SendSms {
 
	/**
	 * @param args
	 */
 
	public static void main(String[] args) {
 
/***********************************************************************
 
		 * Execute the retrieval of the token and signature only once.
 
		 * Preferably from the web interface and store them as Constants
		 **********************************************************************/
 
		AuthenticationClient authclient = new AuthenticationClient();
 
		AuthenticationSoap authsoap = authclient.getAuthenticationSoap();
 
		AuthenticationParameters authparams = authsoap.getParameters("YourUserName", "YourPassword");
 
		String token = authparams.getToken();
 
		String signature = authparams.getSignature();
 
		/***********************************************************************
		 * We now have the credentials, now build a SOAP client and make the call.
		 **********************************************************************/
 
		SMSClient client = new SMSClient();
 
		SMSSoap soap = client.getSMSSoap();
 
		soap.send_Plain(token, signature, "+15557779999", "Hello", SmsEncoding.SEVEN);
 
	}
 
}

back