In an effort to explain how to take advantage of KSOAP, I have put together a sample application. For the purpose of clarity I have made this application simple and straightforward. It is a wireless-app that enables a fictitious manager to receive, by way of a mobile phone, system alerts that are periodically generated by some anonymous back-end system during the normal course of the day. Upon receiving such an alert he or she might decide to call an administrator, or notify their department, or perhaps even dial-in from home and fix the problem.
This sample application involves just four classes.
- SystemAlert.java
The data model - AlertService.java
The Service module generating SystemAlerts. - AlertServlet.java
The HTTP interface that sends and receives SOAP Messages. - AlertClient.java
The MIDLet application residing on the Mobile Phone
The components work together as illustrated below.