qidao123.com ToB IT社区-企服评测·应用市场»论坛 › 数据库 › Oracle › 鸿蒙NEXT开辟随机工具类RandomUtil（ArkTs）

鸿蒙NEXT开辟随机工具类RandomUtil（ArkTs）

[复制链接]
发表于 2025-10-2 13:25:29 | 显示全部楼层 |阅读模式

马上注册，结交更多好友，享用更多功能，让你轻松玩转社区。

您需要 登录 才可以下载或查看，没有账号？立即注册

×
import { util } from '@kit.ArkTS';
import { cryptoFramework } from '@kit.CryptoArchitectureKit';
 
/**
 * 随机工具类
 * author: 鸿蒙布道师
 * since: 2025/04/01
 */
export class RandomUtil {
  /**
   * 天生随机布尔值
   * @returns true 或 false
   */
  static getRandomBoolean(): boolean {
    return Math.random() >= 0.5;
  }
 
  /**
   * 天生指定范围内的随机整数
   * @param min 最小值（包罗）
   * @param max 最大值（不包罗）
   * @returns 随机整数
   */
  static getRandomInt(min: number = 0, max: number = Number.MAX_SAFE_INTEGER): number {
    return Math.floor(Math.random() * (max - min) + min);
  }
 
  /**
   * 天生指定范围内的随机浮点数
   * @param min 最小值（包罗）
   * @param max 最大值（不包罗）
   * @returns 随机浮点数
   */
  static getRandomNumber(min: number, max: number): number {
    return Math.random() * (max - min) + min;
  }
 
  /**
   * 天生 [0, limit) 范围内的随机整数
   * @param limit 上限值（不包罗）
   * @returns 随机整数
   */
  static getRandomLimit(limit: number): number {
    return Math.floor(Math.random() * limit);
  }
 
  /**
   * 天生一个随机汉字（Unicode 范围 '\u4E00'-'\u9FFF'）
   * @returns 随机的汉字字符
   */
  static getRandomChineseChar(): string {
    const start = 0x4e00; // 汉字起始 Unicode 编码
    const end = 0x9fff;   // 汉字竣事 Unicode 编码
    return String.fromCharCode(RandomUtil.getRandomInt(start, end + 1));
  }
 
  /**
   * 天生指定长度的随机汉字字符串
   * @param length 目标长度
   * @returns 随机汉字字符串
   */
  static getRandomChinese(length: number): string {
    return Array.from<string, string>({ length }, (): string => RandomUtil.getRandomChineseChar()).join('');
  }
 
  /**
   * 根据指定字符池天生随机字符串
   * @param length 目标长度
   * @param strPool 字符池
   * @returns 随机字符串
   */
  static getRandomStr(length: number, strPool: string): string {
    const poolLength = strPool.length;
    return Array.from<string, string>({ length }, (): string => strPool[RandomUtil.getRandomLimit(poolLength)]).join('');
  }
 
  /**
   * 天生随机颜色（十六进制格式）
   * @returns 十六进制颜色字符串
   */
  static getRandomColor(): string {
    const hexadecimal = '0123456789ABCDEF'.split(''); // 将字符串拆分为字符数组
    return '#' + Array.from<string, string>({ length: 6 }, (): string => hexadecimal[RandomUtil.getRandomLimit(16)]).join('');
  }
 
  /**
   * 天生随机指定长度的 DataBlob
   * @param length 数据长度
   * @returns DataBlob 对象
   */
  static getRandomDataBlob(length: number): cryptoFramework.DataBlob {
    return cryptoFramework.createRandom().generateRandomSync(length);
  }
 
  /**
   * 天生随机指定长度的 Uint8Array
   * @param length 数据长度
   * @returns Uint8Array 数据
   */
  static getRandomUint8Array(length: number): Uint8Array {
    return RandomUtil.getRandomDataBlob(length).data;
  }
 
  /**
   * 天生 36 位 UUID（带分隔符）
   * @returns 36 位 UUID 字符串
   */
  static generateUUID36(): string {
    return RandomUtil.generateUUIDInternal(36, [8, 13, 18, 23]);
  }
 
  /**
   * 天生 32 位 UUID（带分隔符）
   * @returns 32 位 UUID 字符串
   */
  static generateUUID32(): string {
    return RandomUtil.generateUUIDInternal(32, [8, 12, 16, 20]);
  }
 
  /**
   * 内部方法：天生通用 UUID
   * @param length UUID 总长度
   * @param separators 分隔符位置数组
   * @returns UUID 字符串
   */
  private static generateUUIDInternal(length: number, separators: number[]): string {
    const chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'.split('');
    let rand = 0;
 
    // 利用 Array.from 并显式指定泛型参数
    return Array.from<string, string>(
      { length }, // 第一个泛型参数：输入对象的范例
      (_, i): string => { // 第二个泛型参数：回调函数返回值的范例
        if (separators.includes(i)) return '-'; // 插入分隔符
        if (i === 14) return '4'; // UUID 版本号（第14位固定为4）
        if (rand <= 0x02) rand = 0x2000000 + Math.random() * 0x1000000 | 0; // 更新随机数缓存
        const r = rand & 0xf; // 取低4位
        rand >>= 4; // 移动到下一个4位
        return chars[(i === 19 || i === 12) ? (r & 0x3) | 0x8 : r];
      }
    ).join(''); // 将字符数组拼接成字符串
  }
  /**
   * 利用加密安全随机数天生器天生 RFC 4122 版本 4 的字符串范例 UUID
   * @param entropyCache 是否利用缓存，默认 true
   * @returns UUID 字符串
   */
  static generateRandomUUID(entropyCache: boolean = true): string {
    return util.generateRandomUUID(entropyCache);
  }
 
  /**
   * 利用加密安全随机数天生器天生 RFC 4122 版本 4 的 Uint8Array 范例 UUID
   * @param entropyCache 是否利用缓存，默认 true
   * @returns Uint8Array 数据
   */
  static generateRandomBinaryUUID(entropyCache: boolean = true): Uint8Array {
    return util.generateRandomBinaryUUID(entropyCache);
  }
}
  2. import { util } from '@kit.ArkTS';
  3. import { cryptoFramework } from '@kit.CryptoArchitectureKit';
  5. /**
  6. * 随机工具类
  7. * author: 鸿蒙布道师
  8. * since: 2025/04/01
  9. */
  10. export class RandomUtil {
  11.   /**
  12.    * 生成随机布尔值
  13.    * @returns true 或 false
  14.    */
  15.   static getRandomBoolean(): boolean {
  16.     return Math.random() >= 0.5;
  17.   }
  19.   /**
  20.    * 生成指定范围内的随机整数
  21.    * @param min 最小值（包含）
  22.    * @param max 最大值（不包含）
  23.    * @returns 随机整数
  24.    */
  25.   static getRandomInt(min: number = 0, max: number = Number.MAX_SAFE_INTEGER): number {
  26.     return Math.floor(Math.random() * (max - min) + min);
  27.   }
  29.   /**
  30.    * 生成指定范围内的随机浮点数
  31.    * @param min 最小值（包含）
  32.    * @param max 最大值（不包含）
  33.    * @returns 随机浮点数
  34.    */
  35.   static getRandomNumber(min: number, max: number): number {
  36.     return Math.random() * (max - min) + min;
  37.   }
  39.   /**
  40.    * 生成 [0, limit) 范围内的随机整数
  41.    * @param limit 上限值（不包含）
  42.    * @returns 随机整数
  43.    */
  44.   static getRandomLimit(limit: number): number {
  45.     return Math.floor(Math.random() * limit);
  46.   }
  48.   /**
  49.    * 生成一个随机汉字（Unicode 范围 '\u4E00'-'\u9FFF'）
  50.    * @returns 随机的汉字字符
  51.    */
  52.   static getRandomChineseChar(): string {
  53.     const start = 0x4e00; // 汉字起始 Unicode 编码
  54.     const end = 0x9fff;   // 汉字结束 Unicode 编码
  55.     return String.fromCharCode(RandomUtil.getRandomInt(start, end + 1));
  56.   }
  58.   /**
  59.    * 生成指定长度的随机汉字字符串
  60.    * @param length 目标长度
  61.    * @returns 随机汉字字符串
  62.    */
  63.   static getRandomChinese(length: number): string {
  64.     return Array.from<string, string>({ length }, (): string => RandomUtil.getRandomChineseChar()).join('');
  65.   }
  67.   /**
  68.    * 根据指定字符池生成随机字符串
  69.    * @param length 目标长度
  70.    * @param strPool 字符池
  71.    * @returns 随机字符串
  72.    */
  73.   static getRandomStr(length: number, strPool: string): string {
  74.     const poolLength = strPool.length;
  75.     return Array.from<string, string>({ length }, (): string => strPool[RandomUtil.getRandomLimit(poolLength)]).join('');
  76.   }
  78.   /**
  79.    * 生成随机颜色（十六进制格式）
  80.    * @returns 十六进制颜色字符串
  81.    */
  82.   static getRandomColor(): string {
  83.     const hexadecimal = '0123456789ABCDEF'.split(''); // 将字符串拆分为字符数组
  84.     return '#' + Array.from<string, string>({ length: 6 }, (): string => hexadecimal[RandomUtil.getRandomLimit(16)]).join('');
  85.   }
  87.   /**
  88.    * 生成随机指定长度的 DataBlob
  89.    * @param length 数据长度
  90.    * @returns DataBlob 对象
  91.    */
  92.   static getRandomDataBlob(length: number): cryptoFramework.DataBlob {
  93.     return cryptoFramework.createRandom().generateRandomSync(length);
  94.   }
  96.   /**
  97.    * 生成随机指定长度的 Uint8Array
  98.    * @param length 数据长度
  99.    * @returns Uint8Array 数据
  100.    */
  101.   static getRandomUint8Array(length: number): Uint8Array {
  102.     return RandomUtil.getRandomDataBlob(length).data;
  103.   }
  105.   /**
  106.    * 生成 36 位 UUID（带分隔符）
  107.    * @returns 36 位 UUID 字符串
  108.    */
  109.   static generateUUID36(): string {
  110.     return RandomUtil.generateUUIDInternal(36, [8, 13, 18, 23]);
  111.   }
  113.   /**
  114.    * 生成 32 位 UUID（带分隔符）
  115.    * @returns 32 位 UUID 字符串
  116.    */
  117.   static generateUUID32(): string {
  118.     return RandomUtil.generateUUIDInternal(32, [8, 12, 16, 20]);
  119.   }
  121.   /**
  122.    * 内部方法：生成通用 UUID
  123.    * @param length UUID 总长度
  124.    * @param separators 分隔符位置数组
  125.    * @returns UUID 字符串
  126.    */
  127.   private static generateUUIDInternal(length: number, separators: number[]): string {
  128.     const chars = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz'.split('');
  129.     let rand = 0;
  131.     // 使用 Array.from 并显式指定泛型参数
  132.     return Array.from<string, string>(
  133.       { length }, // 第一个泛型参数：输入对象的类型
  134.       (_, i): string => { // 第二个泛型参数：回调函数返回值的类型
  135.         if (separators.includes(i)) return '-'; // 插入分隔符
  136.         if (i === 14) return '4'; // UUID 版本号（第14位固定为4）
  137.         if (rand <= 0x02) rand = 0x2000000 + Math.random() * 0x1000000 | 0; // 更新随机数缓存
  138.         const r = rand & 0xf; // 取低4位
  139.         rand >>= 4; // 移动到下一个4位
  140.         return chars[(i === 19 || i === 12) ? (r & 0x3) | 0x8 : r];
  141.       }
  142.     ).join(''); // 将字符数组拼接成字符串
  143.   }
  144.   /**
  145.    * 使用加密安全随机数生成器生成 RFC 4122 版本 4 的字符串类型 UUID
  146.    * @param entropyCache 是否使用缓存，默认 true
  147.    * @returns UUID 字符串
  148.    */
  149.   static generateRandomUUID(entropyCache: boolean = true): string {
  150.     return util.generateRandomUUID(entropyCache);
  151.   }
  153.   /**
  154.    * 使用加密安全随机数生成器生成 RFC 4122 版本 4 的 Uint8Array 类型 UUID
  155.    * @param entropyCache 是否使用缓存，默认 true
  156.    * @returns Uint8Array 数据
  157.    */
  158.   static generateRandomBinaryUUID(entropyCache: boolean = true): Uint8Array {
  159.     return util.generateRandomBinaryUUID(entropyCache);
  160.   }
  161. }
复制代码
回复

使用道具 举报

返回列表

李优秀
+ 我要发帖

登录后关闭弹窗

登录参与点评抽奖  加入IT实名职场社区
去登录
快速回复 返回顶部 返回列表