幸福框架:可扩展的、动态的、万能的 编号生成器
背景
上周整理了一下,把代码合并到了http://happy.codeplex.com/,需要的朋友直接下载最新代码,不要用Download(直接去Source Code下载)。
今天重点介绍一下如何使用。
一些常见的编号示例
像如下这些规则,非常容易支持,如:
- 【xxxx】年某企业第【x】份劳动合同,规则配置:【<日期:yyyy>】年某企业第【<种子:销售订单:yyyy>】份劳动合同。
- xxxx年xxxx月xxxx日第x份销售订单,规则配置:<日期:yyyy年MM月dd日>第<种子:销售订单:yyyyMMdd>份销售订单。
测试代码
1 using System;
2 using System.Collections.Generic;
3 using Microsoft.VisualStudio.TestTools.UnitTesting;
4 using System.IO;
5
6 using Happy.Domain.CodeRule;
7 using Happy.Domain.CodeRule.Generators;
8
9 namespace Happy.Test.Doamin.CodeRule
10 {
11 [TestClass]
12 public class CodeRuleInterceptorTest
13 {
14 [TestMethod]
15 public void Intercept_Test()
16 {
17 var seedKey = "销售订单";
18 var file = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "App_Seeds", seedKey + ".txt");
19 if (File.Exists(file))
20 {
21 File.Delete(file);
22 }
23
24 var interceptor = new CodeRuleInterceptor();
25
26 interceptor
27 .RegisterInterceptor(new DateTimeCodeGeneratorInterceptor())
28 .RegisterInterceptor(new LiteralCodeGeneratorInterceptor())
29 .RegisterInterceptor(new SeedCodeGeneratorInterceptor(new FileSeedStore()));
30
31 var generator = interceptor.Intercept("前缀---<日期:yyyyMMdd>---中缀---<种子:销售订单>---后缀");
32
33 Assert.IsNotNull(generator);
34
35
36 Assert.AreEqual("前缀---20130705---中缀---00001---后缀", generator.Generate(new GenerateContext()));
37 Assert.AreEqual("前缀---20130705---中缀---00002---后缀", generator.Generate(new GenerateContext()));
38 Assert.AreEqual("前缀---20130705---中缀---00003---后缀", generator.Generate(new GenerateContext()));
39 }
40 }
41 }
常见问题
问:种子的生成能保证唯一性吗?答:是的,在并发情况下也能保证唯一。
问:种子的生成能保证连续性吗?答:是的,约束就是必须使用基于数据库的种子仓储(Happy.Infrastructure.PetaPoco.PetaPocoSeedStore),且必须运行在处于”可重复读“隔离级别的事务中,上边的测试用例采用的是基于文件的。
问:为什么一定要配置规则,解释执行?答:这是面向产品级别的项目,如果是一般的项目,直接用种子仓储就行了,代码如下:
1 using System;
2 using Microsoft.VisualStudio.TestTools.UnitTesting;
3 using System.IO;
4
5 using Happy.Domain.CodeRule;
6
7 namespace Happy.Test.Doamin.CodeRule
8 {
9 [TestClass]
10 public class FileSeedStoreTest
11 {
12 [TestMethod]
13 public void NextSeed_Test()
14 {
15 var seedKey = "销售订单";
16 var file = Path.Combine(AppDomain.CurrentDomain.BaseDirectory, "App_Seeds", seedKey + ".txt");
17 if (File.Exists(file))
18 {
19 File.Delete(file);
20 }
21
22 var seedStore = new FileSeedStore();
23
24 Assert.AreEqual(1, seedStore.NextSeed(seedKey));
25 Assert.AreEqual(2, seedStore.NextSeed(seedKey));
26 Assert.AreEqual(3, seedStore.NextSeed(seedKey));
27 }
28 }
29 }
备注
这种规则生成器,我在产品和项目中都有用过,新入门的朋友可以直接使用,高手要多提些意见。