如何调整ABP.io的AppService REST接口命名规则匹配Boilerplate
调整ABP.io AppService的API路由命名规则匹配Boilerplate格式
针对你遇到的路由命名差异问题,有两种方案可以让ABP.io生成的API路由和Boilerplate保持一致:
方案一:单个服务手动指定路由
直接在目标AppService类上添加[Route]特性,硬编码路由前缀,覆盖ABP.io的默认生成规则:
[Route("api/daf")] public class DAFAppService : PlatformAppService { // 服务实现方法 }
这种方式适合少量服务的个性化调整,操作简单直接。
方案二:全局统一修改路由命名策略
如果需要批量调整所有AppService的路由规则,避免逐个添加特性,可以自定义路由命名约定:
- 创建自定义路由约定类,实现
IAbpApplicationServiceRouteNamingConvention接口:
public class CustomAppServiceRouteNamingConvention : IAbpApplicationServiceRouteNamingConvention { public string GetControllerName(Type controllerType) { // 移除类名末尾的"AppService"后缀,直接返回原名称的小写形式 var serviceName = controllerType.Name.RemovePostFix("AppService"); return serviceName.ToLowerInvariant(); } }
- 在模块的
ConfigureServices方法中替换默认的路由约定:
public override void ConfigureServices(ServiceConfigurationContext context) { Configure<AbpAspNetCoreMvcOptions>(options => { options.ConventionalControllers.RouteNamingConvention = new CustomAppServiceRouteNamingConvention(); }); }
配置完成后,所有AppService都会以去掉AppService后缀的类名小写作为路由前缀,比如DAFAppService会自动生成/api/daf路由,和Boilerplate的规则完全匹配。
内容的提问来源于stack exchange,提问作者Ivan Sager
相关产品推荐
相关产品推荐

