原帖地址http://www.cnblogs.com/zhangdongzi/archive/2011/04/19/2020688.html
Android与服务器端数据交互(基于SOAP协议整合android+webservice)
上一节中我们通过http协议,采用HttpClient向服务器端action请求数据。当然调用服务器端方法获取数据并不止这一种。WebService也可以为我们提供所需数据,
那么什么是webService呢?,它是一种基于SAOP协议的远程调用标准,通过webservice可以将不同操作系统平台,不同语言,不同技术整合到一起。
我们在PC机器java客户端中,需要一些库,比如XFire,Axis2,CXF等等来支持访问WebService,但是这些库并不适合我们资源有限的android手机客户端,做过JAVA ME的人都知道有KSOAP这个第三方的类库,可以帮助我们获取服务器端webService调用,当然KSOAP已经提供了基于android版本的jar包了,那么我们就开始吧:
首先下载KSOAP包:ksoap2-android-assembly-2.5.2-jar-with-dependencies.jar包
然后新建android项目:并把下载的KSOAP包放在android项目的lib目录下:右键->build path->configure build path--选择Libraries,如图:
以下分为七个步骤来调用WebService方法:
第一:实例化SoapObject 对象,指定webService的命名空间(从相关WSDL文档中可以查看命名空间),以及调用方法名称。如:
// 命名空间
private static final String serviceNameSpace = " http://WebXml.com.cn/ " ;
// 调用方法(获得支持的城市)
private static final String getSupportCity = " getSupportCity " ;
// 实例化SoapObject对象
SoapObject request = new SoapObject(serviceNameSpace, getSupportCity);
第二步:假设方法有参数的话,设置调用方法参数
request.addProperty("参数名称","参数值");
第三步:设置SOAP请求信息(参数部分为SOAP协议版本号,与你要调用的webService中版本号一致):
// 获得序列化的Envelope
SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
envelope.bodyOut = request;
第四步:注册Envelope,
(new MarshalBase64()).register(envelope);
第五步:构建传输对象,并指明WSDL文档URL:
// 请求URL
private static final String serviceURL = " http://www.webxml.com.cn/webservices/weatherwebservice.asmx " ;
// Android传输对象
AndroidHttpTransport transport = new AndroidHttpTransport(serviceURL);
transport.debug = true ;
第六步:调用WebService(其中参数为1:命名空间+方法名称,2:Envelope对象):
transport.call(serviceNameSpace + getWeatherbyCityName, envelope);
第七步:解析返回数据:
if (envelope.getResponse() != null ){
return parse(envelope.bodyIn.toString());
}
/** ************
* 解析XML
* @param str
* @return
*/
private static List < String > parse(String str){
String temp;
List < String > list = new ArrayList < String > ();
if (str != null && str.length() > 0 ){
int start = str.indexOf( " string " );
int end = str.lastIndexOf( " ; " );
temp = str.substring(start, end - 3 );
String []test = temp.split( " ; " );
for ( int i = 0 ;i < test.length;i ++ ){
if (i == 0 ){
temp = test[i].substring( 7 );
} else {
temp = test[i].substring( 8 );
}
int index = temp.indexOf( " , " );
list.add(temp.substring( 0 , index));
}
}
return list;
}
这样就成功啦。那么现在我们就来测试下吧,这里有个地址提供webService天气预报的服务的,我这里只提供获取城市列表:
//命名空间
private static final String serviceNameSpace="http://WebXml.com.cn/";
//请求URL
private static final String serviceURL="http://www.webxml.com.cn/webservices/weatherwebservice.asmx";
//调用方法(获得支持的城市)
private static final String getSupportCity="getSupportCity";
//调用城市的方法(需要带参数)
private static final String getWeatherbyCityName="getWeatherbyCityName";
//调用省或者直辖市的方法(获得支持的省份或直辖市)
private static final String getSupportProvince="getSupportProvince";
然后你可以在浏览器中输入地址(WSDL):serviceURL,你会看到一些可供调用的方法:
我们选择获取国内外主要城市或者省份的方法吧:getSupportProvice,然后调用,你会发现浏览器返回给我们的是xml文档:
<? xml version="1.0" encoding="utf-8" ?>
- < ArrayOfString xmlns:xsi ="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd ="http://www.w3.org/2001/XMLSchema" xmlns ="http://WebXml.com.cn/" >
< string > 直辖市 </ string >
< string > 特别行政区 </ string >
< string > 黑龙江 </ string >
< string > 吉林 </ string >
< string > 辽宁 </ string >
< string > 内蒙古 </ string >
< string > 河北 </ string >
< string > 河南 </ string >
< string > 山东 </ string >
< string > 山西 </ string >
< string > 江苏 </ string >
< string > 安徽 </ string >
< string > 陕西 </ string >
< string > 宁夏 </ string >
< string > 甘肃 </ string >
< string > 青海 </ string >
< string > 湖北 </ string >
< string > 湖南 </ string >
< string > 浙江 </ string >
< string > 江西 </ string >
< string > 福建 </ string >
< string > 贵州 </ string >
< string > 四川 </ string >
< string > 广东 </ string >
< string > 广西 </ string >
< string > 云南 </ string >
< string > 海南 </ string >
< string > 新疆 </ string >
< string > 西藏 </ string >
< string > 台湾 </ string >
< string > 亚洲 </ string >
< string > 欧洲 </ string >
< string > 非洲 </ string >
< string > 北美洲 </ string >
< string > 南美洲 </ string >
< string > 大洋洲 </ string >
</ ArrayOfString >
我们可以用 listview来显示:
那么下面我将给出全部代码:
public class WebServiceHelper {
// WSDL文档中的命名空间
private static final String targetNameSpace = " http://WebXml.com.cn/ " ;
// WSDL文档中的URL
private static final String WSDL = " http://webservice.webxml.com.cn/WebServices/WeatherWebService.asmx?wsdl " ;
// 需要调用的方法名(获得本天气预报Web Services支持的洲、国内外省份和城市信息)
private static final String getSupportProvince = " getSupportProvince " ;
// 需要调用的方法名(获得本天气预报Web Services支持的城市信息,根据省份查询城市集合:带参数)
private static final String getSupportCity = " getSupportCity " ;
// 根据城市或地区名称查询获得未来三天内天气情况、现在的天气实况、天气和生活指数
private static final String getWeatherbyCityName = " getWeatherbyCityName " ;
/** ******
* 获得州,国内外省份和城市信息
* @return
*/
public List < String > getProvince(){
List < String > provinces = new ArrayList < String > ();
String str = "" ;
SoapObject soapObject = new SoapObject(targetNameSpace,getSupportProvince);
// request.addProperty("参数", "参数值");调用的方法参数与参数值(根据具体需要可选可不选)
SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
envelope.dotNet = true ;
envelope.setOutputSoapObject(soapObject); // envelope.bodyOut=request;
AndroidHttpTransport httpTranstation = new AndroidHttpTransport(WSDL);
// 或者HttpTransportSE httpTranstation=new HttpTransportSE(WSDL);
try {
httpTranstation.call(targetNameSpace + getSupportProvince, envelope);
SoapObject result = (SoapObject)envelope.getResponse();
// 下面对结果进行解析,结构类似json对象
// str=(String) result.getProperty(6).toString();
int count = result.getPropertyCount();
for ( int index = 0 ;index < count;index ++ ){
provinces.add(result.getProperty(index).toString());
}
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (XmlPullParserException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return provinces;
}
/** ********
* 根据省份或者直辖市获取天气预报所支持的城市集合
* @param province
* @return
*/
public List < String > getCitys(String province){
List < String > citys = new ArrayList < String > ();
SoapObject soapObject = new SoapObject(targetNameSpace,getSupportCity);
soapObject.addProperty( " byProvinceName " , province);
SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
envelope.dotNet = true ;
envelope.setOutputSoapObject(soapObject);
AndroidHttpTransport httpTransport = new AndroidHttpTransport(WSDL);
try {
httpTransport.call(targetNameSpace + getSupportCity, envelope);
SoapObject result = (SoapObject)envelope.getResponse();
int count = result.getPropertyCount();
for ( int index = 0 ;index < count;index ++ ){
citys.add(result.getProperty(index).toString());
}
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (XmlPullParserException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return citys;
}
/** *************************
* 根据城市信息获取天气预报信息
* @param city
* @return
************************** */
public WeatherBean getWeatherByCity(String city){
WeatherBean bean = new WeatherBean();
SoapObject soapObject = new SoapObject(targetNameSpace,getWeatherbyCityName);
soapObject.addProperty( " theCityName " ,city); // 调用的方法参数与参数值(根据具体需要可选可不选)
SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
envelope.dotNet = true ;
envelope.setOutputSoapObject(soapObject); // envelope.bodyOut=request;
AndroidHttpTransport httpTranstation = new AndroidHttpTransport(WSDL);
// 或者HttpTransportSE httpTranstation=new HttpTransportSE(WSDL);
try {
httpTranstation.call(targetNameSpace + getWeatherbyCityName, envelope);
SoapObject result = (SoapObject)envelope.getResponse();
// 下面对结果进行解析,结构类似json对象
bean = parserWeather(result);
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (XmlPullParserException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return bean;
}
/**
* 解析返回的结果
* @param soapObject
*/
protected WeatherBean parserWeather(SoapObject soapObject){
WeatherBean bean = new WeatherBean();
List < Map < String,Object >> list = new ArrayList < Map < String,Object >> ();
Map < String,Object > map = new HashMap < String,Object > ();
// 城市名
bean.setCityName(soapObject.getProperty( 1 ).toString());
// 城市简介
bean.setCityDescription(soapObject.getProperty(soapObject.getPropertyCount() - 1 ).toString());
// 天气实况+建议
bean.setLiveWeather(soapObject.getProperty( 10 ).toString() + " \n " + soapObject.getProperty( 11 ).toString());
// 其他数据
// 日期,
String date = soapObject.getProperty( 6 ).toString();
// ---------------------------------------------------
String weatherToday = " 今天: " + date.split( " " )[ 0 ];
weatherToday += " \n天气: " + date.split( " " )[ 1 ];
weatherToday += " \n气温: " + soapObject.getProperty( 5 ).toString();
weatherToday += " \n风力: " + soapObject.getProperty( 7 ).toString();
weatherToday += " \n " ;
List < Integer > icons = new ArrayList < Integer > ();
icons.add(parseIcon(soapObject.getProperty( 8 ).toString()));
icons.add(parseIcon(soapObject.getProperty( 9 ).toString()));
map.put( " weatherDay " , weatherToday);
map.put( " icons " ,icons);
list.add(map);
// -------------------------------------------------
map = new HashMap < String,Object > ();
date = soapObject.getProperty( 13 ).toString();
String weatherTomorrow = " 明天: " + date.split( " " )[ 0 ];
weatherTomorrow += " \n天气: " + date.split( " " )[ 1 ];
weatherTomorrow += " \n气温: " + soapObject.getProperty( 12 ).toString();
weatherTomorrow += " \n风力: " + soapObject.getProperty( 14 ).toString();
weatherTomorrow += " \n " ;
icons = new ArrayList < Integer > ();
icons.add(parseIcon(soapObject.getProperty( 15 ).toString()));
icons.add(parseIcon(soapObject.getProperty( 16 ).toString()));
map.put( " weatherDay " , weatherTomorrow);
map.put( " icons " ,icons);
list.add(map);
// --------------------------------------------------------------
map = new HashMap < String,Object > ();
date = soapObject.getProperty( 18 ).toString();
String weatherAfterTomorrow = " 后天: " + date.split( " " )[ 0 ];
weatherAfterTomorrow += " \n天气: " + date.split( " " )[ 1 ];
weatherAfterTomorrow += " \n气温: " + soapObject.getProperty( 17 ).toString();
weatherAfterTomorrow += " \n风力: " + soapObject.getProperty( 19 ).toString();
weatherAfterTomorrow += " \n " ;
icons = new ArrayList < Integer > ();
icons.add(parseIcon(soapObject.getProperty( 20 ).toString()));
icons.add(parseIcon(soapObject.getProperty( 21 ).toString()));
map.put( " weatherDay " , weatherAfterTomorrow);
map.put( " icons " ,icons);
list.add(map);
// --------------------------------------------------------------
bean.setList(list);
return bean;
}
// 解析图标字符串
private int parseIcon(String data){
// 0.gif,返回名称0,
int resID = 32 ;
String result = data.substring( 0 , data.length() - 4 ).trim();
// String []icon=data.split(".");
// String result=icon[0].trim();
// Log.e("this is the icon", result.trim());
if ( ! result.equals( " nothing " )){
resID = Integer.parseInt(result.trim());
}
return resID;
// return ("a_"+data).split(".")[0];
}
}
以及帮助类:
public class WebServiceUtil {
// 命名空间
private static final String serviceNameSpace = " http://WebXml.com.cn/ " ;
// 请求URL
private static final String serviceURL = " http://www.webxml.com.cn/webservices/weatherwebservice.asmx " ;
// 调用方法(获得支持的城市)
private static final String getSupportCity = " getSupportCity " ;
// 调用城市的方法(需要带参数)
private static final String getWeatherbyCityName = " getWeatherbyCityName " ;
// 调用省或者直辖市的方法(获得支持的省份或直辖市)
private static final String getSupportProvince = " getSupportProvince " ;
/** ***********
* @return城市列表
************ */
public static List < String > getCityList(){
// 实例化SoapObject对象
SoapObject request = new SoapObject(serviceNameSpace, getSupportCity);
// 获得序列化的Envelope
SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
envelope.bodyOut = request;
( new MarshalBase64()).register(envelope);
// Android传输对象
AndroidHttpTransport transport = new AndroidHttpTransport(serviceURL);
transport.debug = true ;
// 调用
try {
transport.call(serviceNameSpace + getWeatherbyCityName, envelope);
if (envelope.getResponse() != null ){
return parse(envelope.bodyIn.toString());
}
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (XmlPullParserException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return null ;
}
public static List < String > getProviceList(){
// 实例化SoapObject对象
SoapObject request = new SoapObject(serviceNameSpace, getSupportProvince);
// 获得序列化的Envelope
SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11);
envelope.bodyOut = request;
( new MarshalBase64()).register(envelope);
// Android传输对象
AndroidHttpTransport transport = new AndroidHttpTransport(serviceURL);
transport.debug = true ;
// 调用
try {
transport.call(serviceNameSpace + getWeatherbyCityName, envelope);
if (envelope.getResponse() != null ){
return null ;
}
} catch (IOException e) {
// TODO Auto-generated catch block
e.printStackTrace();
} catch (XmlPullParserException e) {
// TODO Auto-generated catch block
e.printStackTrace();
}
return null ;
}
/** ***********
* @param cityName
* @return
************ */
public static String getWeather(String cityName){
return "" ;
}
/** ************
* 解析XML
* @param str
* @return
*/
private static List < String > parse(String str){
String temp;
List < String > list = new ArrayList < String > ();
if (str != null && str.length() > 0 ){
int start = str.indexOf( " string " );
int end = str.lastIndexOf( " ; " );
temp = str.substring(start, end - 3 );
String []test = temp.split( " ; " );
for ( int i = 0 ;i < test.length;i ++ ){
if (i == 0 ){
temp = test[i].substring( 7 );
} else {
temp = test[i].substring( 8 );
}
int index = temp.indexOf( " , " );
list.add(temp.substring( 0 , index));
}
}
return list;
}
/** *******
* 获取天气
* @param soapObject
*/
private void parseWeather(SoapObject soapObject){
// String date=soapObject.getProperty(6);
}
}
以上就是我所作的查询天气预报的全部核心代码了,读者可以根据注释以及本文章了解下具体实现,相信很快就搞明白了,运行结果如下: