Android_androidquery第三方库_Android-Query使用详解

最新推荐文章于 2021-05-25 17:21:21 发布

Ricky彪

最新推荐文章于 2021-05-25 17:21:21 发布

阅读量5.5k

点赞数

分类专栏：第三方依赖库和开源项目 Android 文章标签： androidquery 数据解析网络请求

本文链接：https://blog.csdn.net/u013035016/article/details/52768454

版权

Android 同时被 2 个专栏收录

51 篇文章 1 订阅

订阅专栏

第三方依赖库和开源项目

4 篇文章 0 订阅

订阅专栏

Android之使用Android-query框架进行开发

开发Android使用Android-query框架能够快速的，比传统开发android所要编写的代码要少得很多，容易阅读等优势。

下载文档及其例子和包的地址：http://code.google.com/p/android-query/

使用之前导入androidquery.jar包

1、基本使用：

<span style="white-space:pre">	</span>
<span style="white-space:pre">	</span><span style="color:#ff0000;">// 必须实现AQuery这个类</span>
	AQuery aq = new AQuery(view);
	<span style="color:#ff0000;">// 按顺序分析：取得xml对应控件id,设置图片,设置可以显示,点击事件（方法someMethod必须是public修饰）</span>    

	aq.id(R.id.icon).image(R.drawable.icon).visible().clicked(this, "someMethod");  
	<span style="color:#ff0000;">// 设置文字内容</span>
        aq.id(R.id.name).text(content.getPname());
        aq.id(R.id.time).text(FormatUtility.relativeTime(System.currentTimeMillis(), content.getCreate())).visible();

	aq.id(R.id.desc).text(content.getDesc()).visible();

2、AQuery也支持Fragment

    @Override
    public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) {
        
        View view = inflater.inflate(getContainerView(), container, false);             
                
        aq = new AQuery(getActivity(), view);
        return view;
    }

3、使用AQuery异步加载图片

3.1 从网上读取图片

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

3.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.3 当下载太多图片的时候需要降低图片采样率，第四个参数为了保证图片质量，一般范围时200-399
   aq.id(R.id.image1).image(imageUrl, true, true, 200, 0);

3.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);

3.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);

3.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);

3.7 图片圆角显示,不支持大图片
     ImageOptions options = new ImageOptions();
     options.round = 15;
     aq.id(R.id.image).image(url, options);

3.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);

3.9 图片描点，如果图片过高,描点可用来描述图片的哪一部分用于显示
    Anchor values:
·	1.0 : Display top of the image
	0 : Display the center of the image
	-1.0 : Display bottom of the image
	AQuery.ANCHOR_DYNAMIC : Display image with a top bias for photos.
=======================================================
	ImageOptions options = new ImageOptions();
	options.ratio = 1;
	options.anchor = 1.0;
	aq.id(R.id.image1).image(imageUrl, options);

3.10 自定义图片加载后的处理
    aq.id(R.id.image1).image(imageUrl, true, true, 0, 0, new BitmapAjaxCallback(){}）;

3.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);
	}
});

3.12 如果之前image("url")已经成功,之后的都可以直接使用而不需要重新访问网络,也就是说之后可以离线访问此图像资源

3.13 文件中获取缓冲图片
     File file = aq.getCachedFile(url);

3.14 除了imageview,webview也可以用来放图片
     aq.id(R.id.web).progress(R.id.progress).webImage(url);

3.15 延迟图片加载,帮助你是否加载正在快速滚动的listview,详情参考文档使用

3.16 图片不使用缓存
     aq.id(R.id.image).image(url, false, false);

3.17 缓存配置,缓存一般是保存在内部文件系统,但也可以保存在SDCard里面
      File ext = Environment.getExternalStorageDirectory();
      File cacheDir = new File(ext, "myapp"); 
      AQUtility.setCacheDir(cacheDir);

3.18 共享图片,为了与其他程序共享图片,你需要把文件放在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.19 配置,最好把配置写在application的onCreate方法,详细参考文档

3.20 程序退出时候需要把缓存清除
      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);
        }
       
       3.21 低内存处理
      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();
	}
}

4、异步网络

4.1. 添加权限：<uses-permission android:name="android.permission.INTERNET" />

4.2. 支持的类型

JSONObject
JSONArray
String (HTML, XML)
XmlDom (XML parsing)
XmlPullParser (Large XML files)
byte array
User defined custom type (Transformer)

Bitmap

4.3. 以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 
     
         } 
     
     }

再举一个使用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); 
     
     }

4.4. 如果你想指定保存文件的位置，使用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.5. 自定义类型（文档例子是gson数据使用对象解析），详细见文档

4.6. 使用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");
        
}

4.7. 使用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);
    }
        
});
      
      4.8. 使缓存无效
      
      
       
       public void callback(String url, JSONObject json, AjaxStatus status) {
    
        if(json != null){
                if("1".equals(json.optString("status"))){
                        //do something
                }else{
                        // 不缓存
                        status.invalidate();
                }
        }
}
      
      
      
      4.9. 同步调用：
      
      如果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();