using Dpz.Core.Public.ViewModel.Response;

namespace Dpz.Core.WebApi.Controllers;

/// <summary>
/// 其他的
/// </summary>
[ApiController, Route("api/[controller]")]
public class CommunityController(
    IPictureRecordService pictureRecordService,
    IArticleService articleService,
    IAppOptionService appOptionService,
    IAppLogEntryService logEntryService,
    IFusionCache fusionCache,
    IConfiguration configuration
) : ControllerBase
{
    /// <summary>
    /// 获取banner
    /// </summary>
    /// <returns></returns>
    [HttpGet("getBanners")]
    [ProducesResponseType<List<PictureRecordResponse>>(StatusCodes.Status200OK)]
    public async Task<IActionResult> GetBanners()
    {
        var banners = await GetBannerAsync();
        return Ok(banners);
    }

    /// <summary>
    /// 获取汇总信息
    /// </summary>
    /// <returns></returns>
    [HttpGet("summary")]
    [Authorize(Policy = "System")]
    [ProducesResponseType<SummaryInformation>(StatusCodes.Status200OK)]
    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
    public async Task<IActionResult> GetSummary()
    {
        const string summaryKey = "community-summary";
        var cache = await fusionCache.TryGetAsync<SummaryInformation>(summaryKey);
        if (cache.HasValue)
        {
            return Ok(cache.Value);
        }

        var banner = await GetBannerAsync();

        var summary = new SummaryInformation
        {
            ArticleTotalCount = await articleService.GetTotalCountAsync(),
            Banner = banner,
            LatestArticles = await articleService.GetLatestAsync(),
            TodayArticleCount = await articleService.GetTodayCountAsync(),
        };
        if (
            configuration["AgileConfig:env"]?.Equals("PROD", StringComparison.OrdinalIgnoreCase)
            == false
        )
        {
            SetRandomData(summary);
        }
        else
        {
            summary.LatestLogs = await GetTop100LogsAsync();
            summary.TodayAccessNumber = await logEntryService.GetLatestAccessNumberAsync();
            summary.WeekAccessNumber = await logEntryService.GetLatestAccessNumberAsync(-7);
        }

        await fusionCache.SetAsync(summaryKey, summary, TimeSpan.FromHours(3));
        return Ok(summary);
    }

    [NonAction]
    private static void SetRandomData(SummaryInformation summary)
    {
        summary.TodayAccessNumber = [];
        summary.WeekAccessNumber = [];
        summary.LatestLogs = $"[{DateTime.Now:HH:mm:ss} INF] this is test log";
        var random = new Random();
        for (var i = 0; i < 7; i++)
        {
            if (i == 0)
            {
                summary.TodayAccessNumber.Add(
                    new AccessSummary
                    {
                        Date = DateTime.Now.ToString("yyyy/MM/dd"),
                        Count = random.Next(100, 100000),
                    }
                );
            }
            summary.WeekAccessNumber.Add(
                new AccessSummary
                {
                    Date = DateTime.Now.AddDays(-(i + 1)).ToString("yyyy/MM/dd"),
                    Count = random.Next(100, 100000),
                }
            );
        }
    }

    private async Task<List<PictureRecordResponse>> GetBannerAsync()
    {
        var cache = await fusionCache.TryGetAsync<List<PictureRecordResponse>>(CacheKey.BannerKey);
        if (cache.HasValue)
        {
            return cache.Value;
        }

        var banner = await pictureRecordService.GetBannerAsync();

        await fusionCache.SetAsync(CacheKey.BannerKey, banner, TimeSpan.FromHours(12));
        return banner.ToList();
    }

    [NonAction]
    private async Task<string> GetTop100LogsAsync()
    {
        var logs = await logEntryService.GetPageAsync(pageSize: 100);
        return string.Join(
            "\n",
            logs?.Events.Select(x =>
            {
                var recordTime = Convert.ToDateTime(x.Timestamp);
                return $"[{recordTime:HH:mm:ss} {x.Level}] {x.RenderedMessage}";
            }) ?? new List<string>()
        );
    }

    /// <summary>
    /// 获取壁纸
    /// </summary>
    /// <param name="bingWallpaper"></param>
    /// <returns></returns>
    [HttpGet("wallpaper")]
    public async Task<ActionResult<List<Wallpaper>>> Wallpaper(
        [FromServices] IBingWallpaper bingWallpaper
    )
    {
        var wallpapers = await bingWallpaper.GetTodayWallpapersAsync();
        return Ok(wallpapers);
    }

    /// <summary>
    /// 获取页脚内容
    /// </summary>
    /// <returns></returns>
    [HttpGet("footer")]
    [ProducesResponseType<string>(StatusCodes.Status200OK)]
    public async Task<IActionResult> GetFooter()
    {
        var content = await appOptionService.GetFooterContentAsync();
        return Ok(content);
    }

    /// <summary>
    /// 保存页脚内容
    /// </summary>
    /// <param name="footer"></param>
    /// <returns></returns>
    [HttpPost("footer"), Authorize(Policy = "System")]
    [ProducesResponseType(StatusCodes.Status204NoContent)]
    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
    public async Task<IActionResult> SaveFooter([FromBody] SaveFooterDto footer)
    {
        await appOptionService.SaveFooterContentAsync(footer.Content);
        return NoContent();
    }


    /// <summary>
    /// 获取robots.txt
    /// </summary>
    /// <returns></returns>
    [HttpGet("robots.txt"), Authorize(Policy = "System")]
    [ProducesResponseType(StatusCodes.Status204NoContent)]
    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
    public async Task<IActionResult> GetRobots()
    {
        var robots = await appOptionService.GetRobotsAsync();
        return Ok(robots);
    }

    /// <summary>
    /// 保存robots.txt
    /// </summary>
    /// <param name="request"></param>
    /// <returns></returns>
    [HttpPost("robots.txt"), Authorize(Policy = "System")]
    [ProducesResponseType(StatusCodes.Status204NoContent)]
    [ProducesResponseType(StatusCodes.Status401Unauthorized)]
    public async Task<IActionResult> SaveRobots([FromBody] SvaeRobotsRequest request)
    {
        await appOptionService.SaveRobotsAsync(request.Content);
        return NoContent();
    }

    /// <summary>
    /// 获取友链
    /// </summary>
    /// <returns></returns>
    [HttpGet("friends")]
    public async Task<ActionResult<List<VmFriends>>> GetFriends()
    {
        var friends = await appOptionService.GetFriendsAsync();
        return Ok(friends);
    }

#if DEBUG
    private static HubConnection? _connection;

    /// <summary>
    ///
    /// </summary>
    /// <param name="message"></param>
    /// <returns></returns>
    [HttpPost("send")]
    public async Task<IActionResult> SendMessage([FromBody] string message)
    {
        if (_connection == null || _connection.State == HubConnectionState.Disconnected)
        {
            _connection = new HubConnectionBuilder()
                .WithUrl("https://localhost:37701/notification")
                .WithAutomaticReconnect()
                .Build();
            await _connection.StartAsync();
        }

        await _connection.InvokeCoreAsync("SendSystemNotification", [message]);

        return NoContent();
    }
#endif
}
⚠⚠    以下内容为AI分析的结果,请根据实际情况进行判断。

这是一个名为 CommunityController 的 ASP.NET Core Web API 控制器,主要用于处理社区相关的功能。让我详细解释一下这个代码:

控制器概述

  • 路由: api/[controller] (即 api/Community)
  • 依赖注入: 使用主构造函数注入了多个服务
  • 用途: 提供社区相关的各种 API 接口

主要功能接口

[HttpGet("getBanners")]
  • 获取网站的横幅图片
  • 使用缓存机制提高性能

2. 获取汇总信息 (GET /api/Community/summary)

[Authorize(Policy = "System")]
  • 需要系统权限认证
  • 返回网站的统计信息,包括:
    • 文章总数
    • Banner信息
    • 最新文章
    • 今日文章数量
    • 访问统计数据
    • 最新日志
  • 环境区分:
    • 非生产环境返回随机测试数据
    • 生产环境返回真实数据
  • 缓存: 结果缓存3小时

3. 获取壁纸 (GET /api/Community/wallpaper)

  • 通过依赖注入的 IBingWallpaper 服务获取今日壁纸

4. 页脚管理

  • 获取页脚: GET /api/Community/footer
  • 保存页脚: POST /api/Community/footer (需要系统权限)

5. Robots.txt管理

  • 获取robots.txt: GET /api/Community/robots.txt (需要系统权限)
  • 保存robots.txt: POST /api/Community/robots.txt (需要系统权限)

6. 获取友链 (GET /api/Community/friends)

  • 获取友情链接列表

私有辅助方法

GetBannerAsync()

  • 获取Banner数据的私有方法
  • 实现了12小时的缓存机制

SetRandomData()

  • 为非生产环境生成随机测试数据
  • 包括访问统计和日志数据

GetTop100LogsAsync()

  • 获取最新的100条日志记录
  • 格式化为字符串返回

开发环境特殊功能

#if DEBUG
[HttpPost("send")]
  • 仅在DEBUG模式下可用
  • 用于发送SignalR消息的测试接口
  • 连接到通知Hub发送系统通知

技术特点

  1. 缓存策略: 使用 IFusionCache 进行数据缓存
  2. 权限控制: 部分接口需要 "System" 策略授权
  3. 环境区分: 根据配置区分生产和开发环境
  4. 异步编程: 所有数据操作都是异步的
  5. 依赖注入: 充分利用了.NET Core的DI容器
  6. API文档: 使用OpenAPI特性标注响应类型

这个控制器是一个典型的现代Web API实现,具有良好的架构设计和完善的功能。

评论加载中...