LqTestService.cs
4.2 KB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
using System;
using System.Threading.Tasks;
using Microsoft.AspNetCore.Authorization;
using Microsoft.AspNetCore.Mvc;
using NCC.Common.Core.Manager;
using NCC.Dependency;
using NCC.DynamicApiController;
namespace NCC.Extend.LqTest
{
/// <summary>
/// 测试服务（用于验证接口可用性及自动委派流程）
/// </summary>
[ApiDescriptionSettings(Tag = "绿纤测试服务", Name = "LqTest", Order = 200)]
[Route("api/Extend/[controller]")]
public class LqTestService : IDynamicApiController, ITransient
{
private readonly IUserManager _userManager;
/// <summary>
/// 初始化一个<see cref="LqTestService"/>类型的新实例
/// </summary>
public LqTestService(IUserManager userManager)
{
_userManager = userManager;
}
/// <summary>
/// 健康检查 / 连通性测试
/// </summary>
/// <remarks>
/// 用于验证 API 服务是否正常运行，无需登录即可调用（若需鉴权可移除 AllowAnonymous）
///
/// 示例请求：
/// ```http
/// GET /api/Extend/LqTest/Ping
/// ```
///
/// 参数说明：无
/// </remarks>
/// <returns>服务状态信息</returns>
/// <response code="200">成功返回服务状态</response>
/// <response code="500">服务器错误</response>
[HttpGet("Ping")]
[AllowAnonymous]
public Task<object> Ping()
{
var result = new
{
success = true,
message = "绿纤 ERP 测试接口正常",
timestamp = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"),
service = "LqTestService"
};
return Task.FromResult<object>(result);
}
/// <summary>
/// Hello World 测试接口
/// </summary>
/// <remarks>
/// 直接返回 hello world 字符串，用于简单连通性测试
/// </remarks>
/// <returns>hello world</returns>
/// <response code="200">成功返回</response>
[HttpGet("HelloWorld")]
[AllowAnonymous]
public Task<object> HelloWorld()
{
return Task.FromResult<object>(new { message = "hello world" });
}
/// <summary>
/// Echo 回显测试接口
/// </summary>
/// <remarks>
/// 返回服务器时间与随机数，用于验证接口连通性
///
/// 示例请求：
/// ```http
/// GET /api/Extend/LqTest/Echo
/// ```
/// </remarks>
/// <returns>服务器时间与随机数</returns>
/// <response code="200">成功返回</response>
[HttpGet("Echo")]
[AllowAnonymous]
public Task<object> Echo()
{
var random = new Random();
var result = new
{
message = "echo ok",
serverTime = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss"),
randomValue = random.Next(1, 10000)
};
return Task.FromResult<object>(result);
}
/// <summary>
/// 带鉴权的测试接口（需登录）
/// </summary>
/// <remarks>
/// 验证当前用户登录态，返回用户相关信息
///
/// 示例请求：
/// ```http
/// GET /api/Extend/LqTest/WhoAmI
/// Authorization: Bearer {token}
/// ```
/// </remarks>
/// <returns>当前用户信息</returns>
/// <response code="200">成功返回用户信息</response>
/// <response code="401">未登录或 token 无效</response>
[HttpGet("WhoAmI")]
public async Task<object> WhoAmI()
{
var userId = _userManager.UserId;
var userInfo = await _userManager.GetUserInfo();
var result = new
{
success = true,
userId,
userName = userInfo?.userName ?? "未知",
account = userInfo?.userAccount ?? "未知",
timestamp = DateTime.Now.ToString("yyyy-MM-dd HH:mm:ss")
};
return result;
}
}
}