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 接口
主要功能接口
1. 获取Banner (GET /api/Community/getBanners)
[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发送系统通知
技术特点
- 缓存策略: 使用
IFusionCache进行数据缓存 - 权限控制: 部分接口需要 "System" 策略授权
- 环境区分: 根据配置区分生产和开发环境
- 异步编程: 所有数据操作都是异步的
- 依赖注入: 充分利用了.NET Core的DI容器
- API文档: 使用OpenAPI特性标注响应类型
这个控制器是一个典型的现代Web API实现,具有良好的架构设计和完善的功能。
评论加载中...