android query框架介绍

Android-Query (AQuery)是我开发过程中使用的第一个框架。它 是一个轻量级的开发包,用于实现 Android 上的网络请求等的异步操作,操作 UI 元素,异步加载图片和图片 缓存管理 ,可让 Android 应用开发更加简单、容易,更有趣。
git地址: https://github.com/androidquery/androidquery

一、Android-query操作UI元素非常方便

    
    
// 必须实现AQuery这个类,可以是一个view,activity,fragment
AQuery aq = new AQuery(view);
// 按顺序分析:取得xml对应控件id,支持链式操作。设置图片,设置其可见,设置点击事件(someMethod必须是public)  
aq.id(R.id.icon).image(R.drawable.icon).visible().clicked(this, "someMethod");
// 设置文字内容
aq.id(R.id.name).text("hello world");

二、异步加载图片

1 从网上读取图片

   
   
  aq.id(R.id.image1).image(“图片URL”); 

2 缓存控制如果图片过大,则避免记忆缓存

   
   
boolean memCache = false;
boolean fileCache = true;
aq.id(R.id.image1).image("http://www.vikispot.com/z/images/vikispot/android-w.png", memCache, fileCache);

3 当下载太多图片的时候需要降低图片采样率,第四个参数为了保证图片质量,一般范围时200-399
   
   
 aq.id(R.id.image1).image(imageUrl, true, true, 200, 0);
4 如果下载图片失败,处理的方法:1. 设置一个预定的图片  2. 使imageview不可见或者是gone
  
  
    
    
aq.id(R.id.image1).image(imageUrl, true, true, 0, R.drawable.default_image);
aq.id(R.id.image1).image(imageUrl, true, true, 0, AQuery.INVISIBLE);
aq.id(R.id.image1).image(imageUrl, true, true, 0, AQuery.GONE);
5 图片预加载
    
   
   
// 从之前的url取得小图片 
String thumbnail = "http://farm6.static.flickr.com/5035/5802797131_a729dac808_s.jpg";   
Bitmap preset = aq.getCachedImage(thumbnail); 
// 加载大图片前先显示小图片 
String imageUrl = "http://farm6.static.flickr.com/5035/5802797131_a729dac808_b.jpg";             
aq.id(R.id.image).image(imageUrl, false, false, 0, 0, preset, AQuery.FADE_IN);
6 在加载图片的时候显示进度条,progress里面传入id
   
   
String imageUrl = "http://farm6.static.flickr.com/5035/5802797131_a729dac808_b.jpg";             aq.id(R.id.image).progress(R.id.progress).image(imageUrl, false, false);
7 图片圆角显示,不支持大图片
   
   
ImageOptions options = new ImageOptions();
options.round = 15; 
aq.id(R.id.image).image(url, options);
8 图片长宽比例
   
   
// 保留原图片比例 aq.id(R.id.image).image(imageUrl, true, true, 0, 0, null, AQuery.FADE_IN, AQuery.RATIO_PRESERVE); 
// 自定义图片比例 //1:1, a square aq.id(R.id.image2).image(imageUrl, true, true, 0, 0, null, 0, 1.0f / 1.0f);             
aq.id(R.id.image3).image(imageUrl, true, true, 0, 0, null, 0, 1.5f / 1.0f);     
//16:9, a video thumbnail aq.id(R.id.image4).image(imageUrl, true, true, 0, 0, null, 0, 9.0f / 16.0f);     
aq.id(R.id.image5).image(imageUrl, true, true, 0, 0, null, 0, 3.0f / 4.0f);
10 自定义图片加载后的处理
   
   
aq.id(R.id.image1).image(imageUrl, true, true, 0, 0, new BitmapAjaxCallback(){});
11 异步从文件加载图片,建议使用降低采样率避免oom
   
   
File file = new File(path);        
//load image from file, down sample to target width of 300 pixels   
aq.id(R.id.avatar).image(file, 300); 
//load image from file with callback 
aq.id(R.id.avatar).image(file, false, 300, new BitmapAjaxCallback(){    
@Override 
public void callback(String url, ImageView iv, Bitmap bm, AjaxStatus status){ 
    iv.setImageBitmap(bm); 
} });

三、缓存管理

1 缓存配置,缓存一般是保存在内部文件系统,但也可以保存在SDCard里面
    
    
File ext = Environment.getExternalStorageDirectory(); 
File cacheDir = new File(ext, "myapp"); 
AQUtility.setCacheDir(cacheDir);
2 共享图片,为了与其他程序共享图片,你需要把文件放在SDCard,makeSharedFile方法创建缓存地址的一个副本
    
    
File file = aq.makeSharedFile(url, "android.png"); 
if(file != null){ 
 Intent intent = new Intent(Intent.ACTION_SEND);
intent.setType("image/jpeg"); 
intent.putExtra(Intent.EXTRA_STREAM, Uri.fromFile(file)); 
startActivityForResult(Intent.createChooser(intent, "Share via:"), SEND_REQUEST); }
 
  
3 程序退出时候需要把缓存清除
    
   
   
     
     
if(isTaskRoot()){ 
    AQUtility.cleanCacheAsync(this); 
}
或者: if(isTaskRoot()){
//clean the file cache with advance option
        long triggerSize = 3000000; //大于3M时候开始清除
        long targetSize = 2000000;      //直到少于2M
        AQUtility.cleanCacheAsync(this, triggerSize, targetSize);
        }
4 低内存处理
      
      
public class MainApplication extends Application{ 
@Override 
public void onLowMemory(){   
//clear all memory cached images when system is in low memory 
//note that you can configure the max image cache count, see CONFIGURATION BitmapAjaxCallback.clearCache(); } }

三、网络请求


支持数据类型: JSONObject、 JSONArray、 String (HTML, XML)、 XmlDom (XML parsing)、 XmlPullParser (Large XML files)、 byte array

1、以Json数据为例,注意,红色部分是随你请求的数据类型一起改变

     
     
String url = "http://www.google.com/uds/GnewsSearch?q=Obama&v=1.0";
aq.ajax(url, JSONObject.class, new AjaxCallback<JSONObject>() {
    @Override
    public void callback(String url, JSONObject json, AjaxStatus status) {
       if ( json  !=  null ){
         //successful ajax call, show status code and json content
         Toast.makeText(aq.getContext(), status.getCode() + ":" + json.toString(), Toast.LENGTH_LONG).show();
         } else {
          //ajax error, show error code
          Toast.makeText(aq.getContext(), "Error:" + status.getCode(), Toast.LENGTH_LONG).show();
         }
        }
});  
 

上面的形式也可以写成下面一样,他们是无条件对等 

     
     
public void asyncJson(){ 
        //perform a Google search in just a few lines of code
        String url = "http://www.google.com/uds/GnewsSearch?q=Obama&v=1.0";             
        aq.ajax(url, JSONObject.class, this, "jsonCallback");
}
 
public void jsonCallback(String url, JSONObject json, AjaxStatus status){
        
        if(json != null){               
                //successful ajax call          
        }else{          
                //ajax error
        }
}   

2 使用AQuery的XmlDom解析xml的例子,如果XML过大,使用XMLPullParser

     
     
public void xml_ajax(){         
        String url = "https://picasaweb.google.com/data/feed/base/featured?max-results=8";              
        aq.ajax(url, XmlDom.class, this, "picasaCb");           
}
 
public void picasaCb(String url, XmlDom xml, AjaxStatus status){
// 返回一系列为entry的结点,并把其add进list
        List<XmlDom> entries = xml.tags("entry");               
        List<String> titles = new ArrayList<String>();
        
        String imageUrl = null;
        
        for(XmlDom entry: entries){
                titles.add(entry.text("title")); 
            //循环把第一个结点为title的文本放进title
                imageUrl = entry.tag("content", "type", "image/jpeg").attr("src");
//把第一个结点为content,属性为type,属性值为image/jpeg的src属性值赋予给imageUri
        }       
        aq.id(R.id.image).image(imageUrl);
}         

3 如果你想指定保存文件的位置,使用download方法

      
      
String url = "https://picasaweb.google.com/data/feed/base/featured?max-results=16";            
 
File ext = Environment.getExternalStorageDirectory();
File target = new File(ext, "aquery/myfolder/photos.xml");              
 
aq.progress(R.id.progress).download(url, target, new AjaxCallback<File>(){
       
        public void callback(String url, File file, AjaxStatus status) {
               
                if(file != null){
                        showResult("File:" + file.length() + ":" + file, status);
                }else{
                        showResult("Failed", status);
                }
        }
   }); 

4 使用Http Post (Multiple)

     
     
private void aync_multipart(){
 
      String url = "https://graph.facebook.com/me/photos";
       
        Map<String, Object> params = new HashMap<String, Object>();
        params.put("message", "Message");
       
        //Simply put a byte[] to the params, AQuery will detect it and treat it as a multi-part post
        byte[] data = getImageData();
        params.put("source", data);
       
        //Alternatively, put a File or InputStream instead of byte[]
        //File file = getImageFile();          
        //params.put("source", file);
       
        AQuery aq = new AQuery(getApplicationContext());
        aq.auth(handle).ajax(url, params, JSONObject.class, this, "photoCb");
       
}

5 使用ajax是很容易达到缓存的
     
     
        
        
String url = "http://www.google.com";
 
// 返回最近15分钟内的缓存副本,如果expire为-1,内容将会立即更新且缓存
long expire = 15 * 60 * 1000;
 
aq.ajax(url, String.class, expire, new AjaxCallback<String>() {
 
    @Override
    public void callback(String url, String html, AjaxStatus status) {        
        showResult(html);
    }
       
});
6 使缓存无效
        
        
          
          
public void callback(String url, JSONObject json, AjaxStatus status) {
   
        if(json != null){
                if("1".equals(json.optString("status"))){
                        //do something
                }else{
                        // 不缓存
                        status.invalidate();
                }
        }
}

7 同步调用:如果ajax调用是在新开的线程,sync方法能够阻塞线程,直到ajax调用完毕,如果sync方法用在主线程将会引起Exception
       
       
         
         
String url = "http://www.google.com/uds/GnewsSearch?q=Obama&v=1.0";
       
AjaxCallback<JSONObject> cb = new AjaxCallback<JSONObject>();          
cb.url(url).type(JSONObject.class);          
       
aq.sync(cb);
       
JSONObject jo = cb.getResult();
AjaxStatus status = cb.getStatus();

  • 0
    点赞
  • 1
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值