namespace Admin.NET.Plugin.HwPortal;

// [AllowAnonymous] 是 ASP.NET Core/Furion 里的匿名放行特性。
// 你可以把它理解成 Spring Security 里“这个接口不要求登录”的声明式配置。
// 和 Spring 常见的配置类放行不同，这里直接写在控制器上，阅读时更集中。
[AllowAnonymous]
[Route("portal/search")]
public class HwSearchController : HwPortalControllerBase
{
    // readonly 字段表示“构造完成后不允许再被重新赋值”。
    // 这和 Java 里把依赖字段声明成 final 的意图一致：依赖一旦注入完成，就不要在运行期乱改。
    private readonly HwSearchService _service;

    public HwSearchController(HwSearchService service)
    {
        // 这就是 C#/ASP.NET Core 最常见的“构造函数注入”。
        // 对应 Java Spring 你可以理解成：
        // 1. 以前常见的 @Autowired 字段注入
        // 2. 更推荐的 @RequiredArgsConstructor / 构造器注入
        // 这里只是 C# 没有 Lombok，直接手写构造函数而已。
        _service = service;
    }

    // [HttpGet] 表示这个方法处理 GET 请求。
    // Java Spring 里对应 @GetMapping。
    // 这里没有写路径，表示沿用类上的基础路由，也就是 /portal/search。
    [HttpGet]
    // 这是我们自定义的限流特性。
    // 注意它不是“只做标记”，而是自己实现了 IAsyncActionFilter，框架执行到这里会先跑限流逻辑，再决定要不要进入方法体。
    [HwPortalIpRateLimit("portal_search", 60, 120)]
    public async Task<HwPortalAjaxResult> Search([FromQuery] string keyword, [FromQuery] int? pageNum, [FromQuery] int? pageSize)
    {
        // async + await 是 C# 异步编程的核心写法。
        // 你可以先把它理解成“这个方法里要等待数据库/IO，但等待时不想卡死线程”。
        // Java 里它不等于 new Thread，也不等于 CompletableFuture 全套写法，更像框架层帮你把异步 IO 写法简化了。

        // [FromQuery] 表示参数从 URL 查询串里绑定，例如 ?keyword=轮胎&pageNum=1。
        // Spring Boot 里通常你会写 @RequestParam；ASP.NET Core 则更常用 [FromQuery] 明确绑定来源。
        return Success(await _service.Search(keyword, pageNum, pageSize));
    }

    // 这里写了 "edit"，所以完整路由会变成 /portal/search/edit。
    // 这和 Spring 的 @GetMapping("/edit") 完全是同一类路由声明思路。
    [HttpGet("edit")]
    [HwPortalIpRateLimit("portal_search_edit", 60, 120)]
    public async Task<HwPortalAjaxResult> EditSearch([FromQuery] string keyword, [FromQuery] int? pageNum, [FromQuery] int? pageSize)
    {
        // 展示端和编辑端共用同一套搜索主逻辑，只是编辑端需要多返回 editRoute。
        // 这种“控制器只做参数接线，真正差异交给 Service”的写法，是为了让 API 层保持薄，不把业务判断写散。
        return Success(await _service.SearchForEdit(keyword, pageNum, pageSize));
    }
}