FinalHttp的简要介绍与使用

http://blog.csdn.net/zhaokaiqiang1992/article/details/30291259?utm_source=tuicool

在之前的一篇文章中,我们简单的介绍了下FinalBitmap的使用,这一篇文章将继续介绍AFinal开发框架的使用,这一次的主角是FinalHttp。      

FinalHttp,顾名思义,就是一个用于实现客户端与服务器之间网络通信的类,这个类主要通过对Apache的HttpClient开源项目进行封装,实现了http、https协议下的"GET"和"Post"两种请求方式,以及put、delete、download等功能,我们主要介绍使用FinalHttp实现与服务器的      "GET"和"Post"两种交互方式      。      

private static final ThreadFactory  sThreadFactory = new ThreadFactory() {
  private final AtomicInteger mCount = new AtomicInteger(1);
  public Thread newThread(Runnable r) {
    Thread tread = new Thread(r, "FinalHttp #" + mCount.getAndIncrement());
    tread.setPriority(Thread.NORM_PRIORITY - 1);
      return tread;
  }
    };
    
    private static final Executor executor =Executors.newFixedThreadPool(httpThreadCount, sThreadFactory);
首先,FinalHttp采用的是线程池的方式,提供对请求的异步加载,默认的是启动3个固定的线程。而且, 
tread.setPriority(Thread.NORM_PRIORITY - 1);
这句代码将这些线程的优先级设置的比普通线程低,目前不知道是出于何种考虑。 

      另外,在FinalHttp的构造函数中,进行了很多属性的初始化操作,包括添加请求头、设置超时的时间、设置重试次数等,代码较多,还请读者自己去阅读。      

FinalHttp对      "GET"和"Post"进行了非常好的封装,所以使用起来非常简单,下面,我们简要的学习一下FinalHttp的使用。       

        首先,我们可以通过             

FinalHttp    http    =    new         FinalHttp(); 

就可以很方便的获取到一个FinalHttp的对象。 

    如果我们想实现最简单的GET请求,比如我们用GET方式,请求百度的主页,我们可以这样做 

public void get(View view) {
    //这是最简单的get请求,前面是请求地址,不要忘记添加http://
    //后面是一个回调函数,比较常用的方法有下面两个
    http.get("http://www.baidu.com", new AjaxCallBack<String>() {

      //当我们请求失败的时候会被调用,errorNo是请求失败之后,服务器的错误码,StrMsg则是错误信息
      @Override
      public void onFailure(Throwable t, int errorNo, String strMsg) {
        super.onFailure(t, errorNo, strMsg);
        Log.d(TAG, strMsg);
      }

      //如果请求成功,则调用这个回调函数,t就是服务器返回的字符串信息
      @Override
      public void onSuccess(String t) {
        super.onSuccess(t);
        Log.d(TAG, t);
      }

    });
  }
我们可以看到,用FinalHttp实现GET网络请求,我们不需要自己开线程,因为框架已经封装好了,在内部给我们开的线程,实现网络的异步调用。其实不光有get方法,还有一个getSync,这个方法就是没有进行另起线程的请求,所以,如果我们想用getSync这个方法,我们需要自己开启线程,否则在最新版本的主线程中开启网络服务,会抛异常。 

    当然,这只是最简单的get方法的使用,FinalHttp一共提供了get方法的三种重载,代码如下 

//------------------get 请求-----------------------
  public void get( String url, AjaxCallBack<? extends Object> callBack) {
    get( url, null, callBack);
  }

  public void get( String url, AjaxParams params, AjaxCallBack<? extends Object> callBack) {
    sendRequest(httpClient, httpContext, new HttpGet(getUrlWithQueryString(url, params)), null, callBack);
  }
  
  public void get( String url, Header[] headers, AjaxParams params, AjaxCallBack<? extends Object> callBack) {
    HttpUriRequest request = new HttpGet(getUrlWithQueryString(url, params));
    if(headers != null) request.setHeaders(headers);
    sendRequest(httpClient, httpContext, request, null, callBack);
  }
第二种方式增加了AjaxParams参数,这个参数负责设置get请求的请求值,就是get请求时url地址后面的 &key1=values1  &key2=values2这种形式的请求参数的设置,内部其实就是通过Map<String,String>实现的,所以使用也和Map一样。但是这个AjaxParams比较强大,我们可以往里面添加很多东西,比如说文件,流等。  

      第三种方式又增加了一个Header数组,这个数组用于设置请求的头信息,其他与以上两种相同。      

public Object getSync( String url) {
    return getSync( url, null);
  }

  public Object getSync( String url, AjaxParams params) {
     HttpUriRequest request = new HttpGet(getUrlWithQueryString(url, params));
    return sendSyncRequest(httpClient, httpContext, request, null);
  }
  
  
  public Object getSync( String url, Header[] headers, AjaxParams params) {
    HttpUriRequest request = new HttpGet(getUrlWithQueryString(url, params));
    if(headers != null) request.setHeaders(headers);
    return sendSyncRequest(httpClient, httpContext, request, null);
  }

这是getSync的实现,其实和get方法一样,只不过因为需要自己另开线程,所以没有了回调函数这个参数,使用方法相同。 

    下面我们看一下post方法使用。 

//------------------post 请求-----------------------
  public void post(String url, AjaxCallBack<? extends Object> callBack) {
    post(url, null, callBack);
  }

  public void post(String url, AjaxParams params, AjaxCallBack<? extends Object> callBack) {
    post(url, paramsToEntity(params), null, callBack);
  }

  public void post( String url, HttpEntity entity, String contentType, AjaxCallBack<? extends Object> callBack) {
    sendRequest(httpClient, httpContext, addEntityToRequestBase(new HttpPost(url), entity), contentType, callBack);
  }

  public <T> void post( String url, Header[] headers, AjaxParams params, String contentType,AjaxCallBack<T> callBack) {
    HttpEntityEnclosingRequestBase request = new HttpPost(url);
    if(params != null) request.setEntity(paramsToEntity(params));
    if(headers != null) request.setHeaders(headers);
    sendRequest(httpClient, httpContext, request, contentType, callBack);
  }

  public void post( String url, Header[] headers, HttpEntity entity, String contentType,AjaxCallBack<? extends Object> callBack) {
    HttpEntityEnclosingRequestBase request = addEntityToRequestBase(new HttpPost(url), entity);
    if(headers != null) request.setHeaders(headers);
    sendRequest(httpClient, httpContext, request, contentType, callBack);
  }

上面的代码中,我们可以看出,post与get方法的使用几乎相同,只不过增加了几个新的参数而已。 

    下面是调用post方法的一个简单的示例 

public void post(View view) {
    http.post("http://www.baidu.com", new AjaxCallBack<String>() {

      @Override
      public void onFailure(Throwable t, int errorNo, String strMsg) {
        super.onFailure(t, errorNo, strMsg);
        Log.d(TAG, strMsg);
      }

      @Override
      public void onSuccess(String t) {
        super.onSuccess(t);
        Log.d(TAG, t);
      }

    });

我们通过    AjaxParams     可以来添加文件,然后就可以使用post方法,将文件提交到服务器,实现文件的上传。 

AjaxParams params = new AjaxParams();              params.put("username", "michael yang");              params.put("password", "123456");              params.put("email", "[email protected]");              params.put("profile_picture", new File("/mnt/sdcard/pic.jpg")); // 上传文件        params.put("profile_picture2", inputStream); // 上传数据流        params.put("profile_picture3", new ByteArrayInputStream(bytes)); // 提交字节流   

声明:本站内容如果来自互联网及其他传播媒体,其版权均属原媒体及文章作者所有。转载目的在于传递更多信息及用于网络分享,并不代表本站赞同其观点和对其真实性负责,也不构成任何其他建议。

FinalHttp的简要介绍与使用