300字范文 > Spring Boot + vue-element 开发个人博客项目实战教程（十五文章功能实现（下））

Spring Boot + vue-element 开发个人博客项目实战教程（十五文章功能实现（下））

时间：2020-09-18 22:12:19

⭐ 作者简介：码上言
⭐ 代表教程：Spring Boot + vue-element 开发个人博客项目实战教程
⭐专栏内容：零基础学Java、个人博客系统

项目部署视频

/video/BV1sg4y1A7Kv/?vd_source=dc7bf298d3c608d281c16239b3f5167b

文章目录

项目部署视频前言一、标签和文章关联表开发1、关联表实体类2、文章增加3、邮箱发送3.1、引用3.2、邮件服务器配置 4、添加根据用户id查找用户5、文章修改6、删除文章二、完整代码1、ArticleServiceImpl.java2、ArticleTagServiceImpl.java3、ArticleTagService.java4、ArticleTagMapper.java5、ArticleTagMapper.xml 三、测试

前言

小伙伴们原谅我更新的有点慢了，过年事情比较多，前面的一章我们已经把文章的基本功能实现了，但是文章还牵扯到很多的功能，我们的关联表还没有维护，所以还有很多的东西需要去写。我们先把这个写好，如果有时间后边再使用Mybatis-pius更新第二期，先把这个一期搞完再说吧。

一、标签和文章关联表开发

1、关联表实体类

这个很简单，我们就三个字段，新增加一个ArticleTag.java类

package com.blog.personalblog.entity;import lombok.Data;/*** @author: SuperMan* @create: -01-14*/@Data@Builderpublic class ArticleTag {/*** id主键*/private Integer id;/*** 文章id*/private Integer articleId;/*** 标签id*/private Integer tagId;}

这个地方用到了一个注解@Builder，这个注解主要使用创建者模式又叫建造者模式。简单来说，就是一步步创建一个对象，它对用户屏蔽了里面构建的细节，但却可以精细地控制对象的构造过程。

@Builder声明实体，表示可以进行Builder方式初始化，@Value注解，表示只公开getter，对所有属性的setter都封闭，即private修饰，所以它不能和@Builder现起用

2、文章增加

接下来我们修改上一篇写的文章增加的方法，我们把文章标签关联加上，在我们添加文章的时候，文章和标签的关联表也要进行添加。

首先在文章的实体类中添加一个属性。

/*** 文章标签添加或更新时使用*/private List<Integer> tagIdList;

接下来我们添加文章的标签

//添加文章标签if (article.getTagIdList() != null) {List<ArticleTag> articleTagList = article.getTagIdList().stream().map(tagId -> ArticleTag.builder().tagId(tagId).articleId(article.getId()).build()).collect(Collectors.toList());articleTagService.insertBatch(articleTagList);}

可能会有些童学没看懂这个操作，我来解释一下这个流程。

首先判断添加的文章是否有标签，然后我们将前端传过来的标签关联的id进行遍历，这里没有使用for循环，而是使用了Java8的.stream().map().collect()用法，这样减少的了代码的行数，看起来比较高大上，精简代码。

steam():把一个源数据，可以是集合，数组，I/O channel，产生器generator 等，转化成流。
map():用于映射每个元素到对应的结果
Collectors(): 类实现了很多归约操作，例如将流转换成集合和聚合元素。

在以往的版本中，我们要新建一个空的List，然后遍历，再add到List中非常的麻烦，现在一行代码就实现了这个功能，所以在学习中，不能只使用一种方法要多用集中方法去实现。

我们拿到遍历的List<ArticleTag>，然后批量去插入关联表，这是我们创建一个ArticleTagService.java业务接口。

然后添加一个批量添加的接口。既然是批量插入，我们的参数就设置为List进行接收。

package com.blog.personalblog.service;import com.blog.personalblog.entity.ArticleTag;import java.util.List;/*** @author: SuperMan* @create: -01-24**/public interface ArticleTagService {/*** 批量插入文章标签数据** @param articleTagList*/void insertBatch(List<ArticleTag> articleTagList);}

有了接口就要有接口的实现类，我们再创建一个实现类ArticleTagServiceImpl.java

package com.blog.personalblog.service.Impl;import com.blog.personalblog.entity.ArticleTag;import com.blog.personalblog.mapper.ArticleTagMapper;import com.blog.personalblog.service.ArticleTagService;import lombok.extern.log4j.Log4j2;import org.springframework.stereotype.Service;import javax.annotation.Resource;import java.util.List;/*** @author: SuperMan* @create: -01-24**/@Log4j2@Servicepublic class ArticleTagServiceImpl implements ArticleTagService {@ResourceArticleTagMapper articleTagMapper;@Overridepublic void insertBatch(List<ArticleTag> articleTagList) {try {articleTagMapper.insertBatch(articleTagList);} catch (Exception e) {log.error("批量添加文章标签失败！" + e.getMessage());}}}

这个也没有什么可以讲的，和我们之前的批量插入差不多。

接下来对数据库操作，我们需要创建一个关联表的Mapper接口，对数据库进行操作。

新建ArticleTagMapper.java接口

package com.blog.personalblog.mapper;import com.blog.personalblog.entity.ArticleTag;import org.apache.ibatis.annotations.Param;import org.springframework.stereotype.Repository;import java.util.List;/*** @author: SuperMan* @create: -01-24**/@Repositorypublic interface ArticleTagMapper {/*** 批量插入* @param articleTagList*/int insertBatch(@Param("articleTagList") List<ArticleTag> articleTagList);}

然后再新建一个xml来写sql语句，相信大家这一套流程基本上熟悉了。

新建ArticleTagMapper.xml文件

<?xml version="1.0" encoding="UTF-8" ?><!DOCTYPE mapperPUBLIC "-////DTD Mapper 3.0//EN""/dtd/mybatis-3-mapper.dtd"><mapper namespace="com.blog.personalblog.mapper.ArticleTagMapper"><resultMap id="BaseResultMap" type="com.blog.personalblog.entity.ArticleTag"><result column="id" jdbcType="INTEGER" property="id"/><result column="article_id" jdbcType="INTEGER" property="articleId"/><result column="tag_id" jdbcType="INTEGER" property="tagId"/></resultMap><insert id="insertBatch">INSERT INTO person_article_tag<trim prefix="(" suffix=")" suffixOverrides=",">article_id, tag_id</trim>VALUES<foreach collection="articleTagList" item="item" separator=","><trim prefix="(" suffix=")" suffixOverrides=",">#{item.articleId}, #{item.tagId}</trim></foreach></insert></mapper>

这里的批量插写的sql语句和之前的有点不太一样，使用了trim标签。

mybatis的trim标签一般用于去除sql语句中多余的and关键字，逗号，或者给sql语句前拼接 “where“、“set“以及“values(“ 等前缀，或者添加“)“等后缀，可用于选择性插入、更新、删除或者条件查询等操作。

使用也非常的简单，就是省略了之前的and关键字等。其余的都差不多，也使用了foreach循环。

好啦，到此添加的功能基本上完善了。

3、邮箱发送

我在写的过程中又突然想到了邮箱的功能，反正做项目的目的就是学习，索性我就把邮箱的功能也加入到了文章添加中，我们在添加文章成功后，会发一条成功创建一条文章到你的邮箱上，接收的邮箱是你的创建用户的时候的邮箱，发送的邮箱我们在后台写死，不能对它操作。如果你想挑战的话也可以把发送邮箱写活，配置不同的发送邮箱，可以自己尝试。我这里就不写了，有问题可以问我。

其实很简单，我把邮箱的发送核心都简单化了，只要两个类即可，接下来我们就来完成这个功能。

在我们的config包中新建一个mail包，然后创建一个MailInfo.java实体类和SendMailConfig.java类。

MailInfo.java类主要是用来存放接收的邮箱、标题和邮件内容。具体如下代码：

注意这里也使用了@Builder

package com.blog.personalblog.config.mail;import lombok.Builder;import lombok.Data;import java.util.List;/*** 邮件接收配置信息** @author: SuperMan* @create: -01-24**/@Builder@Datapublic class MailInfo {/*** 接收的邮箱*/private String receiveMail;/*** 邮件标题*/private String title;/*** 邮件内容*/private String content;}

接下来我们要实现邮件发送的方法，这里我们使用了Hutool的邮件发送。

参考官方文档：

/docs/#/extra/%E9%82%AE%E4%BB%B6%E5%B7%A5%E5%85%B7-MailUtil

3.1、引用

Hutool对所有第三方都是可选依赖，因此在使用MailUtil时需要自行引入第三方依赖。

<dependency><groupId>com.sun.mail</groupId><artifactId>javax.mail</artifactId><version>1.6.2</version></dependency>

3.2、邮件服务器配置

注意邮件服务器必须支持并打开SMTP协议

这里我们使用qq邮箱作为发送邮箱，我们需要开通一下我们qq邮箱配置，我们先移步到qq邮箱，使用电脑登录qq邮箱，然后在顶部找到设置->账户

见腾讯的帮助说明：https://service./cgi-bin/help?subtype=1&&id=28&&no=1001256

然后往下找，找到标题为：POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务

然后开启这两个，会提示你发送你一条短信，发送完成后，会有一个授权码，把那个授权码保存下来，那个就是我们发送的密码。

接下里我们去写邮件发送配置SendMailConfig.java

package com.blog.personalblog.config.mail;import cn.hutool.extra.mail.MailAccount;import cn.hutool.extra.mail.MailUtil;import cn.hutool.json.JSONUtil;import lombok.extern.log4j.Log4j2;/*** 邮件发送* @author: SuperMan* @create: -01-24**/@Log4j2public class SendMailConfig {/*** 邮件发送实现方法* @param mailInfo*/public static void sendMail(MailInfo mailInfo) {try {MailAccount account = new MailAccount();//邮件服务器的SMTP地址account.setHost("");//邮件服务器的SMTP端口account.setPort(587);//发件人邮箱，改成你自己的account.setFrom("13323232332@");//密码，刚开通的授权码account.setPass("WYUSTGBIISYSCAIC");//使用SSL安全连接account.setSslEnable(false);MailUtil.send(account, mailInfo.getReceiveMail(),mailInfo.getTitle(), mailInfo.getContent(), false);log.info("邮件发送成功！");} catch (Exception e) {log.error("邮件发送失败" + JSONUtil.toJsonStr(mailInfo));}}}

我把邮箱发送功能封装成了类，我们在那边使用到直接调用这个方法即可，传三个参数即可。MailAccount和MailUtil是Hutool的类，我们引入包直接使用即可。

可以参考Hutool给的例子：

邮件服务器的SMTP地址
host =
邮件服务器的SMTP端口
port = 465
发件人（必须正确，否则发送失败）
from = hutool@
用户名（注意：如果使用foxmail邮箱，此处user为qq号）
user = hutool
密码（注意，某些邮箱需要为SMTP服务单独设置密码，详情查看相关帮助）
pass = q1w2e3
使用 STARTTLS安全连接，STARTTLS是对纯文本通信协议的扩展。
starttlsEnable = true
使用SSL安全连接
sslEnable = true
指定实现.SocketFactory接口的类的名称,这个类将被用于创建SMTP的套接字
socketFactoryClass = .ssl.SSLSocketFactory
如果设置为true,未能创建一个套接字使用指定的套接字工厂类将导致使用.Socket创建的套接字类, 默认值为true
socketFactoryFallback = true
指定的端口连接到在使用指定的套接字工厂。如果没有设置,将使用默认端口456
socketFactoryPort = 465
SMTP超时时长，单位毫秒，缺省值不超时
timeout = 0
Socket连接超时值，单位毫秒，缺省值不超时
connectionTimeout = 0

配置完成后，我们在添加文章成功后进行发送，还是添加文章的实现方法中调用发送邮箱的方法。

4、添加根据用户id查找用户

这里我们使用的是用户信息中的邮箱，我们需要获取到是哪个用户发布的文章，根据用户id去查找用户对象。我们打开UserService.java，添加一个根据用户id查找对象的接口。

/*** 根据用户id查找用户* @param userId* @return*/User findByUserId(Integer userId);

然后在实现类中实现这个接口

@Overridepublic User findByUserId(Integer userId) {User user = userMapper.getUserById(userId);return user;}

再对数据库进行操作，在UserMapper.java中增加一个dao接口

/*** 根据用户id查找* @param userId* @return*/User getUserById(Integer userId);

然后在xml中添加sql语句

<select id="getUserById" parameterType="java.lang.Integer" resultMap="BaseResultMap">select * from person_user where id = #{userId, jdbcType=INTEGER}</select>

完成之后，我们回到ArticleServiceImpl.java实现类中，在添加文章的方法中添加邮箱发送。

User user = userService.findByUserId(article.getUserId());//添加文章发送邮箱提醒String content = "【{0}】您好：\n" +"您已成功发布了标题为: {1} 的文章 \n" +"请注意查收！\n";MailInfo build = MailInfo.builder().receiveMail(user.getEmail()).content(MessageFormat.format(content, user.getUserName(), article.getTitle())).title("文章发布").build();SendMailConfig.sendMail(build);

说明：首先根据用户id去查找该用户的信息，然后创建邮件内容，{0}、{1}是占位符，进行补充内容。然后创建对象并设置值，在这里的邮箱是接收邮件的邮箱，最后调用发送邮箱的方法即可。

到目前为止，我们的添加文章到此写完了，下面还有文章修改也要修改标签关联基本上和添加一样。

5、文章修改

这里需要注意的是在修改文章的时候可能会修改标签，这里我不管标签有没有修改都先把标签删除掉，然后再添加。

在ArticleTagService.java类中再添加一个接口，根据文章id删除关联表的标签数据。

/*** 根据文章id删除关联表的标签数据** @param articleId*/void deleteTag(Integer articleId);

实现类ArticleTagServiceImpl.java

@Overridepublic void deleteTag(Integer articleId) {articleTagMapper.deleteByArticleId(articleId);}

数据操作接口ArticleTagMapper.java

/*** 根据文章id删除关联表的数据* @param articleId*/void deleteByArticleId(@Param("articleId") Integer articleId);

xml文件的数据操作

<delete id="deleteByArticleId" parameterType="java.lang.Integer">DELETE FROM person_article_tag WHERE article_id = #{articleId}</delete>

文章修改的代码：

修改文章基本上和添加的一样，就多了个删除的操作。

@Overridepublic void updateArticle(Article article) {articleMapper.updateArticle(article);articleMap.put(article.getId(), article);//更新文章先把原来的标签删除掉articleTagService.deleteTag(article.getId());//添加文章标签if (article.getTagIdList() != null) {List<ArticleTag> articleTagList = article.getTagIdList().stream().map(tagId -> ArticleTag.builder().tagId(tagId).articleId(article.getId()).build()).collect(Collectors.toList());articleTagService.insertBatch(articleTagList);}}

6、删除文章

删除文章的时候也要将关联的标签删除掉

@Overridepublic void deleteArticle(Integer articleId) {articleMapper.deleteArticle(articleId);articleMap.remove(articleId);//关联标签删除掉articleTagService.deleteTag(articleId);}

好啦，还剩一个文章列表的方法

文章列表查询的时候关联的标签也要查出来，所以我们还要根据文章id去查找关联表中的标签

在ArticleTagService.java中添加一个查找的接口

/*** 根据文章id查找出所有的关联标签数据** @param articleId* @return*/List<ArticleTag> findArticleTagById(Integer articleId);

实现类：

@Overridepublic List<ArticleTag> findArticleTagById(Integer articleId) {List<ArticleTag> articleTagList = articleTagMapper.getArticleTagById(articleId);return articleTagList;}

数据库接口：

/*** 根据文章id查找出所有的关联标签数据* @param articleId* @return*/List<ArticleTag> getArticleTagById(@Param("articleId") Integer articleId);

xml文件：

<select id="getArticleTagById" resultMap="BaseResultMap">SELECT * FROM person_article_tag WHERE article_id = #{articleId}</select>

准备工作完成，接下里修改文章列表，将查找的文章进行遍历，再将标签整合到返回的对象中。

@Overridepublic List<Article> getArticlePage(ArticleBO articleBO) {int pageNum = articleBO.getPageNum();int pageSize = articleBO.getPageSize();PageHelper.startPage(pageNum,pageSize);List<Article> articleList = articleMapper.getArticlePage(articleBO);List<Tag> tagList = new ArrayList<>();if (articleList != null) {for (Article article : articleList) {List<ArticleTag> articleTags = articleTagService.findArticleTagById(article.getId());if (articleTags != null) {for (ArticleTag articleTag : articleTags) {Tag tag = tagService.findTagById(articleTag.getTagId());tagList.add(tag);}}article.setTagList(tagList);}}return articleList;}

好啦，到目前为止，文章的开发整体结束，接下来的一篇写操作日志，还差个登录，基本上我们的博客系统就比较完善了，还有数据的统计，一步步的来，自己也可以先写写。

二、完整代码

这里我粘贴一下完整的代码（只贴修改的类）。供大家参考

1、ArticleServiceImpl.java

package com.blog.personalblog.service.Impl;import com.blog.personalblog.bo.ArticleBO;import com.blog.personalblog.config.mail.MailInfo;import com.blog.personalblog.config.mail.SendMailConfig;import com.blog.personalblog.entity.Article;import com.blog.personalblog.entity.ArticleTag;import com.blog.personalblog.entity.Tag;import com.blog.personalblog.entity.User;import com.blog.personalblog.mapper.ArticleMapper;import com.blog.personalblog.service.ArticleService;import com.blog.personalblog.service.ArticleTagService;import com.blog.personalblog.service.TagService;import com.blog.personalblog.service.UserService;import com.github.pagehelper.PageHelper;import lombok.extern.log4j.Log4j2;import org.springframework.beans.factory.annotation.Autowired;import org.springframework.stereotype.Service;import javax.annotation.PostConstruct;import javax.annotation.Resource;import java.text.MessageFormat;import java.util.ArrayList;import java.util.LinkedHashMap;import java.util.List;import java.util.Map;import java.util.stream.Collectors;/*** @author: SuperMan* @create: -12-01*/@Log4j2@Servicepublic class ArticleServiceImpl implements ArticleService {@AutowiredArticleMapper articleMapper;@ResourceArticleTagService articleTagService;@ResourceUserService userService;@ResourceTagService tagService;/*** key:文章id* value: 文章*/Map<Integer, Article> articleMap = new LinkedHashMap<>();@Override@PostConstructpublic void init() {List<Article> articleList = articleMapper.findAll();try {for(Article article : articleList) {articleMap.put(article.getId(), article);}log.info("文章缓存数据加载完成");} catch (Exception e) {log.error("文章缓存数据加载失败！", e.getMessage());}}@Overridepublic List<Article> getArticlePage(ArticleBO articleBO) {int pageNum = articleBO.getPageNum();int pageSize = articleBO.getPageSize();PageHelper.startPage(pageNum,pageSize);List<Article> articleList = articleMapper.getArticlePage(articleBO);List<Tag> tagList = new ArrayList<>();if (articleList != null) {for (Article article : articleList) {List<ArticleTag> articleTags = articleTagService.findArticleTagById(article.getId());if (articleTags != null) {for (ArticleTag articleTag : articleTags) {Tag tag = tagService.findTagById(articleTag.getTagId());tagList.add(tag);}}article.setTagList(tagList);}}return articleList;}@Overridepublic void saveArticle(Article article) {articleMapper.createArticle(article);articleMap.put(article.getId(), article);//添加文章标签if (article.getTagIdList() != null) {List<ArticleTag> articleTagList = article.getTagIdList().stream().map(tagId -> ArticleTag.builder().tagId(tagId).articleId(article.getId()).build()).collect(Collectors.toList());articleTagService.insertBatch(articleTagList);}User user = userService.findByUserId(article.getUserId());//添加文章发送邮箱提醒String content = "【{0}】您好：\n" +"您已成功发布了标题为: {1} 的文章 \n" +"请注意查收！\n";MailInfo build = MailInfo.builder().receiveMail(user.getEmail()).content(MessageFormat.format(content, user.getUserName(), article.getTitle())).title("文章发布").build();SendMailConfig.sendMail(build);}@Overridepublic void updateArticle(Article article) {articleMapper.updateArticle(article);articleMap.put(article.getId(), article);//更新文章先把原来的标签删除掉articleTagService.deleteTag(article.getId());//添加文章标签if (article.getTagIdList() != null) {List<ArticleTag> articleTagList = article.getTagIdList().stream().map(tagId -> ArticleTag.builder().tagId(tagId).articleId(article.getId()).build()).collect(Collectors.toList());articleTagService.insertBatch(articleTagList);}}@Overridepublic void deleteArticle(Integer articleId) {articleMapper.deleteArticle(articleId);articleMap.remove(articleId);//关联标签删除掉articleTagService.deleteTag(articleId);}@Overridepublic Article findById(Integer articleId) {Article article = articleMap.get(articleId);if (article == null) {Article art = articleMapper.getById(articleId);return art;}return article;}}

2、ArticleTagServiceImpl.java

3、ArticleTagService.java

package com.blog.personalblog.service;import com.blog.personalblog.entity.ArticleTag;import java.util.List;/*** @author: SuperMan* @create: -01-24**/public interface ArticleTagService {/*** 批量插入文章标签数据** @param articleTagList*/void insertBatch(List<ArticleTag> articleTagList);/*** 根据文章id删除关联表的标签数据** @param articleId*/void deleteTag(Integer articleId);/*** 根据文章id查找出所有的关联标签数据** @param articleId* @return*/List<ArticleTag> findArticleTagById(Integer articleId);}

4、ArticleTagMapper.java

package com.blog.personalblog.mapper;import com.blog.personalblog.entity.ArticleTag;import org.apache.ibatis.annotations.Param;import org.springframework.stereotype.Repository;import java.util.List;/*** @author: SuperMan* @create: -01-24**/@Repositorypublic interface ArticleTagMapper {/*** 批量插入* @param articleTagList*/int insertBatch(@Param("articleTagList") List<ArticleTag> articleTagList);/*** 根据文章id删除关联表的数据* @param articleId*/void deleteByArticleId(@Param("articleId") Integer articleId);/*** 根据文章id查找出所有的关联标签数据* @param articleId* @return*/List<ArticleTag> getArticleTagById(@Param("articleId") Integer articleId);}

5、ArticleTagMapper.xml

三、测试

添加文章测试

这里你要确定标签表里要有添加的标签id。

{"author": "码上言1","title": "我的第一篇博客上线啦！","userId": 1,"categoryId": 2,"content": "这是博客的内容","views": 0,"totalWords": 0,"commentableId": 1,"artStatus": 0,"description": "这是备注","imageUrl": "","tagIdList":[ 1,2]}

修改和删除大家自己测试一下

上一篇：Spring Boot + vue-element 开发个人博客项目实战教程（十四、文章功能实现（上））

下一篇：Spring Boot + vue-element 开发个人博客项目实战教程（十六、登录功能实现（上））

本内容不代表本网观点和政治立场，如有侵犯你的权益请联系我们处理。

网友评论

网友评论仅供其表达个人看法，并不表明网站立场。