Browse Source

editreadme

tags/v1.0.0
zhouzj 4 years ago
parent
commit
5f156f57e9
1 changed files with 7 additions and 0 deletions
  1. +7
    -0
      README.md

+ 7
- 0
README.md View File

@@ -104,13 +104,20 @@
## ★★集成建议★★ ## ★★集成建议★★


1.用单例模式调用。外部集成方使用更多的实例并行调用本算法,不会增加ID产出效能,因为本算法采用单线程模式生成ID。 1.用单例模式调用。外部集成方使用更多的实例并行调用本算法,不会增加ID产出效能,因为本算法采用单线程模式生成ID。

2.指定唯一的 WorkerId。必须由外部系统确保 WorkerId 的全局唯一性,并赋值给本算法入口方法。 2.指定唯一的 WorkerId。必须由外部系统确保 WorkerId 的全局唯一性,并赋值给本算法入口方法。

3.异常处理。本算法内部会抛出所有Exception,当本算法内部问题时,外部系统最好Log相关信息并做好应对处理,免得外部系统崩溃。 3.异常处理。本算法内部会抛出所有Exception,当本算法内部问题时,外部系统最好Log相关信息并做好应对处理,免得外部系统崩溃。

4.同步或同步调用。你可以在外部系统的异步(async标记)方法中同步调用本算法。 4.同步或同步调用。你可以在外部系统的异步(async标记)方法中同步调用本算法。

5.订阅ID异步通知。IIdGenerator.GenIdActionAsync 是一个可以向外部系统异步发送ID生成消息的是事件,它包含的消息类型有(漂移开始、漂移结束、时间回拨) 5.订阅ID异步通知。IIdGenerator.GenIdActionAsync 是一个可以向外部系统异步发送ID生成消息的是事件,它包含的消息类型有(漂移开始、漂移结束、时间回拨)
,具体参考 Yitter.IdGenTest 的 Program.cs 启动代码。订阅ID异步通知会有细微的性能损失。 ,具体参考 Yitter.IdGenTest 的 Program.cs 启动代码。订阅ID异步通知会有细微的性能损失。

6.使用雪花漂移算法。虽然代码里包含了传统雪花算法的定义,并且你可以在入口处指定(Method=2)来启用传统算法,但我还是建议你使用雪花漂移算法(Method=1,默认的),毕竟它具有更好的伸缩力和更高的性能。 6.使用雪花漂移算法。虽然代码里包含了传统雪花算法的定义,并且你可以在入口处指定(Method=2)来启用传统算法,但我还是建议你使用雪花漂移算法(Method=1,默认的),毕竟它具有更好的伸缩力和更高的性能。

7.认真理解 IdGeneratorOptions 的定义。这对你更好的集成和使用本算法有很大的帮助。 7.认真理解 IdGeneratorOptions 的定义。这对你更好的集成和使用本算法有很大的帮助。

8.轻易不要修改核心算法。本算法内部参数较多,逻辑较为复杂,在你尚未掌握核心逻辑时,请勿尝试修改核心代码并用于生产环境。 8.轻易不要修改核心算法。本算法内部参数较多,逻辑较为复杂,在你尚未掌握核心逻辑时,请勿尝试修改核心代码并用于生产环境。






Loading…
Cancel
Save