|
|
@@ -7,28 +7,27 @@ import java.nio.charset.Charset;
|
|
|
* 十六进制(简写为hex或下标16)在数学中是一种逢16进1的进位制,一般用数字0到9和字母A到F表示(其中:A~F即10~15)。<br>
|
|
|
* 例如十进制数57,在二进制写作111001,在16进制写作39。<br>
|
|
|
* 像java,c这样的语言为了区分十六进制和十进制数值,会在十六进制数的前面加上 0x,比如0x20是十进制的32,而不是十进制的20<br>
|
|
|
- *
|
|
|
+ * <p>
|
|
|
* 参考:https://my.oschina.net/xinxingegeya/blog/287476
|
|
|
- *
|
|
|
- * @author Looly
|
|
|
*
|
|
|
+ * @author Looly
|
|
|
*/
|
|
|
public class HexUtil {
|
|
|
|
|
|
/**
|
|
|
* 用于建立十六进制字符的输出的小写字符数组
|
|
|
*/
|
|
|
- private static final char[] DIGITS_LOWER = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f' };
|
|
|
+ private static final char[] DIGITS_LOWER = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'a', 'b', 'c', 'd', 'e', 'f'};
|
|
|
/**
|
|
|
* 用于建立十六进制字符的输出的大写字符数组
|
|
|
*/
|
|
|
- private static final char[] DIGITS_UPPER = { '0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F' };
|
|
|
+ private static final char[] DIGITS_UPPER = {'0', '1', '2', '3', '4', '5', '6', '7', '8', '9', 'A', 'B', 'C', 'D', 'E', 'F'};
|
|
|
|
|
|
/**
|
|
|
* 判断给定字符串是否为16进制数<br>
|
|
|
* 如果是,需要使用对应数字类型对象的<code>decode</code>方法解码<br>
|
|
|
* 例如:{@code Integer.decode}方法解码int类型的16进制数字
|
|
|
- *
|
|
|
+ *
|
|
|
* @param value 值
|
|
|
* @return 是否为16进制
|
|
|
*/
|
|
|
@@ -41,12 +40,13 @@ public class HexUtil {
|
|
|
return false;
|
|
|
}
|
|
|
return true;
|
|
|
- }else {
|
|
|
+ } else {
|
|
|
return false;
|
|
|
}
|
|
|
}
|
|
|
|
|
|
// ---------------------------------------------------------------------------------------------------- encode
|
|
|
+
|
|
|
/**
|
|
|
* 将字节数组转换为十六进制字符数组
|
|
|
*
|
|
|
@@ -60,7 +60,7 @@ public class HexUtil {
|
|
|
/**
|
|
|
* 将字节数组转换为十六进制字符数组
|
|
|
*
|
|
|
- * @param str 字符串
|
|
|
+ * @param str 字符串
|
|
|
* @param charset 编码
|
|
|
* @return 十六进制char[]
|
|
|
*/
|
|
|
@@ -71,7 +71,7 @@ public class HexUtil {
|
|
|
/**
|
|
|
* 将字节数组转换为十六进制字符数组
|
|
|
*
|
|
|
- * @param data byte[]
|
|
|
+ * @param data byte[]
|
|
|
* @param toLowerCase <code>true</code> 传换成小写格式 , <code>false</code> 传换成大写格式
|
|
|
* @return 十六进制char[]
|
|
|
*/
|
|
|
@@ -92,7 +92,7 @@ public class HexUtil {
|
|
|
/**
|
|
|
* 将字节数组转换为十六进制字符串,结果为小写
|
|
|
*
|
|
|
- * @param data 被编码的字符串
|
|
|
+ * @param data 被编码的字符串
|
|
|
* @param charset 编码
|
|
|
* @return 十六进制String
|
|
|
*/
|
|
|
@@ -113,7 +113,7 @@ public class HexUtil {
|
|
|
/**
|
|
|
* 将字节数组转换为十六进制字符串
|
|
|
*
|
|
|
- * @param data byte[]
|
|
|
+ * @param data byte[]
|
|
|
* @param toLowerCase <code>true</code> 传换成小写格式 , <code>false</code> 传换成大写格式
|
|
|
* @return 十六进制String
|
|
|
*/
|
|
|
@@ -122,6 +122,7 @@ public class HexUtil {
|
|
|
}
|
|
|
|
|
|
// ---------------------------------------------------------------------------------------------------- decode
|
|
|
+
|
|
|
/**
|
|
|
* 将十六进制字符数组转换为字符串,默认编码UTF-8
|
|
|
*
|
|
|
@@ -135,7 +136,7 @@ public class HexUtil {
|
|
|
/**
|
|
|
* 将十六进制字符数组转换为字符串
|
|
|
*
|
|
|
- * @param hexStr 十六进制String
|
|
|
+ * @param hexStr 十六进制String
|
|
|
* @param charset 编码
|
|
|
* @return 字符串
|
|
|
*/
|
|
|
@@ -200,9 +201,10 @@ public class HexUtil {
|
|
|
}
|
|
|
|
|
|
// ---------------------------------------------------------------------------------------- Color
|
|
|
+
|
|
|
/**
|
|
|
* 将{@link Color}编码为Hex形式
|
|
|
- *
|
|
|
+ *
|
|
|
* @param color {@link Color}
|
|
|
* @return Hex字符串
|
|
|
* @since 3.0.8
|
|
|
@@ -213,14 +215,14 @@ public class HexUtil {
|
|
|
|
|
|
/**
|
|
|
* 将{@link Color}编码为Hex形式
|
|
|
- *
|
|
|
- * @param color {@link Color}
|
|
|
+ *
|
|
|
+ * @param color {@link Color}
|
|
|
* @param prefix 前缀字符串,可以是#、0x等
|
|
|
* @return Hex字符串
|
|
|
* @since 3.0.8
|
|
|
*/
|
|
|
public static String encodeColor(Color color, String prefix) {
|
|
|
- final StringBuffer builder = new StringBuffer(prefix);
|
|
|
+ final StringBuilder builder = new StringBuilder(prefix);
|
|
|
String colorHex;
|
|
|
colorHex = Integer.toHexString(color.getRed());
|
|
|
if (1 == colorHex.length()) {
|
|
|
@@ -242,7 +244,7 @@ public class HexUtil {
|
|
|
|
|
|
/**
|
|
|
* 将Hex颜色值转为
|
|
|
- *
|
|
|
+ *
|
|
|
* @param hexColor 16进制颜色值,可以以#开头,也可以用0x开头
|
|
|
* @return {@link Color}
|
|
|
* @since 3.0.8
|
|
|
@@ -254,11 +256,11 @@ public class HexUtil {
|
|
|
/**
|
|
|
* 将指定int值转换为Unicode字符串形式,常用于特殊字符(例如汉字)转Unicode形式<br>
|
|
|
* 转换的字符串如果u后不足4位,则前面用0填充,例如:
|
|
|
- *
|
|
|
+ *
|
|
|
* <pre>
|
|
|
* '我' =》\u4f60
|
|
|
* </pre>
|
|
|
- *
|
|
|
+ *
|
|
|
* @param value int值,也可以是char
|
|
|
* @return Unicode表现形式
|
|
|
*/
|
|
|
@@ -279,28 +281,26 @@ public class HexUtil {
|
|
|
/**
|
|
|
* 将指定char值转换为Unicode字符串形式,常用于特殊字符(例如汉字)转Unicode形式<br>
|
|
|
* 转换的字符串如果u后不足4位,则前面用0填充,例如:
|
|
|
- *
|
|
|
+ *
|
|
|
* <pre>
|
|
|
* '我' =》\u4f60
|
|
|
* </pre>
|
|
|
- *
|
|
|
+ *
|
|
|
* @param ch char值
|
|
|
* @return Unicode表现形式
|
|
|
* @since 4.0.1
|
|
|
*/
|
|
|
public static String toUnicodeHex(char ch) {
|
|
|
- StringBuilder sb = new StringBuilder(6);
|
|
|
- sb.append("\\u");
|
|
|
- sb.append(DIGITS_LOWER[(ch >> 12) & 15]);
|
|
|
- sb.append(DIGITS_LOWER[(ch >> 8) & 15]);
|
|
|
- sb.append(DIGITS_LOWER[(ch >> 4) & 15]);
|
|
|
- sb.append(DIGITS_LOWER[(ch) & 15]);
|
|
|
- return sb.toString();
|
|
|
+ return "\\u" +//
|
|
|
+ DIGITS_LOWER[(ch >> 12) & 15] +//
|
|
|
+ DIGITS_LOWER[(ch >> 8) & 15] +//
|
|
|
+ DIGITS_LOWER[(ch >> 4) & 15] +//
|
|
|
+ DIGITS_LOWER[(ch) & 15];
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 转为16进制字符串
|
|
|
- *
|
|
|
+ *
|
|
|
* @param value int值
|
|
|
* @return 16进制字符串
|
|
|
* @since 4.4.1
|
|
|
@@ -311,7 +311,7 @@ public class HexUtil {
|
|
|
|
|
|
/**
|
|
|
* 转为16进制字符串
|
|
|
- *
|
|
|
+ *
|
|
|
* @param value int值
|
|
|
* @return 16进制字符串
|
|
|
* @since 4.4.1
|
|
|
@@ -319,17 +319,18 @@ public class HexUtil {
|
|
|
public static String toHex(long value) {
|
|
|
return Long.toHexString(value);
|
|
|
}
|
|
|
-
|
|
|
+
|
|
|
/**
|
|
|
* 将byte值转为16进制并添加到{@link StringBuilder}中
|
|
|
- * @param builder {@link StringBuilder}
|
|
|
- * @param b byte
|
|
|
+ *
|
|
|
+ * @param builder {@link StringBuilder}
|
|
|
+ * @param b byte
|
|
|
* @param toLowerCase 是否使用小写
|
|
|
* @since 4.4.1
|
|
|
*/
|
|
|
public static void appendHex(StringBuilder builder, byte b, boolean toLowerCase) {
|
|
|
final char[] toDigits = toLowerCase ? DIGITS_LOWER : DIGITS_UPPER;
|
|
|
-
|
|
|
+
|
|
|
int high = (b & 0xf0) >>> 4;//高位
|
|
|
int low = b & 0x0f;//低位
|
|
|
builder.append(toDigits[high]);
|
|
|
@@ -337,10 +338,11 @@ public class HexUtil {
|
|
|
}
|
|
|
|
|
|
// ---------------------------------------------------------------------------------------- Private method start
|
|
|
+
|
|
|
/**
|
|
|
* 将字节数组转换为十六进制字符串
|
|
|
*
|
|
|
- * @param data byte[]
|
|
|
+ * @param data byte[]
|
|
|
* @param toDigits 用于控制输出的char[]
|
|
|
* @return 十六进制String
|
|
|
*/
|
|
|
@@ -351,7 +353,7 @@ public class HexUtil {
|
|
|
/**
|
|
|
* 将字节数组转换为十六进制字符数组
|
|
|
*
|
|
|
- * @param data byte[]
|
|
|
+ * @param data byte[]
|
|
|
* @param toDigits 用于控制输出的char[]
|
|
|
* @return 十六进制char[]
|
|
|
*/
|
|
|
@@ -369,7 +371,7 @@ public class HexUtil {
|
|
|
/**
|
|
|
* 将十六进制字符转换成一个整数
|
|
|
*
|
|
|
- * @param ch 十六进制char
|
|
|
+ * @param ch 十六进制char
|
|
|
* @param index 十六进制字符在字符数组中的位置
|
|
|
* @return 一个整数
|
|
|
* @throws RuntimeException 当ch不是一个合法的十六进制字符时,抛出运行时异常
|