# OnceMi.AspNetCore.IdGenerator

**Repository Path**: MiKeNetProject/OnceMi.AspNetCore.IdGenerator

## Basic Information

- **Project Name**: OnceMi.AspNetCore.IdGenerator
- **Description**: ASP.NET Core雪花算法分布式ID生成工具。Use https://github.com/RobThree/IdGen
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 3
- **Created**: 2022-03-02
- **Last Updated**: 2022-03-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# OnceMi.AspNetCore.IdGenerator
ASP.NET Core雪花算法分布式ID生成工具。Use https://github.com/yitter/IdGenerator

# How to use
1. Install OnceMi.AspNetCore.IdGenerator。  
    CLI中安装：  
    ```shell
    dotnet add package OnceMi.AspNetCore.IdGenerator
    ```
    Nuget中安装：  [![](https://img.shields.io/nuget/v/OnceMi.AspNetCore.IdGenerator.svg)](https://www.nuget.org/packages/OnceMi.AspNetCore.IdGenerator)

2. Configuration  
    You need to configure IdGenerator in your Startup.cs：

    ```csharp
    services.AddIdGenerator(x =>
    {
        x.AppId = 1;   //Between 0-63
    });
    ```

    在使用过程中保证每个IdGenerator一个AppId，Appid范围为0-63，如果超过64个应用，可自定义Option（默认Option WorkId为6位）。  

3. Use  
    ```csharp
    public class HomeController : Controller
    {
        private readonly ILogger<HomeController> _logger;
        private readonly IIdGeneratorService _idGenerator;

        public HomeController(ILogger<HomeController> logger, IIdGeneratorService idGenerator)
        {
            _logger = logger;
            _idGenerator = idGenerator;
        }

        public IActionResult Index()
        {
            List<long> ids = new List<long>();
            for (int i = 0; i < 5; i++)
            {
                ids.Add(_idGenerator.NewId());
            }
            ViewBag.Ids = ids;
            return View();
        }
    }
    ```

### API Reference

##### NewId  
`long NewId();`

生成一个ID。  

##### NewIds  
`long[] NewIds(int count);`

生成指定个数的ID。  


### Features

Please visit https://github.com/yitter/IdGenerator