GalHttprequest——android平台上的一个轻量级的http网络请求及缓存框架

GalHttprequest名字的由来

     开发过iOS项目的朋友都应该知道 ASIHTTPRequest类库， ASIHTTPRequest对iOS SDK的底层API进行了封装，并使用一套简单的API调用接口即可十分方便地调用HTTP请求。由于之前有接触过ios开发，对ASIHTTPRequest印象十分深刻，最近一直在开发android上的应用，发觉android明显缺少这样一个方便请求HTTP数据及对数据进行缓存管理的工具，因此有了实现一个类似ASIHTTPRequest框架的想法。这就是GalHttprequest名字的由来。

GalHttprequest的简介

     GalHttprequest 是基于Httpclient上再进行封装的开源项目了，提供了许多比系统自带的网络相关类库更加方便强大的接口API。目前它已支持以下功能：

• 同步请求Stirng、InputStream、Bitmap；
• 异步请求String、InputStream、Bitmap；支持回调接口；
• 支持异步下载文件，提供监听进度回调接口；
• 支持缓存参数设置；
• 支持多线程及队列请求；
• 自动适配移动、联通、电信wap代理;
• 支持快捷post请求;
• 附带一个强大的日志管理工具类LogUtil
• 自动组装url参数
• 提供简单post数据到服务器的API

GalHttprequest使用的小例子

     

          以下是代码中有可能要用到的链接

       static final String PATH_INPUTSTREAM = "http://qiuming.sinaapp.com/?feed=comments-rss2" ;

       static final String PATH_STRING = "http://qiuming.sinaapp.com/?feed=comments-rss2" ;

       static final String PATH_BITMAP = "http://tp3.sinaimg.cn/1859125850/180/5628821209/1" ;

       static final String PATH_WITHPARAMS = "http://qiuming.sinaapp.com/" ;

       static final String PATH_POSTCONTENT = "http://qiuming.sinaapp.com/?feed=comments-rss2" ;

     

• 同步请求InputStream

                   request = GalHttpRequest .requestWithURL ( this, PATH_INPUTSTREAM );

                   // 如果不检测缓存，则设置：
                   // request.setCacheEnable(false);
                   // 必须在调用startXXX()函数之前设置

                   // 返回的缓存已经是ufferedInputStream类型
                   InputStream is = request .startSynchronous ();
                  textView .setVisibility (View .VISIBLE );
                   if ( is!= null ) {
                        textView .setText (is .toString ());
                  }

• 同步请求String

                   request = GalHttpRequest .requestWithURL ( this, PATH_STRING );
                   // 根据服务器返回的状态读取内容，如果服务器内容没有改变，则直接读取缓存内容，如果服务器内容已经修改，则从服务器拉取数据
                   // 并刷新缓存内容
                   String string = request. startSyncRequestString ();

• 同步请求Bitmap

                  title .setText ("同步请求Bitmap" );
                   Header header = new BasicHeader ("Accept-Language" , "zh-cn,zh;q=0.5" );
                   // 支持添加自定义的 Http Header请求
                   request = GalHttpRequest .requestWithURL ( this, PATH_BITMAP ,
                               new Header[] { header }) ;
                   // 请求Bitmap，由于图片基本上不改变，因此如果存在缓存，则直接从缓存读取
                   Bitmap bitmap = request. startSyncRequestBitmap ();
                  imageView .setImageBitmap (bitmap );

• 异步请求InputStream

                  title .setText ("异步请求InputStream" );
                   request = GalHttpRequest .requestWithURL ( this, PATH_INPUTSTREAM );
                   // 必须先设置回调函数，否则调用异步请求无效
                   request. setListener (new GalHttpRequestListener () {
                         @Override
                         public void loadFinished ( final InputStream is, boolean fromcache ) {
                               //注意，由于返回的是InputStream，一般情况都需要长时间操作，所以，回调函数是在子线程调用
                               //因此使用handler
                              handler .post ( new Runnable() {
                                     @Override
                                     public void run () {
                                          textView .setText (is .toString ());
                                          textView .setVisibility (View .VISIBLE );
                                    }
                              }) ;
                        }
                         @Override
                         // 请求失败时，有可能可以从缓存里面读取数据返回
                         public void loadFailed ( final HttpResponse respone ,
                                     InputStream cacheInputStream ) {
                              handler .post ( new Runnable() {
                                    
                                     @Override
                                     public void run () {
                                          textView .setText (respone .toString ());
                                          textView .setVisibility (View .VISIBLE );
                                    }
                              }) ;
                        }
                  }) ;
                   request. startAsynchronous ();

• 异步请求String

                   request = GalHttpRequest .requestWithURL ( this, PATH_STRING );
                   //第一次调用startAsynRequestString或者startAsynRequestBitmap必须在主线程调用
                   //因为只有在主线程中调用才可以初始化GalHttprequest内部的全局句柄Handler
                   request. startAsynRequestString (new GalHttpLoadTextCallBack () {
                         @Override
                         public void textLoaded (String text ) {
                               //该部分允许于UI线程
                              textView .setText (text );
                              textView .setVisibility (View .VISIBLE );
                        }
                  }) ;

• 异步请求Bitmap

                   request = GalHttpRequest .requestWithURL ( this, PATH_BITMAP );
                   request. startAsynRequestBitmap (new GalHttpLoadImageCallBack () {
                         @Override
                         public void imageLoaded (Bitmap bitmap ) {
                              imageView .setImageBitmap (bitmap );
                              imageView .setVisibility (View .VISIBLE );
                        }
                  }) ;

• 异步组装参数

                  title .setText ("组装http参数" );
                   //交给GalHttprequest自动组装 url中的参数
                   NameValuePair feedPair = new BasicNameValuePair ("feed" ,"comments-rss2" );
                   request = GalHttpRequest .requestWithURL ( this, PATH_WITHPARAMS ,feedPair );
                   request. startAsynRequestString (new GalHttpLoadTextCallBack () {
                         @Override
                         public void textLoaded (String text ) {
                               //该部分允许于UI线程
                              textView .setText (text );
                              textView .setVisibility (View .VISIBLE );
                        }
                  }) ;

• 异步post 数据给服务器

                   //交给GalHttprequest自动组装 url中的参数
                   request = GalHttpRequest .requestWithURL ( this, PATH_POSTCONTENT );
                   //设置post内容
                   request. setPostValueForKey ("name" , "qiuscut" );
                   request. startAsynRequestString (new GalHttpLoadTextCallBack () {
                         @Override
                         public void textLoaded (String text ) {
                               //该部分允许于UI线程
                              textView .setText ("在这里post应该是无效的，因为当前url不支持post" );
                              textView .setVisibility (View .VISIBLE );
                        }
                  }) ;

想获取关于GalHttprequest的信息可以访问官方网站:

http://code.google.com/p/galhttprequest/

想及时了解GalHttprequest的最新消息可以关注作者的微博：

http://weibo.com/201200360

欢迎转发，请保留文章出处http://www.cnblogs.com/qiuscut/articles/2467400.html