也就是让栈中最多只剩下一种类型的Activity
+ * 结束除最新之外的同类型 Activity + *也就是让栈中最多只剩下一种类型的 Activity
* - * @param clz activity类 + * @param clz Activity 类 */ public static void finishOtherActivitiesExceptNewest(@NonNull final Class> clz) { finishOtherActivitiesExceptNewest(clz, false); } /** - * 结束除最新之外的同类型Activity - *也就是让栈中最多只剩下一种类型的Activity
+ * 结束除最新之外的同类型 Activity + *也就是让栈中最多只剩下一种类型的 Activity
* - * @param clz activity类 + * @param clz Activity 类 * @param isLoadAnim 是否启动动画 */ public static void finishOtherActivitiesExceptNewest(@NonNull final Class> clz, @@ -985,10 +985,10 @@ public static void finishOtherActivitiesExceptNewest(@NonNull final Class> clz } /** - * 结束除最新之外的同类型Activity - *也就是让栈中最多只剩下一种类型的Activity
+ * 结束除最新之外的同类型 Activity + *也就是让栈中最多只剩下一种类型的 Activity
* - * @param clz activity类 + * @param clz Activity 类 * @param enterAnim 入场动画 * @param exitAnim 出场动画 */ @@ -1010,14 +1010,14 @@ public static void finishOtherActivitiesExceptNewest(@NonNull final Class> clz } /** - * 结束所有activity + * 结束所有 Activity */ public static void finishAllActivities() { finishAllActivities(false); } /** - * 结束所有activity + * 结束所有 Activity * * @param isLoadAnim 是否启动动画 */ @@ -1025,7 +1025,7 @@ public static void finishAllActivities(final boolean isLoadAnim) { List8.0需添加权限 {@code
8.0 需添加权限 {@code
8.0需添加权限 {@code
8.0 需添加权限 {@code
8.0需添加权限 {@code
8.0 需添加权限 {@code
8.0需添加权限 {@code
8.0 需添加权限 {@code
非root需添加权限 {@code
非 root 需添加权限 {@code
非root需添加权限 {@code
非 root 需添加权限 {@code
可据此判断高德,百度地图key是否正确
+ * 获取应用签名的的 SHA1 值 + *可据此判断高德,百度地图 key 是否正确
* - * @return 应用签名的SHA1字符串, 比如:53:FD:54:DC:19:0F:11:AC:B5:22:9E:F1:1A:68:88:1B:8B:E8:54:42 + * @return 应用签名的 SHA1 字符串, 比如:53:FD:54:DC:19:0F:11:AC:B5:22:9E:F1:1A:68:88:1B:8B:E8:54:42 */ public static String getAppSignatureSHA1() { return getAppSignatureSHA1(Utils.getApp().getPackageName()); } /** - * 获取应用签名的的SHA1值 - *可据此判断高德,百度地图key是否正确
+ * 获取应用签名的的 SHA1 值 + *可据此判断高德,百度地图 key 是否正确
* * @param packageName 包名 - * @return 应用签名的SHA1字符串, 比如:53:FD:54:DC:19:0F:11:AC:B5:22:9E:F1:1A:68:88:1B:8B:E8:54:42 + * @return 应用签名的 SHA1 字符串, 比如:53:FD:54:DC:19:0F:11:AC:B5:22:9E:F1:1A:68:88:1B:8B:E8:54:42 */ public static String getAppSignatureSHA1(final String packageName) { Signature[] signature = getAppSignature(packageName); @@ -481,7 +481,7 @@ public static String getAppSignatureSHA1(final String packageName) { } /** - * 判断App是否处于前台 + * 判断 App 是否处于前台 * * @return {@code true}: 是当不是查看当前App,且SDK大于21时, + * 判断 App 是否处于前台 + *
当不是查看当前 App,且 SDK 大于 21 时,
* 需添加权限 {@code
AppInfo(名称,图标,包名,版本号,版本Code,是否系统应用)
+ * 获取 App 信息 + *AppInfo(名称,图标,包名,版本号,版本 Code,是否系统应用)
* - * @return 当前应用的AppInfo + * @return 当前应用的 AppInfo */ public static AppInfo getAppInfo() { return getAppInfo(Utils.getApp().getPackageName()); } /** - * 获取App信息 - *AppInfo(名称,图标,包名,版本号,版本Code,是否系统应用)
+ * 获取 App 信息 + *AppInfo(名称,图标,包名,版本号,版本 Code,是否系统应用)
* * @param packageName 包名 - * @return 当前应用的AppInfo + * @return 当前应用的 AppInfo */ public static AppInfo getAppInfo(final String packageName) { try { @@ -638,11 +638,11 @@ public static AppInfo getAppInfo(final String packageName) { } /** - * 得到AppInfo的Bean + * 得到 AppInfo 的 Bean * * @param pm 包的管理 * @param pi 包的信息 - * @return AppInfo类 + * @return AppInfo 类 */ private static AppInfo getBean(final PackageManager pm, final PackageInfo pi) { if (pm == null || pi == null) return null; @@ -658,11 +658,11 @@ private static AppInfo getBean(final PackageManager pm, final PackageInfo pi) { } /** - * 获取所有已安装App信息 - *{@link #getBean(PackageManager, PackageInfo)}(名称,图标,包名,包路径,版本号,版本Code,是否系统应用)
- *依赖上面的getBean方法
+ * 获取所有已安装 App 信息 + *{@link #getBean(PackageManager, PackageInfo)}(名称,图标,包名,包路径,版本号,版本 Code,是否系统应用)
+ *依赖上面的 getBean 方法
* - * @return 所有已安装的AppInfo列表 + * @return 所有已安装的 AppInfo 列表 */ public static ListDrawLayout需设置 {@code android:fitsSystemWindows="true"}
+ * 为 DrawerLayout 设置状态栏颜色 + *DrawLayout 需设置 {@code android:fitsSystemWindows="true"}
* * @param activity activity * @param drawer drawerLayout * @param fakeStatusBar 伪造状态栏 * @param color 状态栏颜色值 - * @param isTop drawerLayout是否在顶层 + * @param isTop drawerLayout 是否在顶层 */ public static void setStatusBarColor4Drawer(@NonNull final Activity activity, @NonNull final DrawerLayout drawer, @@ -241,15 +237,15 @@ public static void setStatusBarColor4Drawer(@NonNull final Activity activity, } /** - * 为DrawerLayout设置状态栏颜色 - *DrawLayout需设置 {@code android:fitsSystemWindows="true"}
+ * 为 DrawerLayout 设置状态栏颜色 + *DrawLayout 需设置 {@code android:fitsSystemWindows="true"}
* * @param activity activity * @param drawer drawerLayout * @param fakeStatusBar 伪造状态栏 * @param color 状态栏颜色值 * @param alpha 状态栏透明度,此透明度并非颜色中的透明度 - * @param isTop drawerLayout是否在顶层 + * @param isTop drawerLayout 是否在顶层 */ public static void setStatusBarColor4Drawer(@NonNull final Activity activity, @NonNull final DrawerLayout drawer, @@ -272,13 +268,13 @@ public static void setStatusBarColor4Drawer(@NonNull final Activity activity, } /** - * 为DrawerLayout设置状态栏透明度 - *DrawLayout需设置 {@code android:fitsSystemWindows="true"}
+ * 为 DrawerLayout 设置状态栏透明度 + *DrawLayout 需设置 {@code android:fitsSystemWindows="true"}
* * @param activity activity * @param drawer drawerLayout * @param fakeStatusBar 伪造状态栏 - * @param isTop drawerLayout是否在顶层 + * @param isTop drawerLayout 是否在顶层 */ public static void setStatusBarAlpha4Drawer(@NonNull final Activity activity, @NonNull final DrawerLayout drawer, @@ -288,14 +284,14 @@ public static void setStatusBarAlpha4Drawer(@NonNull final Activity activity, } /** - * 为DrawerLayout设置状态栏透明度 - *DrawLayout需设置 {@code android:fitsSystemWindows="true"}
+ * 为 DrawerLayout 设置状态栏透明度 + *DrawLayout 需设置 {@code android:fitsSystemWindows="true"}
* * @param activity activity * @param drawer drawerLayout * @param fakeStatusBar 伪造状态栏 * @param alpha 状态栏透明度 - * @param isTop drawerLayout是否在顶层 + * @param isTop drawerLayout 是否在顶层 */ public static void setStatusBarAlpha4Drawer(@NonNull final Activity activity, @NonNull final DrawerLayout drawer, @@ -413,10 +409,10 @@ private static void transparentStatusBar(final Activity activity) { /////////////////////////////////////////////////////////////////////////// /** - * 获取ActionBar高度 + * 获取 ActionBar 高度 * * @param activity activity - * @return ActionBar高度 + * @return ActionBar 高度 */ public static int getActionBarHeight(@NonNull final Activity activity) { TypedValue tv = new TypedValue(); @@ -477,7 +473,7 @@ private static void invokePanels(@NonNull final Context context, final String me /** * 获取导航栏高度 - *0代表不存在
+ *0 代表不存在
* * @return 导航栏高度 */ diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/CacheUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/CacheUtils.java index bc3a558d7d..2ce760979f 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/CacheUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/CacheUtils.java @@ -212,7 +212,7 @@ public byte[] getBytes(@NonNull final String key, final byte[] defaultValue) { /////////////////////////////////////////////////////////////////////////// /** - * 缓存中写入String + * 缓存中写入 String * * @param key 键 * @param value 值 @@ -222,7 +222,7 @@ public void put(@NonNull final String key, @NonNull final String value) { } /** - * 缓存中写入String + * 缓存中写入 String * * @param key 键 * @param value 值 @@ -233,7 +233,7 @@ public void put(@NonNull final String key, @NonNull final String value, final in } /** - * 缓存中读取String + * 缓存中读取 String * * @param key 键 * @return 存在且没过期返回对应值,否则返回{@code null} @@ -243,7 +243,7 @@ public String getString(@NonNull final String key) { } /** - * 缓存中读取String + * 缓存中读取 String * * @param key 键 * @param defaultValue 默认值 @@ -260,7 +260,7 @@ public String getString(@NonNull final String key, final String defaultValue) { /////////////////////////////////////////////////////////////////////////// /** - * 缓存中写入JSONObject + * 缓存中写入 JSONObject * * @param key 键 * @param value 值 @@ -270,7 +270,7 @@ public void put(@NonNull final String key, @NonNull final JSONObject value) { } /** - * 缓存中写入JSONObject + * 缓存中写入 JSONObject * * @param key 键 * @param value 值 @@ -281,7 +281,7 @@ public void put(@NonNull final String key, @NonNull final JSONObject value, fina } /** - * 缓存中读取JSONObject + * 缓存中读取 JSONObject * * @param key 键 * @return 存在且没过期返回对应值,否则返回{@code null} @@ -291,7 +291,7 @@ public JSONObject getJSONObject(@NonNull final String key) { } /** - * 缓存中读取JSONObject + * 缓存中读取 JSONObject * * @param key 键 * @param defaultValue 默认值 @@ -309,7 +309,7 @@ public JSONObject getJSONObject(@NonNull final String key, final JSONObject defa /////////////////////////////////////////////////////////////////////////// /** - * 缓存中写入JSONArray + * 缓存中写入 JSONArray * * @param key 键 * @param value 值 @@ -319,7 +319,7 @@ public void put(@NonNull final String key, @NonNull final JSONArray value) { } /** - * 缓存中写入JSONArray + * 缓存中写入 JSONArray * * @param key 键 * @param value 值 @@ -330,7 +330,7 @@ public void put(@NonNull final String key, @NonNull final JSONArray value, final } /** - * 缓存中读取JSONArray + * 缓存中读取 JSONArray * * @param key 键 * @return 存在且没过期返回对应值,否则返回{@code null} @@ -340,7 +340,7 @@ public JSONArray getJSONArray(@NonNull final String key) { } /** - * 缓存中读取JSONArray + * 缓存中读取 JSONArray * * @param key 键 * @param defaultValue 默认值 @@ -358,7 +358,7 @@ public JSONArray getJSONArray(@NonNull final String key, final JSONArray default /////////////////////////////////////////////////////////////////////////// /** - * 缓存中写入Bitmap + * 缓存中写入 Bitmap * * @param key 键 * @param value 值 @@ -368,7 +368,7 @@ public void put(@NonNull final String key, @NonNull final Bitmap value) { } /** - * 缓存中写入Bitmap + * 缓存中写入 Bitmap * * @param key 键 * @param value 值 @@ -379,7 +379,7 @@ public void put(@NonNull final String key, @NonNull final Bitmap value, final in } /** - * 缓存中读取Bitmap + * 缓存中读取 Bitmap * * @param key 键 * @return 存在且没过期返回对应值,否则返回{@code null} @@ -389,7 +389,7 @@ public Bitmap getBitmap(@NonNull final String key) { } /** - * 缓存中读取Bitmap + * 缓存中读取 Bitmap * * @param key 键 * @param defaultValue 默认值 @@ -406,7 +406,7 @@ public Bitmap getBitmap(@NonNull final String key, final Bitmap defaultValue) { /////////////////////////////////////////////////////////////////////////// /** - * 缓存中写入Drawable + * 缓存中写入 Drawable * * @param key 键 * @param value 值 @@ -416,7 +416,7 @@ public void put(@NonNull final String key, @NonNull final Drawable value) { } /** - * 缓存中写入Drawable + * 缓存中写入 Drawable * * @param key 键 * @param value 值 @@ -427,7 +427,7 @@ public void put(@NonNull final String key, @NonNull final Drawable value, final } /** - * 缓存中读取Drawable + * 缓存中读取 Drawable * * @param key 键 * @return 存在且没过期返回对应值,否则返回{@code null} @@ -437,7 +437,7 @@ public Drawable getDrawable(@NonNull final String key) { } /** - * 缓存中读取Drawable + * 缓存中读取 Drawable * * @param key 键 * @param defaultValue 默认值 @@ -454,7 +454,7 @@ public Drawable getDrawable(@NonNull final String key, final Drawable defaultVal /////////////////////////////////////////////////////////////////////////// /** - * 缓存中写入Parcelable + * 缓存中写入 Parcelable * * @param key 键 * @param value 值 @@ -464,7 +464,7 @@ public void put(@NonNull final String key, @NonNull final Parcelable value) { } /** - * 缓存中写入Parcelable + * 缓存中写入 Parcelable * * @param key 键 * @param value 值 @@ -475,7 +475,7 @@ public void put(@NonNull final String key, @NonNull final Parcelable value, fina } /** - * 缓存中读取Parcelable + * 缓存中读取 Parcelable * * @param key 键 * @param creator 建造器 @@ -486,7 +486,7 @@ public单位:字节
- *调用了Thread.join(),需异步调用,否则可能主线程会卡顿
+ *调用了 Thread.join(),需异步调用,否则可能主线程会卡顿
* * @return 缓存大小 */ @@ -560,7 +560,7 @@ public long getCacheSize() { /** * 获取缓存个数 - *调用了Thread.join(),需异步调用,否则可能主线程会卡顿
+ *调用了 Thread.join(),需异步调用,否则可能主线程会卡顿
* * @return 缓存个数 */ diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/CleanUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/CleanUtils.java index 0c9a1622c4..fec189c512 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/CleanUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/CleanUtils.java @@ -60,7 +60,7 @@ public static boolean cleanInternalDbByName(final String dbName) { } /** - * 清除内部SP + * 清除内部 SP */data/data/com.xxx.xxx/shared_prefs
* * @return {@code true}: 清除成功例如:
* bytes2HexString(new byte[] { 0, (byte) 0xa8 }) returns 00A8 * * @param bytes 字节数组 - * @return 16进制大写字符串 + * @return 16 进制大写字符串 */ public static String bytes2HexString(final byte[] bytes) { if (bytes == null) return null; @@ -57,7 +57,7 @@ public static String bytes2HexString(final byte[] bytes) { } /** - * hexString转byteArr + * hexString 转 byteArr *例如:
* hexString2Bytes("00A8") returns { 0, (byte) 0xA8 } * @@ -80,9 +80,9 @@ public static byte[] hexString2Bytes(String hexString) { } /** - * hexChar转int + * hexChar 转 int * - * @param hexChar hex单个字节 + * @param hexChar hex 单个字节 * @return 0..15 */ private static int hex2Dec(final char hexChar) { @@ -96,7 +96,7 @@ private static int hex2Dec(final char hexChar) { } /** - * charArr转byteArr + * charArr 转 byteArr * * @param chars 字符数组 * @return 字节数组 @@ -112,7 +112,7 @@ public static byte[] chars2Bytes(final char[] chars) { } /** - * byteArr转charArr + * byteArr 转 charArr * * @param bytes 字节数组 * @return 字符数组 @@ -129,7 +129,7 @@ public static char[] bytes2Chars(final byte[] bytes) { } /** - * 以unit为单位的内存大小转字节数 + * 以 unit 为单位的内存大小转字节数 * * @param memorySize 大小 * @param unit 单位类型 @@ -147,7 +147,7 @@ public static long memorySize2Byte(final long memorySize, @MemoryConstants.Unit } /** - * 字节数转以unit为单位的内存大小 + * 字节数转以 unit 为单位的内存大小 * * @param byteNum 字节数 * @param unit 单位类型 @@ -157,7 +157,7 @@ public static long memorySize2Byte(final long memorySize, @MemoryConstants.Unit *保留3位小数
+ *保留 3 位小数
* * @param byteNum 字节数 * @return 合适内存大小 @@ -187,7 +187,7 @@ public static String byte2FitMemorySize(final long byteNum) { } /** - * 以unit为单位的时间长度转毫秒时间戳 + * 以 unit 为单位的时间长度转毫秒时间戳 * * @param timeSpan 毫秒时间戳 * @param unit 单位类型 @@ -205,7 +205,7 @@ public static long timeSpan2Millis(final long timeSpan, @TimeConstants.Unit fina } /** - * 毫秒时间戳转以unit为单位的时间长度 + * 毫秒时间戳转以 unit 为单位的时间长度 * * @param millis 毫秒时间戳 * @param unit 单位类型 @@ -216,7 +216,7 @@ public static long timeSpan2Millis(final long timeSpan, @TimeConstants.Unit fina *小于等于0,返回null
+ *小于等于 0,返回 null
* @param precision 精度 *需添加权限 {@code
需添加权限 {@code
需添加权限 {@code
需添加权限 {@code
如Xiaomi
+ *如 Xiaomi
* * @return 设备厂商 */ @@ -169,7 +169,7 @@ public static String getManufacturer() { /** * 获取设备型号 - *如MI2SC
+ *如 MI2SC
* * @return 设备型号 */ @@ -185,7 +185,7 @@ public static String getModel() { /** * 关机 - *需要root权限或者系统权限 {@code
需要 root 权限或者系统权限 {@code
需要root权限或者系统权限 {@code
需要 root 权限或者系统权限 {@code
需系统权限 {@code
需要root权限
+ * 重启到 recovery + *需要 root 权限
*/ public static void reboot2Recovery() { ShellUtils.execCmd("reboot recovery", true); } /** - * 重启到bootloader - *需要root权限
+ * 重启到 bootloader + *需要 root 权限
*/ public static void reboot2Bootloader() { ShellUtils.execCmd("reboot bootloader", true); diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/EncodeUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/EncodeUtils.java index 0baffab8cb..19d461ad2e 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/EncodeUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/EncodeUtils.java @@ -23,19 +23,19 @@ private EncodeUtils() { } /** - * URL编码 + * URL 编码 *若想自己指定字符集,可以使用{@link #urlEncode(String input, String charset)}方法
* * @param input 要编码的字符 - * @return 编码为UTF-8的字符串 + * @return 编码为 UTF-8 的字符串 */ public static String urlEncode(final String input) { return urlEncode(input, "UTF-8"); } /** - * URL编码 - *若系统不支持指定的编码字符集,则直接将input原样返回
+ * URL 编码 + *若系统不支持指定的编码字符集,则直接将 input 原样返回
* * @param input 要编码的字符 * @param charset 字符集 @@ -50,23 +50,23 @@ public static String urlEncode(final String input, final String charset) { } /** - * URL解码 + * URL 解码 *若想自己指定字符集,可以使用 {@link #urlDecode(String input, String charset)}方法
* * @param input 要解码的字符串 - * @return URL解码后的字符串 + * @return URL 解码后的字符串 */ public static String urlDecode(final String input) { return urlDecode(input, "UTF-8"); } /** - * URL解码 - *若系统不支持指定的解码字符集,则直接将input原样返回
+ * URL 解码 + *若系统不支持指定的解码字符集,则直接将 input 原样返回
* * @param input 要解码的字符串 * @param charset 字符集 - * @return URL解码为指定字符集的字符串 + * @return URL 解码为指定字符集的字符串 */ public static String urlDecode(final String input, final String charset) { try { @@ -77,71 +77,71 @@ public static String urlDecode(final String input, final String charset) { } /** - * Base64编码 + * Base64 编码 * * @param input 要编码的字符串 - * @return Base64编码后的字符串 + * @return Base64 编码后的字符串 */ public static byte[] base64Encode(final String input) { return base64Encode(input.getBytes()); } /** - * Base64编码 + * Base64 编码 * * @param input 要编码的字节数组 - * @return Base64编码后的字符串 + * @return Base64 编码后的字符串 */ public static byte[] base64Encode(final byte[] input) { return Base64.encode(input, Base64.NO_WRAP); } /** - * Base64编码 + * Base64 编码 * * @param input 要编码的字节数组 - * @return Base64编码后的字符串 + * @return Base64 编码后的字符串 */ public static String base64Encode2String(final byte[] input) { return Base64.encodeToString(input, Base64.NO_WRAP); } /** - * Base64解码 + * Base64 解码 * * @param input 要解码的字符串 - * @return Base64解码后的字符串 + * @return Base64 解码后的字符串 */ public static byte[] base64Decode(final String input) { return Base64.decode(input, Base64.NO_WRAP); } /** - * Base64解码 + * Base64 解码 * * @param input 要解码的字符串 - * @return Base64解码后的字符串 + * @return Base64 解码后的字符串 */ public static byte[] base64Decode(final byte[] input) { return Base64.decode(input, Base64.NO_WRAP); } /** - * Base64URL安全编码 - *将Base64中的URL非法字符�?,/=转为其他字符, 见RFC3548
+ * Base64URL 安全编码 + *将 Base64 中的 URL 非法字符�?,/=转为其他字符, 见 RFC3548
* - * @param input 要Base64URL安全编码的字符串 - * @return Base64URL安全编码后的字符串 + * @param input 要 Base64URL 安全编码的字符串 + * @return Base64URL 安全编码后的字符串 */ public static byte[] base64UrlSafeEncode(final String input) { return Base64.encode(input.getBytes(), Base64.URL_SAFE); } /** - * Html编码 + * Html 编码 * - * @param input 要Html编码的字符串 - * @return Html编码后的字符串 + * @param input 要 Html 编码的字符串 + * @return Html 编码后的字符串 */ public static String htmlEncode(final CharSequence input) { StringBuilder sb = new StringBuilder(); @@ -177,10 +177,10 @@ public static String htmlEncode(final CharSequence input) { } /** - * Html解码 + * Html 解码 * * @param input 待解码的字符串 - * @return Html解码后的字符串 + * @return Html 解码后的字符串 */ @SuppressWarnings("deprecation") public static CharSequence htmlDecode(final String input) { diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/EncryptUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/EncryptUtils.java index 8d0d9b7585..23421c1f2b 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/EncryptUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/EncryptUtils.java @@ -34,27 +34,27 @@ private EncryptUtils() { /////////////////////////////////////////////////////////////////////////// /** - * MD2加密 + * MD2 加密 * * @param data 明文字符串 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptMD2ToString(final String data) { return encryptMD2ToString(data.getBytes()); } /** - * MD2加密 + * MD2 加密 * * @param data 明文字节数组 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptMD2ToString(final byte[] data) { return bytes2HexString(encryptMD2(data)); } /** - * MD2加密 + * MD2 加密 * * @param data 明文字节数组 * @return 密文字节数组 @@ -64,42 +64,42 @@ public static byte[] encryptMD2(final byte[] data) { } /** - * MD5加密 + * MD5 加密 * * @param data 明文字符串 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptMD5ToString(final String data) { return encryptMD5ToString(data.getBytes()); } /** - * MD5加密 + * MD5 加密 * * @param data 明文字符串 * @param salt 盐 - * @return 16进制加盐密文 + * @return 16 进制加盐密文 */ public static String encryptMD5ToString(final String data, final String salt) { return bytes2HexString(encryptMD5((data + salt).getBytes())); } /** - * MD5加密 + * MD5 加密 * * @param data 明文字节数组 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptMD5ToString(final byte[] data) { return bytes2HexString(encryptMD5(data)); } /** - * MD5加密 + * MD5 加密 * * @param data 明文字节数组 * @param salt 盐字节数组 - * @return 16进制加盐密文 + * @return 16 进制加盐密文 */ public static String encryptMD5ToString(final byte[] data, final byte[] salt) { if (data == null || salt == null) return null; @@ -110,7 +110,7 @@ public static String encryptMD5ToString(final byte[] data, final byte[] salt) { } /** - * MD5加密 + * MD5 加密 * * @param data 明文字节数组 * @return 密文字节数组 @@ -120,10 +120,10 @@ public static byte[] encryptMD5(final byte[] data) { } /** - * MD5加密文件 + * MD5 加密文件 * * @param filePath 文件路径 - * @return 文件的16进制密文 + * @return 文件的 16 进制密文 */ public static String encryptMD5File2String(final String filePath) { File file = isSpace(filePath) ? null : new File(filePath); @@ -131,10 +131,10 @@ public static String encryptMD5File2String(final String filePath) { } /** - * MD5加密文件 + * MD5 加密文件 * * @param filePath 文件路径 - * @return 文件的MD5校验码 + * @return 文件的 MD5 校验码 */ public static byte[] encryptMD5File(final String filePath) { File file = isSpace(filePath) ? null : new File(filePath); @@ -142,20 +142,20 @@ public static byte[] encryptMD5File(final String filePath) { } /** - * MD5加密文件 + * MD5 加密文件 * * @param file 文件 - * @return 文件的16进制密文 + * @return 文件的 16 进制密文 */ public static String encryptMD5File2String(final File file) { return bytes2HexString(encryptMD5File(file)); } /** - * MD5加密文件 + * MD5 加密文件 * * @param file 文件 - * @return 文件的MD5校验码 + * @return 文件的 MD5 校验码 */ public static byte[] encryptMD5File(final File file) { if (file == null) return null; @@ -180,27 +180,27 @@ public static byte[] encryptMD5File(final File file) { } /** - * SHA1加密 + * SHA1 加密 * * @param data 明文字符串 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptSHA1ToString(final String data) { return encryptSHA1ToString(data.getBytes()); } /** - * SHA1加密 + * SHA1 加密 * * @param data 明文字节数组 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptSHA1ToString(final byte[] data) { return bytes2HexString(encryptSHA1(data)); } /** - * SHA1加密 + * SHA1 加密 * * @param data 明文字节数组 * @return 密文字节数组 @@ -210,27 +210,27 @@ public static byte[] encryptSHA1(final byte[] data) { } /** - * SHA224加密 + * SHA224 加密 * * @param data 明文字符串 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptSHA224ToString(final String data) { return encryptSHA224ToString(data.getBytes()); } /** - * SHA224加密 + * SHA224 加密 * * @param data 明文字节数组 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptSHA224ToString(final byte[] data) { return bytes2HexString(encryptSHA224(data)); } /** - * SHA224加密 + * SHA224 加密 * * @param data 明文字节数组 * @return 密文字节数组 @@ -240,27 +240,27 @@ public static byte[] encryptSHA224(final byte[] data) { } /** - * SHA256加密 + * SHA256 加密 * * @param data 明文字符串 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptSHA256ToString(final String data) { return encryptSHA256ToString(data.getBytes()); } /** - * SHA256加密 + * SHA256 加密 * * @param data 明文字节数组 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptSHA256ToString(final byte[] data) { return bytes2HexString(encryptSHA256(data)); } /** - * SHA256加密 + * SHA256 加密 * * @param data 明文字节数组 * @return 密文字节数组 @@ -270,27 +270,27 @@ public static byte[] encryptSHA256(final byte[] data) { } /** - * SHA384加密 + * SHA384 加密 * * @param data 明文字符串 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptSHA384ToString(final String data) { return encryptSHA384ToString(data.getBytes()); } /** - * SHA384加密 + * SHA384 加密 * * @param data 明文字节数组 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptSHA384ToString(final byte[] data) { return bytes2HexString(encryptSHA384(data)); } /** - * SHA384加密 + * SHA384 加密 * * @param data 明文字节数组 * @return 密文字节数组 @@ -300,27 +300,27 @@ public static byte[] encryptSHA384(final byte[] data) { } /** - * SHA512加密 + * SHA512 加密 * * @param data 明文字符串 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptSHA512ToString(final String data) { return encryptSHA512ToString(data.getBytes()); } /** - * SHA512加密 + * SHA512 加密 * * @param data 明文字节数组 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptSHA512ToString(final byte[] data) { return bytes2HexString(encryptSHA512(data)); } /** - * SHA512加密 + * SHA512 加密 * * @param data 明文字节数组 * @return 密文字节数组 @@ -330,7 +330,7 @@ public static byte[] encryptSHA512(final byte[] data) { } /** - * hash加密模板 + * hash 加密模板 * * @param data 数据 * @param algorithm 加密算法 @@ -349,29 +349,29 @@ private static byte[] hashTemplate(final byte[] data, final String algorithm) { } /** - * HmacMD5加密 + * HmacMD5 加密 * * @param data 明文字符串 * @param key 秘钥 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptHmacMD5ToString(final String data, final String key) { return encryptHmacMD5ToString(data.getBytes(), key.getBytes()); } /** - * HmacMD5加密 + * HmacMD5 加密 * * @param data 明文字节数组 * @param key 秘钥 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptHmacMD5ToString(final byte[] data, final byte[] key) { return bytes2HexString(encryptHmacMD5(data, key)); } /** - * HmacMD5加密 + * HmacMD5 加密 * * @param data 明文字节数组 * @param key 秘钥 @@ -382,29 +382,29 @@ public static byte[] encryptHmacMD5(final byte[] data, final byte[] key) { } /** - * HmacSHA1加密 + * HmacSHA1 加密 * * @param data 明文字符串 * @param key 秘钥 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptHmacSHA1ToString(final String data, final String key) { return encryptHmacSHA1ToString(data.getBytes(), key.getBytes()); } /** - * HmacSHA1加密 + * HmacSHA1 加密 * * @param data 明文字节数组 * @param key 秘钥 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptHmacSHA1ToString(final byte[] data, final byte[] key) { return bytes2HexString(encryptHmacSHA1(data, key)); } /** - * HmacSHA1加密 + * HmacSHA1 加密 * * @param data 明文字节数组 * @param key 秘钥 @@ -415,29 +415,29 @@ public static byte[] encryptHmacSHA1(final byte[] data, final byte[] key) { } /** - * HmacSHA224加密 + * HmacSHA224 加密 * * @param data 明文字符串 * @param key 秘钥 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptHmacSHA224ToString(final String data, final String key) { return encryptHmacSHA224ToString(data.getBytes(), key.getBytes()); } /** - * HmacSHA224加密 + * HmacSHA224 加密 * * @param data 明文字节数组 * @param key 秘钥 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptHmacSHA224ToString(final byte[] data, final byte[] key) { return bytes2HexString(encryptHmacSHA224(data, key)); } /** - * HmacSHA224加密 + * HmacSHA224 加密 * * @param data 明文字节数组 * @param key 秘钥 @@ -448,29 +448,29 @@ public static byte[] encryptHmacSHA224(final byte[] data, final byte[] key) { } /** - * HmacSHA256加密 + * HmacSHA256 加密 * * @param data 明文字符串 * @param key 秘钥 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptHmacSHA256ToString(final String data, final String key) { return encryptHmacSHA256ToString(data.getBytes(), key.getBytes()); } /** - * HmacSHA256加密 + * HmacSHA256 加密 * * @param data 明文字节数组 * @param key 秘钥 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptHmacSHA256ToString(final byte[] data, final byte[] key) { return bytes2HexString(encryptHmacSHA256(data, key)); } /** - * HmacSHA256加密 + * HmacSHA256 加密 * * @param data 明文字节数组 * @param key 秘钥 @@ -481,29 +481,29 @@ public static byte[] encryptHmacSHA256(final byte[] data, final byte[] key) { } /** - * HmacSHA384加密 + * HmacSHA384 加密 * * @param data 明文字符串 * @param key 秘钥 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptHmacSHA384ToString(final String data, final String key) { return encryptHmacSHA384ToString(data.getBytes(), key.getBytes()); } /** - * HmacSHA384加密 + * HmacSHA384 加密 * * @param data 明文字节数组 * @param key 秘钥 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptHmacSHA384ToString(final byte[] data, final byte[] key) { return bytes2HexString(encryptHmacSHA384(data, key)); } /** - * HmacSHA384加密 + * HmacSHA384 加密 * * @param data 明文字节数组 * @param key 秘钥 @@ -514,29 +514,29 @@ public static byte[] encryptHmacSHA384(final byte[] data, final byte[] key) { } /** - * HmacSHA512加密 + * HmacSHA512 加密 * * @param data 明文字符串 * @param key 秘钥 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptHmacSHA512ToString(final String data, final String key) { return encryptHmacSHA512ToString(data.getBytes(), key.getBytes()); } /** - * HmacSHA512加密 + * HmacSHA512 加密 * * @param data 明文字节数组 * @param key 秘钥 - * @return 16进制密文 + * @return 16 进制密文 */ public static String encryptHmacSHA512ToString(final byte[] data, final byte[] key) { return bytes2HexString(encryptHmacSHA512(data, key)); } /** - * HmacSHA512加密 + * HmacSHA512 加密 * * @param data 明文字节数组 * @param key 秘钥 @@ -547,7 +547,7 @@ public static byte[] encryptHmacSHA512(final byte[] data, final byte[] key) { } /** - * Hmac加密模板 + * Hmac 加密模板 * * @param data 数据 * @param key 秘钥 @@ -568,45 +568,45 @@ private static byte[] hmacTemplate(final byte[] data, final byte[] key, final St } /////////////////////////////////////////////////////////////////////////// - // DES加密相关 + // DES 加密相关 /////////////////////////////////////////////////////////////////////////// /** - * DES转变 + * DES 转变 *法算法名称/加密模式/填充方式
- *加密模式有:电子密码本模式ECB、加密块链模式CBC、加密反馈模式CFB、输出反馈模式OFB
+ *加密模式有:电子密码本模式 ECB、加密块链模式 CBC、加密反馈模式 CFB、输出反馈模式 OFB
*填充方式有:NoPadding、ZerosPadding、PKCS5Padding
*/ public static String DES_Transformation = "DES/ECB/NoPadding"; private static final String DES_Algorithm = "DES"; /** - * DES加密后转为Base64编码 + * DES 加密后转为 Base64 编码 * * @param data 明文 - * @param key 8字节秘钥 - * @return Base64密文 + * @param key 8 字节秘钥 + * @return Base64 密文 */ public static byte[] encryptDES2Base64(final byte[] data, final byte[] key) { return base64Encode(encryptDES(data, key)); } /** - * DES加密后转为16进制 + * DES 加密后转为 16 进制 * * @param data 明文 - * @param key 8字节秘钥 - * @return 16进制密文 + * @param key 8 字节秘钥 + * @return 16 进制密文 */ public static String encryptDES2HexString(final byte[] data, final byte[] key) { return bytes2HexString(encryptDES(data, key)); } /** - * DES加密 + * DES 加密 * * @param data 明文 - * @param key 8字节秘钥 + * @param key 8 字节秘钥 * @return 密文 */ public static byte[] encryptDES(final byte[] data, final byte[] key) { @@ -614,10 +614,10 @@ public static byte[] encryptDES(final byte[] data, final byte[] key) { } /** - * DES解密Base64编码密文 + * DES 解密 Base64 编码密文 * - * @param data Base64编码密文 - * @param key 8字节秘钥 + * @param data Base64 编码密文 + * @param key 8 字节秘钥 * @return 明文 */ public static byte[] decryptBase64DES(final byte[] data, final byte[] key) { @@ -625,10 +625,10 @@ public static byte[] decryptBase64DES(final byte[] data, final byte[] key) { } /** - * DES解密16进制密文 + * DES 解密 16 进制密文 * - * @param data 16进制密文 - * @param key 8字节秘钥 + * @param data 16 进制密文 + * @param key 8 字节秘钥 * @return 明文 */ public static byte[] decryptHexStringDES(final String data, final byte[] key) { @@ -636,10 +636,10 @@ public static byte[] decryptHexStringDES(final String data, final byte[] key) { } /** - * DES解密 + * DES 解密 * * @param data 密文 - * @param key 8字节秘钥 + * @param key 8 字节秘钥 * @return 明文 */ public static byte[] decryptDES(final byte[] data, final byte[] key) { @@ -647,13 +647,13 @@ public static byte[] decryptDES(final byte[] data, final byte[] key) { } /////////////////////////////////////////////////////////////////////////// - // 3DES加密相关 + // 3DES 加密相关 /////////////////////////////////////////////////////////////////////////// /** - * 3DES转变 + * 3DES 转变 *法算法名称/加密模式/填充方式
- *加密模式有:电子密码本模式ECB、加密块链模式CBC、加密反馈模式CFB、输出反馈模式OFB
+ *加密模式有:电子密码本模式 ECB、加密块链模式 CBC、加密反馈模式 CFB、输出反馈模式 OFB
*填充方式有:NoPadding、ZerosPadding、PKCS5Padding
*/ public static String TripleDES_Transformation = "DESede/ECB/NoPadding"; @@ -661,32 +661,32 @@ public static byte[] decryptDES(final byte[] data, final byte[] key) { /** - * 3DES加密后转为Base64编码 + * 3DES 加密后转为 Base64 编码 * * @param data 明文 - * @param key 24字节秘钥 - * @return Base64密文 + * @param key 24 字节秘钥 + * @return Base64 密文 */ public static byte[] encrypt3DES2Base64(final byte[] data, final byte[] key) { return base64Encode(encrypt3DES(data, key)); } /** - * 3DES加密后转为16进制 + * 3DES 加密后转为 16 进制 * * @param data 明文 - * @param key 24字节秘钥 - * @return 16进制密文 + * @param key 24 字节秘钥 + * @return 16 进制密文 */ public static String encrypt3DES2HexString(final byte[] data, final byte[] key) { return bytes2HexString(encrypt3DES(data, key)); } /** - * 3DES加密 + * 3DES 加密 * * @param data 明文 - * @param key 24字节密钥 + * @param key 24 字节密钥 * @return 密文 */ public static byte[] encrypt3DES(final byte[] data, final byte[] key) { @@ -694,10 +694,10 @@ public static byte[] encrypt3DES(final byte[] data, final byte[] key) { } /** - * 3DES解密Base64编码密文 + * 3DES 解密 Base64 编码密文 * - * @param data Base64编码密文 - * @param key 24字节秘钥 + * @param data Base64 编码密文 + * @param key 24 字节秘钥 * @return 明文 */ public static byte[] decryptBase64_3DES(final byte[] data, final byte[] key) { @@ -705,10 +705,10 @@ public static byte[] decryptBase64_3DES(final byte[] data, final byte[] key) { } /** - * 3DES解密16进制密文 + * 3DES 解密 16 进制密文 * - * @param data 16进制密文 - * @param key 24字节秘钥 + * @param data 16 进制密文 + * @param key 24 字节秘钥 * @return 明文 */ public static byte[] decryptHexString3DES(final String data, final byte[] key) { @@ -716,10 +716,10 @@ public static byte[] decryptHexString3DES(final String data, final byte[] key) { } /** - * 3DES解密 + * 3DES 解密 * * @param data 密文 - * @param key 24字节密钥 + * @param key 24 字节密钥 * @return 明文 */ public static byte[] decrypt3DES(final byte[] data, final byte[] key) { @@ -727,13 +727,13 @@ public static byte[] decrypt3DES(final byte[] data, final byte[] key) { } /////////////////////////////////////////////////////////////////////////// - // AES加密相关 + // AES 加密相关 /////////////////////////////////////////////////////////////////////////// /** - * AES转变 + * AES 转变 *法算法名称/加密模式/填充方式
- *加密模式有:电子密码本模式ECB、加密块链模式CBC、加密反馈模式CFB、输出反馈模式OFB
+ *加密模式有:电子密码本模式 ECB、加密块链模式 CBC、加密反馈模式 CFB、输出反馈模式 OFB
*填充方式有:NoPadding、ZerosPadding、PKCS5Padding
*/ public static String AES_Transformation = "AES/ECB/NoPadding"; @@ -741,32 +741,32 @@ public static byte[] decrypt3DES(final byte[] data, final byte[] key) { /** - * AES加密后转为Base64编码 + * AES 加密后转为 Base64 编码 * * @param data 明文 - * @param key 16、24、32字节秘钥 - * @return Base64密文 + * @param key 16、24、32 字节秘钥 + * @return Base64 密文 */ public static byte[] encryptAES2Base64(final byte[] data, final byte[] key) { return base64Encode(encryptAES(data, key)); } /** - * AES加密后转为16进制 + * AES 加密后转为 16 进制 * * @param data 明文 - * @param key 16、24、32字节秘钥 - * @return 16进制密文 + * @param key 16、24、32 字节秘钥 + * @return 16 进制密文 */ public static String encryptAES2HexString(final byte[] data, final byte[] key) { return bytes2HexString(encryptAES(data, key)); } /** - * AES加密 + * AES 加密 * * @param data 明文 - * @param key 16、24、32字节秘钥 + * @param key 16、24、32 字节秘钥 * @return 密文 */ public static byte[] encryptAES(final byte[] data, final byte[] key) { @@ -774,10 +774,10 @@ public static byte[] encryptAES(final byte[] data, final byte[] key) { } /** - * AES解密Base64编码密文 + * AES 解密 Base64 编码密文 * - * @param data Base64编码密文 - * @param key 16、24、32字节秘钥 + * @param data Base64 编码密文 + * @param key 16、24、32 字节秘钥 * @return 明文 */ public static byte[] decryptBase64AES(final byte[] data, final byte[] key) { @@ -785,10 +785,10 @@ public static byte[] decryptBase64AES(final byte[] data, final byte[] key) { } /** - * AES解密16进制密文 + * AES 解密 16 进制密文 * - * @param data 16进制密文 - * @param key 16、24、32字节秘钥 + * @param data 16 进制密文 + * @param key 16、24、32 字节秘钥 * @return 明文 */ public static byte[] decryptHexStringAES(final String data, final byte[] key) { @@ -796,10 +796,10 @@ public static byte[] decryptHexStringAES(final String data, final byte[] key) { } /** - * AES解密 + * AES 解密 * * @param data 密文 - * @param key 16、24、32字节秘钥 + * @param key 16、24、32 字节秘钥 * @return 明文 */ public static byte[] decryptAES(final byte[] data, final byte[] key) { @@ -807,14 +807,14 @@ public static byte[] decryptAES(final byte[] data, final byte[] key) { } /** - * DES加密模板 + * DES 加密模板 * * @param data 数据 * @param key 秘钥 * @param algorithm 加密算法 * @param transformation 转变 * @param isEncrypt {@code true}: 加密 {@code false}: 解密 - * @return 密文或者明文,适用于DES,3DES,AES + * @return 密文或者明文,适用于 DES,3DES,AES */ public static byte[] desTemplate(final byte[] data, final byte[] key, final String algorithm, final String transformation, final boolean isEncrypt) { if (data == null || data.length == 0 || key == null || key.length == 0) return null; diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/FileUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/FileUtils.java index d3cce555a7..958fd115db 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/FileUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/FileUtils.java @@ -80,16 +80,16 @@ public static boolean rename(final String filePath, final String newName) { * @return {@code true}: 重命名成功比readLine要快很多
+ *比 readLine 要快很多
* * @param file 文件 * @return 文件行数 @@ -881,10 +881,10 @@ public static long getFileLength(final File file) { } /** - * 获取文件的MD5校验码 + * 获取文件的 MD5 校验码 * * @param filePath 文件路径 - * @return 文件的MD5校验码 + * @return 文件的 MD5 校验码 */ public static String getFileMD5ToString(final String filePath) { File file = isSpace(filePath) ? null : new File(filePath); @@ -892,30 +892,30 @@ public static String getFileMD5ToString(final String filePath) { } /** - * 获取文件的MD5校验码 + * 获取文件的 MD5 校验码 * * @param file 文件 - * @return 文件的MD5校验码 + * @return 文件的 MD5 校验码 */ public static String getFileMD5ToString(final File file) { return bytes2HexString(getFileMD5(file)); } /** - * 获取文件的MD5校验码 + * 获取文件的 MD5 校验码 * * @param filePath 文件路径 - * @return 文件的MD5校验码 + * @return 文件的 MD5 校验码 */ public static byte[] getFileMD5(final String filePath) { return getFileMD5(getFileByPath(filePath)); } /** - * 获取文件的MD5校验码 + * 获取文件的 MD5 校验码 * * @param file 文件 - * @return 文件的MD5校验码 + * @return 文件的 MD5 校验码 */ public static byte[] getFileMD5(final File file) { if (file == null) return null; @@ -942,7 +942,7 @@ public static byte[] getFileMD5(final File file) { * 获取全路径中的最长目录 * * @param file 文件 - * @return filePath最长目录 + * @return filePath 最长目录 */ public static String getDirName(final File file) { if (file == null) return null; @@ -953,7 +953,7 @@ public static String getDirName(final File file) { * 获取全路径中的最长目录 * * @param filePath 文件路径 - * @return filePath最长目录 + * @return filePath 最长目录 */ public static String getDirName(final String filePath) { if (isSpace(filePath)) return filePath; @@ -1046,12 +1046,12 @@ public static String getFileExtension(final String filePath) { private static final char hexDigits[] = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'}; /** - * byteArr转hexString + * byteArr 转 hexString *例如:
* bytes2HexString(new byte[] { 0, (byte) 0xa8 }) returns 00A8 * * @param bytes 字节数组 - * @return 16进制大写字符串 + * @return 16 进制大写字符串 */ private static String bytes2HexString(final byte[] bytes) { if (bytes == null) return null; @@ -1067,7 +1067,7 @@ private static String bytes2HexString(final byte[] bytes) { /** * 字节数转合适内存大小 - *保留3位小数
+ *保留 3 位小数
* * @param byteNum 字节数 * @return 合适内存大小 diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/FragmentUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/FragmentUtils.java index e60e232c39..0d6c995ae2 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/FragmentUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/FragmentUtils.java @@ -24,7 +24,7 @@ * author: Blankj * blog : http://blankj.com * time : 2017/01/17 - * desc : Fragment相关工具类 + * desc : Fragment 相关工具类 * */ public final class FragmentUtils { @@ -46,11 +46,11 @@ private FragmentUtils() { } /** - * 新增fragment + * 新增 fragment * - * @param fm fragment管理器 - * @param containerId 布局Id - * @param add 要新增的fragment + * @param fm fragment 管理器 + * @param containerId 布局 Id + * @param add 要新增的 fragment */ public static void add(@NonNull final FragmentManager fm, @NonNull final Fragment add, @@ -59,11 +59,11 @@ public static void add(@NonNull final FragmentManager fm, } /** - * 新增fragment + * 新增 fragment * - * @param fm fragment管理器 - * @param containerId 布局Id - * @param add 要新增的fragment + * @param fm fragment 管理器 + * @param containerId 布局 Id + * @param add 要新增的 fragment * @param isHide 是否隐藏 */ public static void add(@NonNull final FragmentManager fm, @@ -74,11 +74,11 @@ public static void add(@NonNull final FragmentManager fm, } /** - * 新增fragment + * 新增 fragment * - * @param fm fragment管理器 - * @param containerId 布局Id - * @param add 要新增的fragment + * @param fm fragment 管理器 + * @param containerId 布局 Id + * @param add 要新增的 fragment * @param isHide 是否隐藏 * @param isAddStack 是否入回退栈 */ @@ -92,11 +92,11 @@ public static void add(@NonNull final FragmentManager fm, } /** - * 新增fragment + * 新增 fragment * - * @param fm fragment管理器 - * @param containerId 布局Id - * @param add 要新增的fragment + * @param fm fragment 管理器 + * @param containerId 布局 Id + * @param add 要新增的 fragment * @param enterAnim 入场动画 * @param exitAnim 出场动画 */ @@ -109,11 +109,11 @@ public static void add(@NonNull final FragmentManager fm, } /** - * 新增fragment + * 新增 fragment * - * @param fm fragment管理器 - * @param containerId 布局Id - * @param add 要新增的fragment + * @param fm fragment 管理器 + * @param containerId 布局 Id + * @param add 要新增的 fragment * @param isAddStack 是否入回退栈 * @param enterAnim 入场动画 * @param exitAnim 出场动画 @@ -128,11 +128,11 @@ public static void add(@NonNull final FragmentManager fm, } /** - * 新增fragment + * 新增 fragment * - * @param fm fragment管理器 - * @param containerId 布局Id - * @param add 要新增的fragment + * @param fm fragment 管理器 + * @param containerId 布局 Id + * @param add 要新增的 fragment * @param enterAnim 入场动画 * @param exitAnim 出场动画 * @param popEnterAnim 入栈动画 @@ -149,11 +149,11 @@ public static void add(@NonNull final FragmentManager fm, } /** - * 新增fragment + * 新增 fragment * - * @param fm fragment管理器 - * @param containerId 布局Id - * @param add 要新增的fragment + * @param fm fragment 管理器 + * @param containerId 布局 Id + * @param add 要新增的 fragment * @param isAddStack 是否入回退栈 * @param enterAnim 入场动画 * @param exitAnim 出场动画 @@ -175,11 +175,11 @@ public static void add(@NonNull final FragmentManager fm, } /** - * 新增fragment + * 新增 fragment * - * @param fm fragment管理器 - * @param add 新增的fragment - * @param containerId 布局Id + * @param fm fragment 管理器 + * @param add 新增的 fragment + * @param containerId 布局 Id * @param sharedElements 共享元素 */ public static void add(@NonNull final FragmentManager fm, @@ -190,11 +190,11 @@ public static void add(@NonNull final FragmentManager fm, } /** - * 新增fragment + * 新增 fragment * - * @param fm fragment管理器 - * @param add 新增的fragment - * @param containerId 布局Id + * @param fm fragment 管理器 + * @param add 新增的 fragment + * @param containerId 布局 Id * @param isAddStack 是否入回退栈 * @param sharedElements 共享元素 */ @@ -210,12 +210,12 @@ public static void add(@NonNull final FragmentManager fm, } /** - * 新增fragment + * 新增 fragment * - * @param fm fragment管理器 - * @param add 新增的fragment - * @param containerId 布局Id - * @param showIndex 要显示的fragment索引 + * @param fm fragment 管理器 + * @param add 新增的 fragment + * @param containerId 布局 Id + * @param showIndex 要显示的 fragment 索引 */ public static void add(@NonNull final FragmentManager fm, @NonNull final List如果fragment实现了OnBackClickListener接口,返回{@code true}: 表示已消费回退键事件,反之则没消费
- *具体示例见FragmentActivity
+ * 处理 fragment 回退键 + *如果 fragment 实现了 OnBackClickListener 接口,返回{@code true}: 表示已消费回退键事件,反之则没消费
+ *具体示例见 FragmentActivity
* * @param fragment fragment * @return 是否消费回退事件 @@ -1043,11 +1043,11 @@ public static boolean dispatchBackPress(@NonNull final Fragment fragment) { } /** - * 处理fragment回退键 - *如果fragment实现了OnBackClickListener接口,返回{@code true}: 表示已消费回退键事件,反之则没消费
- *具体示例见FragmentActivity
+ * 处理 fragment 回退键 + *如果 fragment 实现了 OnBackClickListener 接口,返回{@code true}: 表示已消费回退键事件,反之则没消费
+ *具体示例见 FragmentActivity
* - * @param fm fragment管理器 + * @param fm fragment 管理器 * @return 是否消费回退事件 */ public static boolean dispatchBackPress(@NonNull final FragmentManager fm) { @@ -1084,7 +1084,7 @@ public static void setBackgroundColor(@NonNull final Fragment fragment, @ColorIn * 设置背景资源 * * @param fragment fragment - * @param resId 资源Id + * @param resId 资源 Id */ public static void setBackgroundResource(@NonNull final Fragment fragment, @DrawableRes final int resId) { View view = fragment.getView(); diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/ImageUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/ImageUtils.java index 795802d969..1adf685d8f 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/ImageUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/ImageUtils.java @@ -62,9 +62,9 @@ private ImageUtils() { } /** - * bitmap转byteArr + * bitmap 转 byteArr * - * @param bitmap bitmap对象 + * @param bitmap bitmap 对象 * @param format 格式 * @return 字节数组 */ @@ -76,7 +76,7 @@ public static byte[] bitmap2Bytes(final Bitmap bitmap, final CompressFormat form } /** - * byteArr转bitmap + * byteArr 转 bitmap * * @param bytes 字节数组 * @return bitmap @@ -86,9 +86,9 @@ public static Bitmap bytes2Bitmap(final byte[] bytes) { } /** - * drawable转bitmap + * drawable 转 bitmap * - * @param drawable drawable对象 + * @param drawable drawable 对象 * @return bitmap */ public static Bitmap drawable2Bitmap(final Drawable drawable) { @@ -113,9 +113,9 @@ public static Bitmap drawable2Bitmap(final Drawable drawable) { } /** - * bitmap转drawable + * bitmap 转 drawable * - * @param bitmap bitmap对象 + * @param bitmap bitmap 对象 * @return drawable */ public static Drawable bitmap2Drawable(final Bitmap bitmap) { @@ -123,9 +123,9 @@ public static Drawable bitmap2Drawable(final Bitmap bitmap) { } /** - * drawable转byteArr + * drawable 转 byteArr * - * @param drawable drawable对象 + * @param drawable drawable 对象 * @param format 格式 * @return 字节数组 */ @@ -134,7 +134,7 @@ public static byte[] drawable2Bytes(final Drawable drawable, final CompressForma } /** - * byteArr转drawable + * byteArr 转 drawable * * @param bytes 字节数组 * @return drawable @@ -144,7 +144,7 @@ public static Drawable bytes2Drawable(final byte[] bytes) { } /** - * view转bitmap + * view 转 bitmap * * @param view 视图 * @return bitmap @@ -164,7 +164,7 @@ public static Bitmap view2Bitmap(final View view) { } /** - * 获取bitmap + * 获取 bitmap * * @param file 文件 * @return bitmap @@ -175,7 +175,7 @@ public static Bitmap getBitmap(final File file) { } /** - * 获取bitmap + * 获取 bitmap * * @param file 文件 * @param maxWidth 最大宽度 @@ -193,7 +193,7 @@ public static Bitmap getBitmap(final File file, final int maxWidth, final int ma } /** - * 获取bitmap + * 获取 bitmap * * @param filePath 文件路径 * @return bitmap @@ -204,7 +204,7 @@ public static Bitmap getBitmap(final String filePath) { } /** - * 获取bitmap + * 获取 bitmap * * @param filePath 文件路径 * @param maxWidth 最大宽度 @@ -222,7 +222,7 @@ public static Bitmap getBitmap(final String filePath, final int maxWidth, final } /** - * 获取bitmap + * 获取 bitmap * * @param is 输入流 * @return bitmap @@ -233,7 +233,7 @@ public static Bitmap getBitmap(final InputStream is) { } /** - * 获取bitmap + * 获取 bitmap * * @param is 输入流 * @param maxWidth 最大宽度 @@ -247,7 +247,7 @@ public static Bitmap getBitmap(final InputStream is, final int maxWidth, final i } /** - * 获取bitmap + * 获取 bitmap * * @param data 数据 * @param offset 偏移量 @@ -259,7 +259,7 @@ public static Bitmap getBitmap(final byte[] data, final int offset) { } /** - * 获取bitmap + * 获取 bitmap * * @param data 数据 * @param offset 偏移量 @@ -278,9 +278,9 @@ public static Bitmap getBitmap(final byte[] data, final int offset, final int ma } /** - * 获取bitmap + * 获取 bitmap * - * @param resId 资源id + * @param resId 资源 id * @return bitmap */ public static Bitmap getBitmap(@DrawableRes final int resId) { @@ -294,9 +294,9 @@ public static Bitmap getBitmap(@DrawableRes final int resId) { } /** - * 获取bitmap + * 获取 bitmap * - * @param resId 资源id + * @param resId 资源 id * @param maxWidth 最大宽度 * @param maxHeight 最大高度 * @return bitmap @@ -312,7 +312,7 @@ public static Bitmap getBitmap(@DrawableRes final int resId, final int maxWidth, } /** - * 获取bitmap + * 获取 bitmap * * @param fd 文件描述 * @return bitmap @@ -323,7 +323,7 @@ public static Bitmap getBitmap(final FileDescriptor fd) { } /** - * 获取bitmap + * 获取 bitmap * * @param fd 文件描述 * @param maxWidth 最大宽度 @@ -402,8 +402,8 @@ public static Bitmap scale(final Bitmap src, final float scaleWidth, final float * 裁剪图片 * * @param src 源图片 - * @param x 开始坐标x - * @param y 开始坐标y + * @param x 开始坐标 x + * @param y 开始坐标 y * @param width 裁剪宽度 * @param height 裁剪高度 * @return 裁剪后的图片 @@ -416,8 +416,8 @@ public static Bitmap clip(final Bitmap src, final int x, final int y, final int * 裁剪图片 * * @param src 源图片 - * @param x 开始坐标x - * @param y 开始坐标y + * @param x 开始坐标 x + * @param y 开始坐标 y * @param width 裁剪宽度 * @param height 裁剪高度 * @param recycle 是否回收 @@ -434,8 +434,8 @@ public static Bitmap clip(final Bitmap src, final int x, final int y, final int * 倾斜图片 * * @param src 源图片 - * @param kx 倾斜因子x - * @param ky 倾斜因子y + * @param kx 倾斜因子 x + * @param ky 倾斜因子 y * @return 倾斜后的图片 */ public static Bitmap skew(final Bitmap src, final float kx, final float ky) { @@ -446,8 +446,8 @@ public static Bitmap skew(final Bitmap src, final float kx, final float ky) { * 倾斜图片 * * @param src 源图片 - * @param kx 倾斜因子x - * @param ky 倾斜因子y + * @param kx 倾斜因子 x + * @param ky 倾斜因子 y * @param recycle 是否回收 * @return 倾斜后的图片 */ @@ -459,10 +459,10 @@ public static Bitmap skew(final Bitmap src, final float kx, final float ky, fina * 倾斜图片 * * @param src 源图片 - * @param kx 倾斜因子x - * @param ky 倾斜因子y - * @param px 平移因子x - * @param py 平移因子y + * @param kx 倾斜因子 x + * @param ky 倾斜因子 y + * @param px 平移因子 x + * @param py 平移因子 y * @return 倾斜后的图片 */ public static Bitmap skew(final Bitmap src, final float kx, final float ky, final float px, final float py) { @@ -473,10 +473,10 @@ public static Bitmap skew(final Bitmap src, final float kx, final float ky, fina * 倾斜图片 * * @param src 源图片 - * @param kx 倾斜因子x - * @param ky 倾斜因子y - * @param px 平移因子x - * @param py 平移因子y + * @param kx 倾斜因子 x + * @param ky 倾斜因子 y + * @param px 平移因子 x + * @param py 平移因子 y * @param recycle 是否回收 * @return 倾斜后的图片 */ @@ -869,8 +869,8 @@ public static Bitmap addReflection(final Bitmap src, * @param content 水印文本 * @param textSize 水印字体大小 * @param color 水印字体颜色 - * @param x 起始坐标x - * @param y 起始坐标y + * @param x 起始坐标 x + * @param y 起始坐标 y * @return 带有文字水印的图片 */ public static Bitmap addTextWatermark(final Bitmap src, @@ -889,8 +889,8 @@ public static Bitmap addTextWatermark(final Bitmap src, * @param content 水印文本 * @param textSize 水印字体大小 * @param color 水印字体颜色 - * @param x 起始坐标x - * @param y 起始坐标y + * @param x 起始坐标 x + * @param y 起始坐标 y * @param recycle 是否回收 * @return 带有文字水印的图片 */ @@ -919,8 +919,8 @@ public static Bitmap addTextWatermark(final Bitmap src, * * @param src 源图片 * @param watermark 图片水印 - * @param x 起始坐标x - * @param y 起始坐标y + * @param x 起始坐标 x + * @param y 起始坐标 y * @param alpha 透明度 * @return 带有图片水印的图片 */ @@ -936,8 +936,8 @@ public static Bitmap addImageWatermark(final Bitmap src, * * @param src 源图片 * @param watermark 图片水印 - * @param x 起始坐标x - * @param y 起始坐标y + * @param x 起始坐标 x + * @param y 起始坐标 y * @param alpha 透明度 * @param recycle 是否回收 * @return 带有图片水印的图片 @@ -961,21 +961,21 @@ public static Bitmap addImageWatermark(final Bitmap src, } /** - * 转为alpha位图 + * 转为 alpha 位图 * * @param src 源图片 - * @return alpha位图 + * @return alpha 位图 */ public static Bitmap toAlpha(final Bitmap src) { return toAlpha(src, false); } /** - * 转为alpha位图 + * 转为 alpha 位图 * * @param src 源图片 * @param recycle 是否回收 - * @return alpha位图 + * @return alpha 位图 */ public static Bitmap toAlpha(final Bitmap src, final Boolean recycle) { if (isEmptyBitmap(src)) return null; @@ -1070,8 +1070,8 @@ public static Bitmap fastBlur(final Bitmap src, } /** - * renderScript模糊图片 - *API大于17
+ * renderScript 模糊图片 + *API 大于 17
* * @param src 源图片 * @param radius 模糊半径(0...25) @@ -1084,8 +1084,8 @@ public static Bitmap renderScriptBlur(final Bitmap src, } /** - * renderScript模糊图片 - *API大于17
+ * renderScript 模糊图片 + *API 大于 17
* * @param src 源图片 * @param radius 模糊半径(0...25) @@ -1119,23 +1119,23 @@ public static Bitmap renderScriptBlur(final Bitmap src, } /** - * stack模糊图片 + * stack 模糊图片 * * @param src 源图片 * @param radius 模糊半径 - * @return stack模糊后的图片 + * @return stack 模糊后的图片 */ public static Bitmap stackBlur(final Bitmap src, final int radius) { return stackBlur(src, radius, false); } /** - * stack模糊图片 + * stack 模糊图片 * * @param src 源图片 * @param radius 模糊半径 * @param recycle 是否回收 - * @return stack模糊后的图片 + * @return stack 模糊后的图片 */ public static Bitmap stackBlur(final Bitmap src, final int radius, final boolean recycle) { Bitmap ret = recycle ? src : src.copy(src.getConfig(), true); @@ -1470,7 +1470,7 @@ public static String getImageType(final InputStream is) { /** * 获取图片类型 * - * @param bytes bitmap的前8字节 + * @param bytes bitmap 的前 8 字节 * @return 图片类型 */ public static String getImageType(final byte[] bytes) { @@ -1507,7 +1507,7 @@ private static boolean isBMP(final byte[] b) { } /** - * 判断bitmap对象是否为空 + * 判断 bitmap 对象是否为空 * * @param src 源图片 * @return {@code true}: 是8.0需添加权限 {@code
8.0 需添加权限 {@code
8.0需添加权限 {@code
8.0 需添加权限 {@code
在manifest.xml中activity中设置
+在 manifest.xml 中 activity 中设置
android:windowSoftInputMode="adjustPan"
*/ @@ -88,8 +88,8 @@ public static void toggleSoftInput() { /** * 点击屏幕空白区域隐藏软键盘 - *根据EditText所在坐标和用户点击的坐标相对比,来判断是否隐藏键盘
- *需重写dispatchTouchEvent
+ *根据 EditText 所在坐标和用户点击的坐标相对比,来判断是否隐藏键盘
+ *需重写 dispatchTouchEvent
*参照以下注释代码
*/ public static void clickBlankArea2HideSoftInput() { @@ -107,7 +107,7 @@ public boolean dispatchTouchEvent(MotionEvent ev) { return super.dispatchTouchEvent(ev); } - // 根据EditText所在坐标和用户点击的坐标相对比,来判断是否隐藏键盘 + // 根据 EditText 所在坐标和用户点击的坐标相对比,来判断是否隐藏键盘 private boolean isShouldHideKeyboard(View v, MotionEvent event) { if (v != null && (v instanceof EditText)) { int[] l = {0, 0}; diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/LogUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/LogUtils.java index d5fcbea39b..04f5c882b7 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/LogUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/LogUtils.java @@ -43,7 +43,7 @@ * author: Blankj * blog : http://blankj.com * time : 2016/09/21 - * desc : Log相关工具类 + * desc : Log 相关工具类 * */ public final class LogUtils { @@ -67,19 +67,19 @@ public final class LogUtils { private static final int XML = 0x30; private static ExecutorService sExecutor; - private static String sDefaultDir;// log默认存储目录 - private static String sDir; // log存储目录 - private static String sFilePrefix = "util";// log文件前缀 - private static boolean sLogSwitch = true; // log总开关,默认开 - private static boolean sLog2ConsoleSwitch = true; // logcat是否打印,默认打印 - private static String sGlobalTag = null; // log标签 - private static boolean sTagIsSpace = true; // log标签是否为空白 - private static boolean sLogHeadSwitch = true; // log头部开关,默认开 - private static boolean sLog2FileSwitch = false; // log写入文件开关,默认关 - private static boolean sLogBorderSwitch = true; // log边框开关,默认开 - private static int sConsoleFilter = V; // log控制台过滤器 - private static int sFileFilter = V; // log文件过滤器 - private static int sStackDeep = 1; // log栈深度 + private static String sDefaultDir;// log 默认存储目录 + private static String sDir; // log 存储目录 + private static String sFilePrefix = "util";// log 文件前缀 + private static boolean sLogSwitch = true; // log 总开关,默认开 + private static boolean sLog2ConsoleSwitch = true; // logcat 是否打印,默认打印 + private static String sGlobalTag = null; // log 标签 + private static boolean sTagIsSpace = true; // log 标签是否为空白 + private static boolean sLogHeadSwitch = true; // log 头部开关,默认开 + private static boolean sLog2FileSwitch = false; // log 写入文件开关,默认关 + private static boolean sLogBorderSwitch = true; // log 边框开关,默认开 + private static int sConsoleFilter = V; // log 控制台过滤器 + private static int sFileFilter = V; // log 文件过滤器 + private static int sStackDeep = 1; // log 栈深度 private static final String FILE_SEP = System.getProperty("file.separator"); private static final String LINE_SEP = System.getProperty("line.separator"); @@ -432,7 +432,7 @@ private static void printDeviceInfo(final String filePath) { "\nDevice Manufacturer: " + Build.MANUFACTURER +// 设备厂商 "\nDevice Model : " + Build.MODEL +// 设备型号 "\nAndroid Version : " + Build.VERSION.RELEASE +// 系统版本 - "\nAndroid SDK : " + Build.VERSION.SDK_INT +// SDK版本 + "\nAndroid SDK : " + Build.VERSION.SDK_INT +// SDK 版本 "\nApp VersionName : " + versionName + "\nApp VersionCode : " + versionCode + "\n************* Log Head ****************\n\n"; diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/NetworkUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/NetworkUtils.java index ef9bc9b558..7667b919b9 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/NetworkUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/NetworkUtils.java @@ -70,8 +70,8 @@ public static boolean isConnected() { /** * 判断网络是否可用 *需添加权限 {@code
需要异步ping,如果ping不通就说明网络不可用
- *ping的ip为阿里巴巴公共ip:223.5.5.5
+ *需要异步 ping,如果 ping 不通就说明网络不可用
+ *ping 的 ip 为阿里巴巴公共 ip:223.5.5.5
* * @return {@code true}: 可用需添加权限 {@code
需要异步ping,如果ping不通就说明网络不可用
+ *需要异步 ping,如果 ping 不通就说明网络不可用
* - * @param ip ip地址(自己服务器ip),如果为空,ip为阿里巴巴公共ip + * @param ip ip 地址(自己服务器 ip),如果为空,ip 为阿里巴巴公共 ip * @return {@code true}: 可用需添加权限 {@code
需添加权限 {@code
需添加权限 {@code
需添加权限 {@code
需添加权限 {@code
需添加权限 {@code
需添加权限 {@code
需添加权限 {@code
需添加权限 {@code
需添加权限 {@code
中国移动、如中国联通、中国电信
* - * @return sim卡运营商名称 + * @return sim 卡运营商名称 */ public static String getSimOperatorName() { TelephonyManager tm = (TelephonyManager) Utils.getApp().getSystemService(Context.TELEPHONY_SERVICE); @@ -107,7 +107,7 @@ public static String getSimOperatorName() { } /** - * 获取Sim卡运营商名称 + * 获取 Sim 卡运营商名称 *中国移动、如中国联通、中国电信
* * @return 移动网络运营商名称 @@ -236,40 +236,40 @@ public static List需添加权限 {@code
需添加权限 {@code
当不是查看当前App,且SDK大于21时, + *
当不是查看当前 App,且 SDK 大于 21 时,
* 需添加权限 {@code
取值范围为a-z,A-Z,0-9,"_",汉字,不能以"_"结尾,用户名必须是6-20位
+ *取值范围为 a-z,A-Z,0-9,"_",汉字,不能以"_"结尾,用户名必须是 6-20 位
* * @param input 待验证文本 * @return {@code true}: 匹配还有一种就是在Activity中加属性android:screenOrientation="landscape"
- *不设置Activity的android:configChanges时,切屏会重新调用各个生命周期,切横屏时会执行一次,切竖屏时会执行两次
- *设置Activity的android:configChanges="orientation"时,切屏还是会重新调用各个生命周期,切横、竖屏时只会执行一次
- *设置Activity的android:configChanges="orientation|keyboardHidden|screenSize"(4.0以上必须带最后一个参数)时 - * 切屏不会重新调用各个生命周期,只会执行onConfigurationChanged方法
+ *还有一种就是在 Activity 中加属性 android:screenOrientation="landscape"
+ *不设置 Activity 的 android:configChanges 时,切屏会重新调用各个生命周期,切横屏时会执行一次,切竖屏时会执行两次
+ *设置 Activity 的 android:configChanges="orientation"时,切屏还是会重新调用各个生命周期,切横、竖屏时只会执行一次
+ *设置 Activity 的 android:configChanges="orientation|keyboardHidden|screenSize"(4.0 以上必须带最后一个参数)时 + * 切屏不会重新调用各个生命周期,只会执行 onConfigurationChanged 方法
* * @param activity activity */ diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/ShellUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/ShellUtils.java index 144004f09c..d12945367f 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/ShellUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/ShellUtils.java @@ -10,7 +10,7 @@ * author: Blankj * blog : http://blankj.com * time : 2016/08/07 - * desc : Shell相关工具类 + * desc : Shell 相关工具类 * */ public final class ShellUtils { @@ -22,10 +22,10 @@ private ShellUtils() { } /** - * 是否是在root下执行命令 + * 是否是在 root 下执行命令 * * @param command 命令 - * @param isRoot 是否需要root权限执行 + * @param isRoot 是否需要 root 权限执行 * @return CommandResult */ public static CommandResult execCmd(final String command, final boolean isRoot) { @@ -33,10 +33,10 @@ public static CommandResult execCmd(final String command, final boolean isRoot) } /** - * 是否是在root下执行命令 + * 是否是在 root 下执行命令 * * @param commands 多条命令链表 - * @param isRoot 是否需要root权限执行 + * @param isRoot 是否需要 root 权限执行 * @return CommandResult */ public static CommandResult execCmd(final List该方法存在于TypedValue
+ *该方法存在于 TypedValue
* * @param unit 单位 * @param value 值 @@ -91,8 +91,8 @@ public static float applyDimension(final int unit, final float value, final Disp } /** - * 在onCreate中获取视图的尺寸 - *需回调onGetSizeListener接口,在onGetSize中获取view宽高
+ * 在 onCreate 中获取视图的尺寸 + *需回调 onGetSizeListener 接口,在 onGetSize 中获取 view 宽高
*用法示例如下所示
** SizeUtils.forceGetViewSize(view, new SizeUtils.onGetSizeListener() { @@ -118,7 +118,7 @@ public void run() { } /** - * 获取到View尺寸的监听 + * 获取到 View 尺寸的监听 */ public interface onGetSizeListener { void onGetSize(View view); diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/SnackbarUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/SnackbarUtils.java index c080d26d5d..0a9901e91d 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/SnackbarUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/SnackbarUtils.java @@ -23,7 +23,7 @@ * author: Blankj * blog : http://blankj.com * time : 2016/10/16 - * desc : Snackbar相关工具类 + * desc : Snackbar 相关工具类 **/ public final class SnackbarUtils { @@ -73,9 +73,9 @@ private void setDefault() { } /** - * 设置snackbar依赖view + * 设置 snackbar 依赖 view * - * @param parent 依赖view + * @param parent 依赖 view * @return {@link SnackbarUtils} */ public static SnackbarUtils with(@NonNull final View parent) { @@ -180,7 +180,7 @@ public SnackbarUtils setBottomMargin(@IntRange(from = 1) final int bottomMargin) } /** - * 显示snackbar + * 显示 snackbar */ public void show() { final View view = parent; @@ -214,7 +214,7 @@ public void show() { } /** - * 显示预设成功的snackbar + * 显示预设成功的 snackbar */ public void showSuccess() { bgColor = COLOR_SUCCESS; @@ -224,7 +224,7 @@ public void showSuccess() { } /** - * 显示预设警告的snackbar + * 显示预设警告的 snackbar */ public void showWarning() { bgColor = COLOR_WARNING; @@ -234,7 +234,7 @@ public void showWarning() { } /** - * 显示预设错误的snackbar + * 显示预设错误的 snackbar */ public void showError() { bgColor = COLOR_ERROR; @@ -244,7 +244,7 @@ public void showError() { } /** - * 消失snackbar + * 消失 snackbar */ public static void dismiss() { if (snackbarWeakReference != null && snackbarWeakReference.get() != null) { @@ -254,9 +254,9 @@ public static void dismiss() { } /** - * 获取snackbar视图 + * 获取 snackbar 视图 * - * @return snackbar视图 + * @return snackbar 视图 */ public static View getView() { Snackbar snackbar = snackbarWeakReference.get(); @@ -265,7 +265,7 @@ public static View getView() { } /** - * 添加snackbar视图 + * 添加 snackbar 视图 *
在{@link #show()}之后调用
* * @param layoutId 布局文件 @@ -282,10 +282,10 @@ public static void addView(@LayoutRes final int layoutId, @NonNull final ViewGro } /** - * 添加snackbar视图 + * 添加 snackbar 视图 *在{@link #show()}之后调用
* - * @param child 要添加的view + * @param child 要添加的 view * @param params 布局参数 */ public static void addView(@NonNull final View child, @NonNull final ViewGroup.LayoutParams params) { diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/SpanUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/SpanUtils.java index 1c8d827788..ecb579c21f 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/SpanUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/SpanUtils.java @@ -63,7 +63,7 @@ * author: Blankj * blog : http://blankj.com * time : 16/12/13 - * desc : SpannableString相关工具类 + * desc : SpannableString 相关工具类 * */ public final class SpanUtils { @@ -324,9 +324,9 @@ public SpanUtils setBullet(@ColorInt final int color, @IntRange(from = 0) final /** * 设置图标 - *默认0边距,居中对齐
+ *默认 0 边距,居中对齐
* - * @param bitmap 图标bitmap + * @param bitmap 图标 bitmap * @return {@link SpanUtils} */ public SpanUtils setIconMargin(final Bitmap bitmap) { @@ -336,7 +336,7 @@ public SpanUtils setIconMargin(final Bitmap bitmap) { /** * 设置图标 * - * @param bitmap 图标bitmap + * @param bitmap 图标 bitmap * @param gapWidth 图标和文字间距离 * @param align 对齐 *默认0边距,居中对齐
+ *默认 0 边距,居中对齐
* - * @param drawable 图标drawable + * @param drawable 图标 drawable * @return {@link SpanUtils} */ public SpanUtils setIconMargin(final Drawable drawable) { @@ -367,7 +367,7 @@ public SpanUtils setIconMargin(final Drawable drawable) { /** * 设置图标 * - * @param drawable 图标drawable + * @param drawable 图标 drawable * @param gapWidth 图标和文字间距离 * @param align 对齐 *默认0边距,居中对齐
+ *默认 0 边距,居中对齐
* - * @param uri 图标uri + * @param uri 图标 uri * @return {@link SpanUtils} */ public SpanUtils setIconMargin(final Uri uri) { @@ -398,7 +398,7 @@ public SpanUtils setIconMargin(final Uri uri) { /** * 设置图标 * - * @param uri 图标uri + * @param uri 图标 uri * @param gapWidth 图标和文字间距离 * @param align 对齐 *默认0边距,居中对齐
+ *默认 0 边距,居中对齐
* - * @param resourceId 图标resourceId + * @param resourceId 图标 resourceId * @return {@link SpanUtils} */ public SpanUtils setIconMargin(@DrawableRes final int resourceId) { @@ -429,7 +429,7 @@ public SpanUtils setIconMargin(@DrawableRes final int resourceId) { /** * 设置图标 * - * @param resourceId 图标resourceId + * @param resourceId 图标 resourceId * @param gapWidth 图标和文字间距离 * @param align 对齐 *需添加view.setMovementMethod(LinkMovementMethod.getInstance())
+ *需添加 view.setMovementMethod(LinkMovementMethod.getInstance())
* * @param clickSpan 点击事件 * @return {@link SpanUtils} @@ -618,7 +618,7 @@ public SpanUtils setClickSpan(@NonNull final ClickableSpan clickSpan) { /** * 设置超链接 - *需添加view.setMovementMethod(LinkMovementMethod.getInstance())
+ *需添加 view.setMovementMethod(LinkMovementMethod.getInstance())
* * @param url 超链接 * @return {@link SpanUtils} @@ -630,10 +630,10 @@ public SpanUtils setUrl(@NonNull final String url) { /** * 设置模糊 - *尚存bug,其他地方存在相同的字体的话,相同字体出现在之前的话那么就不会模糊,出现在之后的话那会一起模糊
- *以上bug关闭硬件加速即可
+ *尚存 bug,其他地方存在相同的字体的话,相同字体出现在之前的话那么就不会模糊,出现在之后的话那会一起模糊
+ *以上 bug 关闭硬件加速即可
* - * @param radius 模糊半径(需大于0) + * @param radius 模糊半径(需大于 0) * @param style 模糊样式在工具类中经常使用到工具类的格式化描述,这个主要是一个日期的操作类,所以日志格式主要使用 SimpleDateFormat的定义格式.
+ *在工具类中经常使用到工具类的格式化描述,这个主要是一个日期的操作类,所以日志格式主要使用 SimpleDateFormat 的定义格式.
* 格式的意义如下: 日期和时间模式日期和时间格式由日期和时间模式字符串指定。在日期和时间模式字符串中,未加引号的字母 'A' 到 'Z' 和 'a' 到 'z'
* 被解释为模式字母,用来表示日期或时间字符串元素。文本可以使用单引号 (') 引起来,以免进行解释。"''"
@@ -174,7 +174,7 @@ public final class TimeUtils {
* yyyy-MM-dd'T'HH:mm:ss.SSSZ 2016-08-12T15:44:40.461+0800
* EEEE 'DATE('yyyy-MM-dd')' 'TIME('HH:mm:ss')' zzzz 星期五 DATE(2016-08-12) TIME(15:44:40) 中国标准时间
*
- * 注意:SimpleDateFormat不是线程安全的,线程安全需用{@code ThreadLocal 格式为yyyy-MM-dd HH:mm:ss 格式为 yyyy-MM-dd HH:mm:ss 格式为format 格式为 format time格式为yyyy-MM-dd HH:mm:ss time 格式为 yyyy-MM-dd HH:mm:ss time格式为format time 格式为 format time格式为yyyy-MM-dd HH:mm:ss time 格式为 yyyy-MM-dd HH:mm:ss time格式为format time 格式为 format 格式为yyyy-MM-dd HH:mm:ss 格式为 yyyy-MM-dd HH:mm:ss 格式为format 格式为 format time0和time1格式都为yyyy-MM-dd HH:mm:ss time0 和 time1 格式都为 yyyy-MM-dd HH:mm:ss time0和time1格式都为format time0 和 time1 格式都为 format time0和time1格式都为yyyy-MM-dd HH:mm:ss time0 和 time1 格式都为 yyyy-MM-dd HH:mm:ss precision = 0,返回null precision = 0,返回 null precision = 1,返回天 precision = 2,返回天和小时 precision = 3,返回天、小时和分钟 time0和time1格式都为format time0 和 time1 格式都为 format precision = 0,返回null precision = 0,返回 null precision = 1,返回天 precision = 2,返回天和小时 precision = 3,返回天、小时和分钟 precision = 0,返回null precision = 0,返回 null precision = 1,返回天 precision = 2,返回天和小时 precision = 3,返回天、小时和分钟 precision = 0,返回null precision = 0,返回 null precision = 1,返回天 precision = 2,返回天和小时 precision = 3,返回天、小时和分钟 格式为yyyy-MM-dd HH:mm:ss 格式为 yyyy-MM-dd HH:mm:ss 格式为format 格式为 format time格式为yyyy-MM-dd HH:mm:ss time 格式为 yyyy-MM-dd HH:mm:ss
*
- * @return unit时间戳
+ * @return unit 时间戳
*/
public static long getTimeSpan(final String time0, final String time1, @TimeConstants.Unit final int unit) {
return getTimeSpan(time0, time1, DEFAULT_FORMAT, unit);
@@ -327,10 +327,10 @@ public static long getTimeSpan(final String time0, final String time1, @TimeCons
/**
* 获取两个时间差(单位:unit)
- *
@@ -340,7 +340,7 @@ public static long getTimeSpan(final String time0, final String time1, @TimeCons
*
- * @return unit时间戳
+ * @return unit 时间戳
*/
public static long getTimeSpan(final String time0, final String time1, final DateFormat format, @TimeConstants.Unit final int unit) {
return millis2TimeSpan(Math.abs(string2Millis(time0, format) - string2Millis(time1, format)), unit);
@@ -349,8 +349,8 @@ public static long getTimeSpan(final String time0, final String time1, final Dat
/**
* 获取两个时间差(单位:unit)
*
- * @param date0 Date类型时间0
- * @param date1 Date类型时间1
+ * @param date0 Date 类型时间 0
+ * @param date1 Date 类型时间 1
* @param unit 单位类型
*
*
- * @return unit时间戳
+ * @return unit 时间戳
*/
public static long getTimeSpan(final Date date0, final Date date1, @TimeConstants.Unit final int unit) {
return millis2TimeSpan(Math.abs(date2Millis(date0) - date2Millis(date1)), unit);
@@ -368,8 +368,8 @@ public static long getTimeSpan(final Date date0, final Date date1, @TimeConstant
/**
* 获取两个时间差(单位:unit)
*
- * @param millis0 毫秒时间戳0
- * @param millis1 毫秒时间戳1
+ * @param millis0 毫秒时间戳 0
+ * @param millis1 毫秒时间戳 1
* @param unit 单位类型
*
*
- * @return unit时间戳
+ * @return unit 时间戳
*/
public static long getTimeSpan(final long millis0, final long millis1, @TimeConstants.Unit final int unit) {
return millis2TimeSpan(Math.abs(millis0 - millis1), unit);
@@ -386,12 +386,12 @@ public static long getTimeSpan(final long millis0, final long millis1, @TimeCons
/**
* 获取合适型两个时间差
- *
time格式为format
+ *time 格式为 format
* * @param time 时间字符串 * @param format 时间格式 @@ -531,7 +531,7 @@ public static long getTimeSpanByNow(final String time, @TimeConstants.Unit final *time格式为yyyy-MM-dd HH:mm:ss
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 时间字符串 * @param precision 精度 *time格式为format
+ *time 格式为 format
* * @param time 时间字符串 * @param format 时间格式 * @param precision 精度 *time格式为yyyy-MM-dd HH:mm:ss
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 时间字符串 * @return 友好型与当前时间的差 *time格式为format
+ *time 格式为 format
* * @param time 时间字符串 * @param format 时间格式 * @return 友好型与当前时间的差 *time格式为yyyy-MM-dd HH:mm:ss
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 给定时间 * @param timeSpan 时间差的毫秒时间戳 @@ -800,7 +800,7 @@ public static long getMillis(final String time, final long timeSpan, @TimeConsta /** * 获取与给定时间等于时间差的时间戳 - *time格式为format
+ *time 格式为 format
* * @param time 给定时间 * @param format 时间格式 @@ -840,7 +840,7 @@ public static long getMillis(final Date date, final long timeSpan, @TimeConstant /** * 获取与给定时间等于时间差的时间字符串 - *格式为yyyy-MM-dd HH:mm:ss
+ *格式为 yyyy-MM-dd HH:mm:ss
* * @param millis 给定时间 * @param timeSpan 时间差的毫秒时间戳 @@ -860,7 +860,7 @@ public static String getString(final long millis, final long timeSpan, @TimeCons /** * 获取与给定时间等于时间差的时间字符串 - *格式为format
+ *格式为 format
* * @param millis 给定时间 * @param format 时间格式 @@ -881,7 +881,7 @@ public static String getString(final long millis, final DateFormat format, final /** * 获取与给定时间等于时间差的时间字符串 - *time格式为yyyy-MM-dd HH:mm:ss
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 给定时间 * @param timeSpan 时间差的毫秒时间戳 @@ -901,7 +901,7 @@ public static String getString(final String time, final long timeSpan, @TimeCons /** * 获取与给定时间等于时间差的时间字符串 - *格式为format
+ *格式为 format
* * @param time 给定时间 * @param format 时间格式 @@ -922,7 +922,7 @@ public static String getString(final String time, final DateFormat format, final /** * 获取与给定时间等于时间差的时间字符串 - *格式为yyyy-MM-dd HH:mm:ss
+ *格式为 yyyy-MM-dd HH:mm:ss
* * @param date 给定时间 * @param timeSpan 时间差的毫秒时间戳 @@ -942,7 +942,7 @@ public static String getString(final Date date, final long timeSpan, @TimeConsta /** * 获取与给定时间等于时间差的时间字符串 - *格式为format
+ *格式为 format
* * @param date 给定时间 * @param format 时间格式 @@ -962,7 +962,7 @@ public static String getString(final Date date, final DateFormat format, final l } /** - * 获取与给定时间等于时间差的Date + * 获取与给定时间等于时间差的 Date * * @param millis 给定时间 * @param timeSpan 时间差的毫秒时间戳 @@ -974,15 +974,15 @@ public static String getString(final Date date, final DateFormat format, final l *time格式为yyyy-MM-dd HH:mm:ss
+ * 获取与给定时间等于时间差的 Date + *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 给定时间 * @param timeSpan 时间差的毫秒时间戳 @@ -994,15 +994,15 @@ public static Date getDate(final long millis, final long timeSpan, @TimeConstant *格式为format
+ * 获取与给定时间等于时间差的 Date + *格式为 format
* * @param time 给定时间 * @param format 时间格式 @@ -1015,14 +1015,14 @@ public static Date getDate(final String time, final long timeSpan, @TimeConstant *格式为yyyy-MM-dd HH:mm:ss
+ *格式为 yyyy-MM-dd HH:mm:ss
* * @param timeSpan 时间差的毫秒时间戳 * @param unit 单位类型 @@ -1079,7 +1079,7 @@ public static String getStringByNow(final long timeSpan, @TimeConstants.Unit fin /** * 获取与当前时间等于时间差的时间字符串 - *格式为format
+ *格式为 format
* * @param timeSpan 时间差的毫秒时间戳 * @param format 时间格式 @@ -1098,7 +1098,7 @@ public static String getStringByNow(final long timeSpan, final DateFormat format } /** - * 获取与当前时间等于时间差的Date + * 获取与当前时间等于时间差的 Date * * @param timeSpan 时间差的毫秒时间戳 * @param unit 单位类型 @@ -1109,7 +1109,7 @@ public static String getStringByNow(final long timeSpan, final DateFormat format *time格式为yyyy-MM-dd HH:mm:ss
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 时间字符串 * @return {@code true}: 是time格式为format
+ *time 格式为 format
* * @param time 时间字符串 * @param format 时间格式 @@ -1141,7 +1141,7 @@ public static boolean isToday(final String time, final DateFormat format) { /** * 判断是否今天 * - * @param date Date类型时间 + * @param date Date 类型时间 * @return {@code true}: 是time格式为yyyy-MM-dd HH:mm:ss
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 时间字符串 * @return {@code true}: 闰年time格式为format
+ *time 格式为 format
* * @param time 时间字符串 * @param format 时间格式 @@ -1185,7 +1185,7 @@ public static boolean isLeapYear(final String time, final DateFormat format) { /** * 判断是否闰年 * - * @param date Date类型时间 + * @param date Date 类型时间 * @return {@code true}: 闰年time格式为yyyy-MM-dd HH:mm:ss
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 时间字符串 * @return 中式星期 @@ -1228,7 +1228,7 @@ public static String getChineseWeek(final String time) { /** * 获取中式星期 - *time格式为format
+ *time 格式为 format
* * @param time 时间字符串 * @param format 时间格式 @@ -1241,7 +1241,7 @@ public static String getChineseWeek(final String time, final DateFormat format) /** * 获取中式星期 * - * @param date Date类型时间 + * @param date Date 类型时间 * @return 中式星期 */ public static String getChineseWeek(final Date date) { @@ -1260,7 +1260,7 @@ public static String getChineseWeek(final long millis) { /** * 获取美式星期 - *time格式为yyyy-MM-dd HH:mm:ss
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 时间字符串 * @return 美式星期 @@ -1271,7 +1271,7 @@ public static String getUSWeek(final String time) { /** * 获取美式星期 - *time格式为format
+ *time 格式为 format
* * @param time 时间字符串 * @param format 时间格式 @@ -1284,7 +1284,7 @@ public static String getUSWeek(final String time, final DateFormat format) { /** * 获取美式星期 * - * @param date Date类型时间 + * @param date Date 类型时间 * @return 美式星期 */ public static String getUSWeek(final Date date) { @@ -1303,8 +1303,8 @@ public static String getUSWeek(final long millis) { /** * 获取星期索引 - *注意:周日的Index才是1,周六为7
- *time格式为yyyy-MM-dd HH:mm:ss
+ *注意:周日的 Index 才是 1,周六为 7
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 时间字符串 * @return 1...7 @@ -1322,8 +1322,8 @@ public static int getWeekIndex(final String time) { /** * 获取星期索引 - *注意:周日的Index才是1,周六为7
- *time格式为format
+ *注意:周日的 Index 才是 1,周六为 7
+ *time 格式为 format
* * @param time 时间字符串 * @param format 时间格式 @@ -1342,9 +1342,9 @@ public static int getWeekIndex(final String time, final DateFormat format) { /** * 获取星期索引 - *注意:周日的Index才是1,周六为7
+ *注意:周日的 Index 才是 1,周六为 7
* - * @param date Date类型时间 + * @param date Date 类型时间 * @return 1...7 * @see Calendar#SUNDAY * @see Calendar#MONDAY @@ -1362,7 +1362,7 @@ public static int getWeekIndex(final Date date) { /** * 获取星期索引 - *注意:周日的Index才是1,周六为7
+ *注意:周日的 Index 才是 1,周六为 7
* * @param millis 毫秒时间戳 * @return 1...7 @@ -1381,7 +1381,7 @@ public static int getWeekIndex(final long millis) { /** * 获取月份中的第几周 *注意:国外周日才是新的一周的开始
- *time格式为yyyy-MM-dd HH:mm:ss
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 时间字符串 * @return 1...5 @@ -1393,7 +1393,7 @@ public static int getWeekOfMonth(final String time) { /** * 获取月份中的第几周 *注意:国外周日才是新的一周的开始
- *time格式为format
+ *time 格式为 format
* * @param time 时间字符串 * @param format 时间格式 @@ -1407,7 +1407,7 @@ public static int getWeekOfMonth(final String time, final DateFormat format) { * 获取月份中的第几周 *注意:国外周日才是新的一周的开始
* - * @param date Date类型时间 + * @param date Date 类型时间 * @return 1...5 */ public static int getWeekOfMonth(final Date date) { @@ -1430,7 +1430,7 @@ public static int getWeekOfMonth(final long millis) { /** * 获取年份中的第几周 *注意:国外周日才是新的一周的开始
- *time格式为yyyy-MM-dd HH:mm:ss
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 时间字符串 * @return 1...54 @@ -1442,7 +1442,7 @@ public static int getWeekOfYear(final String time) { /** * 获取年份中的第几周 *注意:国外周日才是新的一周的开始
- *time格式为format
+ *time 格式为 format
* * @param time 时间字符串 * @param format 时间格式 @@ -1456,7 +1456,7 @@ public static int getWeekOfYear(final String time, final DateFormat format) { * 获取年份中的第几周 *注意:国外周日才是新的一周的开始
* - * @param date Date类型时间 + * @param date Date 类型时间 * @return 1...54 */ public static int getWeekOfYear(final Date date) { @@ -1480,7 +1480,7 @@ public static int getWeekOfYear(final long millis) { /** * 获取生肖 - *time格式为yyyy-MM-dd HH:mm:ss
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 时间字符串 * @return 生肖 @@ -1491,7 +1491,7 @@ public static String getChineseZodiac(final String time) { /** * 获取生肖 - *time格式为format
+ *time 格式为 format
* * @param time 时间字符串 * @param format 时间格式 @@ -1504,7 +1504,7 @@ public static String getChineseZodiac(final String time, final DateFormat format /** * 获取生肖 * - * @param date Date类型时间 + * @param date Date 类型时间 * @return 生肖 */ public static String getChineseZodiac(final Date date) { @@ -1533,12 +1533,12 @@ public static String getChineseZodiac(final int year) { return CHINESE_ZODIAC[year % 12]; } - private static final String[] ZODIAC = {"水瓶座", "双鱼座", "白羊座", "金牛座", "双子座", "巨蟹座", "狮子座", "处女座", "天秤座", "天蝎座", "射手座", "魔羯座"}; - private static final int[] ZODIAC_FLAGS = {20, 19, 21, 21, 21, 22, 23, 23, 23, 24, 23, 22}; + private static final String[] ZODIAC = {"水瓶座", "双鱼座", "白羊座", "金牛座", "双子座", "巨蟹座", "狮子座", "处女座", "天秤座", "天蝎座", "射手座", "魔羯座"}; + private static final int[] ZODIAC_FLAGS = {20, 19, 21, 21, 21, 22, 23, 23, 23, 24, 23, 22}; /** * 获取星座 - *time格式为yyyy-MM-dd HH:mm:ss
+ *time 格式为 yyyy-MM-dd HH:mm:ss
* * @param time 时间字符串 * @return 生肖 @@ -1549,7 +1549,7 @@ public static String getZodiac(final String time) { /** * 获取星座 - *time格式为format
+ *time 格式为 format
* * @param time 时间字符串 * @param format 时间格式 @@ -1562,7 +1562,7 @@ public static String getZodiac(final String time, final DateFormat format) { /** * 获取星座 * - * @param date Date类型时间 + * @param date Date 类型时间 * @return 星座 */ public static String getZodiac(final Date date) { diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/ToastUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/ToastUtils.java index abc6a01507..fb9b87f5fd 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/ToastUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/ToastUtils.java @@ -3,6 +3,7 @@ import android.content.Context; import android.graphics.PorterDuff; import android.graphics.PorterDuffColorFilter; +import android.graphics.drawable.ColorDrawable; import android.graphics.drawable.Drawable; import android.os.Handler; import android.os.Looper; @@ -11,6 +12,7 @@ import android.support.annotation.LayoutRes; import android.support.annotation.NonNull; import android.support.annotation.StringRes; +import android.support.v4.view.ViewCompat; import android.support.v4.widget.TextViewCompat; import android.view.Gravity; import android.view.LayoutInflater; @@ -51,8 +53,8 @@ private ToastUtils() { * 设置吐司位置 * * @param gravity 位置 - * @param xOffset x偏移 - * @param yOffset y偏移 + * @param xOffset x 偏移 + * @param yOffset y 偏移 */ public static void setGravity(final int gravity, final int xOffset, final int yOffset) { ToastUtils.gravity = gravity; @@ -99,7 +101,7 @@ public static void showShort(@NonNull final CharSequence text) { /** * 安全地显示短时吐司 * - * @param resId 资源Id + * @param resId 资源 Id */ public static void showShort(@StringRes final int resId) { show(resId, Toast.LENGTH_SHORT); @@ -108,7 +110,7 @@ public static void showShort(@StringRes final int resId) { /** * 安全地显示短时吐司 * - * @param resId 资源Id + * @param resId 资源 Id * @param args 参数 */ public static void showShort(@StringRes final int resId, final Object... args) { @@ -137,7 +139,7 @@ public static void showLong(@NonNull final CharSequence text) { /** * 安全地显示长时吐司 * - * @param resId 资源Id + * @param resId 资源 Id */ public static void showLong(@StringRes final int resId) { show(resId, Toast.LENGTH_LONG); @@ -146,7 +148,7 @@ public static void showLong(@StringRes final int resId) { /** * 安全地显示长时吐司 * - * @param resId 资源Id + * @param resId 资源 Id * @param args 参数 */ public static void showLong(@StringRes final int resId, final Object... args) { @@ -239,7 +241,11 @@ private static void setBgAndGravity() { toastView.setBackgroundResource(bgResource); } else if (bgColor != COLOR_DEFAULT) { Drawable background = toastView.getBackground(); - background.setColorFilter(new PorterDuffColorFilter(bgColor, PorterDuff.Mode.SRC_IN)); + if (background != null) { + background.setColorFilter(new PorterDuffColorFilter(bgColor, PorterDuff.Mode.SRC_IN)); + } else { + ViewCompat.setBackground(toastView, new ColorDrawable(bgColor)); + } } sToast.setGravity(gravity, xOffset, yOffset); } @@ -259,4 +265,4 @@ private static View getView(@LayoutRes final int layoutId) { sLayoutId = layoutId; return toastView; } -} \ No newline at end of file +} diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/Utils.java b/utilcode/src/main/java/com/blankj/utilcode/util/Utils.java index a96c7ec77f..e368b37ea1 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/Utils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/Utils.java @@ -15,7 +15,7 @@ * author: Blankj * blog : http://blankj.com * time : 16/12/08 - * desc : Utils初始化相关 + * desc : Utils 初始化相关 * * 瓦瓦 十 * 十齱龠己 亅瓦車己 @@ -113,7 +113,7 @@ public static void init(@NonNull final Application app) { } /** - * 获取Application + * 获取 Application * * @return Application */ diff --git a/utilcode/src/main/java/com/blankj/utilcode/util/ZipUtils.java b/utilcode/src/main/java/com/blankj/utilcode/util/ZipUtils.java index a2673d188e..0a3907c6c3 100644 --- a/utilcode/src/main/java/com/blankj/utilcode/util/ZipUtils.java +++ b/utilcode/src/main/java/com/blankj/utilcode/util/ZipUtils.java @@ -37,7 +37,7 @@ private ZipUtils() { * @param resFilePath 待压缩文件路径 * @param zipFilePath 压缩文件路径 * @return {@code true}: 压缩成功