Android工具包xUtils 3.0 發布 api重構 數據庫操作性能大幅提升
3.0是一次徹底的重構, api發生了很大變化, 但是仍然保持著xUtils一貫的簡介風格, 并且新的api更加簡單, 更具擴展性.
新的特性:
-
HTTP實現替換HttpClient為UrlConnection, 更好的兼容Android 6.0, 自動解析回調泛型, 更安全的斷點續傳策略.
-
支持標準的Cookie策略, 區分domain, path...
-
事件注解去除不常用的功能, 提高性能.
-
數據庫api簡化提高性能, 達到和greenDao一致的性能.
-
圖片綁定支持gif, webp; 支持圓角, 圓形, 方形等裁剪, 支持自動旋轉...
xUtils3簡介
- xUtils 包含了很多實用的android工具。
- xUtils 支持大文件上傳,更全面的http請求協議支持(11種謂詞),擁有更加靈活的ORM,更多的事件注解支持且不受混淆影響...
- xUitls 最低兼容android 4.0 (api level 14), (源碼最低兼容至2.3.3, 可以自己修改最低兼容設置).
- xUtils3變化較多所以建立了新的項目不在舊版(github.com/wyouflf/xUtils)上繼續維護, 相對于舊版本:
- HTTP實現替換HttpClient為UrlConnection, 自動解析回調泛型, 更安全的斷點續傳策略.
- 支持標準的Cookie策略, 區分domain, path...
- 事件和數據庫注解去除不常用的功能, 提高性能.
- 圖片綁定支持gif, webp; 支持圓角, 圓形, 方形等裁剪, 支持自動旋轉...
使用前配置
需要的權限
<uses-permission android:name="android.permission.INTERNET" />
<uses-permission android:name="android.permission.WRITE_EXTERNAL_STORAGE" />
初始化
// 在application的onCreate中初始化 @Override public void onCreate() { super.onCreate(); x.Ext.init(this); ... }
使用@Event事件注解(@ContentView, @ViewInject等更多示例參考sample項目)
/** * 1. 方法必須私有限定, * 2. 方法以Click或Event結尾, 方便配置混淆編譯參數 : * -keepattributes *Annotation* * -keepclassmembers class * { * void *(android.view.View); * *** *Click(...); * *** *Event(...); * } * 3. 方法參數形式必須和type對應的Listener接口一致. * 4. 其他見{@link org.xutils.event.annotation.Event}類的說明. **/ @Event(value = R.id.btn_test_baidu1,
type = View.OnClickListener.class/*可選參數, 默認是View.OnClickListener.class*/) private void onTestBaidu1Click(View view) { ... }
訪問網絡(更多示例參考sample項目)
BaiduParams params = new BaiduParams();
params.wd = "xUtils"; // 有上傳文件時使用multipart表單, 否則上傳原始文件流. // params.setMultipart(true); // 上傳文件方式 1 // params.uploadFile = new File("/sdcard/test.txt"); // 上傳文件方式 2 // params.addBodyParameter("uploadFile", new File("/sdcard/test.txt")); Callback.Cancelable cancelable = x.http().get(params, /** * 1. callback的泛型: * callback參數默認支持的泛型類型參見{@link org.xutils.http.loader.LoaderFactory}, * 例如指定泛型為File則可實現文件下載. 默認支持斷點續傳(采用了文件鎖和尾端校驗續傳文件的一致性). * 其他常用類型可以自己在LoaderFactory中注冊, * 也可以使用{@link org.xutils.http.annotation.HttpResponse} * 將注解HttpResponse加到自定義返回值類型上, 實現自定義ResponseParser接口來統一轉換. * 如果返回值是json形式, 那么利用第三方的json工具將十分容易定義自己的ResponseParser. * 如示例代碼{@link org.xutils.sample.http.BaiduResponse}, 可直接使用BaiduResponse作為 * callback的泛型. * * 2. callback的組合: * 可以用基類或接口組合個種類的Callback, 見{@link org.xutils.common.Callback}. * 例如: * a. 組合使用CacheCallback將使請求檢測緩存或將結果存入緩存(僅GET請求生效). * b. 組合使用PrepareCallback的prepare方法將為callback提供一次后臺執行耗時任務的機會, * 然后將結果給onCache或onSuccess. * c. 組合使用ProgressCallback將提供進度回調. * ...(可參考{@link org.xutils.image.ImageLoader}) * **/ new Callback.CommonCallback<String>() { @Override public void onSuccess(String result) { Toast.makeText(x.app(), result, Toast.LENGTH_LONG).show();
} @Override public void onError(Throwable ex, boolean isOnCallback) { Toast.makeText(x.app(), ex.getMessage(), Toast.LENGTH_LONG).show();
} @Override public void onCancelled(CancelledException cex) { Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();
} @Override public void onFinished() {
}
}); // cancelable.cancel(); // 取消 // 如果需要記錄請求的日志, 可使用RequestTracker接口(優先級依次降低, 找到一個實現后會忽略后面的): // 1. 自定義Callback同時實現RequestTracker接口; // 2. 自定義ResponseParser同時實現RequestTracker接口; // 3. 在LoaderFactory注冊.
如果你只需要一個簡單的版本:
@Event(value = R.id.btn_test_baidu2) private void onTestBaidu2Click(View view) { RequestParams params = new RequestParams("https://www.baidu.com/s");
params.addQueryStringParameter("wd", "xUtils");
x.http().get(params, new Callback.CommonCallback<String>() { @Override public void onSuccess(String result) { Toast.makeText(x.app(), result, Toast.LENGTH_LONG).show();
} @Override public void onError(Throwable ex, boolean isOnCallback) { Toast.makeText(x.app(), ex.getMessage(), Toast.LENGTH_LONG).show();
} @Override public void onCancelled(CancelledException cex) { Toast.makeText(x.app(), "cancelled", Toast.LENGTH_LONG).show();
} @Override public void onFinished() {
}
});
}
使用數據庫(更多示例參考sample項目)
Parent test = db.selector(Parent.class).where("id", "in", new int[]{1, 3, 6}).findFirst(); long count = db.selector(Parent.class).where("name", "LIKE", "w%").and("age", ">", 32).count(); List<Parent> testList = db.selector(Parent.class).where("id", "between", new String[]{"1", "5"}).findAll();
綁定圖片(更多示例參考sample項目)
x.image().bind(imageView, url, imageOptions);
x.image().bind(imageView, "file:///sdcard/test.gif", imageOptions);
x.image().bind(imageView, "assets://test.gif", imageOptions);
x.image().bind(imageView, url, imageOptions, new Callback.CommonCallback<Drawable>() {...});
x.image().loadDrawable(url, imageOptions, new Callback.CommonCallback<Drawable>() {...});
x.image().loadFile(url, imageOptions, new Callback.CommonCallback<File>() {...});
關于libwebpbackport
- 部分4.x的機型對webp格式的支持仍然有問題, 需要借助webp.
- webp來自:https://github.com/webmproject/libwebp
- webpbackport來自:https://github.com/alexey-pelykh/webp-android-backport
- 其中為webpbackport添加了nativeDecodeFile的實現, 并修復在Android 5.0以上系統存在bug:
// android_backport_webp.cpp // 修改: jclassRef = jniEnv->FindClass(...); // 為: jclass temp = jniEnv->FindClass(...);
jclassRef = (jclass)jniEnv->NewGlobalRef(temp);
jniEnv->DeleteLocalRef(temp);
關于作者
- Email: wyouflf@qq.com, wyouflf@gmail.com
- 有任何建議或者使用中遇到問題都可以給我發郵件, 你也可以加入QQ群:330445659(已滿), 275967695, 257323060, 384426013, 176778777, 169852490, 技術交流,idea分享 _
本文由用戶 jopen 自行上傳分享,僅供網友學習交流。所有權歸原作者,若您的權利被侵害,請聯系管理員。
轉載本站原創文章,請注明出處,并保留原始鏈接、圖片水印。
本站是一個以用戶分享為主的開源技術平臺,歡迎各類分享!