2.线上论坛项目

@xiao lin2024-06-17 11:27

一、项目介绍

线上论坛

  • 相关技术：SpringBoot+SpringMvc+Mybatis+Mysql+Swagger
  • 项目简介：本项目是一个功能丰富的线上论坛，用户可编辑、发布、删除帖子，并评论、点赞。帖子按版块分类，方便查找。同时，用户可以修改和展示个人信息，还能发送私信与其他用户交流。
  • 项目描述：

  1. 采用前后端分离架构，通过JSON格式传输数据，基于SpringBoot和Mybatis框架构建。

  2. 设计统一的数据返回格式，全局处理错误信息，提升用户体验。

  3. 利用@ControllerAdvice和@ExceptionHandler实现全局异常处理，确保系统稳定性。

  4. 使用HandlerInterceptor拦截器实现用户登录校验，并采用MD5算法对密码进行加密存储。

  5. 集成Swagger自动生成API测试接口，方便开发者进行测试和调试。

  6. 利用Mybatis Generator自动生成常用的增删改查方法，提高开发效率。

二、项目实现效果

部分页面展示：

帖子页面（首页显示所有帖子，切换版块则显示对应帖子）：

用户个人信息展示页面（包含用户发布的帖子）：

个人信息修改页面：

帖子详情页面（下方为评论）：

用户之间私信：

部分功能说明：

页面上方 ：帖子搜索功能并未实现，月亮按钮为可切换夜间模式，铃铛按钮为用户私信功能。

个人中心：其中头像修改功能并未实现。

三、项目具体实现

1.软件生命周期

一个软件的生命周期可以划分为

  • 可行性研究
  • 需求分析
  • 概要设计
  • 详细设计
  • 编码实现
  • 测试
  • 使用及维护
  • 退役

2.项目需求分析

  1. 用户 注册（设置用户名，昵称，密码，且需要同意隐私条款才可注册）、登录、退出登录 的功能。
  2. 个人中心可修改个人信息（包括 昵称，邮箱地址，电话号码，个人简介）和修改密码（需确认原密码）。
  3. 用户信息页：显示用户信息（昵称，发帖数，邮箱，注册时间，个人简介）及该用户发布的帖子（ 各个帖子显示其 标题 ，作者 ，发布时间，阅读量，点赞数，评论数），帖子按发布时间倒序排列，用户访问其他用户主页时可发送私信。
  4. 帖子列表页：首页显示所有帖子（各个帖子显示其 标题 ，作者 ，发布时间，阅读量，点赞数，评论数），切换版块则显示对应版块帖子，并且统计该版块下所有帖子数量，帖子按发布时间倒序排列。
  5. 查看全文：显示帖子信息（标题，正文，作者，发布时间，阅读量，点赞数，评论数），并且可点赞，评论帖子（下方评论按时间倒序排列），以及给作者发私信，若查看本人帖子，则还有修改，删除帖子功能。
  6. 添加，修改，删除帖子功能（除了标题，正文外，还要选择帖子版块）。
  7. 私信功能：显示信息状态（未读，已读，已回复），且无法给自己发送私信。
  8. 评论，点赞帖子功能。
  9. 页面可切换为白天，夜间显示。
  10. 用户权限限制：访问所有页面均要登录（未登录无法访问，强制跳转至登录页面）。

3.设计

设计数据库存储 用户，帖子，帖子评论，用户私信，帖子版块 信息。

其中用户信息表结构：

4.编码实现

4.1项目构建及相关配置

基于SpringBoot和Mybatis框架构建项目，及MySQL，MyBatis等相关配置...

4.2创建实体类（依据数据库中表结构）

例如：

java 复制代码 
@Data
public class User {
    private Long id;

    private String username;

    @JsonIgnore //不参与Json序列化
    private String password;

    private String nickname;

    private String phoneNum;

    private String email;

    private Byte gender;

    @JsonIgnore //不参与Json序列化
    private String salt;
    @JsonInclude(JsonInclude.Include.ALWAYS) // 不论任何情况都参与JSON序列化
    private String avatarUrl;

    private Integer articleCount;

    private Byte isAdmin;

    private String remark;

    private Byte state;

    @JsonIgnore //不参与Json序列化
    private Byte deleteState;

    private Date createTime;

    private Date updateTime;


}

4.3数据库持久层（涉及到增删改查）

例如：

java 复制代码 
@Mapper
public interface ArticleMapper {
    int insert(Article row);

    int insertSelective(Article row);

    Article selectByPrimaryKey(Long id);

    int updateByPrimaryKeySelective(Article row);

    int updateByPrimaryKeyWithBLOBs(Article row);

    int updateByPrimaryKey(Article row);

    /**
     * 显示首页列表
     * @return
     */
    List<Article> selectAll ();

    /**
     * 显示版块列表
     * @param boardId
     * @return
     */
    List<Article> selectAllByBoardId(Long boardId);

    /**
     * 帖子详情
     * @param id
     * @return
     */
    Article selectDetailById(Long id);

    /**
     * 根据用户id查询对应用户帖子列表
     * @param userId
     * @return
     */
    List<Article> selectByUserId (Long userId);


}

4.4统一前后端数据交互对象

java 复制代码 
/**
 * Created with IntelliJ IDEA.
 * Description:统一的前后端交互对象
 * User: 林
 * Date: 2024-02-29
 * Time: 19:39
 */
public class AppResult<T> {
    @JsonInclude(JsonInclude.Include.ALWAYS) // 不论任何情况都参与JSON序列化
    private long code;
    @JsonInclude(JsonInclude.Include.ALWAYS) // 不论任何情况都参与JSON序列化
    private String message;
    @JsonInclude(JsonInclude.Include.ALWAYS) // 不论任何情况都参与JSON序列化
    private T data;//泛型

    public AppResult(long code, String message, T data) {
        this.code = code;
        this.message = message;
        this.data = data;
    }

    public AppResult(long code, String message) {
        this(code,message,null);
    }

    public long getCode() {
        return code;
    }

    public void setCode(long code) {
        this.code = code;
    }

    public String getMessage() {
        return message;
    }

    public void setMessage(String message) {
        this.message = message;
    }

    public T getData() {
        return data;
    }

    public void setData(T data) {
        this.data = data;
    }

    //提供一些常用的静态方法

    /**
     * 成功
     */
    //不需要返回数据
    public static AppResult success(){
        return  new AppResult(ResultCode.SUCCESS.getCode(),ResultCode.SUCCESS.getMessage());
    }
    //不需要返回数据,自定义描述信息
    public static AppResult success(String message){
        return  new AppResult(ResultCode.SUCCESS.getCode(),message);
    }
    //有数据
    public static <T> AppResult<T> success(T data){
        return new AppResult(ResultCode.SUCCESS.getCode(),ResultCode.SUCCESS.getMessage(),data);
    }
    //有数据,自定义描述信息
    public static <T> AppResult<T> success(String message,T data){
        return new AppResult(ResultCode.SUCCESS.getCode(),message,data);
    }

    /**
     * 失败
     */
    public static AppResult failed(){
        return new AppResult(ResultCode.FAILED.getCode(),ResultCode.FAILED.getMessage());
    }
    //自定义描述信息
    public static AppResult failed(String message){
        return new AppResult(ResultCode.FAILED.getCode(),message);
    }
    //直接接收一个状态码对象,因为失败原因有多个
    public static AppResult failed(ResultCode resultCode){
        return new AppResult(resultCode.getCode(),resultCode.getMessage());
    }
}

4.5全局统一异常处理

使用@ControllerAdvice配和@ExceptionHandler实现全局异常处理：

java 复制代码 
/**
 * Created with IntelliJ IDEA.
 * Description:全局统一异常处理
 * User: 林
 * Date: 2024-03-01
 * Time: 15:57
 */
@Slf4j
@ControllerAdvice
public class GlobalExceptionHandler {

    //处理自定义的异常
    @ResponseBody
    @ExceptionHandler(ApplicationException.class)
    public AppResult applicationExceptionHandler (ApplicationException e) {
        // 打印异常信息
        e.printStackTrace(); // 上生产之前要删除，生产环境使用日志记录的
        // 打印日志
        log.error(e.getMessage());
        if (e.getErrorResult() != null) {
            return e.getErrorResult();
        }
        // 非空校验
        if (e.getMessage() == null || e.getMessage().equals("")) {
            return AppResult.failed(ResultCode.ERROR_SERVICES);
        }
        // 返回具体的异常信息
        return AppResult.failed(e.getMessage());
    }

   //处理非自定义的异常
    @ResponseBody
    @ExceptionHandler(Exception.class)
    public AppResult exceptionHandler (Exception e) {
        // 打印异常信息
        e.printStackTrace();
        // 打印日志
        log.error(e.getMessage());
        // 非空校验
        if (e.getMessage() == null || e.getMessage().equals("")) {
            return AppResult.failed(ResultCode.ERROR_SERVICES);
        }
        // 返回异常信息
        return AppResult.failed(e.getMessage());
    }
}

4.6注册、登录、退出登录

利用MD5对密码进行加密存储：

java 复制代码 
public class MD5Util {

    /**
     * 对字符串进行MD5加密
     * @param str 明文
     * @return 密文
     */
    public static String md5 (String str) {
        return DigestUtils.md5Hex(str);
    }

    /**
     * 对用户密码进行加密
     * @param str 密码明文
     * @param salt 扰动字符，盐值
     * @return 密文
     */
    public static String md5Salt (String str, String salt) {
        return md5(md5(str) + salt);//将原密码加密，拼上盐值，再一起加密成密文
    }
}

4.7修改个人信息

先查询到之前的用户信息，再修改（修改密码则要还检验原密码）。

4.8用户主页信息

查询操作：根据用户id查询用户信息和用户所发布的帖子（按发布时间倒序排列）。

4.9帖子列表

查询操作：首页查询所有帖子，切换版块则查询对应版块帖子（按发布时间倒序排列）。

4.10查看全文

查询加修改操作：查询帖子，更新阅读量+1。

4.11添加、修改、删除帖子

增加，修改，删除操作：这些操作声明为事务

java 复制代码 
 /**
     * 创建帖子
     * @param article
     */
    @Transactional//事务
    void  create (Article article);

4.12私信功能

发送，回复私信：增加操作。

信息查看和信息状态更新（涉及到查询，修改操作）：用户点开私信列表（查询所有收到的私信），有新的消息，则该消息此时状态为未读。点开该消息（查询该消息详情），则状态为已读（修改操作，修改消息状态）。回复该消息，则该消息状态为已回复（修改操作，修改消息状态）。

java 复制代码 
public interface IMessageService {

    /**
     * 创建一个私信，用于发送给其他用户
     * @param message
     */
    void create (Message message);

    /**
     * 根据用户id统计未读的信息
     * @param receiveUserId
     * @return
     */
    Integer selectUnreadCount(Long receiveUserId);

    /**
     * 据id查询用户接收的私信列表,包括发送者信息和私信内容
     * @param receiveUserId
     * @return
     */
    List<Message> selectByReceiveUserId (Long receiveUserId);

    /**
     * 根据id更新私信状态
     * @param id
     * @param state
     */
    void updateStateById(Long id, Byte state);

    /**
     * 根据id查找私信
     * @param id
     * @return
     */
    Message selectById(Long id);

    /**
     * 回复私信
     * @param repliedId
     * @param message
     */
    @Transactional
    void reply (Long repliedId, Message message);
}

4.13评论，点赞帖子

评论帖子：增加操作...

点赞帖子：修改操作，+1.

4.14白天，夜间效果

前端实现...

4.15用户权限限制

使用HandlerInterceptor拦截器实现用户登录校验：

java 复制代码 
/**
 * Created with IntelliJ IDEA.
 * Description:登录拦截器
 * User: 林
 * Date: 2024-03-05
 * Time: 22:13
 */
@Component
public class LoginInterceptor implements HandlerInterceptor {
    @Value("${lin-forum.login.url}")
    private String defaultURL;
    //对拦截的内容做前置处理
    @Override
    public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
        //获取session
        HttpSession session=request.getSession(false);
        //判断session
        if(session!=null && session.getAttribute(USER_SESSION)!=null){
            //用户已经登录
            return true;
        }
        //还未登录,重定向到登录页面
        //校验url地址是否以/开头
        if(!defaultURL.startsWith("/")){
            defaultURL="/"+defaultURL;
        }
        response.sendRedirect(defaultURL);
        return false;
    }
}

四、项目代码（gitee地址）

forum · new林/项目 - 码云 - 开源中国 (gitee.com)

（服务器过期了，没部署...）

相关推荐
天才梦浪1 天前
开源租房项目
java·项目
此星光明6 天前
北大西洋横断面（ANT）项目计划
数据集·项目·ant·北大西洋·调查·横断面
weixin_422201301 个月前
idea如何根据路径快速在项目中快速打卡该页面
前端·vue.js·intellij-idea·项目·路径
独孤思维1 个月前
独孤思维：拒绝了一个付费加入图书电商项目的
职场·项目·副业·独孤思维·赚钱
海绵宝宝de派小星1 个月前
项目：仿RabbitMQ实现的消息队列组件
rabbitmq·项目
独孤思维1 个月前
独孤思维：10个T的赚钱资料，要不要
职场·项目·副业·独孤思维·赚钱
小哈里1 个月前
【竞赛】本科阶段部分证书考试 & 科研竞赛 的 网站导航（算法、项目、安全、数据、科研）
算法·安全·科研·项目·竞赛
Mr.anla1 个月前
从 0 实现一个文件搜索工具 (Java 项目)
java·sqlite·项目·课设
日星月云1 个月前
单点登录【demo】
java·项目
热门推荐
01Coze扣子平台完整体验和实践（附国内和国际版对比）02组基轨迹建模 GBTM的介绍与实现（Stata 或 R）03【经验分享】Ubuntu22.04安装微信(linux官方版)042024亚太赛（中文赛）数学建模竞赛选题建议+初步分析05yolov8实战第五天——yolov8+ffmpg实时视频流检测并进行实时推流——（推流，保姆教学）06【立创EDA-PCB设计基础】6.布线铺铜实战及细节详解07【漏洞复现】Geoserver远程代码执行漏洞（CVE-2024-36401）082025张宇考研数学，百度网盘视频课+36讲PDF讲义+真题09浏览器插件——ModHeader 的分享和学习10基于coc.nvim打造开箱即用的个人PDE