Difference between revisions of "Java Sending SMS via SOAP"
From SMS Wiki
| Line 1: | Line 1: | ||
'''Source code for this project can be found [http://api.upsidewireless.com/samples/java/Java%20SOAP%20Demo.zip here]''' | '''Source code for this project can be found [http://api.upsidewireless.com/samples/java/Java%20SOAP%20Demo.zip here]''' | ||
| − | The process of sending an SMS using Java is | + | 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/] |
| − | + | ||
| − | + | ||
* Once you have the plugin installed, add the XFire nature to your project by right clicking on the project and selecting "Add XFire Nature" | * 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 | + | * 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 | WSDL: http://api.upsidewireless.com/soap/Authentication.asmx?WSDL | ||
Revision as of 22:58, 8 May 2008
Source code for this project can be found here
The process of sending an SMS using Java is shown using Eclipse with the XFire plugin. XFire is an opensource Java SOAP interface [1]
- 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; /** * @author cjensen * */ 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); } }
