快递100接口解析与Volley自定义XML解析

来源：互联网发布：云烟软件编辑：程序博客网时间：2024/05/16 17:36

标题：快递100接口解析与Volley自定义XML解析

1.申请快递100的秘钥：

1、应用场景: （1）电商网站用户打开“我的订单”时调用此API显示结果; （2）物流系统对帐前调用此API查一次所有运单的签收状态

2、是否需要授权: 是，请到快递查询API申请地址申请

3、请求地址: http://api.kuaidi100.com/api?id=[]&com=[]&nu=[]&valicode=[]&show=[0|1|2|3]&muti=[0|1]&order=[desc|asc]; （使用时请先将上述地址中的中括号替换成下面相应的值）

4.输入参数

名称类型是否必需描述idString是身份授权key，请快递查询接口进行申请（大小写敏感）comString是要查询的快递公司代码，不支持中文，对应的公司代码见
《API URL 所支持的快递公司及参数说明》和《支持的国际类快递及参数说明》。
如果找不到您所需的公司，请发邮件至 kuaidi@kingdee.com 咨询（大小写不敏感）nuString是要查询的快递单号，请勿带特殊符号，不支持中文（大小写不敏感）valicodeString是已弃用字段，无意义，请忽略。showString是返回类型：
0：返回json字符串，
1：返回xml对象，
2：返回html对象，
3：返回text文本。
如果不填，默认返回json字符串。mutiString是返回信息数量：
1:返回多行完整的信息，
0:只返回一行信息。
不填默认返回多行。 orderString是排序：
desc：按时间由新到旧排列，
asc：按时间由旧到新排列。
不填默认返回倒序（大小写不敏感）

5.返回结果

字段名称字段含义com物流公司编号nu物流单号time每条跟踪信息的时间context每条跟综信息的描述state快递单当前的状态：　
0：在途，即货物处于运输过程中；
1：揽件，货物已由快递公司揽收并且产生了第一条跟踪信息；
2：疑难，货物寄送过程出了问题；
3：签收，收件人已签收；
4：退签，即货物由于用户拒签、超区等原因退回，而且发件人已经签收；
5：派件，即快递正在进行同城派件；
6：退回，货物正处于退回发件人的途中；
该状态还在不断完善中，若您有更多的参数需求，欢迎发邮件至kuaidi@kingdee.com 提出。status查询结果状态：
0：物流单暂无结果，
1：查询成功，
2：接口出现异常，message无意义，请忽略condition无意义，请忽略ischeck无意义，请忽略

6.返回示例

XML格式

            <xml>            <message>ok</message>            <nu>1200722815552</nu>            <ischeck>1</ischeck>            <com>yunda</com>            <status>1</status>            <condition>F00</condition>            <data>            <time>2013-03-03 19:24:48</time>            <context>江苏泗阳县公司:进行揽件扫描</context>            </data>            <data>            <time>2013-03-03 19:25:10</time>            <context>江苏泗阳县公司:进行发出扫描，将发往：江苏淮安中转站</context>            </data>            <data>            <time>2013-03-03 21:44:47</time>            <context>江苏淮安中转站:快件进入分拨中心进行分拨</context>            </data>            <data>            <time>2013-03-04 03:22:44</time>            <context>江苏南京中转站:从站点发出，本次转运目的地：江苏南京栖霞区仙林公司</context>            </data>            <data>            <time>2013-03-04 08:25:03</time>            <context>江苏南京栖霞区仙林公司:到达目的地网点，快件将很快进行派送</context>            </data>            <data>            <time>2013-03-04 13:09:58</time>            <context>江苏南京栖霞区仙林公司:进行派件扫描；派送业务员：孙；（</context>            </data>            <data>            <time>2013-03-04 13:19:47</time>            <context>江苏南京栖霞区仙林公司:快件已被 图片 签收</context>            </data>            <state>3</state>            </xml>

2.自定义XML解析

public class XMLRequest extends Request<XmlPullParser> {private final Listener<XmlPullParser> mListener;public XMLRequest(int method, String url, Listener<XmlPullParser> listener,ErrorListener errorListener) {super(method, url, errorListener);mListener = listener;}public XMLRequest(String url, Listener<XmlPullParser> listener,ErrorListener errorListener) {this(Method.GET, url, listener, errorListener);}@Overrideprotected Response<XmlPullParser> parseNetworkResponse(NetworkResponse response) {try {String xmlString = new String(response.data,HttpHeaderParser.parseCharset(response.headers));XmlPullParserFactory factory = XmlPullParserFactory.newInstance();XmlPullParser xmlPullParser = factory.newPullParser();xmlPullParser.setInput(new StringReader(xmlString));return Response.success(xmlPullParser,HttpHeaderParser.parseCacheHeaders(response));} catch (UnsupportedEncodingException e) {return Response.error(new ParseError(e));} catch (XmlPullParserException e) {return Response.error(new ParseError(e));}}@Overrideprotected void deliverResponse(XmlPullParser response) {mListener.onResponse(response);}}

3、自定义实体

public class KuaiDi {/** * com 物流公司编号nu 物流单号time 每条跟踪信息的时间context 每条跟综信息的描述state 快递单当前的状态 ：　 0：在途，即货物处于运输过程中；1：揽件，货物已由快递公司揽收并且产生了第一条跟踪信息；2：疑难，货物寄送过程出了问题；3：签收，收件人已签收；4：退签，即货物由于用户拒签、超区等原因退回，而且发件人已经签收；5：派件，即快递正在进行同城派件；6：退回，货物正处于退回发件人的途中；该状态还在不断完善中，若您有更多的参数需求，欢迎发邮件至 kuaidi@kingdee.com 提出。status 查询结果状态： 0：物流单暂无结果， 1：查询成功， 2：接口出现异常，message 无意义，请忽略condition 无意义，请忽略ischeck 无意义，请忽略 */private String nu;//运单号private String comcontact;//联系电话private String companytype;private String com;private String condition;private String status;private String codenumber;private String state;private String message;private String ischeck;private String comurl;private List<Data> data;public String getNu() {return nu;}public void setNu(String nu) {this.nu = nu;}public String getComcontact() {return comcontact;}public void setComcontact(String comcontact) {this.comcontact = comcontact;}public String getCompanytype() {return companytype;}public void setCompanytype(String companytype) {this.companytype = companytype;}public String getCom() {return com;}public void setCom(String com) {this.com = com;}public String getCondition() {return condition;}public void setCondition(String condition) {this.condition = condition;}public String getStatus() {return status;}public void setStatus(String status) {this.status = status;}public String getCodenumber() {return codenumber;}public void setCodenumber(String codenumber) {this.codenumber = codenumber;}public String getState() {return state;}public void setState(String state) {this.state = state;}public String getMessage() {return message;}public void setMessage(String message) {this.message = message;}public String getIscheck() {return ischeck;}public void setIscheck(String ischeck) {this.ischeck = ischeck;}public String getComurl() {return comurl;}public void setComurl(String comurl) {this.comurl = comurl;}public List<Data> getData() {return data;}public void setData(List<Data> data) {this.data = data;}public KuaiDi(String nu, String comcontact, String companytype, String com,String condition, String status, String codenumber, String state,String message, String ischeck, String comurl, List<Data> data) {super();this.nu = nu;this.comcontact = comcontact;this.companytype = companytype;this.com = com;this.condition = condition;this.status = status;this.codenumber = codenumber;this.state = state;this.message = message;this.ischeck = ischeck;this.comurl = comurl;this.data = data;}public KuaiDi() {super();}@Overridepublic String toString() {return "KuaiDi [nu=" + nu + ", comcontact=" + comcontact+ ", companytype=" + companytype + ", com=" + com+ ", condition=" + condition + ", status=" + status+ ", codenumber=" + codenumber + ", state=" + state+ ", message=" + message + ", ischeck=" + ischeck + ", comurl="+ comurl + ", data=" + data + "]";}}public class Data implements Serializable{/*** */private static final long serialVersionUID = 1L;private String time;//时间private String location;//位置private String context;//详细信息@Overridepublic String toString() {return "Data [time=" + time + ", location=" + location + ", context="+ context + "]";}public String getTime() {return time;}public void setTime(String time) {this.time = time;}public String getLocation() {return location;}public void setLocation(String location) {this.location = location;}public String getContext() {return context;}public void setContext(String context) {this.context = context;}public Data() {super();}}

4.解析物流信息：

RequestQueue mRequestQueue = Volley.newRequestQueue(this);mRequestQueue.start();XMLRequest xmlRequest = new XMLRequest(         "http://api.kuaidi100.com/api?id=xxxxxxxxxx&com=huitongkuaidi&nu=70017301113085&&show=1&muti=1&order=desc",         new com.android.volley.Response.Listener<XmlPullParser>() {              KuaiDi kuaidi;            List<Data> datas;            Data data;@Override             public void onResponse(XmlPullParser response) {                 try {                     int eventType = response.getEventType();                     while (eventType != XmlPullParser.END_DOCUMENT) {                     String nodeName = response.getName();                       switch (eventType) {  //                                                            解析到文档开始的时候                       case XmlPullParser.START_DOCUMENT:                            kuaidi = new KuaiDi();                            datas = new ArrayList<Data>();                       break;                       case XmlPullParser.START_TAG:                             if (nodeName.equals("data")) {                             data = new Data();                           }else if(nodeName.equals("time")){                           data.setTime(response.nextText());                           }else if(nodeName.equals("location")){                           data.setLocation(response.nextText());                           }else if(nodeName.equals("context")){                           data.setContext(response.nextText());                           }else if(nodeName.equals("nu")){                           kuaidi.setNu(response.nextText());                           }else if(nodeName.equals("comcontact")){                           kuaidi.setComcontact(response.nextText());                           }else if(nodeName.equals("companytype")){                           kuaidi.setCompanytype(response.nextText());                           }else if(nodeName.equals("com")){                           kuaidi.setCom(response.nextText());                           }else if(nodeName.equals("condition")){                           kuaidi.setCondition(response.nextText());                           }else if(nodeName.equals("status")){                           kuaidi.setStatus(response.nextText());                           }else if(nodeName.equals("state")){                           kuaidi.setState(response.nextText());                           }else if(nodeName.equals("message")){                           kuaidi.setMessage(response.nextText());                           }else if(nodeName.equals("codenumber")){                           kuaidi.setCodenumber(response.nextText());                           }else if(nodeName.equals("ischeck")){                           kuaidi.setIscheck(response.nextText());                           }else if(nodeName.equals("comurl")){                           kuaidi.setComurl(response.nextText());                           }                           break;                         case XmlPullParser.END_TAG:                           if (nodeName.equals("data") && data != null) {                           datas.add(data);                               data = null;                           }                            break;                      default:                     break;                       }                              eventType = response.next();                     }                 } catch (XmlPullParserException e) {                     e.printStackTrace();                 } catch (IOException e) {                     e.printStackTrace();                 }                kuaidi.setData(datas);               System.out.println("----333333---------"+kuaidi.toString());           }         }, new com.android.volley.Response.ErrorListener() {             @Override             public void onErrorResponse(VolleyError error) {                 Log.e("TAG", error.getMessage(), error);                Toast.makeText(getApplicationContext(), "网络不给力，请待会再试", 1).show();           }         });     mRequestQueue.add(xmlRequest); }

5.解析的结果展示：

1 0