基于SSM + Spring Boot + Thymeleaf开发的论坛社区网站

* [简介](#简介) * [项目概述](#项目概述) * [部署](#部署) * [线上部署](#线上部署) * [本地部署](#本地部署) * [项目难度](#项目难度) * [实现步骤](#实现步骤) * [权限模块](#权限模块) * [首页](#首页) * [分页](#分页) * [邮箱注册](#邮箱注册) * [登录](#登录) * [验证码](#验证码) * [状态保持](#状态保持) * [设置头像](#设置头像) * [简单的权限管理](#简单的权限管理) * [发帖评论私信](#发帖评论私信) * [敏感词过滤](#敏感词过滤) * [发帖](#发帖) * [评论](#评论) * [私信](#私信) * [统一异常处理](#统一异常处理) * [统一记录日志](#统一记录日志) * [点赞关注](#点赞关注) * [点赞](#点赞) * [关注](#关注) * [缓存优化](#缓存优化) * [代替session存储验证码](#代替session存储验证码) * [存储登录凭证](#存储登录凭证) * [存储用户信息](#存储用户信息) * [系统通知](#系统通知) * [搜索](#搜索) * [其他](#其他) * [认证授权](#认证授权) * [置顶加精删除](#置顶加精删除) * [网站统计](#网站统计) * [UV独立访客统计](#uv独立访客统计) * [DAU日活统计](#dau日活统计) * [热帖排行](#热帖排行) * [头像上传云服务器](#头像上传云服务器) * [本地缓存](#本地缓存) * [服务器部署](#服务器部署) # 简介 ## 项目概述 本项目是依据2019年牛客项目，基于SSM + Spring Boot + Thymeleaf开发的论坛社区网站，网站实现了如下功能： - 使用Spring Email + Interceptor + Spring Security等实现网站权限模块开发，完成注册、登录、退出、状态、设置、授权等功能。 - 实现网站核心功能，包括首页、帖子、评论、私信、敏感词过滤、全局异常处理、统一日志记录。 - 使用Redis实现其他功能模块，包括点赞、关注、网站数据统计、缓存优化，其中缓存主要为：验证码、登录凭证、会话信息。 - 引入Kafka的目的主要是为了异步生产消费事件，包括评论、点赞、关注时的系统通知，以及Elasticsearch服务器的更新。 - 使用Elasticsearch实现全文搜索。 - 基于Quartz定时任务实现热帖排行；使用Caffeine做热帖服务器缓存，提升性能。 后面我会罗列一些我认为的重点，梳理项目的后台实现步骤。 总结图如下：  ## 部署 ### 线上部署 项目最终部署到了阿里云ECS上, [项目地址](http://8.140.189.108/) ### 本地部署 略。 ## 项目难度 本人是把这个项目作为学校工程实践前的热身项目。整个项目约需1个月，可作为Java练手项目，快速了解热门框架和组件的基本使用。项目可改进的地方有很多，最后会提到。 # 实现步骤 ## 权限模块 ### 首页 首页进行帖子的展示，依据一般后台开发业务流程进行实现：数据库建表->Java对应entity实体类->mapper层接口->接口对应的xml文件实现crud逻辑(Mybatis)->service层->controller层->页面。  ### 分页 通过Page类封装分页逻辑： ```java public class Page { //当前页码，默认1 private int current = 1; //每页显示上限，默认10 private int limit = 10; //数据总数 private int rows; //查询路径，复用分页链接 private String path; public int getCurrent() { return current; } public void setCurrent(int current) { if(current >= 1) { this.current = current; } } public int getLimit() { return limit; } public void setLimit(int limit) { if(limit >= 1 && limit <= 100) { this.limit = limit; } } public int getRows() { return rows; } public void setRows(int rows) { if(rows >= 0) { this.rows = rows; } } public String getPath() { return path; } public void setPath(String path) { this.path = path; } /** * 获取当前页的起始行 * @return */ public int getOffset() { return (current - 1) * limit; } /** * 获取总页数 * @return */ public int getTotal() { if(rows % limit == 0) { return rows / limit; } else { return rows /limit + 1; } } /** * 获取起始页码 * @return */ public int getFrom() { int from = current - 2; return Math.max(from, 1); } /** * 获取终止页码 * @return */ public int getTo() { int to = current + 2; return Math.min(to, getTotal()); } } ``` 前台传来的current等参数通过controller的Page类参数进行封装，从而实现页面跳转。该模块可用于其他地方大量复用。 HomeController层对于Page类的使用： ```java @RequestMapping(value = "/index", method = RequestMethod.GET) public String getIndexPage(Model model, Page page) { page.setRows(discussPostService.findDiscussPostRows(0)); page.setPath("/index"); List<DiscussPost> list = discussPostService.findDiscussPosts(0, page.getOffset(), page.getLimit()); List<Map<String,Object>> discussPosts = new ArrayList<>(); if(list != null) { for(DiscussPost discussPost : list) { Map<String,Object> map = new HashMap<>(); map.put("post", discussPost); map.put("user", userService.findUserById(discussPost.getUserId())); //这里也可以在map层做级联查询调出user数据 discussPosts.add(map); } } model.addAttribute("discussPosts", discussPosts); //model加page可以省略 return "/index"; } ``` ### 邮箱注册 对前台传来的注册表单数据进行判重判空和数据库匹配后，如果能注册，将用户数据插入数据库： ```java //注册 user.setSalt(NcCommunityUtil.generateUUID().substring(0,5)); user.setPassword(NcCommunityUtil.md5(user.getPassword() + user.getSalt())); user.setType(0); //普通用户 user.setStatus(0); //还未激活 user.setActivationCode(NcCommunityUtil.generateUUID()); user.setHeaderUrl(String.format("http://images.nowcoder.com/head/%dt.png", new Random().nextInt(1000))); user.setCreateTime(new Date()); userMapper.insertUser(user); ``` 注意：密码的存储是经过加盐和md5加密的，防止密码泄露。数据库存储了该用户的盐和加密的密码。 然后发送激活邮件： ```java //发送激活邮件 Context context = new Context(); context.setVariable("email", user.getEmail()); context.setVariable("url", domain + contextPath + "/activation/" + user.getId() + "/" + user.getActivationCode()); //激活链接 String content = templateEngine.process("/mail/activation", context); new Thread(new Runnable() { @Override public void run() { mailClient.sendMail(user.getEmail(), "激活账号", content); } }).start(); //由于发送邮件太慢，直接交给多线程去处理 ``` mailClient工具类封装了JavaMailSender进行邮箱激活，需要在配置文件中进行邮箱SMTP服务的配置。这里用子线程去发送邮件，防止卡顿时间过长。 邮箱里的激活链接即是通过"/activation/{userId}/{code}"访问路径修改用户的status字段，使其可用。 ### 登录 登录时检查信息正确性的逻辑和注册时基本一致，需�