49 lines
1.5 KiB
C#
49 lines
1.5 KiB
C#
|
using System;
|
||
|
|
using System.Collections.Generic;
|
||
|
|
using SimApi.Configurations;
|
||
|
|
|
||
|
|
namespace SimApi.Controllers;
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// SimApi 内置端点路由表中的一项。
|
||
|
|
/// </summary>
|
||
|
|
public sealed record SimApiBuiltInRoute(
|
||
|
|
string RouteName,
|
||
|
|
string Controller,
|
||
|
|
string Action,
|
||
|
|
string[] HttpMethods,
|
||
|
|
string Path);
|
||
|
|
|
||
|
|
/// <summary>
|
||
|
|
/// SimApi 内置端点路由表 —— 路径的唯一配置处。
|
||
|
|
/// UseSimApi 用它注册约定路由(动态路由)，
|
||
|
|
/// SimApiBuiltInRoutesDescriptionProvider 用它生成文档条目。
|
||
|
|
/// 某项路径为 null / 空时该端点既不注册路由、也不出现在文档中。
|
||
|
|
/// </summary>
|
||
|
|
public static class SimApiBuiltInRoutes
|
||
|
|
{
|
||
|
|
public static IEnumerable<SimApiBuiltInRoute> Get(SimApiRouteOptions options)
|
||
|
|
{
|
||
|
|
ArgumentNullException.ThrowIfNull(options);
|
||
|
|
|
||
|
|
if (!string.IsNullOrEmpty(options.UserInfoRoute))
|
||
|
|
{
|
||
|
|
yield return new SimApiBuiltInRoute(
|
||
|
|
"UserInfo", "SimApiCommon", "UserInfo", ["POST"], options.UserInfoRoute);
|
||
|
|
}
|
||
|
|
|
||
|
|
if (!string.IsNullOrEmpty(options.LogoutRoute))
|
||
|
|
{
|
||
|
|
yield return new SimApiBuiltInRoute(
|
||
|
|
"Logout", "SimApiAuth", "Logout", ["POST"], options.LogoutRoute);
|
||
|
|
}
|
||
|
|
|
||
|
|
if (!string.IsNullOrEmpty(options.WebConfigRoute))
|
||
|
|
{
|
||
|
|
// 控制器动作同时标注了 HttpGet/HttpPost
|
||
|
|
yield return new SimApiBuiltInRoute(
|
||
|
|
"WebConfig", "SimApiCommon", "WebConfig", ["GET", "POST"], options.WebConfigRoute);
|
||
|
|
}
|
||
|
|
}
|
||
|
|
}
|