see 08/13 log

Author: Blankj

README.md

@@ -16,19 +16,27 @@
 >  - 获取设备MAC地址 *getMacAddress*
 >  - 获取设备厂商，如Xiaomi *getManufacturer*
 >  - 获取设备型号，如MI2SC *getModel*
+
 >  - 获取设备SD卡是否可用 *isSDCardEnable*
 >  - 获取设备SD卡路径 *getSDCardPath*
 
 > - [编码解码相关][encode.md]→[EncodeUtils.java][encode.java]
->  - 以UTF-8编码字符串 *encodeUTF8*
->  - 字符编码 *encode*
->  - 以UTF-8解码字符串 *decodeUTF8*
->  - 字符解码 *decode*
+>  - URL编码 *urlEncode*
+>  - URL解码 *urlDecode*
+>  - Base64编码 *base64Encode*
+>  - Base64解码 *base64Decode*
+>  - Base64URL安全编码 *base64UrlSafeEncode*
+>  - Html编码 *htmlEncode*
+>  - Html解码 *htmlDecode*
 
 > - [加解密相关][encrypt.md]→[EncryptUtils.java][encrypt.java]
->  - MD5加密 *getMD5* *encryptMD5* *getMD5File*
+>  - MD5加密 *getMD5* *encryptMD5*
+>  - 获取文件的MD5校验码 *getMD5File*
 >  - SHA加密 *getSHA* *encryptSHA*
 
+> - [文件相关][file.md]→[FileUtils.java][file.java]
+>  - 这几天完善ing
+
 > - [键盘相关][keyboard.md]→[KeyboardUtils.java][keyboard.java]
 >  - 避免输入法面板遮挡
 >  - 动态隐藏软键盘 *hideSoftInput*

md/about_device.md

@@ -83,24 +83,5 @@ public class DeviceUtils {
         }
         return model;
     }
-
-    /**
-     * 获取设备SD卡是否可用
-     *
-     * @return true : 可用<br>false : 不可用
-     */
-    public static boolean isSDCardEnable() {
-        return Environment.MEDIA_MOUNTED.equals(Environment.getExternalStorageState());
-    }
-
-    /**
-     * 获取设备SD卡路径
-     * <p>一般是/storage/emulated/0/</p>
-     *
-     * @return SD卡路径
-     */
-    public static String getSDCardPath() {
-        return Environment.getExternalStorageDirectory().getAbsolutePath() + File.separator;
-    }
 }
 ```

md/about_encode.md

@@ -1,5 +1,9 @@
 # 编码解码相关
 ``` java
+import android.os.Build;
+import android.text.Html;
+import android.util.Base64;
+
 import java.io.UnsupportedEncodingException;
 import java.net.URLDecoder;
 import java.net.URLEncoder;
@@ -19,57 +23,153 @@ public class EncodeUtils {
     }
 
     /**
-     * 以UTF-8编码字符串
-     * <p>若想自己指定字符集,可以使用encode(String string, String charset)方法</p>
+     * URL编码
+     * <p>若想自己指定字符集,可以使用{@link #urlEncode(String input, String charset)}方法</p>
      *
-     * @param string 要编码的字符
+     * @param input 要编码的字符
      * @return 编码为UTF-8的字符串
      */
-    public static String encodeUTF8(String string) {
-        return encode(string, "UTF-8");
+    public static String urlEncode(String input) {
+        return urlEncode(input, "UTF-8");
     }
 
     /**
-     * 字符编码
-     * <p>若系统不支持指定的编码字符集,则直接将string原样返回</p>
+     * URL编码
+     * <p>若系统不支持指定的编码字符集,则直接将input原样返回</p>
      *
-     * @param string  要编码的字符
+     * @param input   要编码的字符
      * @param charset 字符集
      * @return 编码为字符集的字符串
      */
-    public static String encode(String string, String charset) {
+    public static String urlEncode(String input, String charset) {
         try {
-            return URLEncoder.encode(string, charset);
+            return URLEncoder.encode(input, charset);
         } catch (UnsupportedEncodingException e) {
-            return string;
+            return input;
         }
     }
 
     /**
-     * 以UTF-8解码字符串
-     * <p>若想自己指定字符集,可以使用# {decode(String string, String charset)}方法</p>
+     * URL解码
+     * <p>若想自己指定字符集,可以使用 {@link #urlDecode(String input, String charset)}方法</p>
      *
-     * @param string 要解码的字符
-     * @return 解码为UTF-8的字符串
+     * @param input 要解码的字符串
+     * @return URL解码后的字符串
      */
-    public static String decodeUTF8(String string) {
-        return decode(string, "UTF-8");
+    public static String urlDecode(String input) {
+        return urlDecode(input, "UTF-8");
     }
 
     /**
-     * 字符解码
-     * <p>若系统不支持指定的解码字符集,则直接将string原样返回</p>
+     * URL解码
+     * <p>若系统不支持指定的解码字符集,则直接将input原样返回</p>
      *
-     * @param string  要解码的字符
+     * @param input   要解码的字符串
      * @param charset 字符集
-     * @return 解码为字符集的字符串
+     * @return URL解码为指定字符集的字符串
      */
-    public static String decode(String string, String charset) {
+    public static String urlDecode(String input, String charset) {
         try {
-            return URLDecoder.decode(string, charset);
+            return URLDecoder.decode(input, charset);
         } catch (UnsupportedEncodingException e) {
-            return string;
+            return input;
+        }
+    }
+
+    /**
+     * Base64编码
+     *
+     * @param input 要编码的字符串
+     * @return Base64编码后的字符串
+     */
+    public static String base64Encode(String input) {
+        return base64Encode(input.getBytes());
+    }
+
+    /**
+     * Base64编码
+     *
+     * @param input 要编码的字节数组
+     * @return Base64编码后的字符串
+     */
+    public static String base64Encode(byte[] input) {
+        return Base64.encodeToString(input, Base64.DEFAULT);
+    }
+
+    /**
+     * Base64解码
+     *
+     * @param input 要解码的字符串
+     * @return Base64解码后的字符串
+     */
+    public static String base64Decode(String input) {
+        return new String(Base64.decode(input, Base64.DEFAULT));
+    }
+
+    /**
+     * Base64URL安全编码
+     * <p>将Base64中的URL非法字符�?,/=转为其他字符, 见RFC3548</p>
+     *
+     * @param input 要Base64URL安全编码的字符串
+     * @return Base64URL安全编码后的字符串
+     */
+    public static String base64UrlSafeEncode(String input) {
+        return Base64.encodeToString(input.getBytes(), Base64.URL_SAFE);
+    }
+
+    /**
+     * Html编码
+     *
+     * @param input 要Html编码的字符串
+     * @return Html编码后的字符串
+     */
+    public static String htmlEncode(String input) {
+        if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.JELLY_BEAN) {
+            return Html.escapeHtml(input);
+        } else {
+            // 参照Html.escapeHtml()中代码
+            StringBuilder out = new StringBuilder();
+            for (int i = 0, len = input.length(); i < len; i++) {
+                char c = input.charAt(i);
+                if (c == '<') {
+                    out.append("&lt;");
+                } else if (c == '>') {
+                    out.append("&gt;");
+                } else if (c == '&') {
+                    out.append("&amp;");
+                } else if (c >= 0xD800 && c <= 0xDFFF) {
+                    if (c < 0xDC00 && i + 1 < len) {
+                        char d = input.charAt(i + 1);
+                        if (d >= 0xDC00 && d <= 0xDFFF) {
+                            i++;
+                            int codepoint = 0x010000 | (int) c - 0xD800 << 10 | (int) d - 0xDC00;
+                            out.append("&#").append(codepoint).append(";");
+                        }
+                    }
+                } else if (c > 0x7E || c < ' ') {
+                    out.append("&#").append((int) c).append(";");
+                } else if (c == ' ') {
+                    while (i + 1 < len && input.charAt(i + 1) == ' ') {
+                        out.append("&nbsp;");
+                        i++;
+                    }
+                    out.append(' ');
+                } else {
+                    out.append(c);
+                }
+            }
+            return out.toString();
         }
     }
+
+    /**
+     * Html解码
+     *
+     * @param input 待解码的字符串
+     * @return Html解码后的字符串
+     */
+    public static String htmlDecode(String input) {
+        return Html.fromHtml(input).toString();
+    }
 }
 ```

md/about_file.md

@@ -0,0 +1,19 @@
+# 编码解码相关
+``` java
+/**
+ * <pre>
+ *     author: Blankj
+ *     blog  : http://blankj.com
+ *     time  : 2016/8/11
+ *     desc  : 文件相关的工具类
+ * </pre>
+ */
+public class FileUtils {
+
+    private FileUtils() {
+        throw new UnsupportedOperationException("u can't fuck me...");
+    }
+
+
+}
+```

md/update_log.md

@@ -1,5 +1,6 @@
 ### 更新Log
-#### 16/08/12 新增Base64和Html编码解码及他们的单元测试，新增TimeUtils单元测试
+#### 16/08/13 新增MD2，SHA224，SHA256，SHA384，SHA512加密及单元测试，正折腾DES加密
+#### 16/08/12 新增Base64和Html编码解码及他们的单元测试，新增TimeUtils单元测试，更新md
 #### 16/08/11 新增SDCardUtils，UnitUtils，单元测试慢慢完善中
 #### 16/08/09 目录排版更新，新增Download，Proguard和License
 #### 16/08/08 新增Shell工具类，已传jcenter()遇到好多坑，javaDoc惹的祸，注释一定要规范

utilcode/src/main/java/com/blankj/utilcode/utils/ConvertUtils.java

@@ -0,0 +1,68 @@
+package com.blankj.utilcode.utils;
+
+/**
+ * <pre>
+ *     author: Blankj
+ *     blog  : http://blankj.com
+ *     time  : 2016/8/13
+ *     desc  : 转换相关工具类
+ * </pre>
+ */
+public class ConvertUtils {
+
+    static final char hexDigits[] = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'};
+
+    /**
+     * 每1个byte转为2个hex字符
+     * <p>例如：</p>
+     * bytes2HexString(new byte[] { 0, (byte) 0xa8 }) returns 00A8
+     *
+     * @param src byte数组
+     * @return 16进制大写字符串
+     */
+    public static String bytes2HexString(byte[] src) {
+        char[] res = new char[src.length << 1];
+        for (int i = 0, j = 0; i < src.length; i++) {
+            res[j++] = hexDigits[src[i] >>> 4 & 0x0f];
+            res[j++] = hexDigits[src[i] & 0x0f];
+        }
+        return new String(res);
+    }
+
+    /**
+     * 每2个hex字符转为1个byte
+     * <p>例如：</p>
+     * bytes2HexString("00A8") returns { 0, (byte) 0xA8 }
+     *
+     * @param hexString 十六进制字符串
+     * @return byte数组
+     */
+    public static byte[] hexString2Bytes(String hexString) {
+        int len = hexString.length();
+        if (len % 2 != 0) {
+            throw new IllegalArgumentException("长度不是偶数");
+        }
+        char[] hexBytes = hexString.toUpperCase().toCharArray();
+        byte[] res = new byte[len / 2];
+        for (int i = 0; i < len; i += 2) {
+            res[i >> 1] = (byte) (hex2Dec(hexBytes[i]) << 4 | hex2Dec(hexBytes[i + 1]));
+        }
+        return res;
+    }
+
+    /**
+     * 单个hex字符转为10进制
+     *
+     * @param hexChar hex单个字节
+     * @return 0..15
+     */
+    private static int hex2Dec(char hexChar) {
+        if (hexChar >= '0' && hexChar <= '9') {
+            return hexChar - '0';
+        } else if (hexChar >= 'A' && hexChar <= 'E') {
+            return hexChar - 'A' + 10;
+        } else {
+            throw new IllegalArgumentException();
+        }
+    }
+}