Asp-Net-Core开发笔记:EFCore统一实体和属性命名风格
前言
C# 编码规范中,类和属性都是大写驼峰命名风格(PascalCase / UpperCamelCase),而在数据库中我们往往使用小写蛇形命名(snake_case),在默认情况下,EFCore会把原始的类名和属性名直接映射到数据库,这不符合数据库的命名规范。
为了符合命名规范,而且也为了看起来更舒服,需要自己做命名转换处理。
FreeSQL的命名转换功能
FreeSQL 内置了很方便的命名风格转换功能,只需要设置 UseNameConvert
就可以实现 Pasca Case 到 snake_case 的转换。
var fsql = new FreeSqlBuilder()
.UseConnectionString(DataType.MySql, Default.Value)
.UseAutoSyncStructure(true)
.UseNameConvert(NameConvertType.PascalCaseToUnderscoreWithLower)
.UseMonitorCommand(cmd => Trace.WriteLine(cmd.CommandText))
.Build();
EFCore 没有内置这个功能,需要我们自行实现。
使用正则实现命名风格转换
使用正则表达式可以实现这个功能
这里来写一个扩展方法
public static class StringExt {
public static string ToSnakeCase(this string input) {
if (string.IsNullOrEmpty(input)) {
return input;
}
var startUnderscores = Regex.Match(input, @"^_+");
return startUnderscores + Regex.Replace(input, @"([a-z0-9])([A-Z])", "$1_$2").ToLower();
}
}
这个方法会在每个小写字母/数字与大写字母之间添加下划线,并把整个字符串转换为小写。
修改 EFCore 行为
EFCore 有非常丰富的功能,修改表名和字段名当然也不在话下。
重写 DbContext
的 OnModelCreating
方法就行
public class AppDbContext : DbContext {
// ...
protected override void OnModelCreating(ModelBuilder modelBuilder) {
base.OnModelCreating(modelBuilder);
modelBuilder.ApplyConfigurationsFromAssembly(GetType().Assembly);
// CamelCase to SnakeCase
foreach (var entity in modelBuilder.Model.GetEntityTypes()) {
// Replace table names
if (!string.IsNullOrWhiteSpace(entity.GetTableName())) {
entity.SetTableName(entity.GetTableName()!.ToSnakeCase());
}
// Replace column names
foreach (var property in entity.GetProperties()) {
property.SetColumnName(property.GetColumnName().ToSnakeCase());
}
foreach (var key in entity.GetKeys()) {
if (!string.IsNullOrWhiteSpace(key.GetName())) {
key.SetName(key.GetName()!.ToSnakeCase());
}
}
foreach (var key in entity.GetForeignKeys()) {
if (!string.IsNullOrWhiteSpace(key.GetConstraintName())) {
key.SetConstraintName(key.GetConstraintName()!.ToSnakeCase());
}
}
foreach (var index in entity.GetIndexes()) {
if (!string.IsNullOrWhiteSpace(index.GetDatabaseName())) {
index.SetDatabaseName(index.GetDatabaseName()!.ToSnakeCase());
}
}
}
}
}
以上代码会对表名、列名、key、index的名称做转换。
搞定~
扩展:使用插件实现名称转换
2023-10-10 补充: 本文在博客发表之后,有同学分享了 EFCore.NamingConventions
这个插件,可以很方便的实现命名风格转换
项目地址: https://github.com/efcore/EFCore.NamingConventions
使用方式
先安装 EFCore.NamingConventions
这个nuget包
然后重写 DbContext 的 OnConfiguring
方法
protected override void OnConfiguring(DbContextOptionsBuilder optionsBuilder) {
base.OnConfiguring(optionsBuilder);
optionsBuilder.UseSnakeCaseNamingConvention();
}
一行代码就可以实现名称转换
这个插件同时支持多种风格的转换,调用不同的扩展方法即可
- UseSnakeCaseNamingConvention:
FullName
becomesfull_name
- UseLowerCaseNamingConvention:
FullName
becomesfullname
- UseCamelCaseNamingConvention:
FullName
becomesfullName
- UseUpperCaseNamingConvention:
FullName
becomesFULLNAME
- UseUpperSnakeCaseNamingConvention:
FullName
becomesFULL_NAME
参考资料
微信公众号:「程序设计实验室」
专注于互联网热门新技术探索与团队敏捷开发实践,包括架构设计、机器学习与数据分析算法、移动端开发、Linux、Web前后端开发等,欢迎一起探讨技术,分享学习实践经验。