Android常用工具類的封裝

tonjies發表於2018-04-27
Android封裝

Android常用工具類的封裝

Log封裝類
為什麼要封裝Log，這是因為我們每次輸入Log的時候，每次都要輸入TAG，例如這樣：

Log.d("tonjie","要輸出的內容");

1
即便我們可以在一個類中宣告常量TAG，private static final String TAG = “tonjies”；也仍然需要輸入常量，而且很多時候我都是除錯完程式，在程式沒有問題的情況下就把Log刪除的，所以練習時的簡便就是我需要的，那麼廢話不多說，直接看程式碼吧！

public class L {

    //TAG
    public static String TAG = "tonjies";

    //5個等級 DIWE

    public static void d(String text) {
        Log.d(TAG, text + "");
    }

    public static void i(String text) {
        Log.i(TAG, text + "");
    }

    public static void w(String text) {
        Log.w(TAG, text + "");
    }

    public static void e(String text) {
        Log.e(TAG, text + "");
    }
}

怎麼樣，相當簡單的程式碼吧！我們只是把每次都要輸入的TAG，提取出來，並把該值設定成預設的值罷了，讓我們來看看怎麼使用

//┏┓　　　┏┓
//┏┛┻━━━┛┻┓
//┃　　　　　　　┃ 　
//┃　　　━　　　┃
//┃　┳┛　┗┳　┃
//┃　　　　　　　┃
//┃　　　┻　　　┃
//┃　　　　　　　┃
//┗━┓　　　┏━┛
//┃　　　┃  神獸保佑　　　　　　　　
//┃　　　┃  程式碼無BUG！
//┃　　　┗━━━┓
//┃　　　　　　　┣┓
//┃　　　　　　　┏┛
//┗┓┓┏━┳┓┏┛
// ┃┫┫　┃┫┫
//
public class MainActivity extends AppCompatActivity {

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);
        L.d("log列印成功");
    }
}

我們輸入L.d(“你好，世界”)，執行程式，輸入tonjies，觀察Logo，果然成功了，怎麼樣，只輸入兩個字母的Log是不是稍微方便一點了

11881598-b4213461ed32c70a
輸出Log

這樣封裝可能會出現一個問題，就是在不經意用了太多的L工具類，導致輸出的東西太亂，這時候我們可以選中L類，右鍵Find Usages，或者使用快捷鍵Alt+F7，在下邊的find視窗檢視我們都在哪裡使用過，把不需要的註釋或者刪除掉

sharedPreferences封裝類：

關於SharedPreferences的用法就不贅述了，詳情請檢視第一行程式碼第6.4節，強烈推薦使用科學的方法檢視資料庫檔案，如facebook的stetho，這裡封裝的目的和封裝Log一樣，同樣是為了簡化操作，讓我們先來看看原本的用法

  • 存資料:
SharedPreferences.Editor editor=getSharedPreferences("data",MODE_PRIVATE).edit();
editor.putString("name","tonjies");
editor.putInt("age",20);
editor.apply();
  • 取資料：
SharedPreferences preferences = getSharedPreferences("data", MODE_PRIVATE);
String name = preferences.getString("name", "");
int age = preferences.getInt("age", 18);
L.d("name:" + name);
L.d("age" + age);

使用stetho工具檢視：

11881598-debbfa0dd50f4b67
stetho工具

封裝類：


/**
 * Created by 舍長 on 2018/2/10.
 * SharedPreferences 封裝類
 */

public class ShareUtils {

    public static final String NAME = "config";

    /**
     * 儲存String型別的值
     * @param mContext this
     * @param key      key值
     * @param value    要儲存的String值
     */
    public static void putString(Context mContext, String key, String value) {
        SharedPreferences sharedPreferences = mContext.getSharedPreferences(NAME, Context.MODE_PRIVATE);
        sharedPreferences.edit().putString(key, value).commit();
    }

    /**
     * 獲取String型別的值
     * @param mContext this
     * @param key      key
     * @param defValue 預設值
     * @return
     */
    public static String getString(Context mContext, String key, String defValue) {
        SharedPreferences sharedPreferences = mContext.getSharedPreferences(NAME, Context.MODE_PRIVATE);
        return sharedPreferences.getString(key, defValue);
    }

    /**
     * 儲存Int型別的值
     * @param mContext this
     * @param key      key
     * @param value    要儲存的Int值
     */
    public static void putInt(Context mContext, String key, int value) {
        SharedPreferences sharedPreferences = mContext.getSharedPreferences(NAME, Context.MODE_PRIVATE);
        sharedPreferences.edit().putInt(key, value).commit();
    }

    /**
     * 獲取Int型別的值
     * @param mContext this
     * @param key      key
     * @param defValue 預設值
     * @return
     */
    public static int getInt(Context mContext, String key, int defValue) {
        SharedPreferences sharedPreferences = mContext.getSharedPreferences(NAME, Context.MODE_PRIVATE);
        return sharedPreferences.getInt(key, defValue);
    }

    /**
     * 儲存Boolean型別的值
     * @param mContext this
     * @param key      key
     * @param value    要儲存Boolean值
     */
    public static void putBoolean(Context mContext, String key, boolean value) {
        SharedPreferences sharedPreferences = mContext.getSharedPreferences(NAME, Context.MODE_PRIVATE);
        sharedPreferences.edit().putBoolean(key, value).commit();
    }

    /**
     * 獲取Boolean型別的值
     * @param mContext this
     * @param key      key
     * @param defValue 預設值
     * @return
     */
    public static boolean getBoolean(Context mContext, String key, Boolean defValue) {
        SharedPreferences sharedPreferences = mContext.getSharedPreferences(NAME, Context.MODE_PRIVATE);
        return sharedPreferences.getBoolean(key, defValue);
    }

    //刪除 單個 key
    public static void deleShare(Context context, String key) {
        SharedPreferences sharedPreferences = context.getSharedPreferences(NAME, Context.MODE_PRIVATE);
        sharedPreferences.edit().remove(key).commit();
    }

    //刪除全部 key
    public static void deleAll(Context context) {
        SharedPreferences sharedPreferences = context.getSharedPreferences(NAME, Context.MODE_PRIVATE);
        sharedPreferences.edit().clear().commit();
    }
}

我們把可複用的SharedPreferences類名和方法提取出來，並把不同的context物件，想要儲存的值 ，想要去除去除的key欄位值 ， 預設值等傳入，看看具體的用法吧！

  • 存資料：
//取出String型別
final String string = ShareUtils.getString(ShareActivity.this, "name", "沒有值可以取出來");
 L.d(string);
  • 取資料：
//取出int型別
final int age2= ShareUtils.getInt(ShareActivity.this, "age", 18);
L.d(age2+"");

自定義字型封裝類：

老規矩了，先看看原本應該如何實現

在src-main-asset(需要自己建立)-fonts(自己建立)-新增字型-MengYuanti.ttf

private void type() {
     Typeface typeface=Typeface.createFromAsset(getAssets(),"fonts/MengYuanti.ttf");
     txtB.setTypeface(typeface);
 }
11881598-efe942ffbc071392
新增字型檔案

封裝類：

/**
 * Created by 舍長 on 2018/4/27.
 */

public class FontSetting {
    public FontSetting() {
    }

    public static void setFont(Context context, TextView textView, String fontsPath) {
        try {
            Typeface fromAsset = Typeface.createFromAsset(context.getAssets(), fontsPath);
            textView.setTypeface(fromAsset);
        } catch (Exception e) {
            L.d("找不到檔案資源！");
            Toast.makeText(context, "伺服器出錯啦！", Toast.LENGTH_SHORT).show();
        }
    }
}

我們新增了setFont方法，並try…catch了一下，為什麼要進行異常處理呢，因為如果我們的fontPath路徑fontsPath錯誤了，比如”fonts/MengYuanti.ttf”變為了”fonts/engYuanti.ttf”，程式會跑出java.lang.RuntimeException:異常，程式會崩潰、所以我們進行異常捕獲，並且告訴使用者，是伺服器出現了異常，這樣使用者的投訴就會讓伺服器人員去背，完美！

具體使用：

/**
 * Created by 舍長 on 2018/4/5.
 * 描述: Android字型設定
 */

public class FontActivity extends WinBaseActivity {
    @BindView(R.id.txt_01)
    TextView txt01;

    @Override
    protected void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.switch_item_layout);
        ButterKnife.bind(this);
        FontSetting.setFont(FontActivity.this,txt01,"fonts/chuxintech.woff");
    }
}

四、MD5封裝工具類

public class MD5Util {
    public final static String MD5(String s) {
        char hexDigits[] = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9',
                'a', 'b', 'c', 'd', 'e', 'f' };
        try {
            byte[] btInput = s.getBytes();
            // 獲得MD5摘要演算法的 MessageDigest 物件
            MessageDigest mdInst = MessageDigest.getInstance("MD5");
            // 使用指定的位元組更新摘要
            mdInst.update(btInput);
            // 獲得密文
            byte[] md = mdInst.digest();
            // 把密文轉換成十六進位制的字串形式
            int j = md.length;
            char str[] = new char[j * 2];
            int k = 0;
            for (int i = 0; i < j; i++) {
                byte byte0 = md[i];
                str[k++] = hexDigits[byte0 >>> 4 & 0xf];
                str[k++] = hexDigits[byte0 & 0xf];
            }
            return new String(str);
        } catch (Exception e) {
            return null;
        }
    }

    public static void main(String[] args) {
        System.out.print(MD5Util.MD5("password"));
    }
}

五、執行緒睡眠工具類

public class CSleep {
    public static final long DEFAULT_SLEEP_TIME = 500;

    private boolean          isRuning           = false;

    public boolean isRuning() {
        return isRuning;
    }

    public void runWithTime(final long defaultSleepTime) {
        isRuning = true;
        new Thread() {

            @Override
            public void run() {
                try {
                    sleep(defaultSleepTime, 0);
                } catch (InterruptedException e) {
                    e.printStackTrace();
                }
                isRuning = false;
                super.run();
            }
        }.start();
    }
}

六、檢查網路是否連通

/**
     * 檢查網路是否連通
     * 
     * @return boolean
     * @since V1.0
     */
    public boolean isNetworkAvailable(Context context) {
        // 建立並初始化連線物件
        ConnectivityManager connMan = (ConnectivityManager) context.getSystemService(Context.CONNECTIVITY_SERVICE);
        // 判斷初始化是否成功並作出相應處理
        if (connMan != null) {
            // 呼叫getActiveNetworkInfo方法建立物件,如果不為空則表明網路連通，否則沒連通
            NetworkInfo info = connMan.getActiveNetworkInfo();
            if (info != null) {
                return info.isAvailable();
            }
        }
        return false;
    }

七、異常類捕捉

/**
 * UncaughtException處理類,當程式發生Uncaught異常的時候,由該類來接管程式,並記錄傳送錯誤報告. 需要在Application中註冊，為了要在程式啟動器就監控整個程式。
 */
public class CrashHandler implements UncaughtExceptionHandler {
    /** TAG */
    public static final String              TAG       = "CrashHandler";
    /** 系統預設的UncaughtException處理類 */
    private Thread.UncaughtExceptionHandler mDefaultHandler;
    /** CrashHandler例項 */
    private static CrashHandler             mCrashHandler;
    /** 程式的Context物件 */
    private Context                         mContext;
    /** 用來儲存裝置資訊和異常資訊 */
    private Map<String, String>             infos     = new HashMap<String, String>();
    /** 用於格式化日期,作為日誌檔名的一部分 */
    private DateFormat                      formatter = new SimpleDateFormat("yyyy-MM-dd-HH-mm-ss");

    /**
     * 私有建構函式
     */
    private CrashHandler() {

    }

    /**
     * 獲取CrashHandler例項 ,單例模式
     * 
     * @return
     * @since V1.0
     */
    public static CrashHandler getInstance() {
        if (mCrashHandler == null)
            mCrashHandler = new CrashHandler();
        return mCrashHandler;
    }

    /**
     * 初始化
     * 
     * @param context
     * @since V1.0
     */
    public void init(Context context) {
        mContext = context;
        // 獲取系統預設的UncaughtException處理器
        mDefaultHandler = Thread.getDefaultUncaughtExceptionHandler();
        // 設定該CrashHandler為程式的預設處理器
        Thread.setDefaultUncaughtExceptionHandler(this);
    }

    /**
     * 當UncaughtException發生時會轉入該函式來處理
     */
    @Override
    public void uncaughtException(Thread thread, Throwable ex) {
        if (!handleException(ex) && mDefaultHandler != null) {
            // 如果使用者沒有處理則讓系統預設的異常處理器來處理
            mDefaultHandler.uncaughtException(thread, ex);
        } else {
            try {
                Thread.sleep(3000);
            } catch (InterruptedException e) {
                CLog.e(TAG, "uncaughtException() InterruptedException:" + e);
            }
            // 退出程式
            android.os.Process.killProcess(android.os.Process.myPid());
            System.exit(1);
        }
    }

    /**
     * 自定義錯誤處理,收集錯誤資訊 傳送錯誤報告等操作均在此完成.
     * 
     * @param ex
     * @return true:如果處理了該異常資訊;否則返回false.
     * @since V1.0
     */
    private boolean handleException(Throwable ex) {
        if (ex == null) {
            return false;
        }

        // 收集裝置引數資訊
        collectDeviceInfo(mContext);

        // 使用Toast來顯示異常資訊
        new Thread() {
            @Override
            public void run() {
                Looper.prepare();
                Toast.makeText(mContext, "很抱歉,程式出現異常,即將退出.", Toast.LENGTH_SHORT).show();
                Looper.loop();
            }
        }.start();

        // 儲存日誌檔案
        saveCatchInfo2File(ex);
        return true;
    }

    /**
     * 收集裝置引數資訊
     * 
     * @param ctx
     * @since V1.0
     */
    public void collectDeviceInfo(Context ctx) {
        try {
            PackageManager pm = ctx.getPackageManager();
            PackageInfo pi = pm.getPackageInfo(ctx.getPackageName(), PackageManager.GET_ACTIVITIES);
            if (pi != null) {
                String versionName = pi.versionName == null ? "null" : pi.versionName;
                String versionCode = pi.versionCode + "";
                infos.put("versionName", versionName);
                infos.put("versionCode", versionCode);
            }
        } catch (NameNotFoundException e) {
            CLog.e(TAG, "collectDeviceInfo() an error occured when collect package info NameNotFoundException:", e);
        }
        Field[] fields = Build.class.getDeclaredFields();
        for (Field field : fields) {
            try {
                field.setAccessible(true);
                infos.put(field.getName(), field.get(null).toString());
                CLog.d(TAG, field.getName() + " : " + field.get(null));
            } catch (Exception e) {
                CLog.e(TAG, "collectDeviceInfo() an error occured when collect crash info Exception:", e);
            }
        }
    }

    /**
     * 儲存錯誤資訊到檔案中
     * 
     * @param ex
     * @return 返回檔名稱,便於將檔案傳送到伺服器
     */
    private String saveCatchInfo2File(Throwable ex) {
        StringBuffer sb = new StringBuffer();
        for (Map.Entry<String, String> entry : infos.entrySet()) {
            String key = entry.getKey();
            String value = entry.getValue();
            sb.append(key + "=" + value + "\n");
        }

        Writer writer = new StringWriter();
        PrintWriter printWriter = new PrintWriter(writer);
        ex.printStackTrace(printWriter);
        Throwable cause = ex.getCause();
        while (cause != null) {
            cause.printStackTrace(printWriter);
            cause = cause.getCause();
        }
        printWriter.close();
        String result = writer.toString();
        sb.append(result);
        try {
            long timestamp = System.currentTimeMillis();
            String time = formatter.format(new Date());
            String fileName = "crash-" + time + "-" + timestamp + ".log";
            if (Environment.getExternalStorageState().equals(Environment.MEDIA_MOUNTED)) {
                String path = FilePathUtil.getiVMSDirPath() + "/crash/";
                File dir = new File(path);
                if (!dir.exists()) {
                    dir.mkdirs();
                }
                FileOutputStream fos = new FileOutputStream(path + fileName);
                fos.write(sb.toString().getBytes());
                // 傳送給開發人員
                sendCrashLog2PM(path + fileName);
                fos.close();
            }
            return fileName;
        } catch (Exception e) {
            CLog.e(TAG, "saveCatchInfo2File() an error occured while writing file... Exception:", e);
        }
        return null;
    }

    /**
     * 將捕獲的導致崩潰的錯誤資訊傳送給開發人員 目前只將log日誌儲存在sdcard 和輸出到LogCat中，並未傳送給後臺。
     * 
     * @param fileName
     * @since V1.0
     */
    private void sendCrashLog2PM(String fileName) {
        if (!new File(fileName).exists()) {
            CLog.e(TAG, "sendCrashLog2PM() 日誌檔案不存在");
            return;
        }
        FileInputStream fis = null;
        BufferedReader reader = null;
        String s = null;
        try {
            fis = new FileInputStream(fileName);
            reader = new BufferedReader(new InputStreamReader(fis, "GBK"));
            while (true) {
                s = reader.readLine();
                if (s == null)
                    break;
                // 由於目前尚未確定以何種方式傳送，所以先打出log日誌。
                CLog.e(TAG, s);
            }
        } catch (FileNotFoundException e) {
            e.printStackTrace();
        } catch (IOException e) {
            e.printStackTrace();
        } finally { // 關閉流
            try {
                reader.close();
                fis.close();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }
    }
}

八、彈出框提醒

 public static Dialog showDialog(Context ctx, int layViewID, int ThemeType) {
        Dialog res = new Dialog(ctx, ThemeType);
        res.setContentView(layViewID);
        return res;
    }

九、圖片API類

public class ImageAPI {

    public static Bitmap getImageByFilePath(String filePath, int scale) {
        Bitmap res = null;
        BitmapFactory.Options options = new BitmapFactory.Options();
        options.inJustDecodeBounds = true;
        BitmapFactory.decodeFile(filePath, options);
        options.inJustDecodeBounds = false;
        options.inSampleSize = scale;
        options.inPreferredConfig = Bitmap.Config.ARGB_4444;
        return res;
    }

    public static Bitmap getImageByFilePath(String filePath, int Towidth, int ToHeight) {
        Bitmap res = null;
        BitmapFactory.Options options = new BitmapFactory.Options();
        options.inJustDecodeBounds = true;
        if (!new File(filePath).exists())
            return res;
        BitmapFactory.decodeFile(filePath, options);

        int origionalWidth = options.outHeight;
        int origionalHeight = options.outWidth;
        options.inJustDecodeBounds = false;
        int scale = Math.max(origionalWidth / Towidth, origionalHeight / ToHeight);
        options.inSampleSize = scale;
        options.inPreferredConfig = Bitmap.Config.ARGB_4444;
        try {
            res = BitmapFactory.decodeFile(filePath, options);
        } catch (Exception e) {
            e.printStackTrace();
            return null;
        } catch (OutOfMemoryError e) {
            e.printStackTrace();
            return null;
        }
        return res;
    }

}

十、提醒吐司封裝類

public static void showToast(Context ctx, int id, String str) {
        if (str == null) {
            return;
        }

        Toast toast = Toast.makeText(ctx, ctx.getString(id) + str, Toast.LENGTH_SHORT);
        toast.setGravity(Gravity.CENTER, 0, 0);
        toast.show();
    }

    public static void showToast(Context ctx, String errInfo) {
        if (errInfo == null) {
            return;
        }

        Toast toast = Toast.makeText(ctx, errInfo, Toast.LENGTH_SHORT);
        toast.setGravity(Gravity.CENTER, 0, 0);
        toast.show();
    }

@希望能幫到你！

相關文章