NewId 技术文档

本文档旨在帮助用户详细了解并使用 NewId 项目，该项目是一个内嵌的唯一 ID 生成器，可产生 128 位（16 字节）的顺序 ID。本文将介绍安装指南、项目使用说明以及项目 API 使用文档。

1. 安装指南

请按照以下步骤进行 NewId 项目的安装：

• 确保您的开发环境满足项目要求。
• 克隆或下载项目代码至本地。
• 使用相应的构建工具（如 Maven、Gradle 等）编译项目。

2. 项目使用说明

NewId 项目可以作为一个内嵌的唯一 ID 生成器，适用于需要顺序唯一 ID 的各种场景。以下是一些基本使用方法：

生成 ID

NewId id = NewId.Next(); // 生成类似 {11790000-cf25-b808-dc58-08d367322210} 的 ID

转换为字符串

NewId id = NewId.Next().ToString("D").ToUpperInvariant();
// 生成类似 11790000-CF25-B808-2365-08D36732603A 的字符串

从指定 ID 开始

NewId id = new NewId("11790000-cf25-b808-dc58-08d367322210");

从字节数组创建

var bytes = new byte[] { 16, 23, 54, 74, 21, 14, 75, 32, 44, 41, 31, 10, 11, 12, 86, 42 };
NewId theId = new NewId(bytes);

3. 项目 API 使用文档

以下是 NewId 项目的一些核心 API：

• NewId.Next(): 生成一个新的顺序 ID。
• NewId.ToString("D"): 将 ID 转换为大写字符串格式。
• NewId.ToString("d"): 将 ID 转换为小写字符串格式。
• NewId.Parse(string id): 从字符串解析 ID。
• NewId.GetBytes(): 获取 ID 对应的字节数组。

4. 项目安装方式

NewId 项目可通过以下方式安装：

• 直接下载源代码，使用相应的构建工具进行编译。
• 通过包管理工具（如 NuGet、Maven 等）安装项目的依赖库。

请根据您的实际需求选择合适的安装方式，并遵循相应的操作指南。