HttpLibrary

HttpLibrary_cn

#KJHttp简介

KJHttp是专为解决Android中Http通信而产生的，它在请求和响应层面做到了全自动构建和解析，主要用于Android快速开发。

整个KJHttp工作流程：采用责任链设计模式，由三部分组成，类似设计可以类比Handle...Looper...MessageQueue
1、KJHttp负责不停向NetworkQueue(或CacheQueue实际还是NetworkQueue，具体逻辑请查看 {@link CacheDispatcher})添加Request
2、另一边由TaskThread不停从NetworkQueue中取Request并交给Network执行器(逻辑请查看 {@link NetworkDispatcher} )，
3、Network执行器将执行成功的NetworkResponse返回给TaskThead，并通过Request的定制方法 {@link Request#parseNetworkResponse()}封装成Response，最终交给分发器 {@link Delivery} 分发到主线程并调用HttpCallback相应的方法

##更加方便 KJHttp自带了数据缓存功能，你所访问的Http数据都将在本地建立一个缓存，默认的缓存时间是5分钟，也就是5分钟以内相同的请求都不会经过网络，而是从本地缓存中直接读取。当然对于及时性要求较高的新闻类应用，你也可以关闭这个特性或者只需要将缓存时间设置成0就行了~

##使用方法

// get或post以JSON传参的方式请求数据示例

	/**
    * 使用JSON提交参数而不是Form表单
    */
   private void jsonRequest() {
       KJHttp kjh = new KJHttp();
       HttpParams params = new HttpParams();
       params.putHeaders("Cookie", "cookie不能告诉你");
       //这里传递json字符串，(JSONObject可以调用toString方法转换)
       params.putJsonParams("{\"uid\":863548,\"stickys\":[{\"id\":29058,\"iid\":0,\"content\":\"你好\",\"color\":\"green\",\"createtime\":\"2015-04-16 16:26:17\",\"updatetime\":\"2015-04-16 16:26:17\"}]}");
       kjh.jsonPost(
               "http://www.oschina.net/action/api/team_stickynote_batch_update",
               params, new HttpCallBack() {
                   @Override
                   public void onSuccess(String t) {
                       super.onSuccess(t);
                       toast(t);
                   }
               });
   }

// get或post以AJAX方式请求JSON数据示例

		//类似于post，就只做一个介绍了
		kjh.get("http://www.kymjs.com/", new HttpCallBack();
		
		// post
        KJHttp kjh = new KJHttp();
        HttpParams params = new HttpParams(); 
        params.put("id", "1"); //传递参数
        params.put("name", "kymjs");
        //HttpCallback中有很多方法，可以根据需求选择实现
        kjh.post("http://192.168.1.149/post_api", params, new HttpCallBack() {
            @Override
            public void onPreStart() {
                super.onPreStart();
                KJLoger.debug("在请求开始之前调用");
            }
            @Override
            public void onSuccess(String t) {
                super.onSuccess(t);
                ViewInject.longToast("请求成功");
                KJLoger.debug("log:" + t.toString());
            }
            @Override
            public void onFailure(Throwable t, int errorNo, String strMsg) {
                super.onFailure(t, errorNo, strMsg);
                KJLoger.debug("exception:" + strMsg);
            }
            @Override
            public void onFinish() {
                super.onFinish();
                KJLoger.debug("请求完成，不管成功或者失败都会调用");
            }

            // ......
            //还有更多，就不一一介绍了，大家可以参考API文档
            // ......
        });

post上传文件

	// 服务器端写法
	<?php
		if ($_FILES["file"]["error"] > 0)
		{
			echo "Return Code: " . $_FILES["file"]["error"] . "<br />";
		}
		else
		{
			echo "Upload: " . $_FILES["file"]["name"] . "<br />";
			echo "Type: " . $_FILES["file"]["type"] . "<br />";
			echo "Size: " . ($_FILES["file"]["size"] / 1024) . " Kb<br />";
			echo "Temp file: " . $_FILES["file"]["tmp_name"] . "<br />";

			if (file_exists("upload/" . $_FILES["file"]["name"]))
			{
				echo $_FILES["file"]["name"] . " already exists. ";
			}
			else
			{
				move_uploaded_file($_FILES["file"]["tmp_name"], "upload/" . $_FILES["file"]["name"]);
				echo "Stored in: " . "upload/" . $_FILES["file"]["name"];
			}
		}
	?>

	//文件上传支持多文件上传，支持传file对象，byte[]两种
	private void upload() {
        HttpParams params = new HttpParams();
        //support more file
        params.put("file", FileUtils.getSaveFile("KJLibrary", "logo.jpg"));
		params.put("file1", new File("/path/xxx/xxx")); // support
		params.put("file2", new FileInputStream(file)); // support
        kjh.post("http://192.168.1.149/kymjs/hello.php", params,
                new HttpCallBack() {
                    @Override
                    public void onSuccess(String t) {
                        super.onSuccess(t);
                        ViewInject.toast("success");
                    }

                    @Override
                    public void onFailure(Throwable t, int errorNo,
                            String strMsg) {
                        super.onFailure(t, errorNo, strMsg);
                        ViewInject.toast("error" + strMsg);
                    }
					/** 还有更多实现... **/
                });
    }

文件下载示例

		kjh.download(mEtDownloadPath.getText().toString(), FileUtils.getSaveFile("KJLibrary", "l.pdf"),new HttpCallBack() {
            @Override
            public void onSuccess(File f) {
                super.onSuccess(f);
                KJLoger.debug("success");
                ViewInject.toast("toast");
                mProgress.setProgress(mProgress.getMax());
            }

            @Override
            public void onFailure(Throwable t, int errorNo,String strMsg) {
                super.onFailure(t, errorNo, strMsg);
                KJLoger.debug("onFailure");
            }

            /* onLoading 方法就只在文件下载时才会被回调 */
            @Override
            public void onLoading(long count, long current) {
                super.onLoading(count, current);
                mProgress.setMax((int) count);
                mProgress.setProgress((int) current);
                KJLoger.debug(count + "------" + current);
            }
        });

##高级设置

以上是基础用法，同样也支持自定义设置，你可以自定义数据缓存的方式，请求的优先级，请求数据的有效时间。同时支持根据你的需求所发起的自定义Request。
更多的使用，可以参考实际项目中的使用爱看博客客户端