那么什么是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文档中可以查看命名空间),以及调用方法名称。如:
![](https://i-blog.csdnimg.cn/blog_migrate/81178cc93a2a3bb5048d90d76e7ec935.gif)
// 命名空间 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中版本号一致):
![](https://i-blog.csdnimg.cn/blog_migrate/81178cc93a2a3bb5048d90d76e7ec935.gif)
// 获得序列化的Envelope SoapSerializationEnvelope envelope = new SoapSerializationEnvelope(SoapEnvelope.VER11); envelope.bodyOut = request;
第四步:注册Envelope,
(new MarshalBase64()).register(envelope);
第五步:构建传输对象,并指明WSDL文档URL:
![](https://i-blog.csdnimg.cn/blog_migrate/81178cc93a2a3bb5048d90d76e7ec935.gif)
// 请求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对象):
![](https://i-blog.csdnimg.cn/blog_migrate/81178cc93a2a3bb5048d90d76e7ec935.gif)
transport.call(serviceNameSpace + getWeatherbyCityName, envelope);
第七步:解析返回数据:
![](https://i-blog.csdnimg.cn/blog_migrate/81178cc93a2a3bb5048d90d76e7ec935.gif)
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天气预报的服务的,我这里只提供获取城市列表:
![](https://i-blog.csdnimg.cn/blog_migrate/81178cc93a2a3bb5048d90d76e7ec935.gif)
//命名空间 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文档:
![](https://i-blog.csdnimg.cn/blog_migrate/81178cc93a2a3bb5048d90d76e7ec935.gif)
<? 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来显示:
那么下面我将给出全部代码:
![](https://i-blog.csdnimg.cn/blog_migrate/81178cc93a2a3bb5048d90d76e7ec935.gif)
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]; } }
以及帮助类:
![](https://i-blog.csdnimg.cn/blog_migrate/81178cc93a2a3bb5048d90d76e7ec935.gif)
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); } }
以上就是我所作的查询天气预报的全部核心代码了,读者可以根据注释以及本文章了解下具体实现,相信很快就搞明白了,运行结果如下:
转自: