Android經常使用工具類 (轉載)

 

原文地址：http://www.trinea.cn/android/android-common-utils/

主要介紹總結的Android開發中經常使用的工具類，大部分一樣適用於Java。
目前包括HttpUtils、DownloadManagerPro、ShellUtils、PackageUtils、PreferencesUtils、JSONUtils、FileUtils、ResourceUtils、StringUtils、ParcelUtils、RandomUtils、ArrayUtils、ImageUtils、ListUtils、MapUtils、ObjectUtils、SerializeUtils、SystemUtils、TimeUtils。

The English version of this article see：Android Common Utils

 

全部代碼都在TrineaAndroidCommon@Github中，歡迎Star或Fork^_*，除這些工具類外此項目還包括緩存、下拉ListView等。詳細接口介紹可見TrineaAndroidCommon API Guide。

具體使用：可直接引入TrineaAndroidCommon做爲你項目的library(如何拉取代碼及添加公共庫)，或是本身抽取其中的部分使用。

 

一、HttpUtils
Http網絡工具類，主要包括httpGet、httpPost以及http參數相關方法，以httpGet爲例：
static HttpResponse httpGet(HttpRequest request)
static HttpResponse httpGet(java.lang.String httpUrl)
static String httpGetString(String httpUrl)
包含以上三個方法，默認使用gzip壓縮，使用bufferedReader提升讀取速度。
HttpRequest中能夠設置url、timeout、userAgent等其餘http參數
HttpResponse中能夠獲取返回內容、http響應碼、http過時時間(Cache-Control的max-age和expires)等
前兩個方法能夠進行高級參數設置及豐富內容返回，第三個方法能夠簡單的傳入url獲取返回內容，httpPost相似。更詳細的設置能夠直接使用HttpURLConnection或apache的HttpClient。
源碼可見HttpUtils.java，更多方法及更詳細參數介紹可見HttpUtils Api Guide。

 

二、DownloadManagerPro
Android系統下載管理DownloadManager加強方法，可用於包括獲取下載相關信息，如：
getStatusById(long) 獲得下載狀態
getDownloadBytes(long) 獲得下載進度信息
getBytesAndStatus(long) 獲得下載進度信息和狀態
getFileName(long) 獲得下載文件路徑
getUri(long) 獲得下載uri
getReason(long) 獲得下載失敗或暫停緣由
getPausedReason(long) 獲得下載暫停緣由
getErrorCode(long) 獲得下載錯誤碼
源碼可見DownloadManagerPro.java，更多方法及更詳細參數介紹可見DownloadManagerPro Api Guide。關於Android DownManager使用可見DownManager Demo。

 

三、ShellUtils
Android Shell工具類，可用於檢查系統root權限，並在shell或root用戶下執行shell命令。如：
checkRootPermission() 檢查root權限
execCommand(String[] commands, boolean isRoot, boolean isNeedResultMsg) shell環境執行命令，第二個參數表示是否root權限執行
execCommand(String command, boolean isRoot) shell環境執行命令
源碼可見ShellUtils.java，更多方法及更詳細參數介紹可見ShellUtils Api Guide。關於靜默安裝可見apk-root權限靜默安裝。

 

四、PackageUtils
Android包相關工具類，可用於(root)安裝應用、(root)卸載應用、判斷是否系統應用等，如：
install(Context, String) 安裝應用，若是是系統應用或已經root，則靜默安裝，不然通常安裝
uninstall(Context, String) 卸載應用，若是是系統應用或已經root，則靜默卸載，不然通常卸載
isSystemApplication(Context, String) 判斷應用是否爲系統應用
源碼可見PackageUtils.java，更多方法及更詳細參數介紹可見ShellUtils Api Guide。關於靜默安裝可見apk-root權限靜默安裝。

 

五、PreferencesUtils
Android SharedPreferences相關工具類，可用於方便的向SharedPreferences中讀取和寫入相關類型數據，如：
putString(Context, String, String) 保存string類型數據
putInt(Context, String, int) 保存int類型數據
getString(Context, String) 獲取string類型數據
getInt(Context, String) 獲取int類型數據
可經過修改PREFERENCE_NAME變量修改preference name
源碼可見PreferencesUtils.java，更多方法及更詳細參數介紹可見PreferencesUtils Api Guide。

 

六、JSONUtils
JSONUtils工具類，可用於方便的向Json中讀取和寫入相關類型數據，如：
String getString(JSONObject jsonObject, String key, String defaultValue) 獲得string類型value
String getString(String jsonData, String key, String defaultValue) 獲得string類型value
表示從json中讀取某個String類型key的值

 

getMap(JSONObject jsonObject, String key) 獲得map
getMap(String jsonData, String key) 獲得map
表示從json中讀取某個Map類型key的值
源碼可見JSONUtils.java，更多方法及更詳細參數介紹可見JSONUtils Api Guide。

 

七、FileUtils
文件工具類，可用於讀寫文件及對文件進行操做。如：
readFile(String filePath) 讀文件
writeFile(String filePath, String content, boolean append) 寫文件
getFileSize(String path) 獲得文件大小
deleteFile(String path) 刪除文件
源碼可見FileUtils.java，更多方法及更詳細參數介紹可見FileUtils Api Guide。

 

八、ResourceUtils
Android Resource工具類，可用於從android資源目錄的raw和assets目錄讀取內容，如：
geFileFromAssets(Context context, String fileName) 獲得assets目錄下某個文件內容
geFileFromRaw(Context context, int resId) 獲得raw目錄下某個文件內容
源碼可見ResourceUtils.java，更多方法及更詳細參數介紹可見ResourceUtils Api Guide。

 

九、StringUtils
String工具類，可用於常見字符串操做，如：
isEmpty(String str) 判斷字符串是否爲空或長度爲0
isBlank(String str) 判斷字符串是否爲空或長度爲0 或由空格組成
utf8Encode(String str) 以utf-8格式編碼
capitalizeFirstLetter(String str) 首字母大寫
源碼可見StringUtils.java，更多方法及更詳細參數介紹可見StringUtils Api Guide。

 

十、ParcelUtils
Android Parcel工具類，可用於從parcel讀取或寫入特殊類型數據，如：
readBoolean(Parcel in) 從pacel中讀取boolean類型數據
readHashMap(Parcel in, ClassLoader loader) 從pacel中讀取map類型數據
writeBoolean(boolean b, Parcel out) 向parcel中寫入boolean類型數據
writeHashMap(Map<K, V> map, Parcel out, int flags) 向parcel中寫入map類型數據
源碼可見ParcelUtils.java，更多方法及更詳細參數介紹可見ParcelUtils Api Guide。

 

十一、RandomUtils
隨機數工具類，可用於獲取固定大小固定字符內的隨機數，如：
getRandom(char[] sourceChar, int length) 生成隨機字符串，全部字符均在某個字符串內
getRandomNumbers(int length) 生成隨機數字
源碼可見RandomUtils.java，更多方法及更詳細參數介紹可見RandomUtils Api Guide。

 

十二、ArrayUtils
數組工具類，可用於數組經常使用操做，如：
isEmpty(V[] sourceArray) 判斷數組是否爲空或長度爲0
getLast(V[] sourceArray, V value, V defaultValue, boolean isCircle) 獲得數組中某個元素前一個元素，isCircle表示是否循環
getNext(V[] sourceArray, V value, V defaultValue, boolean isCircle) 獲得數組中某個元素下一個元素，isCircle表示是否循環
源碼可見ArrayUtils.java，更多方法及更詳細參數介紹可見ArrayUtils Api Guide。

 

1三、ImageUtils
圖片工具類，可用於Bitmap, byte array, Drawable之間進行轉換以及圖片縮放，目前功能薄弱，後面會進行加強。如：
bitmapToDrawable(Bitmap b) bimap轉換爲drawable
drawableToBitmap(Drawable d) drawable轉換爲bitmap
drawableToByte(Drawable d) drawable轉換爲byte
scaleImage(Bitmap org, float scaleWidth, float scaleHeight) 縮放圖片
源碼可見ImageUtils.java，更多方法及更詳細參數介紹可見ImageUtils Api Guide。

 

1四、ListUtils
List工具類，可用於List經常使用操做，如：
isEmpty(List<V> sourceList) 判斷List是否爲空或長度爲0
join(List<String> list, String separator) List轉換爲字符串，並以固定分隔符分割
addDistinctEntry(List<V> sourceList, V entry) 向list中添加不重複元素
源碼可見ListUtils.java，更多方法及更詳細參數介紹可見ListUtils Api Guide。

 

1五、MapUtils
Map工具類，可用於Map經常使用操做，如：
isEmpty(Map<K, V> sourceMap) 判斷map是否爲空或長度爲0
parseKeyAndValueToMap(String source, String keyAndValueSeparator, String keyAndValuePairSeparator, boolean ignoreSpace) 字符串解析爲map
toJson(Map<String, String> map) map轉換爲json格式
源碼可見MapUtils.java，更多方法及更詳細參數介紹可見MapUtils Api Guide。

 

1六、ObjectUtils
Object工具類，可用於Object經常使用操做，如：
isEquals(Object actual, Object expected) 比較兩個對象是否相等
compare(V v1, V v2) 比較兩個對象大小
transformIntArray(int[] source)  Integer 數組轉換爲int數組
源碼可見ObjectUtils.java，更多方法及更詳細參數介紹可見ObjectUtils Api Guide。

 

1七、SerializeUtils
序列化工具類，可用於序列化對象到文件或從文件反序列化對象，如：
deserialization(String filePath) 從文件反序列化對象
serialization(String filePath, Object obj) 序列化對象到文件
源碼可見SerializeUtils.java，更多方法及更詳細參數介紹可見SerializeUtils Api Guide。

 

1八、SystemUtils
系統信息工具類，可用於獲得線程池合適的大小，目前功能薄弱，後面會進行加強。如：
getDefaultThreadPoolSize() 獲得跟系統配置相符的線程池大小
源碼可見SystemUtils.java，更多方法及更詳細參數介紹可見SystemUtils Api Guide。

 

1九、TimeUtils
時間工具類，可用於時間相關操做，如：
getCurrentTimeInLong() 獲得當前時間
getTime(long timeInMillis, SimpleDateFormat dateFormat) 將long轉換爲固定格式時間字符串
源碼可見TimeUtils.java，更多方法及更詳細參數介紹可見TimeUtils Api Guide。