17370845950

Java公告功能用Spring Boot+Thymeleaf+MySQL实现，含轻量数据库设计、管理/展示分离接口、前端简洁展示及自动下线/缓存等运维细节。

在Java项目中添加公告展示功能，核心是实现“后台可维护、前端可展示、数据可时效控制”的闭环。不需要复杂框架，Spring Boot + Thymeleaf（或Vue）+ MySQL 就能快速落地，重点在于模块职责清晰、接口边界明确。

一、数据库设计：轻量但支持基础运营需求

公告表（notice）建议至少包含以下字段：

• id：主键，BIGINT自增
• title：VARCHAR(100)，标题
• content：TEXT，富文本内容（可存HTML，或纯文本+前端渲染）
• status：TINYINT，状态（0-草稿，1-已发布，2-已过期）
• start_time / end_time：DATETIME，生效与失效时间（用于自动上下线）
• sort_order：INT，默认0，用于前台排序（数值越大越靠前）
• create_time / update_time：自动维护的时间戳

不建议加栏目分类、多语言等扩展字段——初期用不到，反而增加判断逻辑。后续按需再加。

二、后端服务层：分清“管理”和“展示”两个入口

避免把后台管理接口和前台查询接口混在一个Controller里。推荐拆成：

• NoticeAdminController：/admin/notice/**，带权限校验（如@PreAuthorize("hasRole('ADMIN')")），支持增删改、上下架、批量置顶
• NoticePublicController：/api/notice/**，无鉴权，只提供安全的查询能力

关键逻辑示例（查询当前有效公告）：

@GetMapping("/list")
public Result> listActive() {
    LocalDateTime now = LocalDateTime.now();
    List notices = noticeService.findByStatusAndTimeRange(
        NoticeStatus.PUBLISHED.getCode(), 
        now, now
    );
    return Result.success(notices.stream().map(NoticeVO::of).collect(Collectors.toList()));
}

注意：status=1 且 start_time ≤ now ≤ end_time 才算有效，数据库可加复合索引提升查询效率。

三、前端展示策略：简单可靠优先

不追求轮播、弹窗等花哨效果，先保证信息触达。常见两种方式：

• 首页顶部横幅：固定高度区域，最多显示1条最新公告（按sort_order+end_time降序取第1条），点击跳转详情页
• 独立公告页：列表页分页展示，每条含标题、发布时间、摘要（content前100字）、状态标签；详情页渲染完整HTML内容（注意XSS防护：后端用Jsoup清理，或前端v-html配合白名单）

若用Thymeleaf，模板中可直接写：

四、运维友好细节：别让公告变成定时炸弹

上线后容易被忽略，但很关键：

• 自动下线任务：用@Scheduled每天0点扫描end_time已过期的公告，更新status=2（避免手动忘记）
• 缓存策略**：公告变动频率低，可用Caffeine本地缓存（5分钟），避免每次请求都查库
• 敏感词拦截（可选）：后台提交时调用简单关键词匹配，对title/content做基础过滤并提示

基本上就这些。公告模块本质是“结构清晰的数据展示”，不是技术难点，胜在稳定、易维护、好扩展。