非同步網路:
1. 添加許可權:
2. 支援的類型
JSONObject
JSONArray
String (HTML, XML)
XmlDom (XML parsing)
XmlPullParser (Large XML files)
byte array
User defined custom type (Transformer)
Bitmap
3. 以Json資料為例,注意,紅色部分是隨你請求的資料類型一起改變
String url = "http://www.google.com/uds/GnewsSearch?q=Obama&v=1.0";
aq.ajax(url, JSONObject.class, new AjaxCallback() {
@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 entries = xml.tags("entry");
List titles = new ArrayList();
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. 如果你想指定儲存檔案的位置,使用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(){ public void callback(String url, File file, AjaxStatus status) { if(file != null){ showResult("File:" + file.length() + ":" + file, status); }else{ showResult("Failed", status); } } });
5. 自訂類型(文檔例子是gson資料使用對象解析),詳細見文檔
6. 使用Http Post (Multiple)
privatevoid aync_multipart(){
String url = "https://graph.facebook.com/me/photos"; Map params = new HashMap(); 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"); }
7. 使用ajax是很容易達到緩衝的String url = "http://www.google.com";// 返回最近15分鐘內的快取複本,如果expire為-1,內容將會立即更新且緩衝long expire = 15 * 60 * 1000;aq.ajax(url, String.class, expire, new AjaxCallback() { @Override public void callback(String url, String html, AjaxStatus status) { showResult(html); } });8. 使快取無效判定public void callback(String url, JSONObject json, AjaxStatus status) { if(json != null){ if("1".equals(json.optString("status"))){ //do something }else{ // 不緩衝 status.invalidate(); } }}9. 同步調用:如果ajax調用是在新開的線程,sync方法能夠阻塞線程,直到ajax調用完畢,如果sync方法用在主線程將會引起ExceptionString url = "http://www.google.com/uds/GnewsSearch?q=Obama&v=1.0"; AjaxCallback cb = new AjaxCallback(); cb.url(url).type(JSONObject.class); aq.sync(cb); JSONObject jo = cb.getResult();AjaxStatus status = cb.getStatus();