一步一步教你写一个快递查询APP(适合新手)

前言:

水平:自学Android十五天,以前有过混日子的编程经验。

目标: 《第一行代码》学完之后,总想写个APP,天气的APP写了个初版,后面再说,今天演示的是制作快递查询APP的整个经过。

适合人群:新手

工具:Android Studio 2.2.2

  • 新建一个工程,选择Empty Actvity即可,其他默认。

1.布局

actvity_main.xml








    

    
    

    


涉及到的相应要修改的文件,res->value->strings.xml文件


KuaiDISearch
请输入快递单号:
查询
input your Courier number

看默认的输入框不爽,OK,我们来修改一下样式。在layout文件下新建一个名为edit_bg.xml的文件。

然后天剑EditText的android:background=”@layout/edit_bg”




    
        
        
        
    


  • 下拉框的数据绑定,本文是通过xml文件。

在values下新建一个名为arrays.xml的文件,




    申通
    EMS
    顺丰
    圆通
    中通
    韵达
    天天
    汇通
    全峰
    德邦
    宅急送


  • 我只找到十一家,其他的我暂时还没看。

  • 然后设置Spinner的entries属性。

    android:entries=”@array/kdcompany”

  • 最后我们还要设置每一个item的样式。

  • 在layout下新建一个名为item_list.xml文件。(csdn的markdown编辑器不知道为啥不显示我在markdownpad2里编辑内容,大家直接看源码吧。)

整体布局就是垂直方向线性布局,在第二层,嵌套一个水平方向的线性布局。

涉及到的控件:一个TextView,EditText,Spinner,Button,ListView

知识点:

  • LinearLayout,vertical,horizontal,layout_weight
  • 效果图:
    一步一步教你写一个快递查询APP(适合新手)_第1张图片

2.ListView使用方法

听说ListView是安卓开发常用的控件,看起来好像是。
我们的第一版的需求不要太复杂,把快递查询的结果分成两列,一列显示时间,一列显示内容(快递到哪儿了)

  • 运行一下程序,结果报错了:

Your content must have a ListView whose id attribute is ‘android.R.id.list’

原来在layout_main.xml中ListView的id需要使用系统的。

这一步需要注意的问题是ListView 控件的id要使用Android系统内置的 android:id=”@android:id/list”

忘了说了,我们让我们的MainActivity继承ListActivity,即extends ListActivity。

3.接口数据

昨天夜里一点逛知乎,看到了一个快递的免费接口,这让我马上想到做出这个应用。

http://www.kuaidi100.com/query?type=快递公司代号&postid=快递单号

快递公司代号:申通=”shentong” EMS=”ems” 顺丰=”shunfeng” 圆通=”yuantong” 中通=”zhongtong” 韵达=”yunda” 天天=”tiantian” 汇通=”huitongkuaidi” 全峰=”quanfengkuaidi” 德邦=”debangwuliu” 宅急送=”zhaijisong”

示例:http://www.kuaidi100.com/query?type=tiantian&postid=XXXXXXXXXXX
  • 网站返回的是JSON数据,为了更好地阅读JSON数据,可以把返回的数据复制到以下网址,可以格式化JSON数据。

  • www.bejson.com,其他类似的网站也行,点我

导入了org.apache.http.legacy还是无效呢,因为有两个版本的。
还要设置targetSdkVersion与legacy包相匹配。

4.解析JSON数据

4.1 Button的点击事件

先声明:

private Button query;

在onCreate方法里赋值:

query = (Button)findViewById(R.id.query);

用匿名内部类来写点击事件(其他写法,可以参考我的博文Button点击事件的四种写法)

    query.setOnClickListener(new View.OnClickListener() {
        @Override
        public void onClick(View v) {
            sendRequest();
        }
    });

点击按钮之后,我们想服务器(接口所在的)发送请求,sendRequest方法就是干这个的。

//发送Http请求
private void sendRequest(){
    new Thread(new Runnable() {
        @Override
        public void run() {
            try{
                HttpClient httpClient = new DefaultHttpClient();
                //处理快递单号
                HttpGet httpGet = new HttpGet(http://www.kuaidi100.com/query?type=shunfeng&postid=XXXXXXX);//XXXXXX处填写快递单号
                HttpResponse httpResponse = httpClient.execute(httpGet);
                if(httpResponse.getStatusLine().getStatusCode() == 200){
                    //请求和响应都成功了
                    HttpEntity entity = httpResponse.getEntity();
                    String response = EntityUtils.toString(entity,"utf-8");
                    parseJSON(response);
                }
            }catch (Exception e)
            {
                e.printStackTrace();
            }
        }
    }).start();
}

在这里补一句,HttpClient需要自己在libs添加一个jar包。自己通过在windows上搜索,找到org.apache.http.legacy.jar 还要注意一个版本的问题,你的build.gradle(Module:app)里的targetSdkVersion是24,那么你就在例如D:\Android\sdk\platforms\android-24\optional文件夹下找。

android-24,我之前找了个android-23的,出不来

接受到的JSON数据如下:

"message": "ok",
"nu": "XXXXXXXXXXX",
"ischeck": "0",
"condition": "00",
"com": "tiantian",
"status": "200",
"state": "0",
"data": [
    {
        "time": "2016-12-18 18:57:54",
        "ftime": "2016-12-18 18:57:54",
        "context": "快件已签收,签收人是乡镇代理点,签收网点是XXXXXX",
        "location": ""
    },
  • 先声明一个list和一个HashMap,哈希表是按照键值对来储存数据了。

ArrayList

4.2 到了关键部分了,就是解析JSON数据,有很多种方式,其他方式可以上网搜一搜。

//解析JSON数据
private void parseJSON(String jsonData){
    try{
        //我们需要解析数组data的数据,其中time和context就是需要的字段
        JSONArray jsonArray = new JSONObject(jsonData).getJSONArray("data");
        for (int i = 0;i();
            map.put("time",time);
            map.put("context",context);
            list.add(map);
        }

        //在子线程向ListView里添加数据
        new Thread(){
            public void run(){
                runOnUiThread(new Runnable() {
                    @Override
                    public void run() {
                        SimpleAdapter simpleAdapter = new SimpleAdapter(MainActivity.this,list,
                                R.layout.item_list,form,to);
                        setListAdapter(simpleAdapter);
                        //假如没有数据,提醒用户
                        if(lv.getCount() == 0){
                            Toast.makeText(MainActivity.this,"还没有数据",Toast.LENGTH_LONG).show();
                        }
                    }
                });
            }
        }.start();

    }catch (Exception e)
    {
        e.printStackTrace();
    }
}
  • 假如没有在子线程更新view,就会报错,如下:

Only the original thread that created a view hierarchy can touch its views.

5.下拉框

到这里,应该可以查询到单条数据了,

回到上面的sendRequest方法。可以看到我们刚才发送请求的地址是:

//处理快递单号

HttpGet httpGet = new HttpGet(http://www.kuaidi100.com/query?

type=shunfeng&postid=XXXXXXX);//XXXXXX处填写快递单号
  • 现在我们要实现输入框和下拉框的功能,为了能让大家看得更直观,我就先只传了一个具体的链接。
  • 需要发送的链接里包含两个参数,一个是快递公司的代号,我们可以获得下拉框选中的值得到,另一个是快递单号,可以通过获取输入框的值得到。

声明:

private EditText postid;
private Spinner spinner;

赋值

    postid = (EditText)findViewById(R.id.postid);
    spinner = (Spinner)findViewById(R.id.spinner);

需要修改一下sendRequest方法。

//发送Http请求
private void sendRequest(){
    new Thread(new Runnable() {
        @Override
        public void run() {
            try{
                HttpClient httpClient = new DefaultHttpClient();
                //处理快递单号
                String queryString = checkPostid();
                HttpGet httpGet = new HttpGet(queryString);
                HttpResponse httpResponse = httpClient.execute(httpGet);
                if(httpResponse.getStatusLine().getStatusCode() == 200){
                    //请求和响应都成功了
                    HttpEntity entity = httpResponse.getEntity();
                    String response = EntityUtils.toString(entity,"utf-8");
                    parseJSON(response);
                }
            }catch (Exception e)
            {
                e.printStackTrace();
            }
        }
    }).start();
}

checkPostid方法就是通过识别快递单号是哪家的快递,给服务器传递响应的请求

//识别快递单号是哪家的快递,给服务器传递响应的请求
private String checkPostid(){
    //基础链接
    String baseStr = "http://www.kuaidi100.com/query?type=";
    String type= "";
    String postidNumber = postid.getText().toString().trim();
    String kuaidiCompany = spinner.getSelectedItem().toString().trim();
    Log.d("post id",postidNumber);
    Log.d("kuaidiCompany id",kuaidiCompany);

    if(kuaidiCompany.equals("申通")){
        type = "shentong";
    }else if(kuaidiCompany.equals("EMS")){
        type = "ems";
    }else if(kuaidiCompany.equals("顺丰")){
        type = "shunfeng";
    }else if(kuaidiCompany.equals("圆通")){
        type = "yuantong";
    }else if(kuaidiCompany.equals("中通")){
        type = "zhongtong";
    }else if (kuaidiCompany.equals("韵达")){
        type = "yunda";
    }else if (kuaidiCompany.equals("天天")){
        type = "tiantian";
    }else if (kuaidiCompany.equals("汇通")){
        type = "huitongkuaidi";
    }else if (kuaidiCompany.equals("全峰")){
        type = "quanfengkuaidi";
    }else if (kuaidiCompany.equals("德邦")){
        type = "debangwuliu";
    }else if(kuaidiCompany.equals("宅急送")){
        type = "zhaijisong";
    }
    Log.d("url",baseStr + type + "&postid=" + postidNumber);
    return baseStr + type + "&postid=" + postidNumber;
}
  • 不要吐槽我的英文,想半天也不知道怎么取个合适的方法名。连工程名也写错了意思。/(ㄒoㄒ)/~~

6.测试

天天,顺丰,中通,韵达都测试过,没有问题。

  • 为了有更好的用户体验,在没有数据的时候,给一个Toast提示一下用户。

    用listview的getCount方法,假如是0,说明没有数据。

                        //假如没有数据,提醒用户
                        if(lv.getCount() == 0){
                            Toast.makeText(MainActivity.this,"还没有数据",Toast.LENGTH_LONG).show();
                        }
    

有时候出现这种情况,那么要去了解status为201是什么意思。今天就算了,都凌晨了。

{“message”:”快递公司参数异常:单号不存在或者已经过期”,”nu”:”“,”ischeck”:”0”,”condition”:”“,”com”:”“,”status”:”201”,”state”:”0”,”data”:[]}

其他的查询快递的APP都是直接输快递单号的,为啥这个不行,因为我在网上找不到快递公司单号的规则啊,就是怎么通过快递单号码来知道它是哪家公司的,这个不像身份证一样那么有规律。

7.问题

  • android没有标题栏
  • 清空android ListView控件的内容

8.后期版本

  • 扫二维码(不过,还是多看看接口的文档,快递单号的问题没解决,扫码暂时也没啥用)
  • 输入单号自动识别快递公司
  • 美化控件和界面
  • 标题栏的问题
  • 菜单栏(先解决标题栏的问题)

9.参考资料以及扩展

  • 接口文档

https://www.kuaidi100.com/openapi/api_post.shtml

  • 美化界面

http://blog.sina.com.cn/s/blog_7256fe8f0101ddmd.html

http://blog.csdn.net/badboy007/article/details/19034609

  • 给EditText设置边框

http://www.cnblogs.com/johnsonwei/p/5785055.html

http://www.jb51.net/article/46652.htm

  • EditText自定义样式

http://blog.csdn.net/jdsjlzx/article/details/25063169

  • layout的五大布局

http://www.tuicool.com/articles/3uUZbmu

  • android开发教程之listview使用方法

http://www.jb51.net/article/46652.htm

  • Android采用ListView实现数据列表显示

http://blog.csdn.net/furongkang/article/details/6819247

  • Android适配器之ArrayAdapter、SimpleAdapter和BaseAdapter的简单用法与有用代码片段

http://blog.csdn.net/shakespeare001/article/details/7926783

  • android Json解析详解(详细代码)

http://blog.csdn.net/onlyonecoder/article/details/8490924

  • Android子线程中更新UI的3种方法

http://gqdy365.iteye.com/blog/2112471

  • Android子线程真的不能更新UI么

http://www.cnblogs.com/lao-liang/p/5108745.html

  • ListView之SimpleAdapter的使用

http://blog.csdn.net/abc5382334/article/details/13503475/

  • 免费实用的API接口

https://zhuanlan.zhihu.com/p/21320392?refer=passer

10.结束语

感谢以上文章的作者,给了我做出第一款APP的资源。

时间已经到了00:43,我还是睡不着。

代码写的烂,需要改进的地方很多。

基础不扎实,还得好好搞搞java。

需要做的事很多,再也没有接口说不会了,说很难了。因为你可以做到的。

一个曾经写过程序又没写了,现在又写了的菜鸟程序员实在是有点啰嗦。

程序的源码我整理一下再上传,方便大家参考,我怕自己没写清楚。
地址(设置了1分的鼓励分):http://download.csdn.net/detail/a1b2c300/9724067

你可能感兴趣的:(Android)