在领域驱动设计(DDD)中,有一个非常重要的概念:强类型Id。使用强类型Id来做标识属性的类型会比用int、Guid等通用类型能带来更多的好处。比如有一个根据根据Id删除用户的方法的签名如下:voidRemoveById(longid); 我们从方法的参数看不出来id代表什么含义,因此如果我们错误地把货物的id传递给这个方法,那么也是可以的。这样用long等通用类型来表示标识属性会让参数等的业务属性弱化。 而如果我们自定义一个UserId类型,如下:classUserId{publiclongValue{}publicUserId(longvalue){this。V}} 这样User类的定义中Id属性的类型就从long变成了UserId类型,如下:classUser{publicUserIdId{}publicstringName{}} 对应的RemoveById方法的签名也变成了:voidRemoveById(UserIdid); 这样不仅能一看就看出来id参数代表的业务含义,也能避免把货物Id的值传递给用户Id参数这样的问题。 在。NET6及之前,EntityFrameworkCore(简称EFCore)中很难优美地实现强类型Id。在。NET7中,EFCore中提供了对强类型Id的支持,具体用法请参考EFCore官方文档中ValuegenerationforDDDguardedtypes这部分内容。 尽管EFCore已经内置了对强类型Id的支持,但是它需要程序员编写非常多的代码。比如一个比较完善的强类型Id类的代码就要编写如下30多行代码:publicreadonlystructPersonId{publicGuidValue{}publicPersonId(Guidvalue){V}publicoverridestringToString(){returnConvert。ToString(Value);}publicoverrideintGetHashCode(){returnValue。GetHashCode();}publicoverrideboolEquals(objectobj){if(objisPersonId){PersonIdobjId(PersonId)returnValueobjId。V}returnbase。Equals(obj);}publicstaticbooloperator(PersonIdc1,PersonIdc2){returnc1。Equals(c2);}publicstaticbooloperator!(PersonIdc1,PersonIdc2){return!c1。Equals(c2);}} 还要编写一个ValueConverter类以及配置自定义的ValueGenerator需要编写的代码的复杂程度让想使用强类型Id的开发者望而却步。 正因为这一点,所以连微软的文档中都警告到强类型Id会增加代码的复杂性,请谨慎使用。幸好,这个世界有我! 为了解决这个问题,我基于。NET的SourceGenerator技术编写了一个开源项目,这个开源项目会在编译时自动生成相关的代码,开发人员只要在实体类上标注一个〔HasStronglyTypedId〕即可。 项目地址:https:github。comyangzhongkeLessCode。EFCore。StronglyTypedId 下面我用一个把所有代码都写到一个控制台项目中的例子来演示它的用法,多项目分层等更复杂的用法请见项目文档以及项目中的Examples文件夹中的内容。 注意:这个项目可能会随着升级而用法有所变化,具体用法请以最新官方文档为准。 用法: 1、新建一个。NET7控制台项目,然后依次安装如下这些Nuget包:LessCode。EFCore、LessCode。EFCore。StronglyTypedIdCommons、LessCode。EFCore。StronglyTypedIdGenerator。当然我们的项目要使用SQLServer以及使用EFcore的migration,所以还要安装如下的Nuget包:Microsoft。EntityFrameworkCore。SqlServer、Microsoft。EntityFrameworkCore。Tools。 2、项目中新建一个实体类型Person〔HasStronglyTypedId〕classPerson{publicPersonIdId{}publicstringName{}} 我们注意到Person上标注的〔HasStronglyTypedId(typeof(Guid))〕,它代表这个类启用强类型Id,编译器在编译的时候自动生成一个名字叫PersonId的类,所以我们就声明了一个名字叫Id、类型为PersonId的属性来表示实体的标识。 PersonId在数据库中保存的默认是long类型,如果想保存为Guid类型,就可以写成〔HasStronglyTypedId(typeof(Guid))〕。 编译一下项目,如果能够编译成功,我们反编译生成的dll,就能看到dll中自动生成了PersonId、PersonIdValueConverter两个类。 3、编写DbContext,代码如下:usingLessCode。EFCclassTestDbContext:DbContext{publicDbSetPersonPersons{}protectedoverridevoidOnConfiguring(DbContextOptionsBuilderoptionsBuilder){optionsBuilder。UseSqlServer(自己的连接字符串);}protectedoverridevoidOnModelCreating(ModelBuildermodelBuilder){base。OnModelCreating(modelBuilder);modelBuilder。ConfigureStronglyTypedId();}protectedoverridevoidConfigureConventions(ModelConfigurationBuilderconfigurationBuilder){base。ConfigureConventions(configurationBuilder);configurationBuilder。ConfigureStronglyTypedIdConventions(this);}} 4、进行数据库的迁移等操作,这部分属于EFCore的标准操作,我不再介绍。对EFCore的用法不熟悉的朋友,请到哔哩哔哩、youtube等平台搜索杨中科。NETCore教程。 5、编写代码进行测试 usingTestDbContextctxnewTestDbContext();Personp1newPerson();p1。Nctx。Persons。Add(p1);ctx。SaveChanges();PersonIdpId1p1。Id;Console。WriteLine(pId1);Person?p2FindById(newPersonId(1));Console。WriteLine(p2。Name);Person?FindById(PersonIdpid){usingTestDbContextctxnewTestDbContext();returnctx。Persons。SingleOrDefault(pp。Idpid);} 强类型Id让我们能够更好的在EFCore中实现DDD,我开源的这个项目能够让开发者只要在实体类上标注一行〔HasStronglyTypedId〕就可以完成强类型Id的使用。希望它能够帮到你,欢迎把它分享到你所在的技术社区。