增加app一键报警

‘liusuyi’

2023-07-21 b91fdc439ca1ba0b98409de0f1c0edf6fd626ee9

增加app一键报警

 src/main/java/com/ard/alarm/apponekey/controller/ArdAlarmApponekeyController.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,40 @@
package com.ard.alarm.apponekey.controller;

import com.ard.utils.hiksdk.util.minio.MinioUtils;
import com.ard.utils.http.AjaxResult;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;
import com.ard.alarm.apponekey.domain.ArdAlarmApponekey;
import com.ard.alarm.apponekey.service.IArdAlarmApponekeyService;
import org.springframework.web.multipart.MultipartFile;


/**
 * app一键报警Controller
 *
 * @author ard
 * @date 2023-07-21
 */
@RestController
@RequestMapping("/alarm/apponekey")
public class ArdAlarmApponekeyController {
    @Autowired
    private IArdAlarmApponekeyService ardAlarmApponekeyService;


    /**
     * æ–°å¢žapp一键报警
     */
    @PostMapping
    public AjaxResult add(String userId,String name, Double longitude,Double latitude,Double altitude,MultipartFile file) {
        String url = MinioUtils.putObjectAndGetUrl("record", file);
        ArdAlarmApponekey ardAlarmApponekey =new ArdAlarmApponekey();
        ardAlarmApponekey.setUserId(userId);
        ardAlarmApponekey.setName(name);
        ardAlarmApponekey.setLongitude(longitude);
        ardAlarmApponekey.setLatitude(latitude);
        ardAlarmApponekey.setAltitude(altitude);
        ardAlarmApponekey.setRecordUrl(url);
        return AjaxResult.success(ardAlarmApponekeyService.insertArdAlarmApponekey(ardAlarmApponekey));
    }
}

 src/main/java/com/ard/alarm/apponekey/domain/ArdAlarmApponekey.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,40 @@
package com.ard.alarm.apponekey.domain;

import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import java.util.Date;

/**
 * app一键报警对象 ard_alarm_apponekey
 * 
 * @author ard
 * @date 2023-07-21
 */
@Data
public class ArdAlarmApponekey
{
    private static final long serialVersionUID = 1L;

    /** ID */
    private String id;

    /** app用户ID */
    private String userId;
    /** app用户姓名 */
    private String name;
    /** ç»åº¦ */
    private Double longitude;

    /** çº¬åº¦ */
    private Double latitude;

    /** é«˜å±‚ */
    private Double altitude;

    /** å½•åƒurl */
    private String recordUrl;

    /** æŽ¥æ”¶åˆ›å»ºæ—¶é—´ */
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss")
    private Date createTime;
}

 src/main/java/com/ard/alarm/apponekey/mapper/ArdAlarmApponekeyMapper.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,63 @@
package com.ard.alarm.apponekey.mapper;

import java.util.List;
import com.ard.alarm.apponekey.domain.ArdAlarmApponekey;
import org.apache.ibatis.annotations.Mapper;

/**
 * app一键报警Mapper接口
 * 
 * @author ard
 * @date 2023-07-21
 */
@Mapper
public interface ArdAlarmApponekeyMapper 
{
    /**
     * æŸ¥è¯¢app一键报警
     * 
     * @param id app一键报警主键
     * @return app一键报警
     */
    public ArdAlarmApponekey selectArdAlarmApponekeyById(String id);

    /**
     * æŸ¥è¯¢app一键报警列表
     * 
     * @param ardAlarmApponekey app一键报警
     * @return app一键报警集合
     */
    public List<ArdAlarmApponekey> selectArdAlarmApponekeyList(ArdAlarmApponekey ardAlarmApponekey);

    /**
     * æ–°å¢žapp一键报警
     * 
     * @param ardAlarmApponekey app一键报警
     * @return ç»“æžœ
     */
    public int insertArdAlarmApponekey(ArdAlarmApponekey ardAlarmApponekey);

    /**
     * ä¿®æ”¹app一键报警
     * 
     * @param ardAlarmApponekey app一键报警
     * @return ç»“æžœ
     */
    public int updateArdAlarmApponekey(ArdAlarmApponekey ardAlarmApponekey);

    /**
     * åˆ é™¤app一键报警
     * 
     * @param id app一键报警主键
     * @return ç»“æžœ
     */
    public int deleteArdAlarmApponekeyById(String id);

    /**
     * æ‰¹é‡åˆ é™¤app一键报警
     * 
     * @param ids éœ€è¦åˆ é™¤çš„数据主键集合
     * @return ç»“æžœ
     */
    public int deleteArdAlarmApponekeyByIds(String[] ids);
}

 src/main/java/com/ard/alarm/apponekey/service/IArdAlarmApponekeyService.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,61 @@
package com.ard.alarm.apponekey.service;

import java.util.List;
import com.ard.alarm.apponekey.domain.ArdAlarmApponekey;

/**
 * app一键报警Service接口
 * 
 * @author ard
 * @date 2023-07-21
 */
public interface IArdAlarmApponekeyService 
{
    /**
     * æŸ¥è¯¢app一键报警
     * 
     * @param id app一键报警主键
     * @return app一键报警
     */
    public ArdAlarmApponekey selectArdAlarmApponekeyById(String id);

    /**
     * æŸ¥è¯¢app一键报警列表
     * 
     * @param ardAlarmApponekey app一键报警
     * @return app一键报警集合
     */
    public List<ArdAlarmApponekey> selectArdAlarmApponekeyList(ArdAlarmApponekey ardAlarmApponekey);

    /**
     * æ–°å¢žapp一键报警
     * 
     * @param ardAlarmApponekey app一键报警
     * @return ç»“æžœ
     */
    public int insertArdAlarmApponekey(ArdAlarmApponekey ardAlarmApponekey);

    /**
     * ä¿®æ”¹app一键报警
     * 
     * @param ardAlarmApponekey app一键报警
     * @return ç»“æžœ
     */
    public int updateArdAlarmApponekey(ArdAlarmApponekey ardAlarmApponekey);

    /**
     * æ‰¹é‡åˆ é™¤app一键报警
     * 
     * @param ids éœ€è¦åˆ é™¤çš„app一键报警主键集合
     * @return ç»“æžœ
     */
    public int deleteArdAlarmApponekeyByIds(String[] ids);

    /**
     * åˆ é™¤app一键报警信息
     * 
     * @param id app一键报警主键
     * @return ç»“æžœ
     */
    public int deleteArdAlarmApponekeyById(String id);
}

 src/main/java/com/ard/alarm/apponekey/service/impl/ArdAlarmApponekeyServiceImpl.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,111 @@
package com.ard.alarm.apponekey.service.impl;

import java.util.Date;
import java.util.List;

import com.alibaba.fastjson2.JSON;
import com.ard.utils.mqtt.MqttConsumer;
import com.ard.utils.uuid.IdUtils;
import lombok.extern.slf4j.Slf4j;
import org.springframework.stereotype.Service;
import com.ard.alarm.apponekey.mapper.ArdAlarmApponekeyMapper;
import com.ard.alarm.apponekey.domain.ArdAlarmApponekey;
import com.ard.alarm.apponekey.service.IArdAlarmApponekeyService;

import javax.annotation.Resource;

import static jdk.nashorn.internal.runtime.regexp.joni.Config.log;

/**
 * app一键报警Service业务层处理
 *
 * @author ard
 * @date 2023-07-21
 */
@Service
@Slf4j(topic = "apponekey")
public class ArdAlarmApponekeyServiceImpl implements IArdAlarmApponekeyService {
    @Resource
    private ArdAlarmApponekeyMapper ardAlarmApponekeyMapper;

    /**
     * æŸ¥è¯¢app一键报警
     *
     * @param id app一键报警主键
     * @return app一键报警
     */
    @Override
    public ArdAlarmApponekey selectArdAlarmApponekeyById(String id) {
        return ardAlarmApponekeyMapper.selectArdAlarmApponekeyById(id);
    }

    /**
     * æŸ¥è¯¢app一键报警列表
     *
     * @param ardAlarmApponekey app一键报警
     * @return app一键报警
     */
    @Override
    public List<ArdAlarmApponekey> selectArdAlarmApponekeyList(ArdAlarmApponekey ardAlarmApponekey) {
        return ardAlarmApponekeyMapper.selectArdAlarmApponekeyList(ardAlarmApponekey);
    }

    /**
     * æ–°å¢žapp一键报警
     *
     * @param ardAlarmApponekey app一键报警
     * @return ç»“æžœ
     */
    @Override
    public int insertArdAlarmApponekey(ArdAlarmApponekey ardAlarmApponekey) {
        try {
            ardAlarmApponekey.setId(IdUtils.fastSimpleUUID());
            ardAlarmApponekey.setCreateTime(new Date());
            printLog(ardAlarmApponekey);
            MqttConsumer.publish(2, false, "apponekey", JSON.toJSONString(ardAlarmApponekey));
            return 1;
        } catch (Exception ex) {
            log.error("一键报警处理异常:" + ex.getMessage());
            return 0;
        }
    }

    private void printLog(ArdAlarmApponekey ardAlarmApponekey) {
        log.info("收到数据:" + "【ID】" + ardAlarmApponekey.getId() + "【userId】" + ardAlarmApponekey.getUserId()
                + "【经度】" + ardAlarmApponekey.getLongitude() + "【纬度】" + ardAlarmApponekey.getLatitude()
                + "【高层】" + ardAlarmApponekey.getAltitude() + "【创建时间】" + ardAlarmApponekey.getCreateTime());
    }

    /**
     * ä¿®æ”¹app一键报警
     *
     * @param ardAlarmApponekey app一键报警
     * @return ç»“æžœ
     */
    @Override
    public int updateArdAlarmApponekey(ArdAlarmApponekey ardAlarmApponekey) {
        return ardAlarmApponekeyMapper.updateArdAlarmApponekey(ardAlarmApponekey);
    }

    /**
     * æ‰¹é‡åˆ é™¤app一键报警
     *
     * @param ids éœ€è¦åˆ é™¤çš„app一键报警主键
     * @return ç»“æžœ
     */
    @Override
    public int deleteArdAlarmApponekeyByIds(String[] ids) {
        return ardAlarmApponekeyMapper.deleteArdAlarmApponekeyByIds(ids);
    }

    /**
     * åˆ é™¤app一键报警信息
     *
     * @param id app一键报警主键
     * @return ç»“æžœ
     */
    @Override
    public int deleteArdAlarmApponekeyById(String id) {
        return ardAlarmApponekeyMapper.deleteArdAlarmApponekeyById(id);
    }
}

 src/main/java/com/ard/utils/hiksdk/util/minio/MinioUtils.java

@@ -154,7 +154,7 @@
        //文件名
        String originalFilename = file.getOriginalFilename();
        //新的文件名
        String fileName = UUID.randomUUID().toString().replace("-", "") + originalFilename;
        String fileName = UUID.randomUUID().toString().replace("-", "") +"_"+ originalFilename;
        try {
            InputStream inputStream = file.getInputStream();
            /*上传对象*/
@@ -170,10 +170,13 @@
            /*获取url*/
            GetPresignedObjectUrlArgs getPresignedObjectUrlArgs = GetPresignedObjectUrlArgs
                    .builder()
                    .method(Method.GET)
                    .bucket(bucketName)
                    .object(fileName)
                    .build();
            return MinioClientSingleton.getMinioClient().getPresignedObjectUrl(getPresignedObjectUrlArgs);
            String presignedObjectUrl = MinioClientSingleton.getMinioClient().getPresignedObjectUrl(getPresignedObjectUrlArgs);
            String ObjectUrl  = presignedObjectUrl.substring(0, presignedObjectUrl.indexOf("?"));
            return ObjectUrl;
        } catch (Exception ex) {
            log.error("上传对象返回url异常：" + ex.getMessage());
        }

 src/main/java/com/ard/utils/http/AjaxResult.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,204 @@
package com.ard.utils.http;

import java.util.HashMap;

/**
 * æ“ä½œæ¶ˆæ¯æé†’
 *
 * @author ruoyi
 */
public class AjaxResult extends HashMap<String, Object>
{
    private static final long serialVersionUID = 1L;

    /** çŠ¶æ€ç  */
    public static final String CODE_TAG = "code";

    /** è¿”回内容 */
    public static final String MSG_TAG = "msg";

    /** æ•°æ®å¯¹è±¡ */
    public static final String DATA_TAG = "data";

    /**
     * åˆå§‹åŒ–一个新创建的 AjaxResult å¯¹è±¡ï¼Œä½¿å…¶è¡¨ç¤ºä¸€ä¸ªç©ºæ¶ˆæ¯ã€‚
     */
    public AjaxResult()
    {
    }

    /**
     * åˆå§‹åŒ–一个新创建的 AjaxResult å¯¹è±¡
     *
     * @param code çŠ¶æ€ç 
     * @param msg è¿”回内容
     */
    public AjaxResult(int code, String msg)
    {
        super.put(CODE_TAG, code);
        super.put(MSG_TAG, msg);
    }

    /**
     * åˆå§‹åŒ–一个新创建的 AjaxResult å¯¹è±¡
     *
     * @param code çŠ¶æ€ç 
     * @param msg è¿”回内容
     * @param data æ•°æ®å¯¹è±¡
     */
    public AjaxResult(int code, String msg, Object data)
    {
        super.put(CODE_TAG, code);
        super.put(MSG_TAG, msg);
        if (data!=null)
        {
            super.put(DATA_TAG, data);
        }
    }

    /**
     * è¿”回成功消息
     *
     * @return æˆåŠŸæ¶ˆæ¯
     */
    public static AjaxResult success()
    {
        return AjaxResult.success("操作成功");
    }

    /**
     * è¿”回成功数据
     *
     * @return æˆåŠŸæ¶ˆæ¯
     */
    public static AjaxResult success(Object data)
    {
        return AjaxResult.success("操作成功", data);
    }

    /**
     * è¿”回成功消息
     *
     * @param msg è¿”回内容
     * @return æˆåŠŸæ¶ˆæ¯
     */
    public static AjaxResult success(String msg)
    {
        return AjaxResult.success(msg, null);
    }

    /**
     * è¿”回成功消息
     *
     * @param msg è¿”回内容
     * @param data æ•°æ®å¯¹è±¡
     * @return æˆåŠŸæ¶ˆæ¯
     */
    public static AjaxResult success(String msg, Object data)
    {
        return new AjaxResult(HttpStatus.SUCCESS, msg, data);
    }

    /**
     * è¿”回警告消息
     *
     * @param msg è¿”回内容
     * @return è­¦å‘Šæ¶ˆæ¯
     */
    public static AjaxResult warn(String msg)
    {
        return AjaxResult.warn(msg, null);
    }

    /**
     * è¿”回警告消息
     *
     * @param msg è¿”回内容
     * @param data æ•°æ®å¯¹è±¡
     * @return è­¦å‘Šæ¶ˆæ¯
     */
    public static AjaxResult warn(String msg, Object data)
    {
        return new AjaxResult(HttpStatus.WARN, msg, data);
    }

    /**
     * è¿”回错误消息
     *
     * @return é”™è¯¯æ¶ˆæ¯
     */
    public static AjaxResult error()
    {
        return AjaxResult.error("操作失败");
    }

    /**
     * è¿”回错误消息
     *
     * @param msg è¿”回内容
     * @return é”™è¯¯æ¶ˆæ¯
     */
    public static AjaxResult error(String msg)
    {
        return AjaxResult.error(msg, null);
    }

    /**
     * è¿”回错误消息
     *
     * @param msg è¿”回内容
     * @param data æ•°æ®å¯¹è±¡
     * @return é”™è¯¯æ¶ˆæ¯
     */
    public static AjaxResult error(String msg, Object data)
    {
        return new AjaxResult(HttpStatus.ERROR, msg, data);
    }

    /**
     * è¿”回错误消息
     *
     * @param code çŠ¶æ€ç 
     * @param msg è¿”回内容
     * @return é”™è¯¯æ¶ˆæ¯
     */
    public static AjaxResult error(int code, String msg)
    {
        return new AjaxResult(code, msg, null);
    }

    /**
     * æ–¹ä¾¿é“¾å¼è°ƒç”¨
     *
     * @param key é”®
     * @param value å€¼
     * @return æ•°æ®å¯¹è±¡
     */
    @Override
    public AjaxResult put(String key, Object value)
    {
        super.put(key, value);
        return this;
    }
    /**
     * å“åº”返回结果
     *
     * @param rows å½±å“è¡Œæ•°
     * @return æ“ä½œç»“æžœ
     */
    public  static AjaxResult toAjax(int rows)
    {
        return rows > 0 ? AjaxResult.success() : AjaxResult.error();
    }
    /**
     * å“åº”返回结果
     *
     * @param result ç»“æžœ
     * @return æ“ä½œç»“æžœ
     */
    public static AjaxResult toAjax(boolean result)
    {
        return result ? success() : error();
    }
}


 src/main/java/com/ard/utils/http/HttpStatus.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,95 @@
package com.ard.utils.http;

/**
 * è¿”回状态码
 *
 * @author ruoyi
 */
public class HttpStatus
{
    /**
     * æ“ä½œæˆåŠŸ
     */
    public static final int SUCCESS = 200;

    /**
     * å¯¹è±¡åˆ›å»ºæˆåŠŸ
     */
    public static final int CREATED = 201;

    /**
     * è¯·æ±‚已经被接受
     */
    public static final int ACCEPTED = 202;

    /**
     * æ“ä½œå·²ç»æ‰§è¡ŒæˆåŠŸï¼Œä½†æ˜¯æ²¡æœ‰è¿”回数据
     */
    public static final int NO_CONTENT = 204;

    /**
     * èµ„源已被移除
     */
    public static final int MOVED_PERM = 301;

    /**
     * é‡å®šå‘
     */
    public static final int SEE_OTHER = 303;

    /**
     * èµ„源没有被修改
     */
    public static final int NOT_MODIFIED = 304;

    /**
     * å‚数列表错误（缺少，格式不匹配）
     */
    public static final int BAD_REQUEST = 400;

    /**
     * æœªæŽˆæƒ
     */
    public static final int UNAUTHORIZED = 401;

    /**
     * è®¿é—®å—限，授权过期
     */
    public static final int FORBIDDEN = 403;

    /**
     * èµ„源，服务未找到
     */
    public static final int NOT_FOUND = 404;

    /**
     * ä¸å…è®¸çš„http方法
     */
    public static final int BAD_METHOD = 405;

    /**
     * èµ„源冲突，或者资源被锁
     */
    public static final int CONFLICT = 409;

    /**
     * ä¸æ”¯æŒçš„数据，媒体类型
     */
    public static final int UNSUPPORTED_TYPE = 415;

    /**
     * ç³»ç»Ÿå†…部错误
     */
    public static final int ERROR = 500;

    /**
     * æŽ¥å£æœªå®žçŽ°
     */
    public static final int NOT_IMPLEMENTED = 501;

    /**
     * ç³»ç»Ÿè­¦å‘Šæ¶ˆæ¯
     */
    public static final int WARN = 601;
}


 src/main/java/com/ard/utils/uuid/IdUtils.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,50 @@
package com.ard.utils.uuid;


/**
 * ID生成器工具类
 * 
 * @author ruoyi
 */
public class IdUtils
{
    /**
     * èŽ·å–随机UUID
     * 
     * @return éšæœºUUID
     */
    public static String randomUUID()
    {
        return UUID.randomUUID().toString();
    }

    /**
     * ç®€åŒ–çš„UUID，去掉了横线
     * 
     * @return ç®€åŒ–çš„UUID，去掉了横线
     */
    public static String simpleUUID()
    {
        return UUID.randomUUID().toString(true);
    }

    /**
     * èŽ·å–随机UUID，使用性能更好的ThreadLocalRandom生成UUID
     * 
     * @return éšæœºUUID
     */
    public static String fastUUID()
    {
        return UUID.fastUUID().toString();
    }

    /**
     * ç®€åŒ–çš„UUID，去掉了横线，使用性能更好的ThreadLocalRandom生成UUID
     * 
     * @return ç®€åŒ–çš„UUID，去掉了横线
     */
    public static String fastSimpleUUID()
    {
        return UUID.fastUUID().toString(true);
    }
}

 src/main/java/com/ard/utils/uuid/UUID.java

¶Ô±ÈÐÂÎļþ
@@ -0,0 +1,485 @@
package com.ard.utils.uuid;

import com.sun.xml.internal.ws.util.UtilException;

import java.security.MessageDigest;
import java.security.NoSuchAlgorithmException;
import java.security.SecureRandom;
import java.util.Random;
import java.util.concurrent.ThreadLocalRandom;

/**
 * æä¾›é€šç”¨å”¯ä¸€è¯†åˆ«ç ï¼ˆuniversally unique identifier）（UUID）实现
 *
 * @author ruoyi
 */
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();
    }

    /** æ­¤UUID的最高64有效位 */
    private final long mostSigBits;

    /** æ­¤UUID的最低64有效位 */
    private final long leastSigBits;

    /**
     * ç§æœ‰æž„造
     * 
     * @param 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++)
        {
            msb = (msb << 8) | (data[i] & 0xff);
        }
        for (int i = 8; i < 16; i++)
        {
            lsb = (lsb << 8) | (data[i] & 0xff);
        }
        this.mostSigBits = msb;
        this.leastSigBits = lsb;
    }

    /**
     * ä½¿ç”¨æŒ‡å®šçš„数据构造新的 UUID。
     *
     * @param mostSigBits ç”¨äºŽ {@code UUID} çš„最高有效 64 ä½
     * @param leastSigBits ç”¨äºŽ {@code UUID} çš„最低有效 64 ä½
     */
    public UUID(long mostSigBits, long leastSigBits)
    {
        this.mostSigBits = mostSigBits;
        this.leastSigBits = leastSigBits;
    }

    /**
     * èŽ·å–类型 4（伪随机生成的）UUID çš„静态工厂。 ä½¿ç”¨åŠ å¯†çš„本地线程伪随机数生成器生成该 UUID。
     * 
     * @return éšæœºç”Ÿæˆçš„ {@code UUID}
     */
    public static UUID fastUUID()
    {
        return randomUUID(false);
    }

    /**
     * èŽ·å–类型 4（伪随机生成的）UUID çš„静态工厂。 ä½¿ç”¨åŠ å¯†çš„强伪随机数生成器生成该 UUID。
     * 
     * @return éšæœºç”Ÿæˆçš„ {@code UUID}
     */
    public static UUID randomUUID()
    {
        return randomUUID(true);
    }

    /**
     * èŽ·å–类型 4（伪随机生成的）UUID çš„静态工厂。 ä½¿ç”¨åŠ å¯†çš„强伪随机数生成器生成该 UUID。
     * 
     * @param isSecure æ˜¯å¦ä½¿ç”¨{@link SecureRandom}如果是可以获得更安全的随机码，否则可以得到更好的性能
     * @return éšæœºç”Ÿæˆçš„ {@code UUID}
     */
    public static UUID randomUUID(boolean isSecure)
    {
        final Random ng = isSecure ? Holder.numberGenerator : getRandom();

        byte[] randomBytes = new byte[16];
        ng.nextBytes(randomBytes);
        randomBytes[6] &= 0x0f; /* clear version */
        randomBytes[6] |= 0x40; /* set to version 4 */
        randomBytes[8] &= 0x3f; /* clear variant */
        randomBytes[8] |= 0x80; /* set to IETF variant */
        return new UUID(randomBytes);
    }

    /**
     * æ ¹æ®æŒ‡å®šçš„字节数组获取类型 3（基于名称的）UUID çš„静态工厂。
     *
     * @param name ç”¨äºŽæž„造 UUID çš„字节数组。
     *
     * @return æ ¹æ®æŒ‡å®šæ•°ç»„生成的 {@code UUID}
     */
    public static UUID nameUUIDFromBytes(byte[] name)
    {
        MessageDigest md;
        try
        {
            md = MessageDigest.getInstance("MD5");
        }
        catch (NoSuchAlgorithmException nsae)
        {
            throw new InternalError("MD5 not supported");
        }
        byte[] md5Bytes = md.digest(name);
        md5Bytes[6] &= 0x0f; /* clear version */
        md5Bytes[6] |= 0x30; /* set to version 3 */
        md5Bytes[8] &= 0x3f; /* clear variant */
        md5Bytes[8] |= 0x80; /* set to IETF variant */
        return new UUID(md5Bytes);
    }

    /**
     * æ ¹æ® {@link #toString()} æ–¹æ³•ä¸­æè¿°çš„字符串标准表示形式创建{@code UUID}。
     *
     * @param name æŒ‡å®š {@code UUID} å­—符串
     * @return å…·æœ‰æŒ‡å®šå€¼çš„ {@code UUID}
     * @throws IllegalArgumentException å¦‚æžœ name ä¸Ž {@link #toString} ä¸­æè¿°çš„字符串表示形式不符抛出此异常
     *
     */
    public static UUID fromString(String name)
    {
        String[] components = name.split("-");
        if (components.length != 5)
        {
            throw new IllegalArgumentException("Invalid UUID string: " + name);
        }
        for (int i = 0; i < 5; i++)
        {
            components[i] = "0x" + components[i];
        }

        long mostSigBits = Long.decode(components[0]).longValue();
        mostSigBits <<= 16;
        mostSigBits |= Long.decode(components[1]).longValue();
        mostSigBits <<= 16;
        mostSigBits |= Long.decode(components[2]).longValue();

        long leastSigBits = Long.decode(components[3]).longValue();
        leastSigBits <<= 48;
        leastSigBits |= Long.decode(components[4]).longValue();

        return new UUID(mostSigBits, leastSigBits);
    }

    /**
     * è¿”回此 UUID çš„ 128 ä½å€¼ä¸­çš„最低有效 64 ä½ã€‚
     *
     * @return æ­¤ UUID çš„ 128 ä½å€¼ä¸­çš„最低有效 64 ä½ã€‚
     */
    public long getLeastSignificantBits()
    {
        return leastSigBits;
    }

    /**
     * è¿”回此 UUID çš„ 128 ä½å€¼ä¸­çš„最高有效 64 ä½ã€‚
     *
     * @return æ­¤ UUID çš„ 128 ä½å€¼ä¸­æœ€é«˜æœ‰æ•ˆ 64 ä½ã€‚
     */
    public long getMostSignificantBits()
    {
        return mostSigBits;
    }

    /**
     * ä¸Žæ­¤ {@code UUID} ç›¸å…³è”的版本号. ç‰ˆæœ¬å·æè¿°æ­¤ {@code UUID} æ˜¯å¦‚何生成的。
     * <p>
     * ç‰ˆæœ¬å·å…·æœ‰ä»¥ä¸‹å«æ„:
     * <ul>
     * <li>1 åŸºäºŽæ—¶é—´çš„ UUID
     * <li>2 DCE å®‰å…¨ UUID
     * <li>3 åŸºäºŽåç§°çš„ UUID
     * <li>4 éšæœºç”Ÿæˆçš„ UUID
     * </ul>
     *
     * @return æ­¤ {@code UUID} çš„版本号
     */
    public int version()
    {
        // Version is bits masked by 0x000000000000F000 in MS long
        return (int) ((mostSigBits >> 12) & 0x0f);
    }

    /**
     * ä¸Žæ­¤ {@code UUID} ç›¸å…³è”的变体号。变体号描述 {@code UUID} çš„布局。
     * <p>
     * å˜ä½“号具有以下含意：
     * <ul>
     * <li>0 ä¸º NCS å‘后兼容保留
     * <li>2 <a href="http://www.ietf.org/rfc/rfc4122.txt">IETF&nbsp;RFC&nbsp;4122</a>(Leach-Salz), ç”¨äºŽæ­¤ç±»
     * <li>6 ä¿ç•™ï¼Œå¾®è½¯å‘后兼容
     * <li>7 ä¿ç•™ä¾›ä»¥åŽå®šä¹‰ä½¿ç”¨
     * </ul>
     *
     * @return æ­¤ {@code UUID} ç›¸å…³è”的变体号
     */
    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)
        // 1 1 0 Reserved, Microsoft backward compatibility
        // 1 1 1 Reserved for future definition.
        return (int) ((leastSigBits >>> (64 - (leastSigBits >>> 62))) & (leastSigBits >> 63));
    }

    /**
     * ä¸Žæ­¤ UUID ç›¸å…³è”的时间戳值。
     *
     * <p>
     * 60 ä½çš„时间戳值根据此 {@code UUID} çš„ time_low、time_mid å’Œ time_hi å­—段构造。<br>
     * æ‰€å¾—到的时间戳以 100 æ¯«å¾®ç§’为单位，从 UTC（通用协调时间） 1582 å¹´ 10 æœˆ 15 æ—¥é›¶æ—¶å¼€å§‹ã€‚
     *
     * <p>
     * æ—¶é—´æˆ³å€¼ä»…在在基于时间的 UUID（其 version ç±»åž‹ä¸º 1）中才有意义。<br>
     * å¦‚果此 {@code UUID} ä¸æ˜¯åŸºäºŽæ—¶é—´çš„ UUID，则此方法抛出 UnsupportedOperationException。
     *
     * @throws UnsupportedOperationException å¦‚果此 {@code UUID} ä¸æ˜¯ version ä¸º 1 çš„ UUID。
     */
    public long timestamp() throws UnsupportedOperationException
    {
        checkTimeBase();
        return (mostSigBits & 0x0FFFL) << 48//
                | ((mostSigBits >> 16) & 0x0FFFFL) << 32//
                | mostSigBits >>> 32;
    }

    /**
     * ä¸Žæ­¤ UUID ç›¸å…³è”的时钟序列值。
     *
     * <p>
     * 14 ä½çš„时钟序列值根据此 UUID çš„ clock_seq å­—段构造。clock_seq å­—段用于保证在基于时间的 UUID ä¸­çš„时间唯一性。
     * <p>
     * {@code clockSequence} å€¼ä»…在基于时间的 UUID（其 version ç±»åž‹ä¸º 1）中才有意义。 å¦‚果此 UUID ä¸æ˜¯åŸºäºŽæ—¶é—´çš„ UUID，则此方法抛出
     * UnsupportedOperationException。
     *
     * @return æ­¤ {@code UUID} çš„时钟序列
     *
     * @throws UnsupportedOperationException å¦‚果此 UUID çš„ version ä¸ä¸º 1
     */
    public int clockSequence() throws UnsupportedOperationException
    {
        checkTimeBase();
        return (int) ((leastSigBits & 0x3FFF000000000000L) >>> 48);
    }

    /**
     * ä¸Žæ­¤ UUID ç›¸å…³çš„节点值。
     *
     * <p>
     * 48 ä½çš„节点值根据此 UUID çš„ node å­—段构造。此字段旨在用于保存机器的 IEEE 802 åœ°å€ï¼Œè¯¥åœ°å€ç”¨äºŽç”Ÿæˆæ­¤ UUID ä»¥ä¿è¯ç©ºé—´å”¯ä¸€æ€§ã€‚
     * <p>
     * èŠ‚点值仅在基于时间的 UUID（其 version ç±»åž‹ä¸º 1）中才有意义。<br>
     * å¦‚果此 UUID ä¸æ˜¯åŸºäºŽæ—¶é—´çš„ UUID，则此方法抛出 UnsupportedOperationException。
     *
     * @return æ­¤ {@code UUID} çš„节点值
     *
     * @throws UnsupportedOperationException å¦‚果此 UUID çš„ version ä¸ä¸º 1
     */
    public long node() throws UnsupportedOperationException
    {
        checkTimeBase();
        return leastSigBits & 0x0000FFFFFFFFFFFFL;
    }

    /**
     * è¿”回此{@code UUID} çš„字符串表现形式。
     *
     * <p>
     * UUID çš„字符串表示形式由此 BNF æè¿°ï¼š
     * 
     * <pre>
     * {@code
     * UUID                   = <time_low>-<time_mid>-<time_high_and_version>-<variant_and_sequence>-<node>
     * time_low               = 4*<hexOctet>
     * time_mid               = 2*<hexOctet>
     * time_high_and_version  = 2*<hexOctet>
     * variant_and_sequence   = 2*<hexOctet>
     * node                   = 6*<hexOctet>
     * hexOctet               = <hexDigit><hexDigit>
     * hexDigit               = [0-9a-fA-F]
     * }
     * </pre>
     * 
     * </blockquote>
     *
     * @return æ­¤{@code UUID} çš„字符串表现形式
     * @see #toString(boolean)
     */
    @Override
    public String toString()
    {
        return toString(false);
    }

    /**
     * è¿”回此{@code UUID} çš„字符串表现形式。
     *
     * <p>
     * UUID çš„字符串表示形式由此 BNF æè¿°ï¼š
     * 
     * <pre>
     * {@code
     * UUID                   = <time_low>-<time_mid>-<time_high_and_version>-<variant_and_sequence>-<node>
     * time_low               = 4*<hexOctet>
     * time_mid               = 2*<hexOctet>
     * time_high_and_version  = 2*<hexOctet>
     * variant_and_sequence   = 2*<hexOctet>
     * node                   = 6*<hexOctet>
     * hexOctet               = <hexDigit><hexDigit>
     * hexDigit               = [0-9a-fA-F]
     * }
     * </pre>
     * 
     * </blockquote>
     *
     * @param isSimple æ˜¯å¦ç®€å•æ¨¡å¼ï¼Œç®€å•æ¨¡å¼ä¸ºä¸å¸¦'-'的UUID字符串
     * @return æ­¤{@code UUID} çš„字符串表现形式
     */
    public String toString(boolean isSimple)
    {
        final StringBuilder builder = new StringBuilder(isSimple ? 32 : 36);
        // time_low
        builder.append(digits(mostSigBits >> 32, 8));
        if (!isSimple)
        {
            builder.append('-');
        }
        // time_mid
        builder.append(digits(mostSigBits >> 16, 4));
        if (!isSimple)
        {
            builder.append('-');
        }
        // time_high_and_version
        builder.append(digits(mostSigBits, 4));
        if (!isSimple)
        {
            builder.append('-');
        }
        // variant_and_sequence
        builder.append(digits(leastSigBits >> 48, 4));
        if (!isSimple)
        {
            builder.append('-');
        }
        // node
        builder.append(digits(leastSigBits, 12));

        return builder.toString();
    }

    /**
     * è¿”回此 UUID çš„哈希码。
     *
     * @return UUID çš„哈希码值。
     */
    @Override
    public int hashCode()
    {
        long hilo = mostSigBits ^ leastSigBits;
        return ((int) (hilo >> 32)) ^ (int) hilo;
    }

    /**
     * å°†æ­¤å¯¹è±¡ä¸ŽæŒ‡å®šå¯¹è±¡æ¯”较。
     * <p>
     * å½“且仅当参数不为 {@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))
        {
            return false;
        }
        UUID id = (UUID) obj;
        return (mostSigBits == id.mostSigBits && leastSigBits == id.leastSigBits);
    }

    // Comparison Operations

    /**
     * å°†æ­¤ UUID ä¸ŽæŒ‡å®šçš„ UUID æ¯”较。
     *
     * <p>
     * å¦‚果两个 UUID ä¸åŒï¼Œä¸”第一个 UUID çš„最高有效字段大于第二个 UUID çš„对应字段，则第一个 UUID å¤§äºŽç¬¬äºŒä¸ª UUID。
     *
     * @param val ä¸Žæ­¤ UUID æ¯”较的 UUID
     *
     * @return åœ¨æ­¤ UUID å°äºŽã€ç­‰äºŽæˆ–大于 val æ—¶ï¼Œåˆ†åˆ«è¿”回 -1、0 æˆ– 1。
     *
     */
    @Override
    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 : //
                (this.mostSigBits > val.mostSigBits ? 1 : //
                        (this.leastSigBits < val.leastSigBits ? -1 : //
                                (this.leastSigBits > val.leastSigBits ? 1 : //
                                        0))));
    }

    // -------------------------------------------------------------------------------------------------------------------
    // Private method start
    /**
     * è¿”回指定数字对应的hex值
     * 
     * @param val å€¼
     * @param digits ä½
     * @return å€¼
     */
    private static String digits(long val, int digits)
    {
        long hi = 1L << (digits * 4);
        return Long.toHexString(hi | (val & (hi - 1))).substring(1);
    }

    /**
     * æ£€æŸ¥æ˜¯å¦ä¸ºtime-based版本UUID
     */
    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);
        }
    }

    /**
     * èŽ·å–随机数生成器对象<br>
     * ThreadLocalRandom是JDK 7之后提供并发产生随机数，能够解决多个线程发生的竞争争夺。
     * 
     * @return {@link ThreadLocalRandom}
     */
    public static ThreadLocalRandom getRandom()
    {
        return ThreadLocalRandom.current();
    }
}