|
@@ -1,8 +1,6 @@
|
|
|
package com.example.util;
|
|
|
|
|
|
|
|
|
-import com.sun.xml.internal.ws.util.UtilException;
|
|
|
-
|
|
|
import java.security.MessageDigest;
|
|
|
import java.security.NoSuchAlgorithmException;
|
|
|
import java.security.SecureRandom;
|
|
@@ -14,41 +12,47 @@ import java.util.concurrent.ThreadLocalRandom;
|
|
|
*
|
|
|
* @author ruoyi
|
|
|
*/
|
|
|
-public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
-{
|
|
|
+public final class UUID implements java.io.Serializable, Comparable<UUID> {
|
|
|
private static final long serialVersionUID = -1185015143654744140L;
|
|
|
|
|
|
/**
|
|
|
* SecureRandom 的单例
|
|
|
- *
|
|
|
*/
|
|
|
- private static class Holder
|
|
|
- {
|
|
|
- static final SecureRandom numberGenerator = getSecureRandom();
|
|
|
+ private static class Holder {
|
|
|
+ static SecureRandom numberGenerator = null;
|
|
|
+
|
|
|
+ static {
|
|
|
+ try {
|
|
|
+ numberGenerator = getSecureRandom();
|
|
|
+ } catch (NoSuchAlgorithmException e) {
|
|
|
+ e.printStackTrace();
|
|
|
+ }
|
|
|
+ }
|
|
|
}
|
|
|
|
|
|
- /** 此UUID的最高64有效位 */
|
|
|
+ /**
|
|
|
+ * 此UUID的最高64有效位
|
|
|
+ */
|
|
|
private final long mostSigBits;
|
|
|
|
|
|
- /** 此UUID的最低64有效位 */
|
|
|
+ /**
|
|
|
+ * 此UUID的最低64有效位
|
|
|
+ */
|
|
|
private final long leastSigBits;
|
|
|
|
|
|
/**
|
|
|
* 私有构造
|
|
|
- *
|
|
|
+ *
|
|
|
* @param data 数据
|
|
|
*/
|
|
|
- private UUID(byte[] data)
|
|
|
- {
|
|
|
+ private UUID(byte[] data) {
|
|
|
long msb = 0;
|
|
|
long lsb = 0;
|
|
|
assert data.length == 16 : "data must be 16 bytes in length";
|
|
|
- for (int i = 0; i < 8; i++)
|
|
|
- {
|
|
|
+ for (int i = 0; i < 8; i++) {
|
|
|
msb = (msb << 8) | (data[i] & 0xff);
|
|
|
}
|
|
|
- for (int i = 8; i < 16; i++)
|
|
|
- {
|
|
|
+ for (int i = 8; i < 16; i++) {
|
|
|
lsb = (lsb << 8) | (data[i] & 0xff);
|
|
|
}
|
|
|
this.mostSigBits = msb;
|
|
@@ -58,43 +62,39 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
/**
|
|
|
* 使用指定的数据构造新的 UUID。
|
|
|
*
|
|
|
- * @param mostSigBits 用于 {@code UUID} 的最高有效 64 位
|
|
|
+ * @param mostSigBits 用于 {@code UUID} 的最高有效 64 位
|
|
|
* @param leastSigBits 用于 {@code UUID} 的最低有效 64 位
|
|
|
*/
|
|
|
- public UUID(long mostSigBits, long leastSigBits)
|
|
|
- {
|
|
|
+ public UUID(long mostSigBits, long leastSigBits) {
|
|
|
this.mostSigBits = mostSigBits;
|
|
|
this.leastSigBits = leastSigBits;
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取类型 4(伪随机生成的)UUID 的静态工厂。 使用加密的本地线程伪随机数生成器生成该 UUID。
|
|
|
- *
|
|
|
+ *
|
|
|
* @return 随机生成的 {@code UUID}
|
|
|
*/
|
|
|
- public static UUID fastUUID()
|
|
|
- {
|
|
|
+ public static UUID fastUUID() {
|
|
|
return randomUUID(false);
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取类型 4(伪随机生成的)UUID 的静态工厂。 使用加密的强伪随机数生成器生成该 UUID。
|
|
|
- *
|
|
|
+ *
|
|
|
* @return 随机生成的 {@code UUID}
|
|
|
*/
|
|
|
- public static UUID randomUUID()
|
|
|
- {
|
|
|
+ public static UUID randomUUID() {
|
|
|
return randomUUID(true);
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取类型 4(伪随机生成的)UUID 的静态工厂。 使用加密的强伪随机数生成器生成该 UUID。
|
|
|
- *
|
|
|
+ *
|
|
|
* @param isSecure 是否使用{@link SecureRandom}如果是可以获得更安全的随机码,否则可以得到更好的性能
|
|
|
* @return 随机生成的 {@code UUID}
|
|
|
*/
|
|
|
- public static UUID randomUUID(boolean isSecure)
|
|
|
- {
|
|
|
+ public static UUID randomUUID(boolean isSecure) {
|
|
|
final Random ng = isSecure ? Holder.numberGenerator : getRandom();
|
|
|
|
|
|
byte[] randomBytes = new byte[16];
|
|
@@ -110,18 +110,13 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
* 根据指定的字节数组获取类型 3(基于名称的)UUID 的静态工厂。
|
|
|
*
|
|
|
* @param name 用于构造 UUID 的字节数组。
|
|
|
- *
|
|
|
* @return 根据指定数组生成的 {@code UUID}
|
|
|
*/
|
|
|
- public static UUID nameUUIDFromBytes(byte[] name)
|
|
|
- {
|
|
|
+ public static UUID nameUUIDFromBytes(byte[] name) {
|
|
|
MessageDigest md;
|
|
|
- try
|
|
|
- {
|
|
|
+ try {
|
|
|
md = MessageDigest.getInstance("MD5");
|
|
|
- }
|
|
|
- catch (NoSuchAlgorithmException nsae)
|
|
|
- {
|
|
|
+ } catch (NoSuchAlgorithmException nsae) {
|
|
|
throw new InternalError("MD5 not supported");
|
|
|
}
|
|
|
byte[] md5Bytes = md.digest(name);
|
|
@@ -138,17 +133,13 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
* @param name 指定 {@code UUID} 字符串
|
|
|
* @return 具有指定值的 {@code UUID}
|
|
|
* @throws IllegalArgumentException 如果 name 与 {@link #toString} 中描述的字符串表示形式不符抛出此异常
|
|
|
- *
|
|
|
*/
|
|
|
- public static UUID fromString(String name)
|
|
|
- {
|
|
|
+ public static UUID fromString(String name) {
|
|
|
String[] components = name.split("-");
|
|
|
- if (components.length != 5)
|
|
|
- {
|
|
|
+ if (components.length != 5) {
|
|
|
throw new IllegalArgumentException("Invalid UUID string: " + name);
|
|
|
}
|
|
|
- for (int i = 0; i < 5; i++)
|
|
|
- {
|
|
|
+ for (int i = 0; i < 5; i++) {
|
|
|
components[i] = "0x" + components[i];
|
|
|
}
|
|
|
|
|
@@ -170,8 +161,7 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
*
|
|
|
* @return 此 UUID 的 128 位值中的最低有效 64 位。
|
|
|
*/
|
|
|
- public long getLeastSignificantBits()
|
|
|
- {
|
|
|
+ public long getLeastSignificantBits() {
|
|
|
return leastSigBits;
|
|
|
}
|
|
|
|
|
@@ -180,8 +170,7 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
*
|
|
|
* @return 此 UUID 的 128 位值中最高有效 64 位。
|
|
|
*/
|
|
|
- public long getMostSignificantBits()
|
|
|
- {
|
|
|
+ public long getMostSignificantBits() {
|
|
|
return mostSigBits;
|
|
|
}
|
|
|
|
|
@@ -198,8 +187,7 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
*
|
|
|
* @return 此 {@code UUID} 的版本号
|
|
|
*/
|
|
|
- public int version()
|
|
|
- {
|
|
|
+ public int version() {
|
|
|
// Version is bits masked by 0x000000000000F000 in MS long
|
|
|
return (int) ((mostSigBits >> 12) & 0x0f);
|
|
|
}
|
|
@@ -217,8 +205,7 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
*
|
|
|
* @return 此 {@code UUID} 相关联的变体号
|
|
|
*/
|
|
|
- public int variant()
|
|
|
- {
|
|
|
+ public int variant() {
|
|
|
// This field is composed of a varying number of bits.
|
|
|
// 0 - - Reserved for NCS backward compatibility
|
|
|
// 1 0 - The IETF aka Leach-Salz variant (used by this class)
|
|
@@ -240,8 +227,7 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
*
|
|
|
* @throws UnsupportedOperationException 如果此 {@code UUID} 不是 version 为 1 的 UUID。
|
|
|
*/
|
|
|
- public long timestamp() throws UnsupportedOperationException
|
|
|
- {
|
|
|
+ public long timestamp() throws UnsupportedOperationException {
|
|
|
checkTimeBase();
|
|
|
return (mostSigBits & 0x0FFFL) << 48//
|
|
|
| ((mostSigBits >> 16) & 0x0FFFFL) << 32//
|
|
@@ -258,11 +244,9 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
* UnsupportedOperationException。
|
|
|
*
|
|
|
* @return 此 {@code UUID} 的时钟序列
|
|
|
- *
|
|
|
* @throws UnsupportedOperationException 如果此 UUID 的 version 不为 1
|
|
|
*/
|
|
|
- public int clockSequence() throws UnsupportedOperationException
|
|
|
- {
|
|
|
+ public int clockSequence() throws UnsupportedOperationException {
|
|
|
checkTimeBase();
|
|
|
return (int) ((leastSigBits & 0x3FFF000000000000L) >>> 48);
|
|
|
}
|
|
@@ -277,11 +261,9 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
* 如果此 UUID 不是基于时间的 UUID,则此方法抛出 UnsupportedOperationException。
|
|
|
*
|
|
|
* @return 此 {@code UUID} 的节点值
|
|
|
- *
|
|
|
* @throws UnsupportedOperationException 如果此 UUID 的 version 不为 1
|
|
|
*/
|
|
|
- public long node() throws UnsupportedOperationException
|
|
|
- {
|
|
|
+ public long node() throws UnsupportedOperationException {
|
|
|
checkTimeBase();
|
|
|
return leastSigBits & 0x0000FFFFFFFFFFFFL;
|
|
|
}
|
|
@@ -291,7 +273,7 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
*
|
|
|
* <p>
|
|
|
* UUID 的字符串表示形式由此 BNF 描述:
|
|
|
- *
|
|
|
+ *
|
|
|
* <pre>
|
|
|
* {@code
|
|
|
* UUID = <time_low>-<time_mid>-<time_high_and_version>-<variant_and_sequence>-<node>
|
|
@@ -304,15 +286,14 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
* hexDigit = [0-9a-fA-F]
|
|
|
* }
|
|
|
* </pre>
|
|
|
- *
|
|
|
+ *
|
|
|
* </blockquote>
|
|
|
*
|
|
|
* @return 此{@code UUID} 的字符串表现形式
|
|
|
* @see #toString(boolean)
|
|
|
*/
|
|
|
@Override
|
|
|
- public String toString()
|
|
|
- {
|
|
|
+ public String toString() {
|
|
|
return toString(false);
|
|
|
}
|
|
|
|
|
@@ -321,7 +302,7 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
*
|
|
|
* <p>
|
|
|
* UUID 的字符串表示形式由此 BNF 描述:
|
|
|
- *
|
|
|
+ *
|
|
|
* <pre>
|
|
|
* {@code
|
|
|
* UUID = <time_low>-<time_mid>-<time_high_and_version>-<variant_and_sequence>-<node>
|
|
@@ -334,37 +315,32 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
* hexDigit = [0-9a-fA-F]
|
|
|
* }
|
|
|
* </pre>
|
|
|
- *
|
|
|
+ *
|
|
|
* </blockquote>
|
|
|
*
|
|
|
* @param isSimple 是否简单模式,简单模式为不带'-'的UUID字符串
|
|
|
* @return 此{@code UUID} 的字符串表现形式
|
|
|
*/
|
|
|
- public String toString(boolean isSimple)
|
|
|
- {
|
|
|
+ public String toString(boolean isSimple) {
|
|
|
final StringBuilder builder = new StringBuilder(isSimple ? 32 : 36);
|
|
|
// time_low
|
|
|
builder.append(digits(mostSigBits >> 32, 8));
|
|
|
- if (false == isSimple)
|
|
|
- {
|
|
|
+ if (false == isSimple) {
|
|
|
builder.append('-');
|
|
|
}
|
|
|
// time_mid
|
|
|
builder.append(digits(mostSigBits >> 16, 4));
|
|
|
- if (false == isSimple)
|
|
|
- {
|
|
|
+ if (false == isSimple) {
|
|
|
builder.append('-');
|
|
|
}
|
|
|
// time_high_and_version
|
|
|
builder.append(digits(mostSigBits, 4));
|
|
|
- if (false == isSimple)
|
|
|
- {
|
|
|
+ if (false == isSimple) {
|
|
|
builder.append('-');
|
|
|
}
|
|
|
// variant_and_sequence
|
|
|
builder.append(digits(leastSigBits >> 48, 4));
|
|
|
- if (false == isSimple)
|
|
|
- {
|
|
|
+ if (false == isSimple) {
|
|
|
builder.append('-');
|
|
|
}
|
|
|
// node
|
|
@@ -379,8 +355,7 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
* @return UUID 的哈希码值。
|
|
|
*/
|
|
|
@Override
|
|
|
- public int hashCode()
|
|
|
- {
|
|
|
+ public int hashCode() {
|
|
|
long hilo = mostSigBits ^ leastSigBits;
|
|
|
return ((int) (hilo >> 32)) ^ (int) hilo;
|
|
|
}
|
|
@@ -391,14 +366,11 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
* 当且仅当参数不为 {@code null}、而是一个 UUID 对象、具有与此 UUID 相同的 varriant、包含相同的值(每一位均相同)时,结果才为 {@code true}。
|
|
|
*
|
|
|
* @param obj 要与之比较的对象
|
|
|
- *
|
|
|
* @return 如果对象相同,则返回 {@code true};否则返回 {@code false}
|
|
|
*/
|
|
|
@Override
|
|
|
- public boolean equals(Object obj)
|
|
|
- {
|
|
|
- if ((null == obj) || (obj.getClass() != UUID.class))
|
|
|
- {
|
|
|
+ public boolean equals(Object obj) {
|
|
|
+ if ((null == obj) || (obj.getClass() != UUID.class)) {
|
|
|
return false;
|
|
|
}
|
|
|
UUID id = (UUID) obj;
|
|
@@ -414,13 +386,10 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
* 如果两个 UUID 不同,且第一个 UUID 的最高有效字段大于第二个 UUID 的对应字段,则第一个 UUID 大于第二个 UUID。
|
|
|
*
|
|
|
* @param val 与此 UUID 比较的 UUID
|
|
|
- *
|
|
|
* @return 在此 UUID 小于、等于或大于 val 时,分别返回 -1、0 或 1。
|
|
|
- *
|
|
|
*/
|
|
|
@Override
|
|
|
- public int compareTo(UUID val)
|
|
|
- {
|
|
|
+ public int compareTo(UUID val) {
|
|
|
// The ordering is intentionally set up so that the UUIDs
|
|
|
// can simply be numerically compared as two numbers
|
|
|
return (this.mostSigBits < val.mostSigBits ? -1 : //
|
|
@@ -432,15 +401,15 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
|
|
|
// -------------------------------------------------------------------------------------------------------------------
|
|
|
// Private method start
|
|
|
+
|
|
|
/**
|
|
|
* 返回指定数字对应的hex值
|
|
|
- *
|
|
|
- * @param val 值
|
|
|
+ *
|
|
|
+ * @param val 值
|
|
|
* @param digits 位
|
|
|
* @return 值
|
|
|
*/
|
|
|
- private static String digits(long val, int digits)
|
|
|
- {
|
|
|
+ private static String digits(long val, int digits) {
|
|
|
long hi = 1L << (digits * 4);
|
|
|
return Long.toHexString(hi | (val & (hi - 1))).substring(1);
|
|
|
}
|
|
@@ -448,39 +417,30 @@ public final class UUID implements java.io.Serializable, Comparable<UUID>
|
|
|
/**
|
|
|
* 检查是否为time-based版本UUID
|
|
|
*/
|
|
|
- private void checkTimeBase()
|
|
|
- {
|
|
|
- if (version() != 1)
|
|
|
- {
|
|
|
+ private void checkTimeBase() {
|
|
|
+ if (version() != 1) {
|
|
|
throw new UnsupportedOperationException("Not a time-based UUID");
|
|
|
}
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取{@link SecureRandom},类提供加密的强随机数生成器 (RNG)
|
|
|
- *
|
|
|
+ *
|
|
|
* @return {@link SecureRandom}
|
|
|
*/
|
|
|
- public static SecureRandom getSecureRandom()
|
|
|
- {
|
|
|
- try
|
|
|
- {
|
|
|
- return SecureRandom.getInstance("SHA1PRNG");
|
|
|
- }
|
|
|
- catch (NoSuchAlgorithmException e)
|
|
|
- {
|
|
|
- throw new UtilException(e);
|
|
|
- }
|
|
|
+ public static SecureRandom getSecureRandom() throws NoSuchAlgorithmException {
|
|
|
+
|
|
|
+ return SecureRandom.getInstance("SHA1PRNG");
|
|
|
+
|
|
|
}
|
|
|
|
|
|
/**
|
|
|
* 获取随机数生成器对象<br>
|
|
|
* ThreadLocalRandom是JDK 7之后提供并发产生随机数,能够解决多个线程发生的竞争争夺。
|
|
|
- *
|
|
|
+ *
|
|
|
* @return {@link ThreadLocalRandom}
|
|
|
*/
|
|
|
- public static ThreadLocalRandom getRandom()
|
|
|
- {
|
|
|
+ public static ThreadLocalRandom getRandom() {
|
|
|
return ThreadLocalRandom.current();
|
|
|
}
|
|
|
}
|