diff --git "a/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/FastJsonRedisSerializer.java" "b/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/FastJsonRedisSerializer.java" new file mode 100644 index 0000000000000000000000000000000000000000..ec5a2a72cf15c53bbdb3665a95f3f55a756f9f7a --- /dev/null +++ "b/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/FastJsonRedisSerializer.java" @@ -0,0 +1,64 @@ +package com.sangeng.config; + +import com.alibaba.fastjson.JSON; +import com.alibaba.fastjson.serializer.SerializerFeature; +import com.fasterxml.jackson.databind.JavaType; +import com.fasterxml.jackson.databind.ObjectMapper; +import com.fasterxml.jackson.databind.type.TypeFactory; +import org.springframework.data.redis.serializer.RedisSerializer; +import org.springframework.data.redis.serializer.SerializationException; +import com.alibaba.fastjson.parser.ParserConfig; +import org.springframework.util.Assert; +import java.nio.charset.Charset; + +/** + * Redis使用FastJson序列化 + * + * @author sg + */ +public class FastJsonRedisSerializer implements RedisSerializer +{ + + public static final Charset DEFAULT_CHARSET = Charset.forName("UTF-8"); + + private Class clazz; + + static + { + ParserConfig.getGlobalInstance().setAutoTypeSupport(true); + } + + public FastJsonRedisSerializer(Class clazz) + { + super(); + this.clazz = clazz; + } + + @Override + public byte[] serialize(T t) throws SerializationException + { + if (t == null) + { + return new byte[0]; + } + return JSON.toJSONString(t, SerializerFeature.WriteClassName).getBytes(DEFAULT_CHARSET); + } + + @Override + public T deserialize(byte[] bytes) throws SerializationException + { + if (bytes == null || bytes.length <= 0) + { + return null; + } + String str = new String(bytes, DEFAULT_CHARSET); + + return JSON.parseObject(str, clazz); + } + + + protected JavaType getJavaType(Class clazz) + { + return TypeFactory.defaultInstance().constructType(clazz); + } +} \ No newline at end of file diff --git "a/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/JwtUtil.java" "b/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/JwtUtil.java" new file mode 100644 index 0000000000000000000000000000000000000000..fd40de346be31c5af2099cd880f6d7f3e1609e1d --- /dev/null +++ "b/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/JwtUtil.java" @@ -0,0 +1,113 @@ +package com.sangeng.utils; + +import io.jsonwebtoken.Claims; +import io.jsonwebtoken.JwtBuilder; +import io.jsonwebtoken.Jwts; +import io.jsonwebtoken.SignatureAlgorithm; + +import javax.crypto.SecretKey; +import javax.crypto.spec.SecretKeySpec; +import java.util.Base64; +import java.util.Date; +import java.util.UUID; + +/** + * JWT工具类 + */ +public class JwtUtil { + + //有效期为 + public static final Long JWT_TTL = 24*60 * 60 *1000L;// 60 * 60 *1000 一个小时 + //设置秘钥明文 + public static final String JWT_KEY = "sangeng"; + + public static String getUUID(){ + String token = UUID.randomUUID().toString().replaceAll("-", ""); + return token; + } + + /** + * 生成jtw + * @param subject token中要存放的数据（json格式） + * @return + */ + public static String createJWT(String subject) { + JwtBuilder builder = getJwtBuilder(subject, null, getUUID());// 设置过期时间 + return builder.compact(); + } + + /** + * 生成jtw + * @param subject token中要存放的数据（json格式） + * @param ttlMillis token超时时间 + * @return + */ + public static String createJWT(String subject, Long ttlMillis) { + JwtBuilder builder = getJwtBuilder(subject, ttlMillis, getUUID());// 设置过期时间 + return builder.compact(); + } + + private static JwtBuilder getJwtBuilder(String subject, Long ttlMillis, String uuid) { + SignatureAlgorithm signatureAlgorithm = SignatureAlgorithm.HS256; + SecretKey secretKey = generalKey(); + long nowMillis = System.currentTimeMillis(); + Date now = new Date(nowMillis); + if(ttlMillis==null){ + ttlMillis=JwtUtil.JWT_TTL; + } + long expMillis = nowMillis + ttlMillis; + Date expDate = new Date(expMillis); + return Jwts.builder() + .setId(uuid) //唯一的ID + .setSubject(subject) // 主题 可以是JSON数据 + .setIssuer("sg") // 签发者 + .setIssuedAt(now) // 签发时间 + .signWith(signatureAlgorithm, secretKey) //使用HS256对称加密算法签名, 第二个参数为秘钥 + .setExpiration(expDate); + } + + /** + * 创建token + * @param id + * @param subject + * @param ttlMillis + * @return + */ + public static String createJWT(String id, String subject, Long ttlMillis) { + JwtBuilder builder = getJwtBuilder(subject, ttlMillis, id);// 设置过期时间 + return builder.compact(); + } + + public static void main(String[] args) throws Exception { + String token = "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJjYWM2ZDVhZi1mNjVlLTQ0MDAtYjcxMi0zYWEwOGIyOTIwYjQiLCJzdWIiOiJzZyIsImlzcyI6InNnIiwiaWF0IjoxNjM4MTA2NzEyLCJleHAiOjE2MzgxMTAzMTJ9.JVsSbkP94wuczb4QryQbAke3ysBDIL5ou8fWsbt_ebg"; + Claims claims = parseJWT(token); + System.out.println(claims); + } + + /** + * 生成加密后的秘钥 secretKey + * @return + */ + public static SecretKey generalKey() { + byte[] encodedKey = Base64.getDecoder().decode(JwtUtil.JWT_KEY); + SecretKey key = new SecretKeySpec(encodedKey, 0, encodedKey.length, "AES"); + return key; + } + + /** + * 解析 + * + * @param jwt + * @return + * @throws Exception + */ + public static Claims parseJWT(String jwt) throws Exception { + SecretKey secretKey = generalKey(); + return Jwts.parser() + .setSigningKey(secretKey) + .parseClaimsJws(jwt) + .getBody(); + } + + +} \ No newline at end of file diff --git "a/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/RedisCache.java" "b/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/RedisCache.java" new file mode 100644 index 0000000000000000000000000000000000000000..f8ac90008836b0ceb72e7bb4b97f8fa67d79f8f2 --- /dev/null +++ "b/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/RedisCache.java" @@ -0,0 +1,238 @@ +package com.sangeng.utils; + +import org.springframework.beans.factory.annotation.Autowired; +import org.springframework.data.redis.core.BoundSetOperations; +import org.springframework.data.redis.core.HashOperations; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.core.ValueOperations; +import org.springframework.stereotype.Component; + +import java.util.*; +import java.util.concurrent.TimeUnit; + +@SuppressWarnings(value = { "unchecked", "rawtypes" }) +@Component +public class RedisCache +{ + @Autowired + public RedisTemplate redisTemplate; + + /** + * 缓存基本的对象，Integer、String、实体类等 + * + * @param key 缓存的键值 + * @param value 缓存的值 + */ + public void setCacheObject(final String key, final T value) + { + redisTemplate.opsForValue().set(key, value); + } + + /** + * 缓存基本的对象，Integer、String、实体类等 + * + * @param key 缓存的键值 + * @param value 缓存的值 + * @param timeout 时间 + * @param timeUnit 时间颗粒度 + */ + public void setCacheObject(final String key, final T value, final Integer timeout, final TimeUnit timeUnit) + { + redisTemplate.opsForValue().set(key, value, timeout, timeUnit); + } + + /** + * 设置有效时间 + * + * @param key Redis键 + * @param timeout 超时时间 + * @return true=设置成功；false=设置失败 + */ + public boolean expire(final String key, final long timeout) + { + return expire(key, timeout, TimeUnit.SECONDS); + } + + /** + * 设置有效时间 + * + * @param key Redis键 + * @param timeout 超时时间 + * @param unit 时间单位 + * @return true=设置成功；false=设置失败 + */ + public boolean expire(final String key, final long timeout, final TimeUnit unit) + { + return redisTemplate.expire(key, timeout, unit); + } + + /** + * 获得缓存的基本对象。 + * + * @param key 缓存键值 + * @return 缓存键值对应的数据 + */ + public T getCacheObject(final String key) + { + ValueOperations operation = redisTemplate.opsForValue(); + return operation.get(key); + } + + /** + * 删除单个对象 + * + * @param key + */ + public boolean deleteObject(final String key) + { + return redisTemplate.delete(key); + } + + /** + * 删除集合对象 + * + * @param collection 多个对象 + * @return + */ + public long deleteObject(final Collection collection) + { + return redisTemplate.delete(collection); + } + + /** + * 缓存List数据 + * + * @param key 缓存的键值 + * @param dataList 待缓存的List数据 + * @return 缓存的对象 + */ + public long setCacheList(final String key, final List dataList) + { + Long count = redisTemplate.opsForList().rightPushAll(key, dataList); + return count == null ? 0 : count; + } + + /** + * 获得缓存的list对象 + * + * @param key 缓存的键值 + * @return 缓存键值对应的数据 + */ + public List getCacheList(final String key) + { + return redisTemplate.opsForList().range(key, 0, -1); + } + + /** + * 缓存Set + * + * @param key 缓存键值 + * @param dataSet 缓存的数据 + * @return 缓存数据的对象 + */ + public BoundSetOperations setCacheSet(final String key, final Set dataSet) + { + BoundSetOperations setOperation = redisTemplate.boundSetOps(key); + Iterator it = dataSet.iterator(); + while (it.hasNext()) + { + setOperation.add(it.next()); + } + return setOperation; + } + + /** + * 获得缓存的set + * + * @param key + * @return + */ + public Set getCacheSet(final String key) + { + return redisTemplate.opsForSet().members(key); + } + + /** + * 缓存Map + * + * @param key + * @param dataMap + */ + public void setCacheMap(final String key, final Map dataMap) + { + if (dataMap != null) { + redisTemplate.opsForHash().putAll(key, dataMap); + } + } + + /** + * 获得缓存的Map + * + * @param key + * @return + */ + public Map getCacheMap(final String key) + { + return redisTemplate.opsForHash().entries(key); + } + + /** + * 往Hash中存入数据 + * + * @param key Redis键 + * @param hKey Hash键 + * @param value 值 + */ + public void setCacheMapValue(final String key, final String hKey, final T value) + { + redisTemplate.opsForHash().put(key, hKey, value); + } + + /** + * 获取Hash中的数据 + * + * @param key Redis键 + * @param hKey Hash键 + * @return Hash中的对象 + */ + public T getCacheMapValue(final String key, final String hKey) + { + HashOperations opsForHash = redisTemplate.opsForHash(); + return opsForHash.get(key, hKey); + } + + /** + * 删除Hash中的数据 + * + * @param key + * @param hkey + */ + public void delCacheMapValue(final String key, final String hkey) + { + HashOperations hashOperations = redisTemplate.opsForHash(); + hashOperations.delete(key, hkey); + } + + /** + * 获取多个Hash中的数据 + * + * @param key Redis键 + * @param hKeys Hash键集合 + * @return Hash对象集合 + */ + public List getMultiCacheMapValue(final String key, final Collection hKeys) + { + return redisTemplate.opsForHash().multiGet(key, hKeys); + } + + /** + * 获得缓存的基本对象列表 + * + * @param pattern 字符串前缀 + * @return 对象列表 + */ + public Collection keys(final String pattern) + { + return redisTemplate.keys(pattern); + } +} \ No newline at end of file diff --git "a/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/RedisConfig.java" "b/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/RedisConfig.java" new file mode 100644 index 0000000000000000000000000000000000000000..ab2e1ad4efb9e05d2604402845421216130b8391 --- /dev/null +++ "b/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/RedisConfig.java" @@ -0,0 +1,32 @@ +package com.sangeng.config; + +import org.springframework.context.annotation.Bean; +import org.springframework.context.annotation.Configuration; +import org.springframework.data.redis.connection.RedisConnectionFactory; +import org.springframework.data.redis.core.RedisTemplate; +import org.springframework.data.redis.serializer.StringRedisSerializer; + +@Configuration +public class RedisConfig { + + @Bean + @SuppressWarnings(value = { "unchecked", "rawtypes" }) + public RedisTemplate redisTemplate(RedisConnectionFactory connectionFactory) + { + RedisTemplate template = new RedisTemplate<>(); + template.setConnectionFactory(connectionFactory); + + FastJsonRedisSerializer serializer = new FastJsonRedisSerializer(Object.class); + + // 使用StringRedisSerializer来序列化和反序列化redis的key值 + template.setKeySerializer(new StringRedisSerializer()); + template.setValueSerializer(serializer); + + // Hash的key也采用StringRedisSerializer的序列化方式 + template.setHashKeySerializer(new StringRedisSerializer()); + template.setHashValueSerializer(serializer); + + template.afterPropertiesSet(); + return template; + } +} \ No newline at end of file diff --git "a/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/WebUtils.java" "b/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/WebUtils.java" new file mode 100644 index 0000000000000000000000000000000000000000..7ea8be20c119c459a65ef6c03263c0d905f35698 --- /dev/null +++ "b/doc/\347\231\273\345\275\225\345\212\237\350\203\275\346\211\200\351\234\200\350\265\204\346\272\220/WebUtils.java" @@ -0,0 +1,44 @@ +package com.sangeng.utils; + +import org.springframework.web.context.request.RequestContextHolder; + +import javax.servlet.ServletContext; +import javax.servlet.http.HttpServletResponse; +import java.io.IOException; +import java.io.UnsupportedEncodingException; +import java.net.URLEncoder; + +public class WebUtils +{ + /** + * 将字符串渲染到客户端 + * + * @param response 渲染对象 + * @param string 待渲染的字符串 + * @return null + */ + public static void renderString(HttpServletResponse response, String string) { + try + { + response.setStatus(200); + response.setContentType("application/json"); + response.setCharacterEncoding("utf-8"); + response.getWriter().print(string); + } + catch (IOException e) + { + e.printStackTrace(); + } + } + + + public static void setDownLoadHeader(String filename, ServletContext context, HttpServletResponse response) throws UnsupportedEncodingException { + String mimeType = context.getMimeType(filename);//获取文件的mime类型 + response.setHeader("content-type",mimeType); + String fname= URLEncoder.encode(filename,"UTF-8"); + response.setHeader("Content-disposition","attachment; filename="+fname); + +// response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); +// response.setCharacterEncoding("utf-8"); + } +} \ No newline at end of file diff --git "a/doc/\347\254\224\350\256\260/img/image-20220202111056036-16437714601701.png" "b/doc/\347\254\224\350\256\260/img/image-20220202111056036-16437714601701.png" new file mode 100644 index 0000000000000000000000000000000000000000..08a58869b2d898d030121ccf14e3f4679ee8444a Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220202111056036-16437714601701.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220202111056036.png" "b/doc/\347\254\224\350\256\260/img/image-20220202111056036.png" new file mode 100644 index 0000000000000000000000000000000000000000..08a58869b2d898d030121ccf14e3f4679ee8444a Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220202111056036.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220202121318183-16437751995162.png" "b/doc/\347\254\224\350\256\260/img/image-20220202121318183-16437751995162.png" new file mode 100644 index 0000000000000000000000000000000000000000..47827a0d0ab6fbf760f3692a262c42fe9eb68d53 Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220202121318183-16437751995162.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220202121318183.png" "b/doc/\347\254\224\350\256\260/img/image-20220202121318183.png" new file mode 100644 index 0000000000000000000000000000000000000000..47827a0d0ab6fbf760f3692a262c42fe9eb68d53 Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220202121318183.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220202152402296-16437866440853.png" "b/doc/\347\254\224\350\256\260/img/image-20220202152402296-16437866440853.png" new file mode 100644 index 0000000000000000000000000000000000000000..1f9bf4666a8e97cb671477117ea88432f65827ec Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220202152402296-16437866440853.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220202152402296.png" "b/doc/\347\254\224\350\256\260/img/image-20220202152402296.png" new file mode 100644 index 0000000000000000000000000000000000000000..1f9bf4666a8e97cb671477117ea88432f65827ec Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220202152402296.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220202152440565.png" "b/doc/\347\254\224\350\256\260/img/image-20220202152440565.png" new file mode 100644 index 0000000000000000000000000000000000000000..eca950ee612cd79b708dc434e9bf469f3e9169bb Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220202152440565.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220208214106296.png" "b/doc/\347\254\224\350\256\260/img/image-20220208214106296.png" new file mode 100644 index 0000000000000000000000000000000000000000..b20a194ad9abfef1d56840f28cdd70634a1b36e8 Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220208214106296.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220227224443813.png" "b/doc/\347\254\224\350\256\260/img/image-20220227224443813.png" new file mode 100644 index 0000000000000000000000000000000000000000..86b0738fe6d3b57257f2bab7097f35a5304c0cd6 Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220227224443813.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220227224537701.png" "b/doc/\347\254\224\350\256\260/img/image-20220227224537701.png" new file mode 100644 index 0000000000000000000000000000000000000000..31524e8da2d0835846b2c6b260320d110dd90013 Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220227224537701.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220228230512598.png" "b/doc/\347\254\224\350\256\260/img/image-20220228230512598.png" new file mode 100644 index 0000000000000000000000000000000000000000..be279c535dc065cc8a6f1b688e9d8758ac062611 Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220228230512598.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220228230933808.png" "b/doc/\347\254\224\350\256\260/img/image-20220228230933808.png" new file mode 100644 index 0000000000000000000000000000000000000000..f23934f6149f1e74771c4cf0611f6f37fd8d741d Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220228230933808.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220313133714102.png" "b/doc/\347\254\224\350\256\260/img/image-20220313133714102.png" new file mode 100644 index 0000000000000000000000000000000000000000..2d82e9c9d476a567b30125b67cd5f5b01a737e22 Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220313133714102.png" differ diff --git "a/doc/\347\254\224\350\256\260/img/image-20220717120448125.png" "b/doc/\347\254\224\350\256\260/img/image-20220717120448125.png" new file mode 100644 index 0000000000000000000000000000000000000000..a0a29058eaeaa84456f9da6736ac823722657958 Binary files /dev/null and "b/doc/\347\254\224\350\256\260/img/image-20220717120448125.png" differ diff --git "a/doc/\347\254\224\350\256\260/\351\241\271\347\233\256\345\256\236\346\210\230-\345\211\215\345\220\216\347\253\257\345\210\206\347\246\273\345\215\232\345\256\242\347\263\273\347\273\237.md" "b/doc/\347\254\224\350\256\260/\351\241\271\347\233\256\345\256\236\346\210\230-\345\211\215\345\220\216\347\253\257\345\210\206\347\246\273\345\215\232\345\256\242\347\263\273\347\273\237.md" new file mode 100644 index 0000000000000000000000000000000000000000..43d6433f566c748099ff54da5b69e5b1cfd968d7 --- /dev/null +++ "b/doc/\347\254\224\350\256\260/\351\241\271\347\233\256\345\256\236\346\210\230-\345\211\215\345\220\216\347\253\257\345\210\206\347\246\273\345\215\232\345\256\242\347\263\273\347\273\237.md" @@ -0,0 +1,8459 @@ +# 项目实战-前后端分离博客系统 + +## 1.课程介绍 + +* 纯后端讲解 +* 完整的前台后台代码编写 +* 主流技术栈（SpringBoot,MybatisPlus,SpringSecurity,EasyExcel,Swagger2,Redis,Echarts,Vue,ElementUI....） +* 完善细致的需求分析 +* 由易到难循序渐进 + + + +## 2.创建工程 + +​ 我们有前台和后台两套系统。两套系统的前端工程都已经提供好了。所以我们只需要写两套系统的后端。 + +​ 但是大家思考下，实际上两套后端系统的很多内容是可能重复的。这里如果我们只是单纯的创建两个后端工程。那么就会有大量的重复代码，并且需要修改的时候也需要修改两次。这就是代码复用性不高。 + +​ 所以我们需要创建多模块项目，两套系统可能都会用到的代码可以写到一个公共模块中，让前台系统和后台系统分别取依赖公共模块。 + + + +① 创建父模块 + +~~~~xml + + + 4.0.0 + + com.sangeng + SGBlog + pom + 1.0-SNAPSHOT + + sangeng-framework + sangeng-admin + sangeng-blog + + + + UTF-8 + 1.8 + + + + + + + + org.springframework.boot + spring-boot-dependencies + 2.5.0 + pom + import + + + + com.alibaba + fastjson + 1.2.33 + + + + io.jsonwebtoken + jjwt + 0.9.0 + + + + com.baomidou + mybatis-plus-boot-starter + 3.4.3 + + + + + com.aliyun.oss + aliyun-sdk-oss + 3.10.2 + + + + + com.alibaba + easyexcel + 3.0.5 + + + + io.springfox + springfox-swagger2 + 2.9.2 + + + io.springfox + springfox-swagger-ui + 2.9.2 + + + + + + + + + + org.apache.maven.plugins + maven-compiler-plugin + 3.1 + + ${java.version} + ${java.version} + ${project.build.sourceEncoding} + + + + + + +~~~~ + + + +②创建公共子模块 sangeng-framework + +~~~~xml + + + + SGBlog + com.sangeng + 1.0-SNAPSHOT + + 4.0.0 + + sangeng-framework + + + + org.springframework.boot + spring-boot-starter-web + + + + org.projectlombok + lombok + true + + + + org.springframework.boot + spring-boot-starter-test + test + + + + org.springframework.boot + spring-boot-starter-security + + + + org.springframework.boot + spring-boot-starter-data-redis + + + + com.alibaba + fastjson + + + + io.jsonwebtoken + jjwt + + + + com.baomidou + mybatis-plus-boot-starter + + + + mysql + mysql-connector-java + + + + + com.aliyun.oss + aliyun-sdk-oss + + + + + org.springframework.boot + spring-boot-starter-aop + + + + com.alibaba + easyexcel + + + io.springfox + springfox-swagger2 + + + io.springfox + springfox-swagger-ui + + + + + +~~~~ + + + +③创建博客后台模块sangeng-admin + +~~~~xml + + + + SGBlog + com.sangeng + 1.0-SNAPSHOT + + 4.0.0 + + sangeng-admin + + + + com.sangeng + sangeng-framework + 1.0-SNAPSHOT + + + + +~~~~ + +④创建博客前台模块sangeng-blog + +~~~~xml + + + + SGBlog + com.sangeng + 1.0-SNAPSHOT + + 4.0.0 + + sangeng-blog + + + + com.sangeng + sangeng-framework + 1.0-SNAPSHOT + + + + + +~~~~ + + + +## 3.博客前台 + +### 3.0 准备工作 + +#### 3.1 SpringBoot和MybatisPuls整合配置测试 + +①创建启动类 + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +@SpringBootApplication +@MapperScan("com.sangeng.mapper") +public class SanGengBlogApplication { + + public static void main(String[] args) { + SpringApplication.run(SanGengBlogApplication.class,args); + } +} +~~~~ + +②创建application.yml配置文件 + +~~~~yml +server: + port: 7777 +spring: + datasource: + url: jdbc:mysql://localhost:3306/sg_blog?characterEncoding=utf-8&serverTimezone=Asia/Shanghai + username: root + password: root + driver-class-name: com.mysql.cj.jdbc.Driver + servlet: + multipart: + max-file-size: 2MB + max-request-size: 5MB +mybatis-plus: + configuration: + # 日志 + log-impl: org.apache.ibatis.logging.stdout.StdOutImpl + global-config: + db-config: + logic-delete-field: delFlag + logic-delete-value: 1 + logic-not-delete-value: 0 + id-type: auto + +~~~~ + +③ SQL语句 + +​ SQL脚本：SGBlog\资源\SQL\sg_article.sql + +④ 创建实体类，Mapper，Service + +​ 注意思考这些文件应该写在哪个模块下？ + +~~~~java +@SuppressWarnings("serial") +@Data +@AllArgsConstructor +@NoArgsConstructor +@TableName("sg_article") +public class Article { + @TableId + private Long id; + //标题 + private String title; + //文章内容 + private String content; + //文章类型:1 文章 2草稿 + private String type; + //文章摘要 + private String summary; + //所属分类id + private Long categoryId; + //缩略图 + private String thumbnail; + //是否置顶（0否，1是） + private String isTop; + //状态（0已发布，1草稿） + private String status; + //评论数 + private Integer commentCount; + //访问量 + private Long viewCount; + //是否允许评论 1是，0否 + private String isComment; + + private Long createBy; + + private Date createTime; + + private Long updateBy; + + private Date updateTime; + //删除标志（0代表未删除，1代表已删除） + private Integer delFlag; + +} + + +~~~~ + +~~~~java +public interface ArticleMapper extends BaseMapper
{ + + +} + +~~~~ + +~~~~java +public interface ArticleService extends IService
{ +} + +~~~~ + +~~~~java +@Service +public class ArticleServiceImpl extends ServiceImpl implements ArticleService { + +} +~~~~ + + + +⑤ 创建Controller测试接口 + +​ 注意思考这些文件应该写在哪个模块下？ + +~~~~java +@RestController +@RequestMapping("/article") +public class ArticleController { + + @Autowired + private ArticleService articleService; + + @GetMapping("/list") + public List
test(){ + return articleService.list(); + } +} + +~~~~ + +​ 我们可以暂时先注释掉sangeng-framework中的SpringSecurity依赖方便测试 + + + +### 3.1 热门文章列表 + +#### 3.1.0 文章表分析 + +​ 通过需求去分析需要有哪些字段。 + +#### 3.1.1 需求 + +​ 需要查询浏览量最高的前10篇文章的信息。要求展示文章标题和浏览量。把能让用户自己点击跳转到具体的文章详情进行浏览。 + +​ 注意：不能把草稿展示出来，不能把删除了的文章查询出来。要按照浏览量进行降序排序。 + +#### 3.1.2 接口设计 + +​ 见接口文档 + +#### 3.1.3 基础版本代码实现 + +①准备工作 + +统一响应类和响应枚举 + +~~~~java +package com.sangeng.domain; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.sangeng.enums.AppHttpCodeEnum; + +import java.io.Serializable; + +@JsonInclude(JsonInclude.Include.NON_NULL) +public class ResponseResult implements Serializable { + private Integer code; + private String msg; + private T data; + + public ResponseResult() { + this.code = AppHttpCodeEnum.SUCCESS.getCode(); + this.msg = AppHttpCodeEnum.SUCCESS.getMsg(); + } + + public ResponseResult(Integer code, T data) { + this.code = code; + this.data = data; + } + + public ResponseResult(Integer code, String msg, T data) { + this.code = code; + this.msg = msg; + this.data = data; + } + + public ResponseResult(Integer code, String msg) { + this.code = code; + this.msg = msg; + } + + public static ResponseResult errorResult(int code, String msg) { + ResponseResult result = new ResponseResult(); + return result.error(code, msg); + } + public static ResponseResult okResult() { + ResponseResult result = new ResponseResult(); + return result; + } + public static ResponseResult okResult(int code, String msg) { + ResponseResult result = new ResponseResult(); + return result.ok(code, null, msg); + } + + public static ResponseResult okResult(Object data) { + ResponseResult result = setAppHttpCodeEnum(AppHttpCodeEnum.SUCCESS, AppHttpCodeEnum.SUCCESS.getMsg()); + if(data!=null) { + result.setData(data); + } + return result; + } + + public static ResponseResult errorResult(AppHttpCodeEnum enums){ + return setAppHttpCodeEnum(enums,enums.getMsg()); + } + + public static ResponseResult errorResult(AppHttpCodeEnum enums, String msg){ + return setAppHttpCodeEnum(enums,msg); + } + + public static ResponseResult setAppHttpCodeEnum(AppHttpCodeEnum enums){ + return okResult(enums.getCode(),enums.getMsg()); + } + + private static ResponseResult setAppHttpCodeEnum(AppHttpCodeEnum enums, String msg){ + return okResult(enums.getCode(),msg); + } + + public ResponseResult error(Integer code, String msg) { + this.code = code; + this.msg = msg; + return this; + } + + public ResponseResult ok(Integer code, T data) { + this.code = code; + this.data = data; + return this; + } + + public ResponseResult ok(Integer code, T data, String msg) { + this.code = code; + this.data = data; + this.msg = msg; + return this; + } + + public ResponseResult ok(T data) { + this.data = data; + return this; + } + + public Integer getCode() { + return code; + } + + public void setCode(Integer code) { + this.code = code; + } + + public String getMsg() { + return msg; + } + + public void setMsg(String msg) { + this.msg = msg; + } + + public T getData() { + return data; + } + + public void setData(T data) { + this.data = data; + } + + + +} +~~~~ + +~~~~java +package com.sangeng.enums; + +public enum AppHttpCodeEnum { + // 成功 + SUCCESS(200,"操作成功"), + // 登录 + NEED_LOGIN(401,"需要登录后操作"), + NO_OPERATOR_AUTH(403,"无权限操作"), + SYSTEM_ERROR(500,"出现错误"), + USERNAME_EXIST(501,"用户名已存在"), + PHONENUMBER_EXIST(502,"手机号已存在"), EMAIL_EXIST(503, "邮箱已存在"), + REQUIRE_USERNAME(504, "必需填写用户名"), + LOGIN_ERROR(505,"用户名或密码错误"); + int code; + String msg; + + AppHttpCodeEnum(int code, String errorMessage){ + this.code = code; + this.msg = errorMessage; + } + + public int getCode() { + return code; + } + + public String getMsg() { + return msg; + } +} + +~~~~ + + + +② 代码实现 + +~~~~java +@RestController +@RequestMapping("/article") +public class ArticleController { + + @Autowired + private ArticleService articleService; + + @GetMapping("/hotArticleList") + public ResponseResult hotArticleList(){ + + ResponseResult result = articleService.hotArticleList(); + return result; + } +} + +~~~~ + +~~~~java +public interface ArticleService extends IService
{ + ResponseResult hotArticleList(); +} + +~~~~ + +~~~~java +@Service +public class ArticleServiceImpl extends ServiceImpl implements ArticleService { + + @Override + public ResponseResult hotArticleList() { + //查询热门文章 封装成ResponseResult返回 + LambdaQueryWrapper
queryWrapper = new LambdaQueryWrapper<>(); + //必须是正式文章 + queryWrapper.eq(Article::getStatus,0); + //按照浏览量进行排序 + queryWrapper.orderByDesc(Article::getViewCount); + //最多只查询10条 + Page
page = new Page(1,10); + page(page,queryWrapper); + + List
articles = page.getRecords(); + return ResponseResult.okResult(articles); + } +} + +~~~~ + + + + + +③ 解决跨域问题 + +~~~~java +@Configuration +public class WebConfig implements WebMvcConfigurer { + + @Override + public void addCorsMappings(CorsRegistry registry) { + // 设置允许跨域的路径 + registry.addMapping("/**") + // 设置允许跨域请求的域名 + .allowedOriginPatterns("*") + // 是否允许cookie + .allowCredentials(true) + // 设置允许的请求方式 + .allowedMethods("GET", "POST", "DELETE", "PUT") + // 设置允许的header属性 + .allowedHeaders("*") + // 跨域允许时间 + .maxAge(3600); + } + +} +~~~~ + + + + + +#### 3.1.4 使用VO优化 + +​ 目前我们的响应格式其实是不符合接口文档的标准的，多返回了很多字段。这是因为我们查询出来的结果是Article来封装的，Article中字段比较多。 + +​ 我们在项目中一般最后还要把VO来接受查询出来的结果。一个接口对应一个VO，这样即使接口响应字段要修改也只要改VO即可。 + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class HotArticleVo { + private Long id; + //标题 + private String title; + + //访问量 + private Long viewCount; +} + +~~~~ + +~~~~java +@Service +public class ArticleServiceImpl extends ServiceImpl implements ArticleService { + + @Override + public ResponseResult hotArticleList() { + //查询热门文章 封装成ResponseResult返回 + LambdaQueryWrapper
queryWrapper = new LambdaQueryWrapper<>(); + //必须是正式文章 + queryWrapper.eq(Article::getStatus,0); + //按照浏览量进行排序 + queryWrapper.orderByDesc(Article::getViewCount); + //最多只查询10条 + Page
page = new Page(1,10); + page(page,queryWrapper); + + List
articles = page.getRecords(); + //bean拷贝 + List articleVos = new ArrayList<>(); + for (Article article : articles) { + HotArticleVo vo = new HotArticleVo(); + BeanUtils.copyProperties(article,vo); + articleVos.add(vo); + } + + return ResponseResult.okResult(articleVos); + } +} +~~~~ + +#### 3.1.5 字面值处理 + +​ 实际项目中都不允许直接在代码中使用字面值。都需要定义成常量来使用。这种方式有利于提高代码的可维护性。 + +~~~~java +public class SystemConstants +{ + /** + * 文章是草稿 + */ + public static final int ARTICLE_STATUS_DRAFT = 1; + /** + * 文章是正常分布状态 + */ + public static final int ARTICLE_STATUS_NORMAL = 0; + +} +~~~~ + +~~~~java +@Service +public class ArticleServiceImpl extends ServiceImpl implements ArticleService { + + @Override + public ResponseResult hotArticleList() { + //查询热门文章 封装成ResponseResult返回 + LambdaQueryWrapper
queryWrapper = new LambdaQueryWrapper<>(); + //必须是正式文章 + queryWrapper.eq(Article::getStatus, SystemConstants.ARTICLE_STATUS_NORMAL); + //按照浏览量进行排序 + queryWrapper.orderByDesc(Article::getViewCount); + //最多只查询10条 + Page
page = new Page(1,10); + page(page,queryWrapper); + + List
articles = page.getRecords(); + //bean拷贝 + List articleVos = new ArrayList<>(); + for (Article article : articles) { + HotArticleVo vo = new HotArticleVo(); + BeanUtils.copyProperties(article,vo); + articleVos.add(vo); + } + + return ResponseResult.okResult(articleVos); + } +} +~~~~ + + + + + +### 3.2 Bean拷贝工具类封装 + +~~~~java +public class BeanCopyUtils { + + private BeanCopyUtils() { + } + + public static V copyBean(Object source,Class clazz) { + //创建目标对象 + V result = null; + try { + result = clazz.newInstance(); + //实现属性copy + BeanUtils.copyProperties(source, result); + } catch (Exception e) { + e.printStackTrace(); + } + //返回结果 + return result; + } + public static List copyBeanList(List list,Class clazz){ + return list.stream() + .map(o -> copyBean(o, clazz)) + .collect(Collectors.toList()); + } +} + +~~~~ + + + + + +### 3.2 查询分类列表 + +#### 3.2.0 分类表分析 + +​ 通过需求去分析需要有哪些字段。 + +​ 建表SQL及初始化数据见：SGBlog\资源\SQL\sg_category.sql + +#### 3.2.1 需求 + +![image-20220202111056036](img/image-20220202111056036-16437714601701.png) + +​ 页面上需要展示分类列表，用户可以点击具体的分类查看该分类下的文章列表。 + +​ 注意： ①要求只展示有发布正式文章的分类 ②必须是正常状态的分类 + + + +#### 3.2.2 接口设计 + +​ 见接口文档 + +#### 3.2.3 EasyCode代码模板 + +~~~~java +##导入宏定义 +$!{define.vm} + +##保存文件（宏定义） +#save("/entity", ".java") + +##包路径（宏定义） +#setPackageSuffix("entity") + +##自动导入包（全局变量） +$!{autoImport.vm} + +import java.io.Serializable; +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; +import com.baomidou.mybatisplus.annotation.TableId; +import com.baomidou.mybatisplus.annotation.TableName; +##表注释（宏定义） +#tableComment("表实体类") +@SuppressWarnings("serial") +@Data +@AllArgsConstructor +@NoArgsConstructor +@TableName("$!{tableInfo.obj.name}") +public class $!{tableInfo.name} { +#foreach($column in $tableInfo.pkColumn) + #if(${column.comment})//${column.comment}#end +@TableId + private $!{tool.getClsNameByFullName($column.type)} $!{column.name}; +#end + +#foreach($column in $tableInfo.otherColumn) + #if(${column.comment})//${column.comment}#end + + private $!{tool.getClsNameByFullName($column.type)} $!{column.name}; +#end + + + +} + +~~~~ + +~~~~java +##导入宏定义 +$!{define.vm} + +##设置表后缀（宏定义） +#setTableSuffix("Mapper") + +##保存文件（宏定义） +#save("/mapper", "Mapper.java") + +##包路径（宏定义） +#setPackageSuffix("mapper") + +import com.baomidou.mybatisplus.core.mapper.BaseMapper; + + +##表注释（宏定义） +#tableComment("表数据库访问层") +public interface $!{tableName} extends BaseMapper<$!tableInfo.name> { + +} + +~~~~ + +~~~~java +##导入宏定义 +$!{define.vm} + +##设置表后缀（宏定义） +#setTableSuffix("Service") + +##保存文件（宏定义） +#save("/service", "Service.java") + +##包路径（宏定义） +#setPackageSuffix("service") + +import com.baomidou.mybatisplus.extension.service.IService; + + +##表注释（宏定义） +#tableComment("表服务接口") +public interface $!{tableName} extends IService<$!tableInfo.name> { + +} + +~~~~ + + + +~~~~java +##导入宏定义 +$!{define.vm} + +##设置表后缀（宏定义） +#setTableSuffix("ServiceImpl") + +##保存文件（宏定义） +#save("/service/impl", "ServiceImpl.java") + +##包路径（宏定义） +#setPackageSuffix("service.impl") + +import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; +import org.springframework.stereotype.Service; + +##表注释（宏定义） +#tableComment("表服务实现类") +@Service("$!tool.firstLowerCase($tableInfo.name)Service") +public class $!{tableName} extends ServiceImpl<$!{tableInfo.name}Mapper, $!{tableInfo.name}> implements $!{tableInfo.name}Service { + +} + +~~~~ + + + +#### 3.2.4 代码实现 + +~~~~java +@RestController +@RequestMapping("/category") +public class CategoryController { + + @Autowired + private CategoryService categoryService; + + @GetMapping("/getCategoryList") + public ResponseResult getCategoryList(){ + return categoryService.getCategoryList(); + } +} + + +~~~~ + +~~~~java +public interface CategoryService extends IService { + + + ResponseResult getCategoryList(); + +} +~~~~ + +~~~~java +@Service("categoryService") +public class CategoryServiceImpl extends ServiceImpl implements CategoryService { + + @Autowired + private ArticleService articleService; + + @Override + public ResponseResult getCategoryList() { + //查询文章表 状态为已发布的文章 + LambdaQueryWrapper
articleWrapper = new LambdaQueryWrapper<>(); + articleWrapper.eq(Article::getStatus,SystemConstants.ARTICLE_STATUS_NORMAL); + List
articleList = articleService.list(articleWrapper); + //获取文章的分类id，并且去重 + Set categoryIds = articleList.stream() + .map(article -> article.getCategoryId()) + .collect(Collectors.toSet()); + + //查询分类表 + List categories = listByIds(categoryIds); + categories = categories.stream(). + filter(category -> SystemConstants.STATUS_NORMAL.equals(category.getStatus())) + .collect(Collectors.toList()); + //封装vo + List categoryVos = BeanCopyUtils.copyBeanList(categories, CategoryVo.class); + + return ResponseResult.okResult(categoryVos); + } +} + +~~~~ + + + +### 3.3 分页查询文章列表 + +#### 3.3.1 需求 + +​ 在首页和分类页面都需要查询文章列表。 + +​ 首页：查询所有的文章 + +​ 分类页面：查询对应分类下的文章 + +​ 要求：①只能查询正式发布的文章 ②置顶的文章要显示在最前面 + +#### 3.3.2 接口设计 + +​ 见文档 + +#### 3.3.3 代码实现 + +MP支持分页配置 + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +@Configuration +public class MbatisPlusConfig { + + /** + * 3.4.0之后版本 + * @return + */ + @Bean + public MybatisPlusInterceptor mybatisPlusInterceptor(){ + MybatisPlusInterceptor mybatisPlusInterceptor = new MybatisPlusInterceptor(); + mybatisPlusInterceptor.addInnerInterceptor(new PaginationInnerInterceptor()); + return mybatisPlusInterceptor; + } +} +~~~~ + +在ArticleController中 + +~~~~java + @GetMapping("/articleList") + public ResponseResult articleList(Integer pageNum,Integer pageSize,Long categoryId){ + return articleService.articleList(pageNum,pageSize,categoryId); + } +~~~~ + +在ArticleService中 + +~~~~java +ResponseResult articleList(Integer pageNum, Integer pageSize, Long categoryId); +~~~~ + +在ArticleServiceImpl中 + +~~~~java + +@Service +public class ArticleServiceImpl extends ServiceImpl implements ArticleService { + + @Autowired + private CategoryService categoryService; + + @Override + public ResponseResult hotArticleList() { + //查询热门文章 封装成ResponseResult返回 + LambdaQueryWrapper
queryWrapper = new LambdaQueryWrapper<>(); + //必须是正式文章 + queryWrapper.eq(Article::getStatus, SystemConstants.ARTICLE_STATUS_NORMAL); + //按照浏览量进行排序 + queryWrapper.orderByDesc(Article::getViewCount); + //最多只查询10条 + Page
page = new Page(1,10); + page(page,queryWrapper); + + List
articles = page.getRecords(); + //bean拷贝 +// List articleVos = new ArrayList<>(); +// for (Article article : articles) { +// HotArticleVo vo = new HotArticleVo(); +// BeanUtils.copyProperties(article,vo); +// articleVos.add(vo); +// } + List vs = BeanCopyUtils.copyBeanList(articles, HotArticleVo.class); + return ResponseResult.okResult(vs); + } + + @Override + public ResponseResult articleList(Integer pageNum, Integer pageSize, Long categoryId) { + //查询条件 + LambdaQueryWrapper
lambdaQueryWrapper = new LambdaQueryWrapper<>(); + // 如果 有categoryId 就要 查询时要和传入的相同 + lambdaQueryWrapper.eq(Objects.nonNull(categoryId)&&categoryId>0 ,Article::getCategoryId,categoryId); + // 状态是正式发布的 + lambdaQueryWrapper.eq(Article::getStatus,SystemConstants.ARTICLE_STATUS_NORMAL); + // 对isTop进行降序 + lambdaQueryWrapper.orderByDesc(Article::getIsTop); + + //分页查询 + Page
page = new Page<>(pageNum,pageSize); + page(page,lambdaQueryWrapper); + + List
articles = page.getRecords(); + //查询categoryName + articles.stream() + .map(article -> article.setCategoryName(categoryService.getById(article.getCategoryId()).getName())) + .collect(Collectors.toList()); + //articleId去查询articleName进行设置 +// for (Article article : articles) { +// Category category = categoryService.getById(article.getCategoryId()); +// article.setCategoryName(category.getName()); +// } + + //封装查询结果 + List articleListVos = BeanCopyUtils.copyBeanList(page.getRecords(), ArticleListVo.class); + + PageVo pageVo = new PageVo(articleListVos,page.getTotal()); + return ResponseResult.okResult(pageVo); + } +} +~~~~ + + + +PageVo + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class PageVo { + private List rows; + private Long total; +} + +~~~~ + +ArticleListVo + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class ArticleListVo { + + private Long id; + //标题 + private String title; + //文章摘要 + private String summary; + //所属分类名 + private String categoryName; + //缩略图 + private String thumbnail; + + + //访问量 + private Long viewCount; + + private Date createTime; + + +} +~~~~ + +在Article中增加一个字段 + +~~~~java + @TableField(exist = false) + private String categoryName; +~~~~ + + + +#### 3.3.4 FastJson配置 + +~~~~java + @Bean//使用@Bean注入fastJsonHttpMessageConvert + public HttpMessageConverter fastJsonHttpMessageConverters() { + //1.需要定义一个Convert转换消息的对象 + FastJsonHttpMessageConverter fastConverter = new FastJsonHttpMessageConverter(); + FastJsonConfig fastJsonConfig = new FastJsonConfig(); + fastJsonConfig.setSerializerFeatures(SerializerFeature.PrettyFormat); + fastJsonConfig.setDateFormat("yyyy-MM-dd HH:mm:ss"); + + SerializeConfig.globalInstance.put(Long.class, ToStringSerializer.instance); + + fastJsonConfig.setSerializeConfig(SerializeConfig.globalInstance); + fastConverter.setFastJsonConfig(fastJsonConfig); + HttpMessageConverter converter = fastConverter; + return converter; + } + + @Override + public void configureMessageConverters(List> converters) { + converters.add(fastJsonHttpMessageConverters()); + } +~~~~ + + + +### 3.4 文章详情接口 + +#### 3.4.1 需求 + +​ 要求在文章列表点击阅读全文时能够跳转到文章详情页面，可以让用户阅读文章正文。 + +​ 要求：①要在文章详情中展示其分类名 + +#### 3.4.2 接口设计 + +| 请求方式 | 请求路径 | +| -------- | ------------- | +| Get | /article/{id} | + +响应格式： + +~~~~json +{ + "code": 200, + "data": { + "categoryId": "1", + "categoryName": "java", + "content": "内容", + "createTime": "2022-01-23 23:20:11", + "id": "1", + "isComment": "0", + "title": "SpringSecurity从入门到精通", + "viewCount": "114" + }, + "msg": "操作成功" +} +~~~~ + +#### 3.4.3 代码实现 + +ArticleController中新增 + +~~~~java + @GetMapping("/{id}") + public ResponseResult getArticleDetail(@PathVariable("id") Long id){ + return articleService.getArticleDetail(id); + } +~~~~ + + + +Service + +~~~~java +ResponseResult getArticleDetail(Long id); +~~~~ + + + +ServiceImpl + +~~~~java + @Override + public ResponseResult getArticleDetail(Long id) { + //根据id查询文章 + Article article = getById(id); + //转换成VO + ArticleDetailVo articleDetailVo = BeanCopyUtils.copyBean(article, ArticleDetailVo.class); + //根据分类id查询分类名 + Long categoryId = articleDetailVo.getCategoryId(); + Category category = categoryService.getById(categoryId); + if(category!=null){ + articleDetailVo.setCategoryName(category.getName()); + } + //封装响应返回 + return ResponseResult.okResult(articleDetailVo); + } +~~~~ + + + + + +### 3.5 友联查询 + +#### 3.5.0 友链表分析 + +​ 通过需求去分析需要有哪些字段。 + +​ 建表SQL及初始化数据见：SGBlog\资源\SQL\sg_link.sql + +#### 3.5.1 需求 + +​ 在友链页面要查询出所有的审核通过的友链。 + +#### 3.5.2 接口设计 + +| 请求方式 | 请求路径 | +| -------- | ---------------- | +| Get | /link/getAllLink | + +响应格式： + +~~~~json +{ + "code": 200, + "data": [ + { + "address": "https://www.baidu.com", + "description": "sda", + "id": "1", + "logo": "图片url1", + "name": "sda" + }, + { + "address": "https://www.qq.com", + "description": "dada", + "id": "2", + "logo": "图片url2", + "name": "sda" + } + ], + "msg": "操作成功" +} +~~~~ + + + +#### 3.5.3 代码实现 + +Controller + +~~~~java +@RestController +@RequestMapping("/link") +public class LinkController { + + @Autowired + private LinkService linkService; + + @GetMapping("/getAllLink") + public ResponseResult getAllLink(){ + return linkService.getAllLink(); + } +} + +~~~~ + + + +Service + +~~~~java +public interface LinkService extends IService { + + ResponseResult getAllLink(); +} + + +~~~~ + + + +ServiceImpl + +~~~~java +@Service("linkService") +public class LinkServiceImpl extends ServiceImpl implements LinkService { + + @Override + public ResponseResult getAllLink() { + //查询所有审核通过的 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + queryWrapper.eq(Link::getStatus, SystemConstants.LINK_STATUS_NORMAL); + List links = list(queryWrapper); + //转换成vo + List linkVos = BeanCopyUtils.copyBeanList(links, LinkVo.class); + //封装返回 + return ResponseResult.okResult(linkVos); + } +} + +~~~~ + + + +SystemConstants + +~~~~java + /** + * 友链状态为审核通过 + */ + public static final String LINK_STATUS_NORMAL = "0"; +~~~~ + + + + + +### 3.6 登录功能实现 + +​ 使用我们前台和后台的认证授权统一都使用SpringSecurity安全框架来实现。 + +#### 3.6.0 需求 + +​ 需要实现登录功能 + +​ 有些功能必须登录后才能使用，未登录状态是不能使用的。 + +#### 3.6.1 接口设计 + +| 请求方式 | 请求路径 | +| -------- | -------- | +| POST | /login | + +请求体： + +~~~~json +{ + "userName":"sg", + "password":"1234" +} +~~~~ + +响应格式： + +~~~~json +{ + "code": 200, + "data": { + "token": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiI0ODBmOThmYmJkNmI0NjM0OWUyZjY2NTM0NGNjZWY2NSIsInN1YiI6IjEiLCJpc3MiOiJzZyIsImlhdCI6MTY0Mzg3NDMxNiwiZXhwIjoxNjQzOTYwNzE2fQ.ldLBUvNIxQCGemkCoMgT_0YsjsWndTg5tqfJb77pabk", + "userInfo": { + "avatar": "https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fi0.hdslb.com%2Fbfs%2Farticle%2F3bf9c263bc0f2ac5c3a7feb9e218d07475573ec8.gi", + "email": "23412332@qq.com", + "id": 1, + "nickName": "sg333", + "sex": "1" + } + }, + "msg": "操作成功" +} +~~~~ + +#### 3.6.2 表分析 + +​ 建表SQL及初始化数据见：SGBlog\资源\SQL\sys_user.sql + +​ 顺便生成下User和UserMapper后面会用到 + +#### 3.6.3 思路分析 + +登录 + +​ ①自定义登录接口 + +​ 调用ProviderManager的方法进行认证 如果认证通过生成jwt + +​ 把用户信息存入redis中 + +​ ②自定义UserDetailsService + +​ 在这个实现类中去查询数据库 + +​ 注意配置passwordEncoder为BCryptPasswordEncoder + +校验： + +​ ①定义Jwt认证过滤器 + +​ 获取token + +​ 解析token获取其中的userid + +​ 从redis中获取用户信息 + +​ 存入SecurityContextHolder + +#### 3.6.4 准备工作 + +①添加依赖 + +注意放开Security依赖的注释 + +~~~~xml + + + org.springframework.boot + spring-boot-starter-data-redis + + + + com.alibaba + fastjson + 1.2.33 + + + + io.jsonwebtoken + jjwt + 0.9.0 + +~~~~ + +②工具类和相关配置类 + +​ 见 ：SGBlog\资源\登录功能所需资源 + +#### 3.6.5 登录接口代码实现 + +##### BlogLoginController + +~~~~java +@RestController +public class BlogLoginController { + @Autowired + private BlogLoginService blogLoginService; + + @PostMapping("/login") + public ResponseResult login(@RequestBody User user){ + return blogLoginService.login(user); + } +} + +~~~~ + + + +##### BlogLoginService + +~~~~java +public interface BlogLoginService { + ResponseResult login(User user); +} + +~~~~ + + + +##### SecurityConfig + +~~~~java +@Configuration +public class SecurityConfig extends WebSecurityConfigurerAdapter { + + @Bean + public PasswordEncoder passwordEncoder(){ + return new BCryptPasswordEncoder(); + } + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 + .antMatchers("/login").anonymous() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().permitAll(); + + + http.logout().disable(); + //允许跨域 + http.cors(); + } + @Override + @Bean + public AuthenticationManager authenticationManagerBean() throws Exception { + return super.authenticationManagerBean(); + } +} +~~~~ + + + +##### BlogLoginServiceImpl + +~~~~java + +@Service +public class BlogLoginServiceImpl implements BlogLoginService { + + @Autowired + private AuthenticationManager authenticationManager; + + @Autowired + private RedisCache redisCache; + + @Override + public ResponseResult login(User user) { + UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(user.getUserName(),user.getPassword()); + Authentication authenticate = authenticationManager.authenticate(authenticationToken); + //判断是否认证通过 + if(Objects.isNull(authenticate)){ + throw new RuntimeException("用户名或密码错误"); + } + //获取userid 生成token + LoginUser loginUser = (LoginUser) authenticate.getPrincipal(); + String userId = loginUser.getUser().getId().toString(); + String jwt = JwtUtil.createJWT(userId); + //把用户信息存入redis + redisCache.setCacheObject("bloglogin:"+userId,loginUser); + + //把token和userinfo封装 返回 + //把User转换成UserInfoVo + UserInfoVo userInfoVo = BeanCopyUtils.copyBean(loginUser.getUser(), UserInfoVo.class); + BlogUserLoginVo vo = new BlogUserLoginVo(jwt,userInfoVo); + return ResponseResult.okResult(vo); + } +} +~~~~ + + + +##### UserDetailServiceImpl + +~~~~java +@Service +public class UserDetailsServiceImpl implements UserDetailsService { + + @Autowired + private UserMapper userMapper; + + @Override + public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException { + //根据用户名查询用户信息 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + queryWrapper.eq(User::getUserName,username); + User user = userMapper.selectOne(queryWrapper); + //判断是否查到用户 如果没查到抛出异常 + if(Objects.isNull(user)){ + throw new RuntimeException("用户不存在"); + } + //返回用户信息 + // TODO 查询权限信息封装 + return new LoginUser(user); + } +} +~~~~ + + + + + +##### LoginUser + +~~~~java +@Data +@AllArgsConstructor +@NoArgsConstructor +public class LoginUser implements UserDetails { + + private User user; + + + @Override + public Collection getAuthorities() { + return null; + } + + @Override + public String getPassword() { + return user.getPassword(); + } + + @Override + public String getUsername() { + return user.getUserName(); + } + + @Override + public boolean isAccountNonExpired() { + return true; + } + + @Override + public boolean isAccountNonLocked() { + return true; + } + + @Override + public boolean isCredentialsNonExpired() { + return true; + } + + @Override + public boolean isEnabled() { + return true; + } +} + +~~~~ + + + + + +##### BlogUserLoginVo + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class BlogUserLoginVo { + + private String token; + private UserInfoVo userInfo; +} +~~~~ + + + +##### UserInfoVo + +~~~~java +@Data +@Accessors(chain = true) +public class UserInfoVo { + /** + * 主键 + */ + private Long id; + + /** + * 昵称 + */ + private String nickName; + + /** + * 头像 + */ + private String avatar; + + private String sex; + + private String email; + + +} + +~~~~ + + + + + +#### 3.6.6 登录校验过滤器代码实现 + +##### 思路 + +​ ①定义Jwt认证过滤器 + +​ 获取token + +​ 解析token获取其中的userid + +​ 从redis中获取用户信息 + +​ 存入SecurityContextHolder + +##### JwtAuthenticationTokenFilter + +~~~~java +@Component +public class JwtAuthenticationTokenFilter extends OncePerRequestFilter { + + @Autowired + private RedisCache redisCache; + + @Override + protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException { + //获取请求头中的token + String token = request.getHeader("token"); + if(!StringUtils.hasText(token)){ + //说明该接口不需要登录 直接放行 + filterChain.doFilter(request, response); + return; + } + //解析获取userid + Claims claims = null; + try { + claims = JwtUtil.parseJWT(token); + } catch (Exception e) { + e.printStackTrace(); + //token超时 token非法 + //响应告诉前端需要重新登录 + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.NEED_LOGIN); + WebUtils.renderString(response, JSON.toJSONString(result)); + return; + } + String userId = claims.getSubject(); + //从redis中获取用户信息 + LoginUser loginUser = redisCache.getCacheObject("bloglogin:" + userId); + //如果获取不到 + if(Objects.isNull(loginUser)){ + //说明登录过期 提示重新登录 + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.NEED_LOGIN); + WebUtils.renderString(response, JSON.toJSONString(result)); + return; + } + //存入SecurityContextHolder + UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(loginUser,null,null); + SecurityContextHolder.getContext().setAuthentication(authenticationToken); + + filterChain.doFilter(request, response); + } + + +} +~~~~ + +##### SecurityConfig + +~~~~java +@Configuration +public class SecurityConfig extends WebSecurityConfigurerAdapter { + + @Override + @Bean + public AuthenticationManager authenticationManagerBean() throws Exception { + return super.authenticationManagerBean(); + } + + @Autowired + private JwtAuthenticationTokenFilter jwtAuthenticationTokenFilter; + + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 + .antMatchers("/login").anonymous() + //jwt过滤器测试用，如果测试没有问题吧这里删除了 + .antMatchers("/link/getAllLink").authenticated() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().permitAll(); + + + http.logout().disable(); + //把jwtAuthenticationTokenFilter添加到SpringSecurity的过滤器链中 + http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); + //允许跨域 + http.cors(); + } + + @Bean + public PasswordEncoder passwordEncoder(){ + return new BCryptPasswordEncoder(); + } +} + +~~~~ + + + +### 3.7 认证授权失败处理 + +​ 目前我们的项目在认证出错或者权限不足的时候响应回来的Json是Security的异常处理结果。但是这个响应的格式肯定是不符合我们项目的接口规范的。所以需要自定义异常处理。 + + + +​ AuthenticationEntryPoint 认证失败处理器 + +​ AccessDeniedHandler 授权失败处理器 + + + +~~~~java +@Component +public class AuthenticationEntryPointImpl implements AuthenticationEntryPoint { + + @Override + public void commence(HttpServletRequest request, HttpServletResponse response, AuthenticationException authException) throws IOException, ServletException { + authException.printStackTrace(); + //InsufficientAuthenticationException + //BadCredentialsException + ResponseResult result = null; + if(authException instanceof BadCredentialsException){ + result = ResponseResult.errorResult(AppHttpCodeEnum.LOGIN_ERROR.getCode(),authException.getMessage()); + }else if(authException instanceof InsufficientAuthenticationException){ + result = ResponseResult.errorResult(AppHttpCodeEnum.NEED_LOGIN); + }else{ + result = ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR.getCode(),"认证或授权失败"); + } + //响应给前端 + WebUtils.renderString(response, JSON.toJSONString(result)); + } +} + +~~~~ + + + +~~~~java +@Component +public class AccessDeniedHandlerImpl implements AccessDeniedHandler { + @Override + public void handle(HttpServletRequest request, HttpServletResponse response, AccessDeniedException accessDeniedException) throws IOException, ServletException { + accessDeniedException.printStackTrace(); + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.NO_OPERATOR_AUTH); + //响应给前端 + WebUtils.renderString(response, JSON.toJSONString(result)); + } +} + +~~~~ + + + +配置Security异常处理器 + +~~~~java +@Configuration +public class SecurityConfig extends WebSecurityConfigurerAdapter { + + @Override + @Bean + public AuthenticationManager authenticationManagerBean() throws Exception { + return super.authenticationManagerBean(); + } + + @Autowired + private JwtAuthenticationTokenFilter jwtAuthenticationTokenFilter; + @Autowired + AuthenticationEntryPoint authenticationEntryPoint; + @Autowired + AccessDeniedHandler accessDeniedHandler; + + + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 + .antMatchers("/login").anonymous() + //jwt过滤器测试用，如果测试没有问题吧这里删除了 + .antMatchers("/link/getAllLink").authenticated() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().permitAll(); + + //配置异常处理器 + http.exceptionHandling() + .authenticationEntryPoint(authenticationEntryPoint) + .accessDeniedHandler(accessDeniedHandler); + + http.logout().disable(); + //把jwtAuthenticationTokenFilter添加到SpringSecurity的过滤器链中 + http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); + //允许跨域 + http.cors(); + } + + @Bean + public PasswordEncoder passwordEncoder(){ + return new BCryptPasswordEncoder(); + } +} + +~~~~ + +### 3.8 统一异常处理 + +​ 实际我们在开发过程中可能需要做很多的判断校验，如果出现了非法情况我们是期望响应对应的提示的。但是如果我们每次都自己手动去处理就会非常麻烦。我们可以选择直接抛出异常的方式，然后对异常进行统一处理。把异常中的信息封装成ResponseResult响应给前端。 + +​ + +SystemException + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +public class SystemException extends RuntimeException{ + + private int code; + + private String msg; + + public int getCode() { + return code; + } + + public String getMsg() { + return msg; + } + + public SystemException(AppHttpCodeEnum httpCodeEnum) { + super(httpCodeEnum.getMsg()); + this.code = httpCodeEnum.getCode(); + this.msg = httpCodeEnum.getMsg(); + } + +} + +~~~~ + +GlobalExceptionHandler + +~~~~java +@RestControllerAdvice +@Slf4j +public class GlobalExceptionHandler { + + @ExceptionHandler(SystemException.class) + public ResponseResult systemExceptionHandler(SystemException e){ + //打印异常信息 + log.error("出现了异常！ {}",e); + //从异常对象中获取提示信息封装返回 + return ResponseResult.errorResult(e.getCode(),e.getMsg()); + } + + + @ExceptionHandler(Exception.class) + public ResponseResult exceptionHandler(Exception e){ + //打印异常信息 + log.error("出现了异常！ {}",e); + //从异常对象中获取提示信息封装返回 + return ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR.getCode(),e.getMessage()); + } +} + +~~~~ + + + +### 3.9 退出登录接口 + +#### 3.9.1 接口设计 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------- | --------------- | +| POST | /logout | 需要token请求头 | + +响应格式: + +~~~~json +{ + "code": 200, + "msg": "操作成功" +} +~~~~ + + + +#### 3.9.2 代码实现 + +要实现的操作： + +​ 删除redis中的用户信息 + +BlogLoginController + +~~~~java + @PostMapping("/logout") + public ResponseResult logout(){ + return blogLoginService.logout(); + } +~~~~ + +BlogLoginService + +~~~~java +ResponseResult logout(); +~~~~ + +BlogLoginServiceImpl + +~~~~java + @Override + public ResponseResult logout() { + //获取token 解析获取userid + Authentication authentication = SecurityContextHolder.getContext().getAuthentication(); + LoginUser loginUser = (LoginUser) authentication.getPrincipal(); + //获取userid + Long userId = loginUser.getUser().getId(); + //删除redis中的用户信息 + redisCache.deleteObject("bloglogin:"+userId); + return ResponseResult.okResult(); + } +~~~~ + +SecurityConfig + +要关闭默认的退出登录功能。并且要配置我们的退出登录接口需要认证才能访问 + +~~~~java + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 + .antMatchers("/login").anonymous() + //注销接口需要认证才能访问 + .antMatchers("/logout").authenticated() + //jwt过滤器测试用，如果测试没有问题吧这里删除了 + .antMatchers("/link/getAllLink").authenticated() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().permitAll(); + + //配置异常处理器 + http.exceptionHandling() + .authenticationEntryPoint(authenticationEntryPoint) + .accessDeniedHandler(accessDeniedHandler); + //关闭默认的注销功能 + http.logout().disable(); + //把jwtAuthenticationTokenFilter添加到SpringSecurity的过滤器链中 + http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); + //允许跨域 + http.cors(); + } +~~~~ + + + +### 3.10 查询评论列表接口 + +#### 3.10.1 需求 + +​ 文章详情页面要展示这篇文章下的评论列表。 + +​ 效果如下: + +![image-20220208214106296](img/image-20220208214106296.png) + + + + + +#### 3.10.2 评论表分析 + +​ 通过需求去分析需要有哪些字段。 + +​ 建表SQL及初始化数据见：SGBlog\资源\SQL\sg_comment.sql + +​ **顺便生成下对应的代码** + +#### 3.10.3 接口设计 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------------------- | ----------------- | +| GET | /comment/commentList | 不需要token请求头 | + +Query格式请求参数： + +articleId:文章id + +pageNum: 页码 + +pageSize: 每页条数 + + + +响应格式: + +~~~~json +{ + "code": 200, + "data": { + "rows": [ + { + "articleId": "1", + "children": [ + { + "articleId": "1", + "content": "你说啥？", + "createBy": "1", + "createTime": "2022-01-30 10:06:21", + "id": "20", + "rootId": "1", + "toCommentId": "1", + "toCommentUserId": "1", + "toCommentUserName": "sg333", + "username": "sg333" + } + ], + "content": "asS", + "createBy": "1", + "createTime": "2022-01-29 07:59:22", + "id": "1", + "rootId": "-1", + "toCommentId": "-1", + "toCommentUserId": "-1", + "username": "sg333" + } + ], + "total": "15" + }, + "msg": "操作成功" +} +~~~~ + + + +#### 3.10.4 代码实现 + +##### 3.10.4.1 不考虑子评论 + +CommentController + +~~~~java +@RestController +@RequestMapping("/comment") +public class CommentController { + + @Autowired + private CommentService commentService; + + @GetMapping("/commentList") + public ResponseResult commentList(Long articleId,Integer pageNum,Integer pageSize){ + return commentService.commentList(articleId,pageNum,pageSize); + } +} + +~~~~ + + + +CommentService + +~~~~java +public interface CommentService extends IService { + + ResponseResult commentList(Long articleId, Integer pageNum, Integer pageSize); +} + +~~~~ + + + +CommentServiceImpl + +~~~~java +@Service("commentService") +public class CommentServiceImpl extends ServiceImpl implements CommentService { + + @Autowired + private UserService userService; + + @Override + public ResponseResult commentList(Long articleId, Integer pageNum, Integer pageSize) { + //查询对应文章的根评论 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + //对articleId进行判断 + queryWrapper.eq(Comment::getArticleId,articleId); + //根评论 rootId为-1 + queryWrapper.eq(Comment::getRootId,-1); + + //分页查询 + Page page = new Page(pageNum,pageSize); + page(page,queryWrapper); + + List commentVoList = toCommentVoList(page.getRecords()); + + return ResponseResult.okResult(new PageVo(commentVoList,page.getTotal())); + } + + private List toCommentVoList(List list){ + List commentVos = BeanCopyUtils.copyBeanList(list, CommentVo.class); + //遍历vo集合 + for (CommentVo commentVo : commentVos) { + //通过creatyBy查询用户的昵称并赋值 + String nickName = userService.getById(commentVo.getCreateBy()).getNickName(); + commentVo.setUsername(nickName); + //通过toCommentUserId查询用户的昵称并赋值 + //如果toCommentUserId不为-1才进行查询 + if(commentVo.getToCommentUserId()!=-1){ + String toCommentUserName = userService.getById(commentVo.getToCommentUserId()).getNickName(); + commentVo.setToCommentUserName(toCommentUserName); + } + } + return commentVos; + } +} + + +~~~~ + + + +CommentVo + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class CommentVo { + private Long id; + //文章id + private Long articleId; + //根评论id + private Long rootId; + //评论内容 + private String content; + //所回复的目标评论的userid + private Long toCommentUserId; + private String toCommentUserName; + //回复目标评论id + private Long toCommentId; + + private Long createBy; + + private Date createTime; + + private String username; +} + +~~~~ + + + +##### 3.10.4.2 查询子评论 + +CommentVo在之前的基础上增加了 private List children; + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class CommentVo { + private Long id; + //文章id + private Long articleId; + //根评论id + private Long rootId; + //评论内容 + private String content; + //所回复的目标评论的userid + private Long toCommentUserId; + private String toCommentUserName; + //回复目标评论id + private Long toCommentId; + + private Long createBy; + + private Date createTime; + + private String username; + + private List children; +} + +~~~~ + + + +CommentServiceImpl + +~~~~java +@Service("commentService") +public class CommentServiceImpl extends ServiceImpl implements CommentService { + + @Autowired + private UserService userService; + + @Override + public ResponseResult commentList(Long articleId, Integer pageNum, Integer pageSize) { + //查询对应文章的根评论 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + //对articleId进行判断 + queryWrapper.eq(Comment::getArticleId,articleId); + //根评论 rootId为-1 + queryWrapper.eq(Comment::getRootId,-1); + + //分页查询 + Page page = new Page(pageNum,pageSize); + page(page,queryWrapper); + + List commentVoList = toCommentVoList(page.getRecords()); + + //查询所有根评论对应的子评论集合，并且赋值给对应的属性 + for (CommentVo commentVo : commentVoList) { + //查询对应的子评论 + List children = getChildren(commentVo.getId()); + //赋值 + commentVo.setChildren(children); + } + + return ResponseResult.okResult(new PageVo(commentVoList,page.getTotal())); + } + + /** + * 根据根评论的id查询所对应的子评论的集合 + * @param id 根评论的id + * @return + */ + private List getChildren(Long id) { + + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + queryWrapper.eq(Comment::getRootId,id); + queryWrapper.orderByAsc(Comment::getCreateTime); + List comments = list(queryWrapper); + + List commentVos = toCommentVoList(comments); + return commentVos; + } + + private List toCommentVoList(List list){ + List commentVos = BeanCopyUtils.copyBeanList(list, CommentVo.class); + //遍历vo集合 + for (CommentVo commentVo : commentVos) { + //通过creatyBy查询用户的昵称并赋值 + String nickName = userService.getById(commentVo.getCreateBy()).getNickName(); + commentVo.setUsername(nickName); + //通过toCommentUserId查询用户的昵称并赋值 + //如果toCommentUserId不为-1才进行查询 + if(commentVo.getToCommentUserId()!=-1){ + String toCommentUserName = userService.getById(commentVo.getToCommentUserId()).getNickName(); + commentVo.setToCommentUserName(toCommentUserName); + } + } + return commentVos; + } +} +~~~~ + + + + + +### 3.11 发表评论接口 + +#### 3.11.1 需求 + +​ 用户登录后可以对文章发表评论，也可以对评论进行回复。 + +​ 用户登录后也可以在友链页面进行评论。 + +#### 3.11.2 接口设计 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------- | ----------- | +| POST | /comment | 需要token头 | + +##### 请求体： + +回复了文章： + +~~~~json +{"articleId":1,"type":0,"rootId":-1,"toCommentId":-1,"toCommentUserId":-1,"content":"评论了文章"} +~~~~ +回复了某条评论： +~~~~json +{"articleId":1,"type":0,"rootId":"3","toCommentId":"3","toCommentUserId":"1","content":"回复了某条评论"} +~~~~ + + + +如果是友链评论，type应该为1 + + + +##### 响应格式： + +~~~~java +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +#### 3.11.3 代码实现 + +CommentController + +~~~~java + @PostMapping + public ResponseResult addComment(@RequestBody Comment comment){ + return commentService.addComment(comment); + } +~~~~ + +CommentService + +~~~~java +ResponseResult addComment(Comment comment); +~~~~ + +CommentServiceImpl + +~~~~java + @Override + public ResponseResult addComment(Comment comment) { + //评论内容不能为空 + if(!StringUtils.hasText(comment.getContent())){ + throw new SystemException(AppHttpCodeEnum.CONTENT_NOT_NULL); + } + save(comment); + return ResponseResult.okResult(); + } +~~~~ + + + +SecurityUtils + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +public class SecurityUtils +{ + + /** + * 获取用户 + **/ + public static LoginUser getLoginUser() + { + return (LoginUser) getAuthentication().getPrincipal(); + } + + /** + * 获取Authentication + */ + public static Authentication getAuthentication() { + return SecurityContextHolder.getContext().getAuthentication(); + } + + public static Boolean isAdmin(){ + Long id = getLoginUser().getUser().getId(); + return id != null && 1L == id; + } + + public static Long getUserId() { + return getLoginUser().getUser().getId(); + } +} +~~~~ + +配置MP字段自动填充 + +~~~~java +@Component +public class MyMetaObjectHandler implements MetaObjectHandler { + @Override + public void insertFill(MetaObject metaObject) { + Long userId = null; + try { + userId = SecurityUtils.getUserId(); + } catch (Exception e) { + e.printStackTrace(); + userId = -1L;//表示是自己创建 + } + this.setFieldValByName("createTime", new Date(), metaObject); + this.setFieldValByName("createBy",userId , metaObject); + this.setFieldValByName("updateTime", new Date(), metaObject); + this.setFieldValByName("updateBy", userId, metaObject); + } + + @Override + public void updateFill(MetaObject metaObject) { + this.setFieldValByName("updateTime", new Date(), metaObject); + this.setFieldValByName(" ", SecurityUtils.getUserId(), metaObject); + } +} +~~~~ + +用注解标识哪些字段在什么情况下需要自动填充 + +~~~~java + /** + * 创建人的用户id + */ + @TableField(fill = FieldFill.INSERT) + private Long createBy; + /** + * 创建时间 + */ + @TableField(fill = FieldFill.INSERT) + private Date createTime; + /** + * 更新人 + */ + @TableField(fill = FieldFill.INSERT_UPDATE) + private Long updateBy; + /** + * 更新时间 + */ + @TableField(fill = FieldFill.INSERT_UPDATE) + private Date updateTime; +~~~~ + + + + + +### 3.12 友联评论列表 + +#### 3.12.1 需求 + +​ 友链页面也需要查询对应的评论列表。 + + + +#### 3.12.2 接口设计 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ------------------------ | ----------------- | +| GET | /comment/linkCommentList | 不需要token请求头 | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +响应格式: + +~~~~json +{ + "code": 200, + "data": { + "rows": [ + { + "articleId": "1", + "children": [ + { + "articleId": "1", + "content": "回复友链评论3", + "createBy": "1", + "createTime": "2022-01-30 10:08:50", + "id": "23", + "rootId": "22", + "toCommentId": "22", + "toCommentUserId": "1", + "toCommentUserName": "sg333", + "username": "sg333" + } + ], + "content": "友链评论2", + "createBy": "1", + "createTime": "2022-01-30 10:08:28", + "id": "22", + "rootId": "-1", + "toCommentId": "-1", + "toCommentUserId": "-1", + "username": "sg333" + } + ], + "total": "1" + }, + "msg": "操作成功" +} +~~~~ + + + + + +#### 3.12.3 代码实现 + +CommentController 修改了之前的文章评论列表接口，并且增加了新的友联评论接口 + +~~~~java + @GetMapping("/commentList") + public ResponseResult commentList(Long articleId,Integer pageNum,Integer pageSize){ + return commentService.commentList(SystemConstants.ARTICLE_COMMENT,articleId,pageNum,pageSize); + } + @GetMapping("/linkCommentList") + public ResponseResult linkCommentList(Integer pageNum,Integer pageSize){ + return commentService.commentList(SystemConstants.LINK_COMMENT,null,pageNum,pageSize); + } +~~~~ + + + +SystemConstants增加了两个常量 + +~~~~java + /** + * 评论类型为：文章评论 + */ + public static final String ARTICLE_COMMENT = "0"; + /** + * 评论类型为：友联评论 + */ + public static final String LINK_COMMENT = "1"; +~~~~ + + + + + +CommentService修改了commentList方法，增加了一个参数commentType + +~~~~java +ResponseResult commentList(String commentType, Long articleId, Integer pageNum, Integer pageSize); +~~~~ + + + +CommentServiceImpl修改commentList方法的代码，必须commentType为0的时候才增加articleId的判断，并且增加了一个评论类型的添加。 + +~~~~java + @Override + public ResponseResult commentList(String commentType, Long articleId, Integer pageNum, Integer pageSize) { + //查询对应文章的根评论 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + //对articleId进行判断 + queryWrapper.eq(SystemConstants.ARTICLE_COMMENT.equals(commentType),Comment::getArticleId,articleId); + //根评论 rootId为-1 + queryWrapper.eq(Comment::getRootId,-1); + + //评论类型 + queryWrapper.eq(Comment::getType,commentType); + + //分页查询 + Page page = new Page(pageNum,pageSize); + page(page,queryWrapper); + + List commentVoList = toCommentVoList(page.getRecords()); + + //查询所有根评论对应的子评论集合，并且赋值给对应的属性 + for (CommentVo commentVo : commentVoList) { + //查询对应的子评论 + List children = getChildren(commentVo.getId()); + //赋值 + commentVo.setChildren(children); + } + + return ResponseResult.okResult(new PageVo(commentVoList,page.getTotal())); + } +~~~~ + + + + + +### 3.13 个人信息查询接口 + +#### 3.13.1 需求 + +​ 进入个人中心的时候需要能够查看当前用户信息 + +#### 3.13.2 接口设计 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------------- | --------------- | +| GET | /user/userInfo | 需要token请求头 | + +不需要参数 + +响应格式: + +~~~~json +{ + "code":200, + "data":{ + "avatar":"https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fi0.hdslb.com%2Fbfs%2Farticle%2F3bf9c263bc0f2ac5c3a7feb9e218d07475573ec8.gi", + "email":"23412332@qq.com", + "id":"1", + "nickName":"sg333", + "sex":"1" + }, + "msg":"操作成功" +} +~~~~ + + + +#### 3.13.3 代码实现 + + + +UserController + +~~~~java +@RestController +@RequestMapping("/user") +public class UserController { + + @Autowired + private UserService userService; + + @GetMapping("/userInfo") + public ResponseResult userInfo(){ + return userService.userInfo(); + } +} + +~~~~ + + + +UserService增加方法定义 + +~~~~java +public interface UserService extends IService { + + ResponseResult userInfo(); + +} + +~~~~ + + + +UserServiceImpl实现userInfo方法 + +~~~~java + @Override + public ResponseResult userInfo() { + //获取当前用户id + Long userId = SecurityUtils.getUserId(); + //根据用户id查询用户信息 + User user = getById(userId); + //封装成UserInfoVo + UserInfoVo vo = BeanCopyUtils.copyBean(user,UserInfoVo.class); + return ResponseResult.okResult(vo); + } +~~~~ + + + +SecurityConfig配置该接口必须认证后才能访问 + +~~~~java + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 + .antMatchers("/login").anonymous() + //注销接口需要认证才能访问 + .antMatchers("/logout").authenticated() + //个人信息接口必须登录后才能访问 + .antMatchers("/user/userInfo").authenticated() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().permitAll(); + + //配置异常处理器 + http.exceptionHandling() + .authenticationEntryPoint(authenticationEntryPoint) + .accessDeniedHandler(accessDeniedHandler); + //关闭默认的注销功能 + http.logout().disable(); + //把jwtAuthenticationTokenFilter添加到SpringSecurity的过滤器链中 + http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); + //允许跨域 + http.cors(); + } +~~~~ + + + +### 3.14 头像上传接口 + +#### 3.14.1 需求 + +​ 在个人中心点击编辑的时候可以上传头像图片。上传完头像后，可以用于更新个人信息接口。 + + + +#### 3.14.2 OSS + +##### 3.14.2.1 为什么要使用OSS + +​ 因为如果把图片视频等文件上传到自己的应用的Web服务器，在读取图片的时候会占用比较多的资源。影响应用服务器的性能。 + +​ 所以我们一般使用OSS(Object Storage Service对象存储服务)存储图片或视频。 + + + +##### 3.14.2.2 七牛云基本使用测试 + +![image-20220227224537701](img/image-20220227224537701.png) + +![image-20220227224443813](img/image-20220227224443813.png) + + + +秘钥 + +![image-20220228230512598](img/image-20220228230512598.png) + +![image-20220228230933808](img/image-20220228230933808.png) + + + +##### 3.14.2.3 七牛云测试代码编写 + +①添加依赖 + +~~~~xml + + com.qiniu + qiniu-java-sdk + [7.7.0, 7.7.99] + +~~~~ + + + +②复制修改案例代码 + +application.yml + +~~~~yml +oss: + accessKey: xxxx + secretKey: xxxx + bucket: sg-blog +~~~~ + +OSSTest.java + +~~~~java +@SpringBootTest +@ConfigurationProperties(prefix = "oss") +public class OSSTest { + + private String accessKey; + private String secretKey; + private String bucket; + + public void setAccessKey(String accessKey) { + this.accessKey = accessKey; + } + + public void setSecretKey(String secretKey) { + this.secretKey = secretKey; + } + + public void setBucket(String bucket) { + this.bucket = bucket; + } + + @Test + public void testOss(){ + //构造一个带指定 Region 对象的配置类 + Configuration cfg = new Configuration(Region.autoRegion()); + //...其他参数参考类注释 + + UploadManager uploadManager = new UploadManager(cfg); + //...生成上传凭证，然后准备上传 +// String accessKey = "your access key"; +// String secretKey = "your secret key"; +// String bucket = "sg-blog"; + + //默认不指定key的情况下，以文件内容的hash值作为文件名 + String key = "2022/sg.png"; + + try { +// byte[] uploadBytes = "hello qiniu cloud".getBytes("utf-8"); +// ByteArrayInputStream byteInputStream=new ByteArrayInputStream(uploadBytes); + + + InputStream inputStream = new FileInputStream("C:\\Users\\root\\Desktop\\Snipaste_2022-02-28_22-48-37.png"); + Auth auth = Auth.create(accessKey, secretKey); + String upToken = auth.uploadToken(bucket); + + try { + Response response = uploadManager.put(inputStream,key,upToken,null, null); + //解析上传成功的结果 + DefaultPutRet putRet = new Gson().fromJson(response.bodyString(), DefaultPutRet.class); + System.out.println(putRet.key); + System.out.println(putRet.hash); + } catch (QiniuException ex) { + Response r = ex.response; + System.err.println(r.toString()); + try { + System.err.println(r.bodyString()); + } catch (QiniuException ex2) { + //ignore + } + } + } catch (Exception ex) { + //ignore + } + + } +} +~~~~ + + + +#### 3.14.2 接口设计 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------- | --------- | +| POST | /upload | 需要token | + +参数： + +​ img,值为要上传的文件 + +请求头： + +​ Content-Type ：multipart/form-data; + + + +响应格式: + +~~~~json +{ + "code": 200, + "data": "文件访问链接", + "msg": "操作成功" +} +~~~~ + +#### 3.14.3 代码实现 + +~~~~java +@RestController +public class UploadController { + @Autowired + private UploadService uploadService; + + @PostMapping("/upload") + public ResponseResult uploadImg(MultipartFile img){ + return uploadService.uploadImg(img); + } +} + +~~~~ + +~~~~java +public interface UploadService { + ResponseResult uploadImg(MultipartFile img); +} + +~~~~ + + + +~~~~java +@Service +@Data +@ConfigurationProperties(prefix = "oss") +public class OssUploadService implements UploadService { + @Override + public ResponseResult uploadImg(MultipartFile img) { + //判断文件类型 + //获取原始文件名 + String originalFilename = img.getOriginalFilename(); + //对原始文件名进行判断 + if(!originalFilename.endsWith(".png")){ + throw new SystemException(AppHttpCodeEnum.FILE_TYPE_ERROR); + } + + //如果判断通过上传文件到OSS + String filePath = PathUtils.generateFilePath(originalFilename); + String url = uploadOss(img,filePath);// 2099/2/3/wqeqeqe.png + return ResponseResult.okResult(url); + } + + private String accessKey; + private String secretKey; + private String bucket; + + + private String uploadOss(MultipartFile imgFile, String filePath){ + //构造一个带指定 Region 对象的配置类 + Configuration cfg = new Configuration(Region.autoRegion()); + //...其他参数参考类注释 + UploadManager uploadManager = new UploadManager(cfg); + //默认不指定key的情况下，以文件内容的hash值作为文件名 + String key = filePath; + try { + InputStream inputStream = imgFile.getInputStream(); + Auth auth = Auth.create(accessKey, secretKey); + String upToken = auth.uploadToken(bucket); + try { + Response response = uploadManager.put(inputStream,key,upToken,null, null); + //解析上传成功的结果 + DefaultPutRet putRet = new Gson().fromJson(response.bodyString(), DefaultPutRet.class); + System.out.println(putRet.key); + System.out.println(putRet.hash); + return "http://r7yxkqloa.bkt.clouddn.com/"+key; + } catch (QiniuException ex) { + Response r = ex.response; + System.err.println(r.toString()); + try { + System.err.println(r.bodyString()); + } catch (QiniuException ex2) { + //ignore + } + } + } catch (Exception ex) { + //ignore + } + return "www"; + } +} + +~~~~ + + + +PathUtils + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +public class PathUtils { + + public static String generateFilePath(String fileName){ + //根据日期生成路径 2022/1/15/ + SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd/"); + String datePath = sdf.format(new Date()); + //uuid作为文件名 + String uuid = UUID.randomUUID().toString().replaceAll("-", ""); + //后缀和文件后缀一致 + int index = fileName.lastIndexOf("."); + // test.jpg -> .jpg + String fileType = fileName.substring(index); + return new StringBuilder().append(datePath).append(uuid).append(fileType).toString(); + } +} + +~~~~ + + + +### 3.15 更新个人信息接口 + +#### 3.15.1 需求 + +​ 在编辑完个人资料后点击保存会对个人资料进行更新。 + +#### 3.15.2 接口设计 + +​ + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------------- | --------------- | +| PUT | /user/userInfo | 需要token请求头 | + +参数 + +请求体中json格式数据： + +~~~~json +{ + "avatar":"https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/01/31/948597e164614902ab1662ba8452e106.png", + "email":"23412332@qq.com", + "id":"1", + "nickName":"sg333", + "sex":"1" +} +~~~~ + + + + + +响应格式: + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +#### 3.15.3 代码实现 + +UserController + +~~~~java + @PutMapping("/userInfo") + public ResponseResult updateUserInfo(@RequestBody User user){ + return userService.updateUserInfo(user); + } +~~~~ + +UserService + +~~~~java +ResponseResult updateUserInfo(User user); +~~~~ + + + +UserServiceImpl + +~~~~java + @Override + public ResponseResult updateUserInfo(User user) { + updateById(user); + return ResponseResult.okResult(); + } +~~~~ + +### 3.16 用户注册 + +#### 3.16.1 需求 + +​ 要求用户能够在注册界面完成用户的注册。要求用户名，昵称，邮箱不能和数据库中原有的数据重复。如果某项重复了注册失败并且要有对应的提示。并且要求用户名，密码，昵称，邮箱都不能为空。 + +​ 注意:密码必须密文存储到数据库中。 + +#### 3.16.2 接口设计 + +​ + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------------- | ----------------- | +| POST | /user/register | 不需要token请求头 | + +参数 + +请求体中json格式数据： + +~~~~json +{ + "email": "string", + "nickName": "string", + "password": "string", + "userName": "string" +} +~~~~ + +响应格式: + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +#### 3.16.3 代码实现 + +UserController + +~~~~java + @PostMapping("/register") + public ResponseResult register(@RequestBody User user){ + return userService.register(user); + } +~~~~ + +UserService + +~~~~java +ResponseResult register(User user); +~~~~ + +UserServiceImpl + +~~~~java + @Autowired + private PasswordEncoder passwordEncoder; + @Override + public ResponseResult register(User user) { + //对数据进行非空判断 + if(!StringUtils.hasText(user.getUserName())){ + throw new SystemException(AppHttpCodeEnum.USERNAME_NOT_NULL); + } + if(!StringUtils.hasText(user.getPassword())){ + throw new SystemException(AppHttpCodeEnum.PASSWORD_NOT_NULL); + } + if(!StringUtils.hasText(user.getEmail())){ + throw new SystemException(AppHttpCodeEnum.EMAIL_NOT_NULL); + } + if(!StringUtils.hasText(user.getNickName())){ + throw new SystemException(AppHttpCodeEnum.NICKNAME_NOT_NULL); + } + //对数据进行是否存在的判断 + if(userNameExist(user.getUserName())){ + throw new SystemException(AppHttpCodeEnum.USERNAME_EXIST); + } + if(nickNameExist(user.getNickName())){ + throw new SystemException(AppHttpCodeEnum.NICKNAME_EXIST); + } + //... + //对密码进行加密 + String encodePassword = passwordEncoder.encode(user.getPassword()); + user.setPassword(encodePassword); + //存入数据库 + save(user); + return ResponseResult.okResult(); + } + +~~~~ + +~~~~java +public enum AppHttpCodeEnum { + // 成功 + SUCCESS(200,"操作成功"), + // 登录 + NEED_LOGIN(401,"需要登录后操作"), + NO_OPERATOR_AUTH(403,"无权限操作"), + SYSTEM_ERROR(500,"出现错误"), + USERNAME_EXIST(501,"用户名已存在"), + PHONENUMBER_EXIST(502,"手机号已存在"), EMAIL_EXIST(503, "邮箱已存在"), + REQUIRE_USERNAME(504, "必需填写用户名"), + CONTENT_NOT_NULL(506, "评论内容不能为空"), + FILE_TYPE_ERROR(507, "文件类型错误，请上传png文件"), + USERNAME_NOT_NULL(508, "用户名不能为空"), + NICKNAME_NOT_NULL(509, "昵称不能为空"), + PASSWORD_NOT_NULL(510, "密码不能为空"), + EMAIL_NOT_NULL(511, "邮箱不能为空"), + NICKNAME_EXIST(512, "昵称已存在"), + LOGIN_ERROR(505,"用户名或密码错误"); + int code; + String msg; + + AppHttpCodeEnum(int code, String errorMessage){ + this.code = code; + this.msg = errorMessage; + } + + public int getCode() { + return code; + } + + public String getMsg() { + return msg; + } +} + +~~~~ + + + + + + + +### 3.17 AOP实现日志记录 + +#### 3.17.1 需求 + +​ 需要通过日志记录接口调用信息。便于后期调试排查。并且可能有很多接口都需要进行日志的记录。 + +​ 接口被调用时日志打印格式如下： + +![image-20220313133714102](img/image-20220313133714102.png) + + + +#### 3.17.2 思路分析 + +​ 相当于是对原有的功能进行增强。并且是批量的增强，这个时候就非常适合用AOP来进行实现。 + +​ + +#### 3.17.3 代码实现 + +日志打印格式 + +~~~~java + log.info("=======Start======="); + // 打印请求 URL + log.info("URL : {}",); + // 打印描述信息 + log.info("BusinessName : {}", ); + // 打印 Http method + log.info("HTTP Method : {}", ); + // 打印调用 controller 的全路径以及执行方法 + log.info("Class Method : {}.{}", ); + // 打印请求的 IP + log.info("IP : {}",); + // 打印请求入参 + log.info("Request Args : {}",); + // 打印出参 + log.info("Response : {}", ); + // 结束后换行 + log.info("=======End=======" + System.lineSeparator()); +~~~~ + + + + + + + +### 3.18 更新浏览次数 + +#### 3.18.1 需求 + +​ 在用户浏览博文时要实现对应博客浏览量的增加。 + +#### 3.18.2 思路分析 + +​ 我们只需要在每次用户浏览博客时更新对应的浏览数即可。 + +​ 但是如果直接操作博客表的浏览量的话，在并发量大的情况下会出现什么问题呢？ + +​ 如何去优化呢？ + +​ + +①在应用启动时把博客的浏览量存储到redis中 + +②更新浏览量时去更新redis中的数据 + +③每隔10分钟把Redis中的浏览量更新到数据库中 + +④读取文章浏览量时从redis读取 + + + +#### 3.18.3 铺垫知识 + +##### 3.18.3.1 CommandLineRunner实现项目启动时预处理 + +​ 如果希望在SpringBoot应用启动时进行一些初始化操作可以选择使用CommandLineRunner来进行处理。 + +​ 我们只需要实现CommandLineRunner接口，并且把对应的bean注入容器。把相关初始化的代码重新到需要重新的方法中。 + +​ 这样就会在应用启动的时候执行对应的代码。 + +~~~~java +@Component +public class TestRunner implements CommandLineRunner { + @Override + public void run(String... args) throws Exception { + System.out.println("程序初始化"); + } +} + +~~~~ + + + +##### 3.18.3.2 定时任务 + +​ 定时任务的实现方式有很多，比如XXL-Job等。但是其实核心功能和概念都是类似的，很多情况下只是调用的API不同而已。 + +​ 这里就先用SpringBoot为我们提供的定时任务的API来实现一个简单的定时任务，让大家先对定时任务里面的一些核心概念有个大致的了解。 + +实现步骤 + +① 使用@EnableScheduling注解开启定时任务功能 + +​ 我们可以在配置类上加上@EnableScheduling + +~~~~java +@SpringBootApplication +@MapperScan("com.sangeng.mapper") +@EnableScheduling +public class SanGengBlogApplication { + public static void main(String[] args) { + SpringApplication.run(SanGengBlogApplication.class,args); + } +} +~~~~ + +② 确定定时任务执行代码，并配置任务执行时间 + +​ 使用@Scheduled注解标识需要定时执行的代码。注解的cron属性相当于是任务的执行时间。目前可以使用 0/5 * * * * ? 进行测试，代表从0秒开始，每隔5秒执行一次。 + +​ 注意：对应的bean要注入容器，否则不会生效。 + +~~~~java +@Component +public class TestJob { + + @Scheduled(cron = "0/5 * * * * ?") + public void testJob(){ + //要执行的代码 + System.out.println("定时任务执行了"); + } +} + +~~~~ + + + +###### 3.18.3.2.1 cron 表达式语法 + +​ cron表达式是用来设置定时任务执行时间的表达式。 + +​ 很多情况下我们可以用 ： [在线Cron表达式生成器](https://www.bejson.com/othertools/cron/) 来帮助我们理解cron表达式和书写cron表达式。 + +​ 但是我们还是有需要学习对应的Cron语法的，这样可以更有利于我们书写Cron表达式。 + + + +如上我们用到的 0/5 * * * * ? *，cron表达式由七部分组成，中间由空格分隔，这七部分从左往右依次是： + +秒（0~59），分钟（0~59），小时（0~23），日期（1-月最后一天），月份（1-12），星期几（1-7,1表示星期日），年份（一般该项不设置，直接忽略掉，即可为空值） + + + +通用特殊字符：, - * / (可以在任意部分使用) + +> * + +星号表示任意值，例如： + +``` +* * * * * ? +``` + +表示 “ 每年每月每天每时每分每秒 ” 。 + + + +> , + +可以用来定义列表，例如 ： + +``` +1,2,3 * * * * ? +``` + +表示 “ 每年每月每天每时每分的每个第1秒，第2秒，第3秒 ” 。 + + + +> - + +定义范围，例如： + +``` +1-3 * * * * ? +``` + +表示 “ 每年每月每天每时每分的第1秒至第3秒 ”。 + + + +> / + +每隔多少，例如 + +``` +5/10 * * * * ? +``` + +表示 “ 每年每月每天每时每分，从第5秒开始，每10秒一次 ” 。即 “ / ” 的左侧是开始值，右侧是间隔。如果是从 “ 0 ” 开始的话，也可以简写成 “ /10 ” + + + + + + + + + +日期部分还可允许特殊字符： ? L W + +星期部分还可允许的特殊字符: ? L # + + + +> ? + +只可用在日期和星期部分。表示没有具体的值，使用?要注意冲突。日期和星期两个部分如果其中一个部分设置了值，则另一个必须设置为 “ ? ”。 + +例如： + +~~~~ +0\* * * 2 * ? + 和 +0\* * * ? * 2 +~~~~ + +同时使用?和同时不使用?都是不对的 + +例如下面写法就是错的 + +~~~~ +* * * 2 * 2 + 和 +* * * ? * ? + +~~~~ + + + + + +> W + +只能用在日期中，表示当月中最接近某天的工作日 + +``` +0 0 0 31W * ? +``` + +表示最接近31号的工作日，如果31号是星期六，则表示30号，即星期五，如果31号是星期天，则表示29号，即星期五。如果31号是星期三，则表示31号本身，即星期三。 + + + + + + + + + +> L + +表示最后（Last）,只能用在日期和星期中 + + + +在日期中表示每月最后一天，在一月份中表示31号，在六月份中表示30号 + +也可以表示每月倒是第N天。例如： L-2表示每个月的倒数第2天 + + + + 0 0 0 LW * ? + LW可以连起来用，表示每月最后一个工作日，即每月最后一个星期五 + + + +在星期中表示7即星期六 + + +~~~~ +0 0 0 ? * L +表示每个星期六 +0 0 0 ? * 6L +若前面有其他值的话，则表示最后一个星期几，即每月的最后一个星期五 +~~~~ + + + + + + +> # + +只能用在星期中，表示第几个星期几 + +~~~~ +0 0 0 ? * 6#3 +表示每个月的第三个星期五。 +~~~~ + + + + + + + +#### 3.18.4 接口设计 + +​ + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ----------------------------- | ----------------- | +| PUT | /article/updateViewCount/{id} | 不需要token请求头 | + +参数 + +​ 请求路径中携带文章id + +响应格式: + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +#### 3.18.5 代码实现 + +##### ①在应用启动时把博客的浏览量存储到redis中 + +​ 实现CommandLineRunner接口，在应用启动时初始化缓存。 + +~~~~java +@Component +public class ViewCountRunner implements CommandLineRunner { + + @Autowired + private ArticleMapper articleMapper; + + @Autowired + private RedisCache redisCache; + + @Override + public void run(String... args) throws Exception { + //查询博客信息 id viewCount + List
articles = articleMapper.selectList(null); + Map viewCountMap = articles.stream() + .collect(Collectors.toMap(article -> article.getId().toString(), article -> { + return article.getViewCount().intValue();// + })); + //存储到redis中 + redisCache.setCacheMap("article:viewCount",viewCountMap); + } +} + +~~~~ + + + +##### ②更新浏览量时去更新redsi中的数据 + +RedisCache增加方法 + +~~~~java + public void incrementCacheMapValue(String key,String hKey,long v){ + redisTemplate.boundHashOps(key).increment(hKey, v); + } +~~~~ + +ArticleController中增加方法更新阅读数 + +~~~~java + @PutMapping("/updateViewCount/{id}") + public ResponseResult updateViewCount(@PathVariable("id") Long id){ + return articleService.updateViewCount(id); + } +~~~~ + +ArticleService中增加方法 + +~~~~java +ResponseResult updateViewCount(Long id); +~~~~ + +ArticleServiceImpl中实现方法 + +~~~~java + @Override + public ResponseResult updateViewCount(Long id) { + //更新redis中对应 id的浏览量 + redisCache.incrementCacheMapValue("article:viewCount",id.toString(),1); + return ResponseResult.okResult(); + } +~~~~ + + + + + + + +##### ③定时任务每隔10分钟把Redis中的浏览量更新到数据库中 + +Article中增加构造方法 + +~~~~java + public Article(Long id, long viewCount) { + this.id = id; + this.viewCount = viewCount; + } +~~~~ + + + + + +~~~~java +@Component +public class UpdateViewCountJob { + + @Autowired + private RedisCache redisCache; + + @Autowired + private ArticleService articleService; + + @Scheduled(cron = "0/5 * * * * ?") + public void updateViewCount(){ + //获取redis中的浏览量 + Map viewCountMap = redisCache.getCacheMap("article:viewCount"); + + List
articles = viewCountMap.entrySet() + .stream() + .map(entry -> new Article(Long.valueOf(entry.getKey()), entry.getValue().longValue())) + .collect(Collectors.toList()); + //更新到数据库中 + articleService.updateBatchById(articles); + + } +} + +~~~~ + + + +##### ④读取文章浏览量时从redis读取 + +~~~~java + @Override + public ResponseResult getArticleDetail(Long id) { + //根据id查询文章 + Article article = getById(id); + //从redis中获取viewCount + Integer viewCount = redisCache.getCacheMapValue("article:viewCount", id.toString()); + article.setViewCount(viewCount.longValue()); + //转换成VO + ArticleDetailVo articleDetailVo = BeanCopyUtils.copyBean(article, ArticleDetailVo.class); + //根据分类id查询分类名 + Long categoryId = articleDetailVo.getCategoryId(); + Category category = categoryService.getById(categoryId); + if(category!=null){ + articleDetailVo.setCategoryName(category.getName()); + } + //封装响应返回 + return ResponseResult.okResult(articleDetailVo); + } + +~~~~ + + + + + +## 4. Swagger2 + +### 4.1 简介 + +​ Swagger 是一套基于 OpenAPI 规范构建的开源工具，可以帮助我们设计、构建、记录以及使用 Rest API。 + +### 4.2 为什么使用Swagger + +​ 当下很多公司都采取前后端分离的开发模式，前端和后端的工作由不同的工程师完成。在这种开发模式下，维持一份及时更新且完整的 Rest API 文档将会极大的提高我们的工作效率。传统意义上的文档都是后端开发人员手动编写的，相信大家也都知道这种方式很难保证文档的及时性，这种文档久而久之也就会失去其参考意义，反而还会加大我们的沟通成本。而 Swagger 给我们提供了一个全新的维护 API 文档的方式，下面我们就来了解一下它的优点： + +1.代码变，文档变。只需要少量的注解，Swagger 就可以根据代码自动生成 API 文档，很好的保证了文档的时效性。 +2.跨语言性，支持 40 多种语言。 +3.Swagger UI 呈现出来的是一份可交互式的 API 文档，我们可以直接在文档页面尝试 API 的调用，省去了准备复杂的调用参数的过程。 + + + +### 4.3 快速入门 + +#### 4.3.1 引入依赖 + +~~~~xml + + io.springfox + springfox-swagger2 + + + io.springfox + springfox-swagger-ui + + +~~~~ + + + +#### 4.3.2 启用Swagger2 + +​ 在启动类上或者配置类加 @EnableSwagger2 注解 + +~~~~java +@SpringBootApplication +@MapperScan("com.sangeng.mapper") +@EnableScheduling +@EnableSwagger2 +public class SanGengBlogApplication { + public static void main(String[] args) { + SpringApplication.run(SanGengBlogApplication.class,args); + } +} +~~~~ + + + +#### 4.3.3 测试 + +​ 访问：http://localhost:7777/swagger-ui.html 注意其中localhost和7777要调整成实际项目的域名和端口号。 + + + +### 4.4 具体配置 + + + +#### 4.4.1 Controller配置 + +##### 4.4.1 @Api 注解 + +属性介绍： + +tags 设置标签 + +description 设置描述信息 + +~~~~java +@RestController +@RequestMapping("/comment") +@Api(tags = "评论",description = "评论相关接口") +public class CommentController { +} +~~~~ + + + + + +#### 4.4.2 接口配置 + +##### 4.4.2.1 接口描述配置@ApiOperation + +~~~~java + @GetMapping("/linkCommentList") + @ApiOperation(value = "友链评论列表",notes = "获取一页友链评论") + public ResponseResult linkCommentList(Integer pageNum,Integer pageSize){ + return commentService.commentList(SystemConstants.LINK_COMMENT,null,pageNum,pageSize); + } +~~~~ + + + +##### 4.4.2.2 接口参数描述 + + @ApiImplicitParam 用于描述接口的参数，但是一个接口可能有多个参数，所以一般与 @ApiImplicitParams 组合使用。 + +~~~~java + @GetMapping("/linkCommentList") + @ApiOperation(value = "友链评论列表",notes = "获取一页友链评论") + @ApiImplicitParams({ + @ApiImplicitParam(name = "pageNum",value = "页号"), + @ApiImplicitParam(name = "pageSize",value = "每页大小") + } + ) + public ResponseResult linkCommentList(Integer pageNum,Integer pageSize){ + return commentService.commentList(SystemConstants.LINK_COMMENT,null,pageNum,pageSize); + } +~~~~ + + + +#### 4.4.3 实体类配置 + +##### 4.4.3.1 实体的描述配置@ApiModel + +@ApiModel用于描述实体类。 + +~~~~java +@Data +@AllArgsConstructor +@NoArgsConstructor +@ApiModel(description = "添加评论dto") +public class AddCommentDto{ + //.. +} +~~~~ + + + +##### 4.4.3.2 实体的属性的描述配置@ApiModelProperty + +@ApiModelProperty用于描述实体的属性 + +~~~~java + @ApiModelProperty(notes = "评论类型（0代表文章评论，1代表友链评论）") + private String type; +~~~~ + + + + + + + +#### 4.4.4 文档信息配置 + +~~~~java +@Configuration +public class SwaggerConfig { + @Bean + public Docket customDocket() { + return new Docket(DocumentationType.SWAGGER_2) + .apiInfo(apiInfo()) + .select() + .apis(RequestHandlerSelectors.basePackage("com.sangeng.controller")) + .build(); + } + + private ApiInfo apiInfo() { + Contact contact = new Contact("团队名", "http://www.my.com", "my@my.com"); + return new ApiInfoBuilder() + .title("文档标题") + .description("文档描述") + .contact(contact) // 联系方式 + .version("1.1.0") // 版本 + .build(); + } +} +~~~~ + + + +## 5. 博客后台 + +### 5.0 准备工作 + +前端工程启动 + +npm install + +npm run dev + + + +①创建启动类 + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +@SpringBootApplication +@MapperScan("com.sangeng.mapper") +public class BlogAdminApplication { + public static void main(String[] args) { + SpringApplication.run(BlogAdminApplication.class, args); + } +} + +~~~~ + +②创建application.yml配置文件 + +~~~~yml +server: + port: 8989 +spring: + datasource: + url: jdbc:mysql://localhost:3306/sg_blog?characterEncoding=utf-8&serverTimezone=UTC + username: root + password: root + driver-class-name: com.mysql.cj.jdbc.Driver + servlet: + multipart: + max-file-size: 2MB + max-request-size: 5MB + +mybatis-plus: + configuration: + # 日志 + log-impl: org.apache.ibatis.logging.stdout.StdOutImpl + global-config: + db-config: + logic-delete-field: delFlag + logic-delete-value: 1 + logic-not-delete-value: 0 + id-type: auto + + +~~~~ + +③ SQL语句 + +​ SQL脚本：SGBlog\资源\SQL\sg_tag.sql + +④ 创建实体类，Mapper，Service + +​ 注意思考这些文件应该写在哪个模块下？ + + + +Tag + +~~~~java + +@SuppressWarnings("serial") +@Data +@AllArgsConstructor +@NoArgsConstructor +@TableName("sg_tag") +public class Tag { + @TableId + private Long id; + + + private Long createBy; + + private Date createTime; + + private Long updateBy; + + private Date updateTime; + //删除标志（0代表未删除，1代表已删除） + private Integer delFlag; + //备注 + private String remark; + //标签名 + private String name; + + + +} + +~~~~ + + +TagMapper +~~~~java +/** + * 标签(Tag)表数据库访问层 + * + * @author makejava + * @since 2022-07-19 22:33:35 + */ +public interface TagMapper extends BaseMapper { + +} + + + +~~~~ + + +TagService +~~~~java +/** + * 标签(Tag)表服务接口 + * + * @author makejava + * @since 2022-07-19 22:33:38 + */ +public interface TagService extends IService { + +} + +~~~~ + + +TagServiceImpl +~~~~java +/** + * 标签(Tag)表服务实现类 + * + * @author makejava + * @since 2022-07-19 22:33:38 + */ +@Service("tagService") +public class TagServiceImpl extends ServiceImpl implements TagService { + +} + + +~~~~ + + + +⑤ 创建Controller测试接口 + +​ 注意思考这些文件应该写在哪个模块下？ + +TagController /content/tag +~~~~java +@RestController +@RequestMapping("/content/tag") +public class TagController { + @Autowired + private TagService tagService; + + @GetMapping("/list") + public ResponseResult list(){ + return ResponseResult.okResult(tagService.list()); + } +} + + +~~~~ + + + +⑥添加security相关类 + +~~~~java +@Configuration +public class SecurityConfig extends WebSecurityConfigurerAdapter { + + @Override + @Bean + public AuthenticationManager authenticationManagerBean() throws Exception { + return super.authenticationManagerBean(); + } + + @Autowired + private JwtAuthenticationTokenFilter jwtAuthenticationTokenFilter; + @Autowired + AuthenticationEntryPoint authenticationEntryPoint; + @Autowired + AccessDeniedHandler accessDeniedHandler; + + + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 +// .antMatchers("/login").anonymous() +// //注销接口需要认证才能访问 +// .antMatchers("/logout").authenticated() +// .antMatchers("/user/userInfo").authenticated() +// .antMatchers("/upload").authenticated() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().permitAll(); + + //配置异常处理器 + http.exceptionHandling() + .authenticationEntryPoint(authenticationEntryPoint) + .accessDeniedHandler(accessDeniedHandler); + //关闭默认的注销功能 + http.logout().disable(); + //把jwtAuthenticationTokenFilter添加到SpringSecurity的过滤器链中 + http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); + //允许跨域 + http.cors(); + } + + @Bean + public PasswordEncoder passwordEncoder(){ + return new BCryptPasswordEncoder(); + } +} + +~~~~ + + + +~~~~java +@Component +public class JwtAuthenticationTokenFilter extends OncePerRequestFilter { + + @Autowired + private RedisCache redisCache; + + @Override + protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException { + //获取请求头中的token + String token = request.getHeader("token"); + if(!StringUtils.hasText(token)){ + //说明该接口不需要登录 直接放行 + filterChain.doFilter(request, response); + return; + } + //解析获取userid + Claims claims = null; + try { + claims = JwtUtil.parseJWT(token); + } catch (Exception e) { + e.printStackTrace(); + //token超时 token非法 + //响应告诉前端需要重新登录 + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.NEED_LOGIN); + WebUtils.renderString(response, JSON.toJSONString(result)); + return; + } + String userId = claims.getSubject(); + //从redis中获取用户信息 + LoginUser loginUser = redisCache.getCacheObject("login:" + userId); + //如果获取不到 + if(Objects.isNull(loginUser)){ + //说明登录过期 提示重新登录 + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.NEED_LOGIN); + WebUtils.renderString(response, JSON.toJSONString(result)); + return; + } + //存入SecurityContextHolder + UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(loginUser,null,null); + SecurityContextHolder.getContext().setAuthentication(authenticationToken); + + filterChain.doFilter(request, response); + } + + +} + +~~~~ + + + +### 5.1 后台登录 + +​ 后台的认证授权也使用SpringSecurity安全框架来实现。 + +#### 5.1.0 需求 + +​ 需要实现登录功能 + +​ 后台所有功能都必须登录才能使用。 + +#### 5.1.1 接口设计 + +| 请求方式 | 请求路径 | +| -------- | ----------- | +| POST | /user/login | + +请求体： + +~~~~json +{ + "userName":"sg", + "password":"1234" +} +~~~~ + +响应格式： + +~~~~json +{ + "code": 200, + "data": { + "token": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiI0ODBmOThmYmJkNmI0NjM0OWUyZjY2NTM0NGNjZWY2NSIsInN1YiI6IjEiLCJpc3MiOiJzZyIsImlhdCI6MTY0Mzg3NDMxNiwiZXhwIjoxNjQzOTYwNzE2fQ.ldLBUvNIxQCGemkCoMgT_0YsjsWndTg5tqfJb77pabk" + }, + "msg": "操作成功" +} +~~~~ + +#### 5.1.2 思路分析 + +登录 + +​ ①自定义登录接口 + +​ 调用ProviderManager的方法进行认证 如果认证通过生成jwt + +​ 把用户信息存入redis中 + +​ ②自定义UserDetailsService + +​ 在这个实现类中去查询数据库 + +​ 注意配置passwordEncoder为BCryptPasswordEncoder + +校验： + +​ ①定义Jwt认证过滤器 + +​ 获取token + +​ 解析token获取其中的userid + +​ 从redis中获取用户信息 + +​ 存入SecurityContextHolder + +#### 5.1.3 准备工作 + +①添加依赖 + +前面已经添加过相关依赖，不需要做什么处理 + +~~~~xml + + + org.springframework.boot + spring-boot-starter-data-redis + + + + com.alibaba + fastjson + 1.2.33 + + + + io.jsonwebtoken + jjwt + 0.9.0 + +~~~~ + + + + + +#### 5.1.4 登录接口代码实现 + +##### LoginController + +复制一份BlogLoginController ，命名为LoginController，其中注入 LoginService + +请求地址修改为/user/login即可 + + + +~~~~java +@RestController +public class LoginController { + @Autowired + private LoginService loginService; + + @PostMapping("/user/login") + public ResponseResult login(@RequestBody User user){ + if(!StringUtils.hasText(user.getUserName())){ + //提示 必须要传用户名 + throw new SystemException(AppHttpCodeEnum.REQUIRE_USERNAME); + } + return loginService.login(user); + } + +} +~~~~ + + + +##### LoginService + +复制一份BlogLoginService命名为LoginService即可 + +~~~~java +public interface LoginService { + ResponseResult login(User user); + +} + +~~~~ + + + +##### SecurityConfig + +之前已经复制过了 + + + + + +##### SystemLoginServiceImpl + +复制一份，LoginServiceImpl，命名为SystemLoginServiceImpl 实现 LoginService + +login方法中存redis的key的前缀修改为login + +返回的数据中只要返回token + + + +~~~~java +@Service +public class SystemLoginServiceImpl implements LoginService { + + @Autowired + private AuthenticationManager authenticationManager; + + @Autowired + private RedisCache redisCache; + + @Override + public ResponseResult login(User user) { + UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(user.getUserName(),user.getPassword()); + Authentication authenticate = authenticationManager.authenticate(authenticationToken); + //判断是否认证通过 + if(Objects.isNull(authenticate)){ + throw new RuntimeException("用户名或密码错误"); + } + //获取userid 生成token + LoginUser loginUser = (LoginUser) authenticate.getPrincipal(); + String userId = loginUser.getUser().getId().toString(); + String jwt = JwtUtil.createJWT(userId); + //把用户信息存入redis + redisCache.setCacheObject("login:"+userId,loginUser); + + //把token封装 返回 + Map map = new HashMap<>(); + map.put("token",jwt); + return ResponseResult.okResult(map); + } +} +~~~~ + + + +##### UserDetailServiceImpl + +复用原来的即可 + +##### LoginUser + +复用原来的即可 + + + + + +### 5.2 后台权限控制及动态路由 + +#### 需求 + +​ 后台系统需要能实现不同的用户权限可以看到不同的功能。 + +​ 用户只能使用他的权限所允许使用的功能。 + + + +#### 功能设计 + +​ 之前在我的SpringSecurity的课程中就介绍过RBAC权限模型。没有学习过的可以去看下 [RBAC权限模型](https://www.bilibili.com/video/BV1mm4y1X7Hc?p=28) 。这里我们就是在RBAC权限模型的基础上去实现这个功能。 + +​ + +#### 表分析 + +​ 通过需求去分析需要有哪些字段。 + +​ 建表SQL及初始化数据见：SGBlog\资源\SQL\sg_menu.sql + + + +#### 接口设计 + +##### getInfo接口 + +是 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------- | --------------- | +| GET | /getInfo | 需要token请求头 | + +请求参数： + +无 + +响应格式: + +如果用户id为1代表管理员，roles 中只需要有admin，permissions中需要有所有菜单类型为C或者F的，状态为正常的，未被删除的权限 + +~~~~json +{ + "code":200, + "data":{ + "permissions":[ + "system:user:list", + "system:role:list", + "system:menu:list", + "system:user:query", + "system:user:add" + //此次省略1000字 + ], + "roles":[ + "admin" + ], + "user":{ + "avatar":"http://r7yxkqloa.bkt.clouddn.com/2022/03/05/75fd15587811443a9a9a771f24da458d.png", + "email":"23412332@qq.com", + "id":1, + "nickName":"sg3334", + "sex":"1" + } + }, + "msg":"操作成功" +} +~~~~ + + + +##### getRouters接口 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ----------- | --------------- | +| GET | /getRouters | 需要token请求头 | + +请求参数： + +无 + +响应格式: + +​ 前端为了实现动态路由的效果，需要后端有接口能返回用户所能访问的菜单数据。 + +​ 注意：**返回的菜单数据需要体现父子菜单的层级关系** + +​ 如果用户id为1代表管理员，menus中需要有所有菜单类型为C或者M的，状态为正常的，未被删除的权限 + +​ 数据格式如下： + +~~~~json +{ + "code":200, + "data":{ + "menus":[ + { + "children":[], + "component":"content/article/write/index", + "createTime":"2022-01-08 11:39:58", + "icon":"build", + "id":2023, + "menuName":"写博文", + "menuType":"C", + "orderNum":"0", + "parentId":0, + "path":"write", + "perms":"content:article:writer", + "status":"0", + "visible":"0" + }, + { + "children":[ + { + "children":[], + "component":"system/user/index", + "createTime":"2021-11-12 18:46:19", + "icon":"user", + "id":100, + "menuName":"用户管理", + "menuType":"C", + "orderNum":"1", + "parentId":1, + "path":"user", + "perms":"system:user:list", + "status":"0", + "visible":"0" + }, + { + "children":[], + "component":"system/role/index", + "createTime":"2021-11-12 18:46:19", + "icon":"peoples", + "id":101, + "menuName":"角色管理", + "menuType":"C", + "orderNum":"2", + "parentId":1, + "path":"role", + "perms":"system:role:list", + "status":"0", + "visible":"0" + }, + { + "children":[], + "component":"system/menu/index", + "createTime":"2021-11-12 18:46:19", + "icon":"tree-table", + "id":102, + "menuName":"菜单管理", + "menuType":"C", + "orderNum":"3", + "parentId":1, + "path":"menu", + "perms":"system:menu:list", + "status":"0", + "visible":"0" + } + ], + "createTime":"2021-11-12 18:46:19", + "icon":"system", + "id":1, + "menuName":"系统管理", + "menuType":"M", + "orderNum":"1", + "parentId":0, + "path":"system", + "perms":"", + "status":"0", + "visible":"0" + } + ] + }, + "msg":"操作成功" +} +~~~~ + + + +#### 代码实现 + +##### 准备工作 + +​ 生成menu和role表对于的类 + +##### getInfo接口 + + + +```java +@Data +@Accessors(chain = true) +@AllArgsConstructor +@NoArgsConstructor +public class AdminUserInfoVo { + + private List permissions; + + private List roles; + + private UserInfoVo user; +} +``` + + + +~~~~java +@RestController +public class LoginController { + @Autowired + private LoginService loginService; + + @Autowired + private MenuService menuService; + + @Autowired + private RoleService roleService; + + @PostMapping("/user/login") + public ResponseResult login(@RequestBody User user){ + if(!StringUtils.hasText(user.getUserName())){ + //提示 必须要传用户名 + throw new SystemException(AppHttpCodeEnum.REQUIRE_USERNAME); + } + return loginService.login(user); + } + + @GetMapping("getInfo") + public ResponseResult getInfo(){ + //获取当前登录的用户 + LoginUser loginUser = SecurityUtils.getLoginUser(); + //根据用户id查询权限信息 + List perms = menuService.selectPermsByUserId(loginUser.getUser().getId()); + //根据用户id查询角色信息 + List roleKeyList = roleService.selectRoleKeyByUserId(loginUser.getUser().getId()); + + //获取用户信息 + User user = loginUser.getUser(); + UserInfoVo userInfoVo = BeanCopyUtils.copyBean(user, UserInfoVo.class); + //封装数据返回 + + AdminUserInfoVo adminUserInfoVo = new AdminUserInfoVo(perms,roleKeyList,userInfoVo); + return ResponseResult.okResult(adminUserInfoVo); + } + +} +~~~~ + + + + + +RoleServiceImpl selectRoleKeyByUserId方法 + +~~~~java +@Service("menuService") +public class MenuServiceImpl extends ServiceImpl implements MenuService { + + @Override + public List selectPermsByUserId(Long id) { + //如果是管理员，返回所有的权限 + if(id == 1L){ + LambdaQueryWrapper wrapper = new LambdaQueryWrapper<>(); + wrapper.in(Menu::getMenuType,SystemConstants.MENU,SystemConstants.BUTTON); + wrapper.eq(Menu::getStatus,SystemConstants.STATUS_NORMAL); + List menus = list(wrapper); + List perms = menus.stream() + .map(Menu::getPerms) + .collect(Collectors.toList()); + return perms; + } + //否则返回所具有的权限 + return getBaseMapper().selectPermsByUserId(id); + } +} +~~~~ + +MenuMapper + +~~~~java +/** + * 菜单权限表(Menu)表数据库访问层 + * + * @author makejava + * @since 2022-08-09 22:32:07 + */ +public interface MenuMapper extends BaseMapper { + + List selectPermsByUserId(Long userId); +} + +~~~~ + +~~~~xml + + + + + + +~~~~ + + + + + +MenuServiceImpl selectPermsByUserId方法 + +~~~~java +@Service("roleService") +public class RoleServiceImpl extends ServiceImpl implements RoleService { + + @Override + public List selectRoleKeyByUserId(Long id) { + //判断是否是管理员 如果是返回集合中只需要有admin + if(id == 1L){ + List roleKeys = new ArrayList<>(); + roleKeys.add("admin"); + return roleKeys; + } + //否则查询用户所具有的角色信息 + return getBaseMapper().selectRoleKeyByUserId(id); + } +} +~~~~ + +~~~~java +public interface RoleMapper extends BaseMapper { + + List selectRoleKeyByUserId(Long userId); +} + +~~~~ + +~~~~xml + + + + + +~~~~ + + + + + +##### getRouters接口 + +RoutersVo + +~~~~java +@Data +@AllArgsConstructor +@NoArgsConstructor +public class RoutersVo { + + private List menus; +} + +~~~~ + + + +LoginController + +~~~~java + @GetMapping("getRouters") + public ResponseResult getRouters(){ + Long userId = SecurityUtils.getUserId(); + //查询menu 结果是tree的形式 + List menus = menuService.selectRouterMenuTreeByUserId(userId); + //封装数据返回 + return ResponseResult.okResult(new RoutersVo(menus)); + } + +~~~~ + +MenuService + +~~~~java +public interface MenuService extends IService { + + List selectPermsByUserId(Long id); + + List selectRouterMenuTreeByUserId(Long userId); +} + +~~~~ + +MenuServiceImpl + +~~~~java +@Override + public List selectRouterMenuTreeByUserId(Long userId) { + MenuMapper menuMapper = getBaseMapper(); + List menus = null; + //判断是否是管理员 + if(SecurityUtils.isAdmin()){ + //如果是 获取所有符合要求的Menu + menus = menuMapper.selectAllRouterMenu(); + }else{ + //否则 获取当前用户所具有的Menu + menus = menuMapper.selectRouterMenuTreeByUserId(userId); + } + + //构建tree + //先找出第一层的菜单 然后去找他们的子菜单设置到children属性中 + List menuTree = builderMenuTree(menus,0L); + return menuTree; + } + + private List builderMenuTree(List menus, Long parentId) { + List menuTree = menus.stream() + .filter(menu -> menu.getParentId().equals(parentId)) + .map(menu -> menu.setChildren(getChildren(menu, menus))) + .collect(Collectors.toList()); + return menuTree; + } + + /** + * 获取存入参数的 子Menu集合 + * @param menu + * @param menus + * @return + */ + private List getChildren(Menu menu, List menus) { + List childrenList = menus.stream() + .filter(m -> m.getParentId().equals(menu.getId())) + .map(m->m.setChildren(getChildren(m,menus))) + .collect(Collectors.toList()); + return childrenList; + } +~~~~ + +MenuMapper.java + +~~~~java + List selectAllRouterMenu(); + + List selectRouterMenuTreeByUserId(Long userId); +~~~~ + + + +MenuMapper.xml + +~~~~xml + + +~~~~ + + + +查询的列： + +SELECT DISTINCT m.id, m.parent_id, m.menu_name, m.path, m.component, m.visible, m.status, IFNULL(m.perms,'') AS perms, m.is_frame, m.menu_type, m.icon, m.order_num, m.create_time + +注意需要按照parent_id和order_num排序 + + + + + +### 5.3 退出登录接口 + +#### 5.3.1 接口设计 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ------------ | --------------- | +| POST | /user/logout | 需要token请求头 | + +响应格式: + +~~~~json +{ + "code": 200, + "msg": "操作成功" +} +~~~~ + + + +#### 5.3.2 代码实现 + +要实现的操作： + +​ 删除redis中的用户信息 + +LoginController + +~~~~java + @PostMapping("/user/logout") + public ResponseResult logout(){ + return loginServcie.logout(); + } +~~~~ + +LoginService + +~~~~java +ResponseResult logout(); +~~~~ + +SystemLoginServiceImpl + +~~~~java + @Override + public ResponseResult logout() { + //获取当前登录的用户id + Long userId = SecurityUtils.getUserId(); + //删除redis中对应的值 + redisCache.deleteObject("login:"+userId); + return ResponseResult.okResult(); + } +~~~~ + +SecurityConfig + +要关闭默认的退出登录功能。并且要配置我们的退出登录接口需要认证才能访问 + +~~~~java + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 + .antMatchers("/user/login").anonymous() +// //注销接口需要认证才能访问 +// .antMatchers("/logout").authenticated() +// .antMatchers("/user/userInfo").authenticated() +// .antMatchers("/upload").authenticated() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().authenticated(); + + //配置异常处理器 + http.exceptionHandling() + .authenticationEntryPoint(authenticationEntryPoint) + .accessDeniedHandler(accessDeniedHandler); + //关闭默认的注销功能 + http.logout().disable(); + //把jwtAuthenticationTokenFilter添加到SpringSecurity的过滤器链中 + http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); + //允许跨域 + http.cors(); + } +~~~~ + + + + + + + + + + + +### 5.4 查询标签列表 + +#### 5.4.0 需求 + +​ 为了方便后期对文章进行管理，需要提供标签的功能，一个文章可以有多个标签。 + +​ 在后台需要分页查询标签功能，要求能根据标签名进行分页查询。 **后期可能会增加备注查询等需求**。 + +​ 注意：不能把删除了的标签查询出来。 + +#### 5.4.1 标签表分析 + +​ 通过需求去分析需要有哪些字段。 + +#### 5.4.2 接口设计 + + + +| 请求方式 | 请求路径 | +| -------- | ---------------- | +| Get | content/tag/list | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +name：标签名 + +remark：备注 + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "rows":[ + { + "id":4, + "name":"Java", + "remark":"sdad" + } + ], + "total":1 + }, + "msg":"操作成功" +} +~~~~ + + + +#### 5.4.3 代码实现 + +Controller + +~~~~java +@RestController +@RequestMapping("/content/tag") +public class TagController { + @Autowired + private TagService tagService; + + @GetMapping("/list") + public ResponseResult list(Integer pageNum, Integer pageSize, TagListDto tagListDto){ + return tagService.pageTagList(pageNum,pageSize,tagListDto); + } +} + + +~~~~ + + + +Service + +```java +public interface TagService extends IService { + + ResponseResult pageTagList(Integer pageNum, Integer pageSize, TagListDto tagListDto); +} + +``` + +~~~~java +@Service("tagService") +public class TagServiceImpl extends ServiceImpl implements TagService { + + @Override + public ResponseResult pageTagList(Integer pageNum, Integer pageSize, TagListDto tagListDto) { + //分页查询 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + queryWrapper.eq(StringUtils.hasText(tagListDto.getName()),Tag::getName,tagListDto.getName()); + queryWrapper.eq(StringUtils.hasText(tagListDto.getRemark()),Tag::getRemark,tagListDto.getRemark()); + + Page page = new Page<>(); + page.setCurrent(pageNum); + page.setSize(pageSize); + page(page, queryWrapper); + //封装数据返回 + PageVo pageVo = new PageVo(page.getRecords(),page.getTotal()); + return ResponseResult.okResult(pageVo); + } +} +~~~~ + + + +### 5.5 新增标签 + +#### 5.5.0 需求 + +​ 点击标签管理的新增按钮可以实现新增标签的功能。 + +#### 5.5.1 接口设计 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ------------ | --------------- | +| POST | /content/tag | 需要token请求头 | + +请求体格式: + +~~~~json +{"name":"c#","remark":"c++++"} +~~~~ + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +#### 5.5.2 测试 + +测试时注意，添加到数据库中的记录有没有 创建时间，更新时间，创建人，更新人字段。 + + + + + +### 5.6 删除标签 + +#### 5.6.1 接口设计 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ----------------- | --------------- | +| DELETE | /content/tag/{id} | 需要token请求头 | + +请求参数在path中 + +例如：content/tag/6 代表删除id为6的标签数据 + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +#### 5.6.2 测试 + +注意测试删除后在列表中是否查看不到该条数据 + +数据库中该条数据还是存在的，只是修改了逻辑删除字段的值 + + + + + +### 5.7 修改标签 + +#### 5.7.1 接口设计 + +##### 5.7.1.1 获取标签信息 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ----------------- | --------------- | +| GET | /content/tag/{id} | 需要token请求头 | + +请求参数在path中 + +例如：content/tag/6 代表获取id为6的标签数据 + + + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "id":4, + "name":"Java", + "remark":"sdad" + }, + "msg":"操作成功" +} +~~~~ + + + +##### 5.7.1.2 修改标签接口 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ------------ | --------------- | +| PUT | /content/tag | 需要token请求头 | + +请求体格式： + +~~~~json +{"id":7,"name":"c#","remark":"c++++"} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.8 写博文 + +#### 5.8.1 需求 + +​ 需要提供写博文的功能，写博文时需要关联分类和标签。 + +​ 可以上传缩略图，也可以在正文中添加图片。 + +​ 文章可以直接发布，也可以保存到草稿箱。 + + + +#### 5.8.2 表分析 + +​ 标签和文章需要关联所以需要一张关联表。 + +​ SQL脚本：SGBlog\资源\SQL\sg_article_tag.sql + + + +#### 5.8.2 接口设计 + +​ 思考下需要哪些接口才能实现这个功能？ + + + +##### 5.8.2.1 查询所有分类接口 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | --------------------------------- | --------------- | +| GET | /content/category/listAllCategory | 需要token请求头 | + +请求参数： + +​ 无 + + + + + +响应格式： + +~~~~json +{ + "code":200, + "data":[ + { + "description":"wsd", + "id":1, + "name":"java" + }, + { + "description":"wsd", + "id":2, + "name":"PHP" + } + ], + "msg":"操作成功" +} +~~~~ + + + +##### 5.8.2.2 查询所有标签接口 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ----------------------- | --------------- | +| GET | /content/tag/listAllTag | 需要token请求头 | + +请求参数: + +​ 无 + +响应格式： + +~~~~json +{ + "code":200, + "data":[ + { + "id":1, + "name":"Mybatis" + }, + { + "id":4, + "name":"Java" + } + ], + "msg":"操作成功" +} +~~~~ + + + + + +##### 5.8.2.3 上传图片 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------- | --------------- | +| POST | /upload | 需要token请求头 | + +参数： + +​ img,值为要上传的文件 + +请求头： + +​ Content-Type ：multipart/form-data; + + + +响应格式: + +~~~~json +{ + "code": 200, + "data": "文件访问链接", + "msg": "操作成功" +} +~~~~ + + + +##### 5.8.2.4 新增博文 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ---------------- | --------------- | +| POST | /content/article | 需要token请求头 | + +请求体格式： + +~~~~json +{ + "title":"测试新增博文", + "thumbnail":"https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/08/21/4ceebc07e7484beba732f12b0d2c43a9.png", + "isTop":"0", + "isComment":"0", + "content":"# 一级标题\n## 二级标题\n![Snipaste_20220228_224837.png](https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/08/21/c3af554d4a0f4935b4073533a4c26ee8.png)\n正文", + "tags":[ + 1, + 4 + ], + "categoryId":1, + "summary":"哈哈", + "status":"1" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +#### 5.8.3 代码实现 + + + +##### 5.8.3.1 查询所有分类接口 + +CategoryController + + + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +@RestController +@RequestMapping("/content/category") +public class CategoryController { + @Autowired + private CategoryService categoryService; + + @GetMapping("/listAllCategory") + public ResponseResult listAllCategory(){ + List list = categoryService.listAllCategory(); + return ResponseResult.okResult(list); + } + + +} + +~~~~ + + + +CategoryVo修改,增加description属性 + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class CategoryVo { + + private Long id; + private String name; + //描述 + private String description; +} +~~~~ + +CategoryService增加listAllCategory方法 + +~~~~java +public interface CategoryService extends IService { + + + ResponseResult getCategoryList(); + + List listAllCategory(); +} + +~~~~ + +SystemConstants中增加常量 + +~~~~java + /** 正常状态 */ + public static final String NORMAL = "0"; +~~~~ + + + + + +CategoryServiceImpl增加方法 + +~~~~java + @Override + public List listAllCategory() { + LambdaQueryWrapper wrapper = new LambdaQueryWrapper<>(); + wrapper.eq(Category::getStatus, SystemConstants.NORMAL); + List list = list(wrapper); + List categoryVos = BeanCopyUtils.copyBeanList(list, CategoryVo.class); + return categoryVos; + } +~~~~ + + + + + +##### 5.8.3.2 查询所有标签接口 + +TagVo + +~~~~java +@Data +@AllArgsConstructor +@NoArgsConstructor +public class TagVo { + private Long id; + + //标签名 + private String name; + + + +} + +~~~~ + + + +TagController + +~~~~java + @GetMapping("/listAllTag") + public ResponseResult listAllTag(){ + List list = tagService.listAllTag(); + return ResponseResult.okResult(list); + } +~~~~ + + + +TagService 增加listAllTag方法 + +~~~~java +List listAllTag(); + +~~~~ + +TagServiceImpl + +~~~~java + @Override + public List listAllTag() { + LambdaQueryWrapper wrapper = new LambdaQueryWrapper<>(); + wrapper.select(Tag::getId,Tag::getName); + List list = list(wrapper); + List tagVos = BeanCopyUtils.copyBeanList(list, TagVo.class); + return tagVos; + } +~~~~ + + + + + +##### 5.8.3.3 上传图片接口 + +在sangeng-admin中增加UploadController + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +@RestController +public class UploadController { + + @Autowired + private UploadService uploadService; + + @PostMapping("/upload") + public ResponseResult uploadImg(@RequestParam("img") MultipartFile multipartFile) { + try { + return uploadService.uploadImg(multipartFile); + } catch (IOException e) { + e.printStackTrace(); + throw new RuntimeException("文件上传上传失败"); + } + } +} +~~~~ + + + + + + + +##### 5.8.3.4 新增博文接口 + + + +ArticleController + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +@RestController +@RequestMapping("/content/article") +public class ArticleController { + + @Autowired + private ArticleService articleService; + + @PostMapping + public ResponseResult add(@RequestBody AddArticleDto article){ + return articleService.add(article); + } + + +} + +~~~~ + + + +AddArticleDto + +注意增加tags属性用于接收文章关联标签的id + +~~~~java +@Data +@AllArgsConstructor +@NoArgsConstructor +public class AddArticleDto { + + private Long id; + //标题 + private String title; + //文章内容 + private String content; + //文章摘要 + private String summary; + //所属分类id + private Long categoryId; + + //缩略图 + private String thumbnail; + //是否置顶（0否，1是） + private String isTop; + //状态（0已发布，1草稿） + private String status; + //访问量 + private Long viewCount; + //是否允许评论 1是，0否 + private String isComment; + private List tags; + +} + +~~~~ + + + + + + + +Article 修改这样创建时间创建人修改时间修改人可以自动填充 + +~~~~java + @TableField(fill = FieldFill.INSERT) + private Long createBy; + @TableField(fill = FieldFill.INSERT) + private Date createTime; + @TableField(fill = FieldFill.INSERT_UPDATE) + private Long updateBy; + @TableField(fill = FieldFill.INSERT_UPDATE) + private Date updateTime; +~~~~ + + + + + +ArticleService增加方法 + +~~~~java +ResponseResult add(AddArticleDto article); +~~~~ + + + +创建ArticleTag表相关的实体类，mapper，service,serviceimpl等 + +```java +@TableName(value="sg_article_tag") +@Data +@AllArgsConstructor +@NoArgsConstructor +public class ArticleTag implements Serializable { + private static final long serialVersionUID = 625337492348897098L; + + /** + * 文章id + */ + private Long articleId; + /** + * 标签id + */ + private Long tagId; + + + +} +``` + + + + + +ArticleServiceImpl增加如下代码 + +~~~~java + @Autowired + private ArticleTagService articleTagService; + + @Override + @Transactional + public ResponseResult add(AddArticleDto articleDto) { + //添加 博客 + Article article = BeanCopyUtils.copyBean(articleDto, Article.class); + save(article); + + + List articleTags = articleDto.getTags().stream() + .map(tagId -> new ArticleTag(article.getId(), tagId)) + .collect(Collectors.toList()); + + //添加 博客和标签的关联 + articleTagService.saveBatch(articleTags); + return ResponseResult.okResult(); + } +~~~~ + + + + + + + +### 5.9 导出所有分类到Excel + +#### 5.9.1 需求 + + + +​ 在分类管理中点击导出按钮可以把所有的分类导出到Excel文件中。 + +​ + +#### 5.9.2 技术方案 + +​ 使用EasyExcel实现Excel的导出操作。 + +​ https://github.com/alibaba/easyexcel + +​ https://easyexcel.opensource.alibaba.com/docs/current/quickstart/write#%E7%A4%BA%E4%BE%8B%E4%BB%A3%E7%A0%81-1 + +#### 5.9.3 接口设计 + +​ + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ------------------------ | --------------- | +| GET | /content/category/export | 需要token请求头 | + +请求参数： + +​ 无 + + + + + +响应格式： + +成功的话可以直接导出一个Excel文件 + + + +失败的话响应格式如下： + +~~~~json +{ + "code":500, + "msg":"出现错误" +} +~~~~ + + + +#### 5.9.4 代码实现 + +工具类方法修改 + +WebUtils + +~~~~java + public static void setDownLoadHeader(String filename, HttpServletResponse response) throws UnsupportedEncodingException { + response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); + response.setCharacterEncoding("utf-8"); + String fname= URLEncoder.encode(filename,"UTF-8").replaceAll("\\+", "%20"); + response.setHeader("Content-disposition","attachment; filename="+fname); + } +~~~~ + + + +CategoryController + +~~~~java + @GetMapping("/export") + public void export(HttpServletResponse response){ + try { + //设置下载文件的请求头 + WebUtils.setDownLoadHeader("分类.xlsx",response); + //获取需要导出的数据 + List categoryVos = categoryService.list(); + + List excelCategoryVos = BeanCopyUtils.copyBeanList(categoryVos, ExcelCategoryVo.class); + //把数据写入到Excel中 + EasyExcel.write(response.getOutputStream(), ExcelCategoryVo.class).autoCloseStream(Boolean.FALSE).sheet("分类导出") + .doWrite(excelCategoryVos); + + } catch (Exception e) { + //如果出现异常也要响应json + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR); + WebUtils.renderString(response, JSON.toJSONString(result)); + } + } +~~~~ + + + + + +ExcelCategoryVo + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class ExcelCategoryVo { + @ExcelProperty("分类名") + private String name; + //描述 + @ExcelProperty("描述") + private String description; + + //状态0:正常,1禁用 + @ExcelProperty("状态0:正常,1禁用") + private String status; +} + +~~~~ + + + +### 5.10 权限控制 + +#### 5.10.1 需求 + +​ 需要对导出分类的接口做权限控制。 + +sg eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJkZGJkNjM5MWJiZTA0NmMzOTc4NDg1ZTcxNWQ3YjQ0MSIsInN1YiI6IjEiLCJpc3MiOiJzZyIsImlhdCI6MTY2MjI0NDE4NywiZXhwIjoxNjYyMzMwNTg3fQ.z4JGwFN3lWyVbOCbhikCe-O4D6SvCQFEE5eQY3jDJkw + +sangeng + +eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiI0Y2I1ZjhmMTc0Mjk0NzM0YjI4Y2M1NTQzYjQ2Yjc1YyIsInN1YiI6IjYiLCJpc3MiOiJzZyIsImlhdCI6MTY2MjI0NDQzMywiZXhwIjoxNjYyMzMwODMzfQ.yEkbyGYXBp5ndnyq-3acdgpvqx2mnI8B9fK9f3Y6Jco + +#### 5.10.2 代码实现 + + + +SecurityConfig + +~~~~java +@EnableGlobalMethodSecurity(prePostEnabled = true) +~~~~ + + + + + +UserDetailsServiceImpl + +~~~~java +@Service +public class UserDetailsServiceImpl implements UserDetailsService { + + @Autowired + private UserMapper userMapper; + + @Autowired + private MenuMapper menuMapper; + + @Override + public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException { + //根据用户名查询用户信息 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + queryWrapper.eq(User::getUserName,username); + User user = userMapper.selectOne(queryWrapper); + //判断是否查到用户 如果没查到抛出异常 + if(Objects.isNull(user)){ + throw new RuntimeException("用户不存在"); + } + //返回用户信息 + if(user.getType().equals(SystemConstants.ADMAIN)){ + List list = menuMapper.selectPermsByUserId(user.getId()); + return new LoginUser(user,list); + } + return new LoginUser(user,null); + } +} + +~~~~ + + + +LoginUser + +增加属性 + +~~~~java +private List permissions; +~~~~ + + + + + +PermissionService + +hasPermisson + +~~~~java + +@Service("ps") +public class PermissionService { + + /** + * 判断当前用户是否具有permission + * @param permission 要判断的权限 + * @return + */ + public boolean hasPermission(String permission){ + //如果是超级管理员 直接返回true + if(SecurityUtils.isAdmin()){ + return true; + } + //否则 获取当前登录用户所具有的权限列表 如何判断是否存在permission + List permissions = SecurityUtils.getLoginUser().getPermissions(); + return permissions.contains(permission); + } +} +~~~~ + + + +CategoryController + +~~~~java + + @PreAuthorize("@ps.hasPermission('content:category:export')") + @GetMapping("/export") + public void export(HttpServletResponse response){ + try { + //设置下载文件的请求头 + WebUtils.setDownLoadHeader("分类.xlsx",response); + //获取需要导出的数据 + List categoryVos = categoryService.list(); + + List excelCategoryVos = BeanCopyUtils.copyBeanList(categoryVos, ExcelCategoryVo.class); + //把数据写入到Excel中 + EasyExcel.write(response.getOutputStream(), ExcelCategoryVo.class).autoCloseStream(Boolean.FALSE).sheet("分类导出") + .doWrite(excelCategoryVos); + + } catch (Exception e) { + //如果出现异常也要响应json + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR); + WebUtils.renderString(response, JSON.toJSONString(result)); + } + } +~~~~ + + + + + +### 5.11 文章列表 + +#### 5.10.1 需求 + +​ 为了对文章进行管理，需要提供文章列表， + +​ 在后台需要分页查询文章功能，要求能根据标题和摘要**模糊查询**。 + +​ 注意：不能把删除了的文章查询出来 + + + +#### 5.10.2 接口设计 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | --------------------- | --------------- | +| Get | /content/article/list | 是 | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +title：文章标题 + +summary：文章摘要 + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "rows":[ + { + "categoryId":"1", + "content":"嘻嘻嘻嘻嘻嘻", + "createTime":"2022-01-24 07:20:11", + "id":"1", + "isComment":"0", + "isTop":"1", + "status":"0", + "summary":"SpringSecurity框架教程-Spring Security+JWT实现项目级前端分离认证授权", + "thumbnail":"https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/01/31/948597e164614902ab1662ba8452e106.png", + "title":"SpringSecurity从入门到精通", + "viewCount":"161" + } + ], + "total":"1" + }, + "msg":"操作成功" +} +~~~~ + + + +​ + +### 5.12 修改文章 + +#### 5.12.1 需求 + +​ 点击文章列表中的修改按钮可以跳转到写博文页面。回显示该文章的具体信息。 + +​ 用户可以在该页面修改文章信息。点击更新按钮后修改文章。 + + + + + +#### 5.12.2 分析 + +​ 这个功能的实现首先需要能够根据文章id查询文章的详细信息这样才能实现文章的回显。 + +​ 如何需要提供更新文章的接口。 + + + +#### 5.12.3 接口设计 + +##### 5.12.3.1 查询文章详情接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | -------------------- | --------------- | +| Get | content/article/{id} | 是 | + +Path格式请求参数： + +id: 文章id + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "categoryId":"1", + "content":"xxxxxxx", + "createBy":"1", + "createTime":"2022-08-28 15:15:46", + "delFlag":0, + "id":"10", + "isComment":"0", + "isTop":"1", + "status":"0", + "summary":"啊实打实", + "tags":[ + "1", + "4", + "5" + ], + "thumbnail":"https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/08/28/7659aac2b74247fe8ebd9e054b916dbf.png", + "title":"委屈饿驱蚊器", + "updateBy":"1", + "updateTime":"2022-08-28 15:15:46", + "viewCount":"0" + }, + "msg":"操作成功" +} +~~~~ + + + +##### 5.12.3.2 更新文章接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | --------------- | --------------- | +| PUT | content/article | 是 | + +请求体参数格式： + +~~~~json +{ + "categoryId":"1", + "content":"![Snipaste_20220228_224837.png](https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/08/28/f3938a0368c540ee909ba7f7079a829a.png)\n\n# 十大\n## 时代的", + "createBy":"1", + "createTime":"2022-08-28 15:15:46", + "delFlag":0, + "id":"10", + "isComment":"0", + "isTop":"1", + "status":"0", + "summary":"啊实打实2", + "tags":[ + "1", + "4", + "5" + ], + "thumbnail":"https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/08/28/7659aac2b74247fe8ebd9e054b916dbf.png", + "title":"委屈饿驱蚊器", + "updateBy":"1", + "updateTime":"2022-08-28 15:15:46", + "viewCount":"0" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.13 删除文章 + +#### 5.13.1 需求 + +​ 点击文章后面的删除按钮可以删除该文章 + +​ 注意：是逻辑删除不是物理删除 + +#### 5.13.2 接口设计 + +​ + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | -------------------- | --------------- | +| DELETE | content/article/{id} | 是 | + +Path请求参数： + +id：要删除的文章id + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + + + +### 5.14 菜单列表 + +#### 5.14.1 需求 + +​ 需要展示菜单列表，不需要分页。 + +​ 可以针对菜单名进行模糊查询 + +​ 也可以针对菜单的状态进行查询。 + +​ 菜单要按照父菜单id和orderNum进行排序 + +#### 5.14.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------- | --------------- | +| GET | system/menu/list | 是 | + +Query请求参数： + +status : 状态 + +menuName： 菜单名 + +响应格式： + +~~~~json +{ + "code":200, + "data":[ + { + "component":"content/article/write/index", + "icon":"build", + "id":"2023", + "isFrame":1, + "menuName":"写博文", + "menuType":"C", + "orderNum":0, + "parentId":"0", + "path":"write", + "perms":"content:article:writer", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "icon":"system", + "id":"1", + "isFrame":1, + "menuName":"系统管理", + "menuType":"M", + "orderNum":1, + "parentId":"0", + "path":"system", + "perms":"", + "remark":"系统管理目录", + "status":"0", + "visible":"0" + }, + { + "icon":"table", + "id":"2017", + "isFrame":1, + "menuName":"内容管理", + "menuType":"M", + "orderNum":4, + "parentId":"0", + "path":"content", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"system/user/index", + "icon":"user", + "id":"100", + "isFrame":1, + "menuName":"用户管理", + "menuType":"C", + "orderNum":1, + "parentId":"1", + "path":"user", + "perms":"system:user:list", + "remark":"用户管理菜单", + "status":"0", + "visible":"0" + }, + { + "component":"system/role/index", + "icon":"peoples", + "id":"101", + "isFrame":1, + "menuName":"角色管理", + "menuType":"C", + "orderNum":2, + "parentId":"1", + "path":"role", + "perms":"system:role:list", + "remark":"角色管理菜单", + "status":"0", + "visible":"0" + }, + { + "component":"system/menu/index", + "icon":"tree-table", + "id":"102", + "isFrame":1, + "menuName":"菜单管理", + "menuType":"C", + "orderNum":3, + "parentId":"1", + "path":"menu", + "perms":"system:menu:list", + "remark":"菜单管理菜单", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1001", + "isFrame":1, + "menuName":"用户查询", + "menuType":"F", + "orderNum":1, + "parentId":"100", + "path":"", + "perms":"system:user:query", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1002", + "isFrame":1, + "menuName":"用户新增", + "menuType":"F", + "orderNum":2, + "parentId":"100", + "path":"", + "perms":"system:user:add", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1003", + "isFrame":1, + "menuName":"用户修改", + "menuType":"F", + "orderNum":3, + "parentId":"100", + "path":"", + "perms":"system:user:edit", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1004", + "isFrame":1, + "menuName":"用户删除", + "menuType":"F", + "orderNum":4, + "parentId":"100", + "path":"", + "perms":"system:user:remove", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1005", + "isFrame":1, + "menuName":"用户导出", + "menuType":"F", + "orderNum":5, + "parentId":"100", + "path":"", + "perms":"system:user:export", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1006", + "isFrame":1, + "menuName":"用户导入", + "menuType":"F", + "orderNum":6, + "parentId":"100", + "path":"", + "perms":"system:user:import", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1007", + "isFrame":1, + "menuName":"重置密码", + "menuType":"F", + "orderNum":7, + "parentId":"100", + "path":"", + "perms":"system:user:resetPwd", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1008", + "isFrame":1, + "menuName":"角色查询", + "menuType":"F", + "orderNum":1, + "parentId":"101", + "path":"", + "perms":"system:role:query", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1009", + "isFrame":1, + "menuName":"角色新增", + "menuType":"F", + "orderNum":2, + "parentId":"101", + "path":"", + "perms":"system:role:add", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1010", + "isFrame":1, + "menuName":"角色修改", + "menuType":"F", + "orderNum":3, + "parentId":"101", + "path":"", + "perms":"system:role:edit", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1011", + "isFrame":1, + "menuName":"角色删除", + "menuType":"F", + "orderNum":4, + "parentId":"101", + "path":"", + "perms":"system:role:remove", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1012", + "isFrame":1, + "menuName":"角色导出", + "menuType":"F", + "orderNum":5, + "parentId":"101", + "path":"", + "perms":"system:role:export", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1013", + "isFrame":1, + "menuName":"菜单查询", + "menuType":"F", + "orderNum":1, + "parentId":"102", + "path":"", + "perms":"system:menu:query", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1014", + "isFrame":1, + "menuName":"菜单新增", + "menuType":"F", + "orderNum":2, + "parentId":"102", + "path":"", + "perms":"system:menu:add", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1015", + "isFrame":1, + "menuName":"菜单修改", + "menuType":"F", + "orderNum":3, + "parentId":"102", + "path":"", + "perms":"system:menu:edit", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1016", + "isFrame":1, + "menuName":"菜单删除", + "menuType":"F", + "orderNum":4, + "parentId":"102", + "path":"", + "perms":"system:menu:remove", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"content/article/index", + "icon":"build", + "id":"2019", + "isFrame":1, + "menuName":"文章管理", + "menuType":"C", + "orderNum":0, + "parentId":"2017", + "path":"article", + "perms":"content:article:list", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"content/category/index", + "icon":"example", + "id":"2018", + "isFrame":1, + "menuName":"分类管理", + "menuType":"C", + "orderNum":1, + "parentId":"2017", + "path":"category", + "perms":"content:category:list", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"content/link/index", + "icon":"404", + "id":"2022", + "isFrame":1, + "menuName":"友链管理", + "menuType":"C", + "orderNum":4, + "parentId":"2017", + "path":"link", + "perms":"content:link:list", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"content/tag/index", + "icon":"button", + "id":"2021", + "isFrame":1, + "menuName":"标签管理", + "menuType":"C", + "orderNum":6, + "parentId":"2017", + "path":"tag", + "perms":"content:tag:index", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "icon":"#", + "id":"2028", + "isFrame":1, + "menuName":"导出分类", + "menuType":"F", + "orderNum":1, + "parentId":"2018", + "path":"", + "perms":"content:category:export", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "icon":"#", + "id":"2024", + "isFrame":1, + "menuName":"友链新增", + "menuType":"F", + "orderNum":0, + "parentId":"2022", + "path":"", + "perms":"content:link:add", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "icon":"#", + "id":"2025", + "isFrame":1, + "menuName":"友链修改", + "menuType":"F", + "orderNum":1, + "parentId":"2022", + "path":"", + "perms":"content:link:edit", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "icon":"#", + "id":"2026", + "isFrame":1, + "menuName":"友链删除", + "menuType":"F", + "orderNum":1, + "parentId":"2022", + "path":"", + "perms":"content:link:remove", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "icon":"#", + "id":"2027", + "isFrame":1, + "menuName":"友链查询", + "menuType":"F", + "orderNum":2, + "parentId":"2022", + "path":"", + "perms":"content:link:query", + "remark":"", + "status":"0", + "visible":"0" + } + ], + "msg":"操作成功" +} +~~~~ + + + + + +### 5.15 新增菜单 + +#### 5.15.1 需求 + +​ 可以新增菜单 + +#### 5.15.2 接口设计 + +​ + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | --------------- | --------------- | +| POST | content/article | 是 | + +请求体参数： + +​ Menu类对应的json格式 + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +### 5.16 修改菜单 + +#### 5.16.1 需求 + +​ 能够修改菜单，但是修改的时候不能把父菜单设置为当前菜单，如果设置了需要给出相应的提示。并且修改失败。 + +#### 5.16.2 接口设计 + +##### 5.16.2.1 根据id查询菜单数据 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------- | --------------- | +| Get | system/menu/{id} | 是 | + +Path格式请求参数： + +id: 菜单id + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "icon":"table", + "id":"2017", + "menuName":"内容管理", + "menuType":"M", + "orderNum":"4", + "parentId":"0", + "path":"content", + "remark":"", + "status":"0", + "visible":"0" + }, + "msg":"操作成功" +} +~~~~ + + + +##### 5.16.2.2 更新菜单 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------- | --------------- | +| PUT | system/menu | 是 | + +请求体参数： + +​ Menu类对应的json格式 + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + +如果把父菜单设置为当前菜单: + +~~~~java +{ + "code":500, + "msg":"修改菜单'写博文'失败，上级菜单不能选择自己" +} +~~~~ + + + +### 5.17 删除菜单 + +#### 5.17.1 需求 + +​ 能够删除菜单，但是如果要删除的菜单有子菜单则提示：存在子菜单不允许删除 并且删除失败。 + +#### 5.17.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------------------ | --------------- | +| DELETE | content/article/{menuId} | 是 | + +Path参数： + +menuId：要删除菜单的id + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + +如果要删除的菜单有子菜单则 + +~~~~java +{ + "code":500, + "msg":"存在子菜单不允许删除" +} +~~~~ + + + + + +### 5.18 角色列表 + +#### 5.18.1 需求 + +​ 需要有角色列表分页查询的功能。 + +​ 要求能够针对角色名称进行模糊查询。 + +​ 要求能够针对状态进行查询。 + +​ 要求按照role_sort进行升序排列。 + +#### 5.18.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------- | --------------- | +| GET | system/role/list | 是 | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +roleName：角色名称 + +status：状态 + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "rows":[ + { + "id":"12", + "roleKey":"link", + "roleName":"友链审核员", + "roleSort":"1", + "status":"0" + } + ], + "total":"1" + }, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.19 改变角色状态 + +#### 5.19.1 需求 + +​ 要求能够修改角色的停启用状态 + +#### 5.19.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------------------ | --------------- | +| PUT | system/role/changeStatus | 是 | + +请求体： + +~~~~json +{"roleId":"11","status":"1"} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.20 新增角色！！ + +#### 5.20.1 需求 + +​ 需要提供新增角色的功能。新增角色时能够直接设置角色所关联的菜单权限。 + +#### 5.20.2 接口设计 + +##### 5.20.2.1 获取菜单树接口 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------------------- | --------------- | +| GET | /system/menu/treeselect | 是 | + +无需请求参数 + +响应格式： + +~~~~json +{ + "code":200, + "data":[ + { + "children":[], + "id":"2023", + "label":"写博文", + "parentId":"0" + }, + { + "children":[ + { + "children":[ + { + "children":[], + "id":"1001", + "label":"用户查询", + "parentId":"100" + }, + { + "children":[], + "id":"1002", + "label":"用户新增", + "parentId":"100" + }, + { + "children":[], + "id":"1003", + "label":"用户修改", + "parentId":"100" + }, + { + "children":[], + "id":"1004", + "label":"用户删除", + "parentId":"100" + }, + { + "children":[], + "id":"1005", + "label":"用户导出", + "parentId":"100" + }, + { + "children":[], + "id":"1006", + "label":"用户导入", + "parentId":"100" + }, + { + "children":[], + "id":"1007", + "label":"重置密码", + "parentId":"100" + } + ], + "id":"100", + "label":"用户管理", + "parentId":"1" + }, + { + "children":[ + { + "children":[], + "id":"1008", + "label":"角色查询", + "parentId":"101" + }, + { + "children":[], + "id":"1009", + "label":"角色新增", + "parentId":"101" + }, + { + "children":[], + "id":"1010", + "label":"角色修改", + "parentId":"101" + }, + { + "children":[], + "id":"1011", + "label":"角色删除", + "parentId":"101" + }, + { + "children":[], + "id":"1012", + "label":"角色导出", + "parentId":"101" + } + ], + "id":"101", + "label":"角色管理", + "parentId":"1" + }, + { + "children":[ + { + "children":[], + "id":"1013", + "label":"菜单查询", + "parentId":"102" + }, + { + "children":[], + "id":"1014", + "label":"菜单新增", + "parentId":"102" + }, + { + "children":[], + "id":"1015", + "label":"菜单修改", + "parentId":"102" + }, + { + "children":[], + "id":"1016", + "label":"菜单删除", + "parentId":"102" + } + ], + "id":"102", + "label":"菜单管理", + "parentId":"1" + } + ], + "id":"1", + "label":"系统管理", + "parentId":"0" + }, + { + "children":[ + { + "children":[], + "id":"2019", + "label":"文章管理", + "parentId":"2017" + }, + { + "children":[ + { + "children":[], + "id":"2028", + "label":"导出分类", + "parentId":"2018" + } + ], + "id":"2018", + "label":"分类管理", + "parentId":"2017" + }, + { + "children":[ + { + "children":[], + "id":"2024", + "label":"友链新增", + "parentId":"2022" + }, + { + "children":[], + "id":"2025", + "label":"友链修改", + "parentId":"2022" + }, + { + "children":[], + "id":"2026", + "label":"友链删除", + "parentId":"2022" + }, + { + "children":[], + "id":"2027", + "label":"友链查询", + "parentId":"2022" + } + ], + "id":"2022", + "label":"友链管理", + "parentId":"2017" + }, + { + "children":[], + "id":"2021", + "label":"标签管理", + "parentId":"2017" + } + ], + "id":"2017", + "label":"内容管理", + "parentId":"0" + } + ], + "msg":"操作成功" +} +~~~~ + + + + + +##### 5.20.2.2 新增角色接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------- | --------------- | +| POST | system/role | 是 | + +请求体： + +~~~~json +{ + "roleName":"测试新增角色", + "roleKey":"wds", + "roleSort":0, + "status":"0", + "menuIds":[ + "1", + "100" + ], + "remark":"我是角色备注" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + + + +### 5.21 修改角色 + +#### 5.21.1 需求 + +​ 需要提供修改角色的功能。修改角色时可以修改角色所关联的菜单权限 + +#### 5.21.2 接口设计 + +##### 5.21.2.1 角色信息回显接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------- | --------------- | +| Get | system/role/{id} | 是 | + +Path格式请求参数： + +id: 角色id + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "id":"11", + "remark":"嘎嘎嘎", + "roleKey":"aggag", + "roleName":"嘎嘎嘎", + "roleSort":"5", + "status":"0" + }, + "msg":"操作成功" +} +~~~~ + +##### 5.21.2.2 加载对应角色菜单列表树接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------------------------------ | --------------- | +| Get | /system/menu/roleMenuTreeselect/{id} | 是 | + +Path格式请求参数： + +id: 角色id + +响应格式： + +字段介绍 + +​ menus：菜单树。 + +​ checkedKeys：角色所关联的菜单权限id列表。 + +~~~~json +{ + "code":200, + "data":{ + "menus":[ + { + "children":[], + "id":"2023", + "label":"写博文", + "parentId":"0" + }, + { + "children":[ + { + "children":[ + { + "children":[], + "id":"1001", + "label":"用户查询", + "parentId":"100" + }, + { + "children":[], + "id":"1002", + "label":"用户新增", + "parentId":"100" + }, + { + "children":[], + "id":"1003", + "label":"用户修改", + "parentId":"100" + }, + { + "children":[], + "id":"1004", + "label":"用户删除", + "parentId":"100" + }, + { + "children":[], + "id":"1005", + "label":"用户导出", + "parentId":"100" + }, + { + "children":[], + "id":"1006", + "label":"用户导入", + "parentId":"100" + }, + { + "children":[], + "id":"1007", + "label":"重置密码", + "parentId":"100" + } + ], + "id":"100", + "label":"用户管理", + "parentId":"1" + }, + { + "children":[ + { + "children":[], + "id":"1008", + "label":"角色查询", + "parentId":"101" + }, + { + "children":[], + "id":"1009", + "label":"角色新增", + "parentId":"101" + }, + { + "children":[], + "id":"1010", + "label":"角色修改", + "parentId":"101" + }, + { + "children":[], + "id":"1011", + "label":"角色删除", + "parentId":"101" + }, + { + "children":[], + "id":"1012", + "label":"角色导出", + "parentId":"101" + } + ], + "id":"101", + "label":"角色管理", + "parentId":"1" + }, + { + "children":[ + { + "children":[], + "id":"1013", + "label":"菜单查询", + "parentId":"102" + }, + { + "children":[], + "id":"1014", + "label":"菜单新增", + "parentId":"102" + }, + { + "children":[], + "id":"1015", + "label":"菜单修改", + "parentId":"102" + }, + { + "children":[], + "id":"1016", + "label":"菜单删除", + "parentId":"102" + } + ], + "id":"102", + "label":"菜单管理", + "parentId":"1" + } + ], + "id":"1", + "label":"系统管理", + "parentId":"0" + }, + { + "children":[ + { + "children":[], + "id":"2019", + "label":"文章管理", + "parentId":"2017" + }, + { + "children":[ + { + "children":[], + "id":"2028", + "label":"导出分类", + "parentId":"2018" + } + ], + "id":"2018", + "label":"分类管理", + "parentId":"2017" + }, + { + "children":[ + { + "children":[], + "id":"2024", + "label":"友链新增", + "parentId":"2022" + }, + { + "children":[], + "id":"2025", + "label":"友链修改", + "parentId":"2022" + }, + { + "children":[], + "id":"2026", + "label":"友链删除", + "parentId":"2022" + }, + { + "children":[], + "id":"2027", + "label":"友链查询", + "parentId":"2022" + } + ], + "id":"2022", + "label":"友链管理", + "parentId":"2017" + }, + { + "children":[], + "id":"2021", + "label":"标签管理", + "parentId":"2017" + } + ], + "id":"2017", + "label":"内容管理", + "parentId":"0" + } + ], + "checkedKeys":[ + "1001" + ] + }, + "msg":"操作成功" +} +~~~~ + + + + + +##### 5.21.2.3 更新角色信息接口 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------- | --------------- | +| PUT | system/role | 是 | + +请求体： + +~~~~json +{ + "id":"13", + "remark":"我是角色备注", + "roleKey":"wds", + "roleName":"测试新增角色", + "roleSort":0, + "status":"0", + "menuIds":[ + "1", + "100", + "1001" + ] +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + + + + + +### 5.22 删除角色 + +#### 5.22.1 需求 + +​ 删除固定的某个角色（逻辑删除） + +#### 5.22.2 接口设计 + +​ + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------- | --------------- | +| DELETE | system/role/{id} | 是 | + +Path请求参数： + +id：要删除的角色id + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.23 用户列表 + +#### 5.23.1 需求 + +​ 需要用户分页列表接口。 + +​ 可以根据用户名模糊搜索。 + +​ 可以进行手机号的搜索。 + +​ 可以进行状态的查询。 + +#### 5.23.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------- | --------------- | +| GET | system/user/list | 是 | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +userName：用户名 + +phonenumber：手机号 + +status:状态 + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "rows":[ + { + "avatar":"http://r7yxkqloa.bkt.clouddn.com/2022/03/05/75fd15587811443a9a9a771f24da458d.png", + "createTime":"2022-01-05 17:01:56", + "email":"23412332@qq.com", + "id":"1", + "nickName":"sg3334", + "phonenumber":"18888888888", + "sex":"1", + "status":"0", + "updateBy":"1", + "updateTime":"2022-03-13 21:36:22", + "userName":"sg" + } + ], + "total":"1" + }, + "msg":"操作成功" +} +~~~~ + + + +### 5.24 新增用户！！！ + + + +#### 5.24.1 需求 + +​ 需要新增用户功能。新增用户时可以直接关联角色。 + +​ 注意：新增用户时注意密码加密存储。 + +​ 用户名不能为空，否则提示：必需填写用户名 + +​ 用户名必须之前未存在，否则提示：用户名已存在 + +​ 手机号必须之前未存在，否则提示：手机号已存在 + +​ 邮箱必须之前未存在，否则提示：邮箱已存在 + +#### 5.24.2 接口设计 + +##### 5.24.2.1 查询角色列表接口 + +注意：查询的是所有状态正常的角色 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------------------ | --------------- | +| GET | /system/role/listAllRole | 是 | + + + +响应格式： + +~~~~json +{ + "code":200, + "data":[ + { + "createBy":"0", + "createTime":"2021-11-12 18:46:19", + "delFlag":"0", + "id":"1", + "remark":"超级管理员", + "roleKey":"admin", + "roleName":"超级管理员", + "roleSort":"1", + "status":"0", + "updateBy":"0" + }, + { + "createBy":"0", + "createTime":"2021-11-12 18:46:19", + "delFlag":"0", + "id":"2", + "remark":"普通角色", + "roleKey":"common", + "roleName":"普通角色", + "roleSort":"2", + "status":"0", + "updateBy":"0", + "updateTime":"2022-01-02 06:32:58" + }, + { + "createTime":"2022-01-06 22:07:40", + "delFlag":"0", + "id":"11", + "remark":"嘎嘎嘎", + "roleKey":"aggag", + "roleName":"嘎嘎嘎", + "roleSort":"5", + "status":"0", + "updateBy":"1", + "updateTime":"2022-09-12 10:00:25" + }, + { + "createTime":"2022-01-16 14:49:30", + "delFlag":"0", + "id":"12", + "roleKey":"link", + "roleName":"友链审核员", + "roleSort":"1", + "status":"0", + "updateTime":"2022-01-16 16:05:09" + } + ], + "msg":"操作成功" +} +~~~~ + + + + + + + +##### 5.24.2.2 新增用户 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------- | --------------- | +| POST | system/user | 是 | + +请求体： + +~~~~json +{ + "userName":"wqeree", + "nickName":"测试新增用户", + "password":"1234343", + "phonenumber":"18889778907", + "email":"233@sq.com", + "sex":"0", + "status":"0", + "roleIds":[ + "2" + ] +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.25 删除用户 + +#### 5.25.1 需求 + +删除固定的某个用户（逻辑删除） + +#### 5.25.2 接口设计 + +不能删除当前操作的用户 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------------- | --------------- | +| DELETE | /system/user/{id} | 是 | + +Path请求参数： + +id：要删除的用户id + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.26 修改用户 + +#### 5.26.1 需求 + +需要提供修改用户的功能。修改用户时可以修改用户所关联的角色。 + +#### 5.26.2 接口设计 + +##### 5.26.2.1 根据id查询用户信息回显接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------------- | --------------- | +| Get | /system/user/{id} | 是 | + +Path格式请求参数： + +id: 用户id + +响应格式： + +roleIds：用户所关联的角色id列表 + +roles：所有角色的列表 + +user：用户信息 + +~~~~json +{ + "code":200, + "data":{ + "roleIds":[ + "11" + ], + "roles":[ + { + "createBy":"0", + "createTime":"2021-11-12 18:46:19", + "delFlag":"0", + "id":"1", + "remark":"超级管理员", + "roleKey":"admin", + "roleName":"超级管理员", + "roleSort":"1", + "status":"0", + "updateBy":"0" + }, + { + "createBy":"0", + "createTime":"2021-11-12 18:46:19", + "delFlag":"0", + "id":"2", + "remark":"普通角色", + "roleKey":"common", + "roleName":"普通角色", + "roleSort":"2", + "status":"0", + "updateBy":"0", + "updateTime":"2022-01-02 06:32:58" + }, + { + "createTime":"2022-01-06 22:07:40", + "delFlag":"0", + "id":"11", + "remark":"嘎嘎嘎", + "roleKey":"aggag", + "roleName":"嘎嘎嘎", + "roleSort":"5", + "status":"0", + "updateBy":"1", + "updateTime":"2022-09-11 20:34:49" + }, + { + "createTime":"2022-01-16 14:49:30", + "delFlag":"0", + "id":"12", + "roleKey":"link", + "roleName":"友链审核员", + "roleSort":"1", + "status":"0", + "updateTime":"2022-01-16 16:05:09" + } + ], + "user":{ + "email":"weq@2132.com", + "id":"14787164048663", + "nickName":"sg777", + "sex":"0", + "status":"0", + "userName":"sg777" + } + }, + "msg":"操作成功" +} +~~~~ + + + +##### 5.26.2.2 更新用户信息接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------ | --------------- | +| PUT | /system/user | 是 | + +请求体： + +~~~~json +{ + "email":"weq@2132.com", + "id":"14787164048663", + "nickName":"sg777", + "sex":"1", + "status":"0", + "userName":"sg777", + "roleIds":[ + "11" + ] +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +### 5.27 分页查询分类列表 + +#### 5.27.1 需求 + +​ 需要分页查询分类列表。 + +​ 能根据分类名称进行模糊查询。 + +​ 能根据状态进行查询。 + +#### 5.27.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | --------------------- | --------------- | +| GET | content/category/list | 是 | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +name：分类名 + +status: 状态 + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "rows":[ + { + "description":"wsd", + "id":"1", + "name":"java", + "status":"0" + }, + { + "description":"wsd", + "id":"2", + "name":"PHP", + "status":"0" + } + ], + "total":"2" + }, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.28 新增分类 + +#### 5.28.1 需求 + +​ 需要新增分类功能 + +#### 5.28.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------------- | --------------- | +| POST | /content/category | 是 | + +请求体： + +~~~~json +{ + "name":"威威", + "description":"是的", + "status":"0" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.29 修改分类 + +#### 5.29.1 需求 + +​ 需要提供修改分类的功能 + +#### 5.29.2 接口设计 + +##### 5.29.2.1 根据id查询分类 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | --------------------- | --------------- | +| Get | content/category/{id} | 是 | + +Path格式请求参数： + +id: 分类id + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "description":"qwew", + "id":"4", + "name":"ww", + "status":"0" + }, + "msg":"操作成功" +} +~~~~ + + + + + +##### 5.29.2.2 更新分类 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------------- | --------------- | +| PUT | /content/category | 是 | + +请求体： + +~~~~json +{ + "description":"是的", + "id":"3", + "name":"威威2", + "status":"0" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.30 删除分类 + +#### 5.30.1 需求 + +​ 删除某个分类（逻辑删除） + +#### 5.30.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------------- | --------------- | +| DELETE | /content/category/{id} | 是 | + +Path请求参数： + +id：要删除的分类id + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.31 分页查询友链列表 + +#### 5.31.1 需求 + +​ 需要分页查询友链列表。 + +​ 能根据友链名称进行模糊查询。 + +​ 能根据状态进行查询。 + +#### 5.31.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------------ | --------------- | +| GET | /content/link/list | 是 | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +name：友链名 + +status:状态 + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "rows":[ + { + "address":"https://www.baidu.com", + "description":"sda", + "id":"1", "logo":"https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fn1.itc.cn%2Fimg8%2Fwb%2Frecom%2F2016%2F05%2F10%2F146286696706220328.PNG&refer=http%3A%2F%2Fn1.itc.cn&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1646205529&t=f942665181eb9b0685db7a6f59d59975", + "name":"sda", + "status":"0" + } + ], + "total":"1" + }, + "msg":"操作成功" +} +~~~~ + + + +### 5.32 新增友链 + +#### 5.32.1 需求 + +​ 需要新增友链功能 + +#### 5.32.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------- | --------------- | +| POST | /content/link | 是 | + +请求体： + +~~~~json +{ + "name":"sda", + "description":"weqw", + "address":"wewe", + "logo":"weqe", + "status":"2" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +### 5.33 修改友链 + +#### 5.33.1 需求 + +​ 需要提供修改友链的功能 + +#### 5.33.2 接口设计 + +##### 5.33.2.1 根据id查询友联 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------------- | --------------- | +| Get | content/link/{id} | 是 | + +Path格式请求参数： + +id: 友链id + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "address":"wewe", + "description":"weqw", + "id":"4", + "logo":"weqe", + "name":"sda", + "status":"2" + }, + "msg":"操作成功" +} +~~~~ + + + + + +##### 5.33.2.2 修改友链 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------- | --------------- | +| PUT | /content/link | 是 | + +请求体： + +~~~~json +{ + "address":"https://www.qq.com", + "description":"dada2", + "id":"2", + "logo":"https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fn1.itc.cn%2Fimg8%2Fwb%2Frecom%2F2016%2F05%2F10%2F146286696706220328.PNG&refer=http%3A%2F%2Fn1.itc.cn&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1646205529&t=f942665181eb9b0685db7a6f59d59975", + "name":"sda", + "status":"0" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +### 5.34 删除友链 + +#### 5.34.1 需求 + +​ 删除某个友链（逻辑删除） + +#### 5.34.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------------ | --------------- | +| DELETE | /content/link/{id} | 是 | + +Path请求参数： + +id：要删除的友链id + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + diff --git "a/doc/\351\241\271\347\233\256\345\256\236\346\210\230-\345\211\215\345\220\216\347\253\257\345\210\206\347\246\273\345\215\232\345\256\242\347\263\273\347\273\237.md" "b/doc/\351\241\271\347\233\256\345\256\236\346\210\230-\345\211\215\345\220\216\347\253\257\345\210\206\347\246\273\345\215\232\345\256\242\347\263\273\347\273\237.md" new file mode 100644 index 0000000000000000000000000000000000000000..942374d689c76e3e63a4f54ecae3a01721bad066 --- /dev/null +++ "b/doc/\351\241\271\347\233\256\345\256\236\346\210\230-\345\211\215\345\220\216\347\253\257\345\210\206\347\246\273\345\215\232\345\256\242\347\263\273\347\273\237.md" @@ -0,0 +1,8459 @@ +# 项目实战-前后端分离博客系统 + +## 1.课程介绍 + +* 纯后端讲解 +* 完整的前台后台代码编写 +* 主流技术栈（SpringBoot,MybatisPlus,SpringSecurity,EasyExcel,Swagger2,Redis,Echarts,Vue,ElementUI....） +* 完善细致的需求分析 +* 由易到难循序渐进 + + + +## 2.创建工程 + +​ 我们有前台和后台两套系统。两套系统的前端工程都已经提供好了。所以我们只需要写两套系统的后端。 + +​ 但是大家思考下，实际上两套后端系统的很多内容是可能重复的。这里如果我们只是单纯的创建两个后端工程。那么就会有大量的重复代码，并且需要修改的时候也需要修改两次。这就是代码复用性不高。 + +​ 所以我们需要创建多模块项目，两套系统可能都会用到的代码可以写到一个公共模块中，让前台系统和后台系统分别取依赖公共模块。 + + + +① 创建父模块 + +~~~~xml + + + 4.0.0 + + com.sangeng + SGBlog + pom + 1.0-SNAPSHOT + + sangeng-framework + sangeng-admin + sangeng-blog + + + + UTF-8 + 1.8 + + + + + + + + org.springframework.boot + spring-boot-dependencies + 2.5.0 + pom + import + + + + com.alibaba + fastjson + 1.2.33 + + + + io.jsonwebtoken + jjwt + 0.9.0 + + + + com.baomidou + mybatis-plus-boot-starter + 3.4.3 + + + + + com.aliyun.oss + aliyun-sdk-oss + 3.10.2 + + + + + com.alibaba + easyexcel + 3.0.5 + + + + io.springfox + springfox-swagger2 + 2.9.2 + + + io.springfox + springfox-swagger-ui + 2.9.2 + + + + + + + + + + org.apache.maven.plugins + maven-compiler-plugin + 3.1 + + ${java.version} + ${java.version} + ${project.build.sourceEncoding} + + + + + + +~~~~ + + + +②创建公共子模块 sangeng-framework + +~~~~xml + + + + SGBlog + com.sangeng + 1.0-SNAPSHOT + + 4.0.0 + + sangeng-framework + + + + org.springframework.boot + spring-boot-starter-web + + + + org.projectlombok + lombok + true + + + + org.springframework.boot + spring-boot-starter-test + test + + + + org.springframework.boot + spring-boot-starter-security + + + + org.springframework.boot + spring-boot-starter-data-redis + + + + com.alibaba + fastjson + + + + io.jsonwebtoken + jjwt + + + + com.baomidou + mybatis-plus-boot-starter + + + + mysql + mysql-connector-java + + + + + com.aliyun.oss + aliyun-sdk-oss + + + + + org.springframework.boot + spring-boot-starter-aop + + + + com.alibaba + easyexcel + + + io.springfox + springfox-swagger2 + + + io.springfox + springfox-swagger-ui + + + + + +~~~~ + + + +③创建博客后台模块sangeng-admin + +~~~~xml + + + + SGBlog + com.sangeng + 1.0-SNAPSHOT + + 4.0.0 + + sangeng-admin + + + + com.sangeng + sangeng-framework + 1.0-SNAPSHOT + + + + +~~~~ + +④创建博客前台模块sangeng-blog + +~~~~xml + + + + SGBlog + com.sangeng + 1.0-SNAPSHOT + + 4.0.0 + + sangeng-blog + + + + com.sangeng + sangeng-framework + 1.0-SNAPSHOT + + + + + +~~~~ + + + +## 3.博客前台 + +### 3.0 准备工作 + +#### 3.1 SpringBoot和MybatisPuls整合配置测试 + +①创建启动类 + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +@SpringBootApplication +@MapperScan("com.sangeng.mapper") +public class SanGengBlogApplication { + + public static void main(String[] args) { + SpringApplication.run(SanGengBlogApplication.class,args); + } +} +~~~~ + +②创建application.yml配置文件 + +~~~~yml +server: + port: 7777 +spring: + datasource: + url: jdbc:mysql://localhost:3306/sg_blog?characterEncoding=utf-8&serverTimezone=Asia/Shanghai + username: root + password: root + driver-class-name: com.mysql.cj.jdbc.Driver + servlet: + multipart: + max-file-size: 2MB + max-request-size: 5MB +mybatis-plus: + configuration: + # 日志 + log-impl: org.apache.ibatis.logging.stdout.StdOutImpl + global-config: + db-config: + logic-delete-field: delFlag + logic-delete-value: 1 + logic-not-delete-value: 0 + id-type: auto + +~~~~ + +③ SQL语句 + +​ SQL脚本：SGBlog\资源\SQL\sg_article.sql + +④ 创建实体类，Mapper，Service + +​ 注意思考这些文件应该写在哪个模块下？ + +~~~~java +@SuppressWarnings("serial") +@Data +@AllArgsConstructor +@NoArgsConstructor +@TableName("sg_article") +public class Article { + @TableId + private Long id; + //标题 + private String title; + //文章内容 + private String content; + //文章类型:1 文章 2草稿 + private String type; + //文章摘要 + private String summary; + //所属分类id + private Long categoryId; + //缩略图 + private String thumbnail; + //是否置顶（0否，1是） + private String isTop; + //状态（0已发布，1草稿） + private String status; + //评论数 + private Integer commentCount; + //访问量 + private Long viewCount; + //是否允许评论 1是，0否 + private String isComment; + + private Long createBy; + + private Date createTime; + + private Long updateBy; + + private Date updateTime; + //删除标志（0代表未删除，1代表已删除） + private Integer delFlag; + +} + + +~~~~ + +~~~~java +public interface ArticleMapper extends BaseMapper
{ + + +} + +~~~~ + +~~~~java +public interface ArticleService extends IService
{ +} + +~~~~ + +~~~~java +@Service +public class ArticleServiceImpl extends ServiceImpl implements ArticleService { + +} +~~~~ + + + +⑤ 创建Controller测试接口 + +​ 注意思考这些文件应该写在哪个模块下？ + +~~~~java +@RestController +@RequestMapping("/article") +public class ArticleController { + + @Autowired + private ArticleService articleService; + + @GetMapping("/list") + public List
test(){ + return articleService.list(); + } +} + +~~~~ + +​ 我们可以暂时先注释掉sangeng-framework中的SpringSecurity依赖方便测试 + + + +### 3.1 热门文章列表 + +#### 3.1.0 文章表分析 + +​ 通过需求去分析需要有哪些字段。 + +#### 3.1.1 需求 + +​ 需要查询浏览量最高的前10篇文章的信息。要求展示文章标题和浏览量。把能让用户自己点击跳转到具体的文章详情进行浏览。 + +​ 注意：不能把草稿展示出来，不能把删除了的文章查询出来。要按照浏览量进行降序排序。 + +#### 3.1.2 接口设计 + +​ 见接口文档 + +#### 3.1.3 基础版本代码实现 + +①准备工作 + +统一响应类和响应枚举 + +~~~~java +package com.sangeng.domain; + +import com.fasterxml.jackson.annotation.JsonInclude; +import com.sangeng.enums.AppHttpCodeEnum; + +import java.io.Serializable; + +@JsonInclude(JsonInclude.Include.NON_NULL) +public class ResponseResult implements Serializable { + private Integer code; + private String msg; + private T data; + + public ResponseResult() { + this.code = AppHttpCodeEnum.SUCCESS.getCode(); + this.msg = AppHttpCodeEnum.SUCCESS.getMsg(); + } + + public ResponseResult(Integer code, T data) { + this.code = code; + this.data = data; + } + + public ResponseResult(Integer code, String msg, T data) { + this.code = code; + this.msg = msg; + this.data = data; + } + + public ResponseResult(Integer code, String msg) { + this.code = code; + this.msg = msg; + } + + public static ResponseResult errorResult(int code, String msg) { + ResponseResult result = new ResponseResult(); + return result.error(code, msg); + } + public static ResponseResult okResult() { + ResponseResult result = new ResponseResult(); + return result; + } + public static ResponseResult okResult(int code, String msg) { + ResponseResult result = new ResponseResult(); + return result.ok(code, null, msg); + } + + public static ResponseResult okResult(Object data) { + ResponseResult result = setAppHttpCodeEnum(AppHttpCodeEnum.SUCCESS, AppHttpCodeEnum.SUCCESS.getMsg()); + if(data!=null) { + result.setData(data); + } + return result; + } + + public static ResponseResult errorResult(AppHttpCodeEnum enums){ + return setAppHttpCodeEnum(enums,enums.getMsg()); + } + + public static ResponseResult errorResult(AppHttpCodeEnum enums, String msg){ + return setAppHttpCodeEnum(enums,msg); + } + + public static ResponseResult setAppHttpCodeEnum(AppHttpCodeEnum enums){ + return okResult(enums.getCode(),enums.getMsg()); + } + + private static ResponseResult setAppHttpCodeEnum(AppHttpCodeEnum enums, String msg){ + return okResult(enums.getCode(),msg); + } + + public ResponseResult error(Integer code, String msg) { + this.code = code; + this.msg = msg; + return this; + } + + public ResponseResult ok(Integer code, T data) { + this.code = code; + this.data = data; + return this; + } + + public ResponseResult ok(Integer code, T data, String msg) { + this.code = code; + this.data = data; + this.msg = msg; + return this; + } + + public ResponseResult ok(T data) { + this.data = data; + return this; + } + + public Integer getCode() { + return code; + } + + public void setCode(Integer code) { + this.code = code; + } + + public String getMsg() { + return msg; + } + + public void setMsg(String msg) { + this.msg = msg; + } + + public T getData() { + return data; + } + + public void setData(T data) { + this.data = data; + } + + + +} +~~~~ + +~~~~java +package com.sangeng.enums; + +public enum AppHttpCodeEnum { + // 成功 + SUCCESS(200,"操作成功"), + // 登录 + NEED_LOGIN(401,"需要登录后操作"), + NO_OPERATOR_AUTH(403,"无权限操作"), + SYSTEM_ERROR(500,"出现错误"), + USERNAME_EXIST(501,"用户名已存在"), + PHONENUMBER_EXIST(502,"手机号已存在"), EMAIL_EXIST(503, "邮箱已存在"), + REQUIRE_USERNAME(504, "必需填写用户名"), + LOGIN_ERROR(505,"用户名或密码错误"); + int code; + String msg; + + AppHttpCodeEnum(int code, String errorMessage){ + this.code = code; + this.msg = errorMessage; + } + + public int getCode() { + return code; + } + + public String getMsg() { + return msg; + } +} + +~~~~ + + + +② 代码实现 + +~~~~java +@RestController +@RequestMapping("/article") +public class ArticleController { + + @Autowired + private ArticleService articleService; + + @GetMapping("/hotArticleList") + public ResponseResult hotArticleList(){ + + ResponseResult result = articleService.hotArticleList(); + return result; + } +} + +~~~~ + +~~~~java +public interface ArticleService extends IService
{ + ResponseResult hotArticleList(); +} + +~~~~ + +~~~~java +@Service +public class ArticleServiceImpl extends ServiceImpl implements ArticleService { + + @Override + public ResponseResult hotArticleList() { + //查询热门文章 封装成ResponseResult返回 + LambdaQueryWrapper
queryWrapper = new LambdaQueryWrapper<>(); + //必须是正式文章 + queryWrapper.eq(Article::getStatus,0); + //按照浏览量进行排序 + queryWrapper.orderByDesc(Article::getViewCount); + //最多只查询10条 + Page
page = new Page(1,10); + page(page,queryWrapper); + + List
articles = page.getRecords(); + return ResponseResult.okResult(articles); + } +} + +~~~~ + + + + + +③ 解决跨域问题 + +~~~~java +@Configuration +public class WebConfig implements WebMvcConfigurer { + + @Override + public void addCorsMappings(CorsRegistry registry) { + // 设置允许跨域的路径 + registry.addMapping("/**") + // 设置允许跨域请求的域名 + .allowedOriginPatterns("*") + // 是否允许cookie + .allowCredentials(true) + // 设置允许的请求方式 + .allowedMethods("GET", "POST", "DELETE", "PUT") + // 设置允许的header属性 + .allowedHeaders("*") + // 跨域允许时间 + .maxAge(3600); + } + +} +~~~~ + + + + + +#### 3.1.4 使用VO优化 + +​ 目前我们的响应格式其实是不符合接口文档的标准的，多返回了很多字段。这是因为我们查询出来的结果是Article来封装的，Article中字段比较多。 + +​ 我们在项目中一般最后还要把VO来接受查询出来的结果。一个接口对应一个VO，这样即使接口响应字段要修改也只要改VO即可。 + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class HotArticleVo { + private Long id; + //标题 + private String title; + + //访问量 + private Long viewCount; +} + +~~~~ + +~~~~java +@Service +public class ArticleServiceImpl extends ServiceImpl implements ArticleService { + + @Override + public ResponseResult hotArticleList() { + //查询热门文章 封装成ResponseResult返回 + LambdaQueryWrapper
queryWrapper = new LambdaQueryWrapper<>(); + //必须是正式文章 + queryWrapper.eq(Article::getStatus,0); + //按照浏览量进行排序 + queryWrapper.orderByDesc(Article::getViewCount); + //最多只查询10条 + Page
page = new Page(1,10); + page(page,queryWrapper); + + List
articles = page.getRecords(); + //bean拷贝 + List articleVos = new ArrayList<>(); + for (Article article : articles) { + HotArticleVo vo = new HotArticleVo(); + BeanUtils.copyProperties(article,vo); + articleVos.add(vo); + } + + return ResponseResult.okResult(articleVos); + } +} +~~~~ + +#### 3.1.5 字面值处理 + +​ 实际项目中都不允许直接在代码中使用字面值。都需要定义成常量来使用。这种方式有利于提高代码的可维护性。 + +~~~~java +public class SystemConstants +{ + /** + * 文章是草稿 + */ + public static final int ARTICLE_STATUS_DRAFT = 1; + /** + * 文章是正常分布状态 + */ + public static final int ARTICLE_STATUS_NORMAL = 0; + +} +~~~~ + +~~~~java +@Service +public class ArticleServiceImpl extends ServiceImpl implements ArticleService { + + @Override + public ResponseResult hotArticleList() { + //查询热门文章 封装成ResponseResult返回 + LambdaQueryWrapper
queryWrapper = new LambdaQueryWrapper<>(); + //必须是正式文章 + queryWrapper.eq(Article::getStatus, SystemConstants.ARTICLE_STATUS_NORMAL); + //按照浏览量进行排序 + queryWrapper.orderByDesc(Article::getViewCount); + //最多只查询10条 + Page
page = new Page(1,10); + page(page,queryWrapper); + + List
articles = page.getRecords(); + //bean拷贝 + List articleVos = new ArrayList<>(); + for (Article article : articles) { + HotArticleVo vo = new HotArticleVo(); + BeanUtils.copyProperties(article,vo); + articleVos.add(vo); + } + + return ResponseResult.okResult(articleVos); + } +} +~~~~ + + + + + +### 3.2 Bean拷贝工具类封装 + +~~~~java +public class BeanCopyUtils { + + private BeanCopyUtils() { + } + + public static V copyBean(Object source,Class clazz) { + //创建目标对象 + V result = null; + try { + result = clazz.newInstance(); + //实现属性copy + BeanUtils.copyProperties(source, result); + } catch (Exception e) { + e.printStackTrace(); + } + //返回结果 + return result; + } + public static List copyBeanList(List list,Class clazz){ + return list.stream() + .map(o -> copyBean(o, clazz)) + .collect(Collectors.toList()); + } +} + +~~~~ + + + + + +### 3.2 查询分类列表 + +#### 3.2.0 分类表分析 + +​ 通过需求去分析需要有哪些字段。 + +​ 建表SQL及初始化数据见：SGBlog\资源\SQL\sg_category.sql + +#### 3.2.1 需求 + +![image-20220202111056036](img/image-20220202111056036-16437714601701.png) + +​ 页面上需要展示分类列表，用户可以点击具体的分类查看该分类下的文章列表。 + +​ 注意： ①要求只展示有发布正式文章的分类 ②必须是正常状态的分类 + + + +#### 3.2.2 接口设计 + +​ 见接口文档 + +#### 3.2.3 EasyCode代码模板 + +~~~~java +##导入宏定义 +$!{define.vm} + +##保存文件（宏定义） +#save("/entity", ".java") + +##包路径（宏定义） +#setPackageSuffix("entity") + +##自动导入包（全局变量） +$!{autoImport.vm} + +import java.io.Serializable; +import lombok.AllArgsConstructor; +import lombok.Data; +import lombok.NoArgsConstructor; +import com.baomidou.mybatisplus.annotation.TableId; +import com.baomidou.mybatisplus.annotation.TableName; +##表注释（宏定义） +#tableComment("表实体类") +@SuppressWarnings("serial") +@Data +@AllArgsConstructor +@NoArgsConstructor +@TableName("$!{tableInfo.obj.name}") +public class $!{tableInfo.name} { +#foreach($column in $tableInfo.pkColumn) + #if(${column.comment})//${column.comment}#end +@TableId + private $!{tool.getClsNameByFullName($column.type)} $!{column.name}; +#end + +#foreach($column in $tableInfo.otherColumn) + #if(${column.comment})//${column.comment}#end + + private $!{tool.getClsNameByFullName($column.type)} $!{column.name}; +#end + + + +} + +~~~~ + +~~~~java +##导入宏定义 +$!{define.vm} + +##设置表后缀（宏定义） +#setTableSuffix("Mapper") + +##保存文件（宏定义） +#save("/mapper", "Mapper.java") + +##包路径（宏定义） +#setPackageSuffix("mapper") + +import com.baomidou.mybatisplus.core.mapper.BaseMapper; + + +##表注释（宏定义） +#tableComment("表数据库访问层") +public interface $!{tableName} extends BaseMapper<$!tableInfo.name> { + +} + +~~~~ + +~~~~java +##导入宏定义 +$!{define.vm} + +##设置表后缀（宏定义） +#setTableSuffix("Service") + +##保存文件（宏定义） +#save("/service", "Service.java") + +##包路径（宏定义） +#setPackageSuffix("service") + +import com.baomidou.mybatisplus.extension.service.IService; + + +##表注释（宏定义） +#tableComment("表服务接口") +public interface $!{tableName} extends IService<$!tableInfo.name> { + +} + +~~~~ + + + +~~~~java +##导入宏定义 +$!{define.vm} + +##设置表后缀（宏定义） +#setTableSuffix("ServiceImpl") + +##保存文件（宏定义） +#save("/service/impl", "ServiceImpl.java") + +##包路径（宏定义） +#setPackageSuffix("service.impl") + +import com.baomidou.mybatisplus.extension.service.impl.ServiceImpl; +import org.springframework.stereotype.Service; + +##表注释（宏定义） +#tableComment("表服务实现类") +@Service("$!tool.firstLowerCase($tableInfo.name)Service") +public class $!{tableName} extends ServiceImpl<$!{tableInfo.name}Mapper, $!{tableInfo.name}> implements $!{tableInfo.name}Service { + +} + +~~~~ + + + +#### 3.2.4 代码实现 + +~~~~java +@RestController +@RequestMapping("/category") +public class CategoryController { + + @Autowired + private CategoryService categoryService; + + @GetMapping("/getCategoryList") + public ResponseResult getCategoryList(){ + return categoryService.getCategoryList(); + } +} + + +~~~~ + +~~~~java +public interface CategoryService extends IService { + + + ResponseResult getCategoryList(); + +} +~~~~ + +~~~~java +@Service("categoryService") +public class CategoryServiceImpl extends ServiceImpl implements CategoryService { + + @Autowired + private ArticleService articleService; + + @Override + public ResponseResult getCategoryList() { + //查询文章表 状态为已发布的文章 + LambdaQueryWrapper
articleWrapper = new LambdaQueryWrapper<>(); + articleWrapper.eq(Article::getStatus,SystemConstants.ARTICLE_STATUS_NORMAL); + List
articleList = articleService.list(articleWrapper); + //获取文章的分类id，并且去重 + Set categoryIds = articleList.stream() + .map(article -> article.getCategoryId()) + .collect(Collectors.toSet()); + + //查询分类表 + List categories = listByIds(categoryIds); + categories = categories.stream(). + filter(category -> SystemConstants.STATUS_NORMAL.equals(category.getStatus())) + .collect(Collectors.toList()); + //封装vo + List categoryVos = BeanCopyUtils.copyBeanList(categories, CategoryVo.class); + + return ResponseResult.okResult(categoryVos); + } +} + +~~~~ + + + +### 3.3 分页查询文章列表 + +#### 3.3.1 需求 + +​ 在首页和分类页面都需要查询文章列表。 + +​ 首页：查询所有的文章 + +​ 分类页面：查询对应分类下的文章 + +​ 要求：①只能查询正式发布的文章 ②置顶的文章要显示在最前面 + +#### 3.3.2 接口设计 + +​ 见文档 + +#### 3.3.3 代码实现 + +MP支持分页配置 + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +@Configuration +public class MbatisPlusConfig { + + /** + * 3.4.0之后版本 + * @return + */ + @Bean + public MybatisPlusInterceptor mybatisPlusInterceptor(){ + MybatisPlusInterceptor mybatisPlusInterceptor = new MybatisPlusInterceptor(); + mybatisPlusInterceptor.addInnerInterceptor(new PaginationInnerInterceptor()); + return mybatisPlusInterceptor; + } +} +~~~~ + +在ArticleController中 + +~~~~java + @GetMapping("/articleList") + public ResponseResult articleList(Integer pageNum,Integer pageSize,Long categoryId){ + return articleService.articleList(pageNum,pageSize,categoryId); + } +~~~~ + +在ArticleService中 + +~~~~java +ResponseResult articleList(Integer pageNum, Integer pageSize, Long categoryId); +~~~~ + +在ArticleServiceImpl中 + +~~~~java + +@Service +public class ArticleServiceImpl extends ServiceImpl implements ArticleService { + + @Autowired + private CategoryService categoryService; + + @Override + public ResponseResult hotArticleList() { + //查询热门文章 封装成ResponseResult返回 + LambdaQueryWrapper
queryWrapper = new LambdaQueryWrapper<>(); + //必须是正式文章 + queryWrapper.eq(Article::getStatus, SystemConstants.ARTICLE_STATUS_NORMAL); + //按照浏览量进行排序 + queryWrapper.orderByDesc(Article::getViewCount); + //最多只查询10条 + Page
page = new Page(1,10); + page(page,queryWrapper); + + List
articles = page.getRecords(); + //bean拷贝 +// List articleVos = new ArrayList<>(); +// for (Article article : articles) { +// HotArticleVo vo = new HotArticleVo(); +// BeanUtils.copyProperties(article,vo); +// articleVos.add(vo); +// } + List vs = BeanCopyUtils.copyBeanList(articles, HotArticleVo.class); + return ResponseResult.okResult(vs); + } + + @Override + public ResponseResult articleList(Integer pageNum, Integer pageSize, Long categoryId) { + //查询条件 + LambdaQueryWrapper
lambdaQueryWrapper = new LambdaQueryWrapper<>(); + // 如果 有categoryId 就要 查询时要和传入的相同 + lambdaQueryWrapper.eq(Objects.nonNull(categoryId)&&categoryId>0 ,Article::getCategoryId,categoryId); + // 状态是正式发布的 + lambdaQueryWrapper.eq(Article::getStatus,SystemConstants.ARTICLE_STATUS_NORMAL); + // 对isTop进行降序 + lambdaQueryWrapper.orderByDesc(Article::getIsTop); + + //分页查询 + Page
page = new Page<>(pageNum,pageSize); + page(page,lambdaQueryWrapper); + + List
articles = page.getRecords(); + //查询categoryName + articles.stream() + .map(article -> article.setCategoryName(categoryService.getById(article.getCategoryId()).getName())) + .collect(Collectors.toList()); + //articleId去查询articleName进行设置 +// for (Article article : articles) { +// Category category = categoryService.getById(article.getCategoryId()); +// article.setCategoryName(category.getName()); +// } + + //封装查询结果 + List articleListVos = BeanCopyUtils.copyBeanList(page.getRecords(), ArticleListVo.class); + + PageVo pageVo = new PageVo(articleListVos,page.getTotal()); + return ResponseResult.okResult(pageVo); + } +} +~~~~ + + + +PageVo + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class PageVo { + private List rows; + private Long total; +} + +~~~~ + +ArticleListVo + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class ArticleListVo { + + private Long id; + //标题 + private String title; + //文章摘要 + private String summary; + //所属分类名 + private String categoryName; + //缩略图 + private String thumbnail; + + + //访问量 + private Long viewCount; + + private Date createTime; + + +} +~~~~ + +在Article中增加一个字段 + +~~~~java + @TableField(exist = false) + private String categoryName; +~~~~ + + + +#### 3.3.4 FastJson配置 + +~~~~java + @Bean//使用@Bean注入fastJsonHttpMessageConvert + public HttpMessageConverter fastJsonHttpMessageConverters() { + //1.需要定义一个Convert转换消息的对象 + FastJsonHttpMessageConverter fastConverter = new FastJsonHttpMessageConverter(); + FastJsonConfig fastJsonConfig = new FastJsonConfig(); + fastJsonConfig.setSerializerFeatures(SerializerFeature.PrettyFormat); + fastJsonConfig.setDateFormat("yyyy-MM-dd HH:mm:ss"); + + SerializeConfig.globalInstance.put(Long.class, ToStringSerializer.instance); + + fastJsonConfig.setSerializeConfig(SerializeConfig.globalInstance); + fastConverter.setFastJsonConfig(fastJsonConfig); + HttpMessageConverter converter = fastConverter; + return converter; + } + + @Override + public void configureMessageConverters(List> converters) { + converters.add(fastJsonHttpMessageConverters()); + } +~~~~ + + + +### 3.4 文章详情接口 + +#### 3.4.1 需求 + +​ 要求在文章列表点击阅读全文时能够跳转到文章详情页面，可以让用户阅读文章正文。 + +​ 要求：①要在文章详情中展示其分类名 + +#### 3.4.2 接口设计 + +| 请求方式 | 请求路径 | +| -------- | ------------- | +| Get | /article/{id} | + +响应格式： + +~~~~json +{ + "code": 200, + "data": { + "categoryId": "1", + "categoryName": "java", + "content": "内容", + "createTime": "2022-01-23 23:20:11", + "id": "1", + "isComment": "0", + "title": "SpringSecurity从入门到精通", + "viewCount": "114" + }, + "msg": "操作成功" +} +~~~~ + +#### 3.4.3 代码实现 + +ArticleController中新增 + +~~~~java + @GetMapping("/{id}") + public ResponseResult getArticleDetail(@PathVariable("id") Long id){ + return articleService.getArticleDetail(id); + } +~~~~ + + + +Service + +~~~~java +ResponseResult getArticleDetail(Long id); +~~~~ + + + +ServiceImpl + +~~~~java + @Override + public ResponseResult getArticleDetail(Long id) { + //根据id查询文章 + Article article = getById(id); + //转换成VO + ArticleDetailVo articleDetailVo = BeanCopyUtils.copyBean(article, ArticleDetailVo.class); + //根据分类id查询分类名 + Long categoryId = articleDetailVo.getCategoryId(); + Category category = categoryService.getById(categoryId); + if(category!=null){ + articleDetailVo.setCategoryName(category.getName()); + } + //封装响应返回 + return ResponseResult.okResult(articleDetailVo); + } +~~~~ + + + + + +### 3.5 友联查询 + +#### 3.5.0 友链表分析 + +​ 通过需求去分析需要有哪些字段。 + +​ 建表SQL及初始化数据见：SGBlog\资源\SQL\sg_link.sql + +#### 3.5.1 需求 + +​ 在友链页面要查询出所有的审核通过的友链。 + +#### 3.5.2 接口设计 + +| 请求方式 | 请求路径 | +| -------- | ---------------- | +| Get | /link/getAllLink | + +响应格式： + +~~~~json +{ + "code": 200, + "data": [ + { + "address": "https://www.baidu.com", + "description": "sda", + "id": "1", + "logo": "图片url1", + "name": "sda" + }, + { + "address": "https://www.qq.com", + "description": "dada", + "id": "2", + "logo": "图片url2", + "name": "sda" + } + ], + "msg": "操作成功" +} +~~~~ + + + +#### 3.5.3 代码实现 + +Controller + +~~~~java +@RestController +@RequestMapping("/link") +public class LinkController { + + @Autowired + private LinkService linkService; + + @GetMapping("/getAllLink") + public ResponseResult getAllLink(){ + return linkService.getAllLink(); + } +} + +~~~~ + + + +Service + +~~~~java +public interface LinkService extends IService { + + ResponseResult getAllLink(); +} + + +~~~~ + + + +ServiceImpl + +~~~~java +@Service("linkService") +public class LinkServiceImpl extends ServiceImpl implements LinkService { + + @Override + public ResponseResult getAllLink() { + //查询所有审核通过的 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + queryWrapper.eq(Link::getStatus, SystemConstants.LINK_STATUS_NORMAL); + List links = list(queryWrapper); + //转换成vo + List linkVos = BeanCopyUtils.copyBeanList(links, LinkVo.class); + //封装返回 + return ResponseResult.okResult(linkVos); + } +} + +~~~~ + + + +SystemConstants + +~~~~java + /** + * 友链状态为审核通过 + */ + public static final String LINK_STATUS_NORMAL = "0"; +~~~~ + + + + + +### 3.6 登录功能实现 + +​ 使用我们前台和后台的认证授权统一都使用SpringSecurity安全框架来实现。 + +#### 3.6.0 需求 + +​ 需要实现登录功能 + +​ 有些功能必须登录后才能使用，未登录状态是不能使用的。 + +#### 3.6.1 接口设计 + +| 请求方式 | 请求路径 | +| -------- | -------- | +| POST | /login | + +请求体： + +~~~~json +{ + "userName":"sg", + "password":"1234" +} +~~~~ + +响应格式： + +~~~~json +{ + "code": 200, + "data": { + "token": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiI0ODBmOThmYmJkNmI0NjM0OWUyZjY2NTM0NGNjZWY2NSIsInN1YiI6IjEiLCJpc3MiOiJzZyIsImlhdCI6MTY0Mzg3NDMxNiwiZXhwIjoxNjQzOTYwNzE2fQ.ldLBUvNIxQCGemkCoMgT_0YsjsWndTg5tqfJb77pabk", + "userInfo": { + "avatar": "https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fi0.hdslb.com%2Fbfs%2Farticle%2F3bf9c263bc0f2ac5c3a7feb9e218d07475573ec8.gi", + "email": "23412332@qq.com", + "id": 1, + "nickName": "sg333", + "sex": "1" + } + }, + "msg": "操作成功" +} +~~~~ + +#### 3.6.2 表分析 + +​ 建表SQL及初始化数据见：SGBlog\资源\SQL\sys_user.sql + +​ 顺便生成下User和UserMapper后面会用到 + +#### 3.6.3 思路分析 + +登录 + +​ ①自定义登录接口 + +​ 调用ProviderManager的方法进行认证 如果认证通过生成jwt + +​ 把用户信息存入redis中 + +​ ②自定义UserDetailsService + +​ 在这个实现类中去查询数据库 + +​ 注意配置passwordEncoder为BCryptPasswordEncoder + +校验： + +​ ①定义Jwt认证过滤器 + +​ 获取token + +​ 解析token获取其中的userid + +​ 从redis中获取用户信息 + +​ 存入SecurityContextHolder + +#### 3.6.4 准备工作 + +①添加依赖 + +注意放开Security依赖的注释 + +~~~~xml + + + org.springframework.boot + spring-boot-starter-data-redis + + + + com.alibaba + fastjson + 1.2.33 + + + + io.jsonwebtoken + jjwt + 0.9.0 + +~~~~ + +②工具类和相关配置类 + +​ 见 ：SGBlog\资源\登录功能所需资源 + +#### 3.6.5 登录接口代码实现 + +##### BlogLoginController + +~~~~java +@RestController +public class BlogLoginController { + @Autowired + private BlogLoginService blogLoginService; + + @PostMapping("/login") + public ResponseResult login(@RequestBody User user){ + return blogLoginService.login(user); + } +} + +~~~~ + + + +##### BlogLoginService + +~~~~java +public interface BlogLoginService { + ResponseResult login(User user); +} + +~~~~ + + + +##### SecurityConfig + +~~~~java +@Configuration +public class SecurityConfig extends WebSecurityConfigurerAdapter { + + @Bean + public PasswordEncoder passwordEncoder(){ + return new BCryptPasswordEncoder(); + } + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 + .antMatchers("/login").anonymous() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().permitAll(); + + + http.logout().disable(); + //允许跨域 + http.cors(); + } + @Override + @Bean + public AuthenticationManager authenticationManagerBean() throws Exception { + return super.authenticationManagerBean(); + } +} +~~~~ + + + +##### BlogLoginServiceImpl + +~~~~java + +@Service +public class BlogLoginServiceImpl implements BlogLoginService { + + @Autowired + private AuthenticationManager authenticationManager; + + @Autowired + private RedisCache redisCache; + + @Override + public ResponseResult login(User user) { + UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(user.getUserName(),user.getPassword()); + Authentication authenticate = authenticationManager.authenticate(authenticationToken); + //判断是否认证通过 + if(Objects.isNull(authenticate)){ + throw new RuntimeException("用户名或密码错误"); + } + //获取userid 生成token + LoginUser loginUser = (LoginUser) authenticate.getPrincipal(); + String userId = loginUser.getUser().getId().toString(); + String jwt = JwtUtil.createJWT(userId); + //把用户信息存入redis + redisCache.setCacheObject("bloglogin:"+userId,loginUser); + + //把token和userinfo封装 返回 + //把User转换成UserInfoVo + UserInfoVo userInfoVo = BeanCopyUtils.copyBean(loginUser.getUser(), UserInfoVo.class); + BlogUserLoginVo vo = new BlogUserLoginVo(jwt,userInfoVo); + return ResponseResult.okResult(vo); + } +} +~~~~ + + + +##### UserDetailServiceImpl + +~~~~java +@Service +public class UserDetailsServiceImpl implements UserDetailsService { + + @Autowired + private UserMapper userMapper; + + @Override + public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException { + //根据用户名查询用户信息 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + queryWrapper.eq(User::getUserName,username); + User user = userMapper.selectOne(queryWrapper); + //判断是否查到用户 如果没查到抛出异常 + if(Objects.isNull(user)){ + throw new RuntimeException("用户不存在"); + } + //返回用户信息 + // TODO 查询权限信息封装 + return new LoginUser(user); + } +} +~~~~ + + + + + +##### LoginUser + +~~~~java +@Data +@AllArgsConstructor +@NoArgsConstructor +public class LoginUser implements UserDetails { + + private User user; + + + @Override + public Collection getAuthorities() { + return null; + } + + @Override + public String getPassword() { + return user.getPassword(); + } + + @Override + public String getUsername() { + return user.getUserName(); + } + + @Override + public boolean isAccountNonExpired() { + return true; + } + + @Override + public boolean isAccountNonLocked() { + return true; + } + + @Override + public boolean isCredentialsNonExpired() { + return true; + } + + @Override + public boolean isEnabled() { + return true; + } +} + +~~~~ + + + + + +##### BlogUserLoginVo + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class BlogUserLoginVo { + + private String token; + private UserInfoVo userInfo; +} +~~~~ + + + +##### UserInfoVo + +~~~~java +@Data +@Accessors(chain = true) +public class UserInfoVo { + /** + * 主键 + */ + private Long id; + + /** + * 昵称 + */ + private String nickName; + + /** + * 头像 + */ + private String avatar; + + private String sex; + + private String email; + + +} + +~~~~ + + + + + +#### 3.6.6 登录校验过滤器代码实现 + +##### 思路 + +​ ①定义Jwt认证过滤器 + +​ 获取token + +​ 解析token获取其中的userid + +​ 从redis中获取用户信息 + +​ 存入SecurityContextHolder + +##### JwtAuthenticationTokenFilter + +~~~~java +@Component +public class JwtAuthenticationTokenFilter extends OncePerRequestFilter { + + @Autowired + private RedisCache redisCache; + + @Override + protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException { + //获取请求头中的token + String token = request.getHeader("token"); + if(!StringUtils.hasText(token)){ + //说明该接口不需要登录 直接放行 + filterChain.doFilter(request, response); + return; + } + //解析获取userid + Claims claims = null; + try { + claims = JwtUtil.parseJWT(token); + } catch (Exception e) { + e.printStackTrace(); + //token超时 token非法 + //响应告诉前端需要重新登录 + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.NEED_LOGIN); + WebUtils.renderString(response, JSON.toJSONString(result)); + return; + } + String userId = claims.getSubject(); + //从redis中获取用户信息 + LoginUser loginUser = redisCache.getCacheObject("bloglogin:" + userId); + //如果获取不到 + if(Objects.isNull(loginUser)){ + //说明登录过期 提示重新登录 + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.NEED_LOGIN); + WebUtils.renderString(response, JSON.toJSONString(result)); + return; + } + //存入SecurityContextHolder + UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(loginUser,null,null); + SecurityContextHolder.getContext().setAuthentication(authenticationToken); + + filterChain.doFilter(request, response); + } + + +} +~~~~ + +##### SecurityConfig + +~~~~java +@Configuration +public class SecurityConfig extends WebSecurityConfigurerAdapter { + + @Override + @Bean + public AuthenticationManager authenticationManagerBean() throws Exception { + return super.authenticationManagerBean(); + } + + @Autowired + private JwtAuthenticationTokenFilter jwtAuthenticationTokenFilter; + + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 + .antMatchers("/login").anonymous() + //jwt过滤器测试用，如果测试没有问题吧这里删除了 + .antMatchers("/link/getAllLink").authenticated() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().permitAll(); + + + http.logout().disable(); + //把jwtAuthenticationTokenFilter添加到SpringSecurity的过滤器链中 + http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); + //允许跨域 + http.cors(); + } + + @Bean + public PasswordEncoder passwordEncoder(){ + return new BCryptPasswordEncoder(); + } +} + +~~~~ + + + +### 3.7 认证授权失败处理 + +​ 目前我们的项目在认证出错或者权限不足的时候响应回来的Json是Security的异常处理结果。但是这个响应的格式肯定是不符合我们项目的接口规范的。所以需要自定义异常处理。 + + + +​ AuthenticationEntryPoint 认证失败处理器 + +​ AccessDeniedHandler 授权失败处理器 + + + +~~~~java +@Component +public class AuthenticationEntryPointImpl implements AuthenticationEntryPoint { + + @Override + public void commence(HttpServletRequest request, HttpServletResponse response, AuthenticationException authException) throws IOException, ServletException { + authException.printStackTrace(); + //InsufficientAuthenticationException + //BadCredentialsException + ResponseResult result = null; + if(authException instanceof BadCredentialsException){ + result = ResponseResult.errorResult(AppHttpCodeEnum.LOGIN_ERROR.getCode(),authException.getMessage()); + }else if(authException instanceof InsufficientAuthenticationException){ + result = ResponseResult.errorResult(AppHttpCodeEnum.NEED_LOGIN); + }else{ + result = ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR.getCode(),"认证或授权失败"); + } + //响应给前端 + WebUtils.renderString(response, JSON.toJSONString(result)); + } +} + +~~~~ + + + +~~~~java +@Component +public class AccessDeniedHandlerImpl implements AccessDeniedHandler { + @Override + public void handle(HttpServletRequest request, HttpServletResponse response, AccessDeniedException accessDeniedException) throws IOException, ServletException { + accessDeniedException.printStackTrace(); + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.NO_OPERATOR_AUTH); + //响应给前端 + WebUtils.renderString(response, JSON.toJSONString(result)); + } +} + +~~~~ + + + +配置Security异常处理器 + +~~~~java +@Configuration +public class SecurityConfig extends WebSecurityConfigurerAdapter { + + @Override + @Bean + public AuthenticationManager authenticationManagerBean() throws Exception { + return super.authenticationManagerBean(); + } + + @Autowired + private JwtAuthenticationTokenFilter jwtAuthenticationTokenFilter; + @Autowired + AuthenticationEntryPoint authenticationEntryPoint; + @Autowired + AccessDeniedHandler accessDeniedHandler; + + + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 + .antMatchers("/login").anonymous() + //jwt过滤器测试用，如果测试没有问题吧这里删除了 + .antMatchers("/link/getAllLink").authenticated() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().permitAll(); + + //配置异常处理器 + http.exceptionHandling() + .authenticationEntryPoint(authenticationEntryPoint) + .accessDeniedHandler(accessDeniedHandler); + + http.logout().disable(); + //把jwtAuthenticationTokenFilter添加到SpringSecurity的过滤器链中 + http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); + //允许跨域 + http.cors(); + } + + @Bean + public PasswordEncoder passwordEncoder(){ + return new BCryptPasswordEncoder(); + } +} + +~~~~ + +### 3.8 统一异常处理 + +​ 实际我们在开发过程中可能需要做很多的判断校验，如果出现了非法情况我们是期望响应对应的提示的。但是如果我们每次都自己手动去处理就会非常麻烦。我们可以选择直接抛出异常的方式，然后对异常进行统一处理。把异常中的信息封装成ResponseResult响应给前端。 + +​ + +SystemException + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +public class SystemException extends RuntimeException{ + + private int code; + + private String msg; + + public int getCode() { + return code; + } + + public String getMsg() { + return msg; + } + + public SystemException(AppHttpCodeEnum httpCodeEnum) { + super(httpCodeEnum.getMsg()); + this.code = httpCodeEnum.getCode(); + this.msg = httpCodeEnum.getMsg(); + } + +} + +~~~~ + +GlobalExceptionHandler + +~~~~java +@RestControllerAdvice +@Slf4j +public class GlobalExceptionHandler { + + @ExceptionHandler(SystemException.class) + public ResponseResult systemExceptionHandler(SystemException e){ + //打印异常信息 + log.error("出现了异常！ {}",e); + //从异常对象中获取提示信息封装返回 + return ResponseResult.errorResult(e.getCode(),e.getMsg()); + } + + + @ExceptionHandler(Exception.class) + public ResponseResult exceptionHandler(Exception e){ + //打印异常信息 + log.error("出现了异常！ {}",e); + //从异常对象中获取提示信息封装返回 + return ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR.getCode(),e.getMessage()); + } +} + +~~~~ + + + +### 3.9 退出登录接口 + +#### 3.9.1 接口设计 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------- | --------------- | +| POST | /logout | 需要token请求头 | + +响应格式: + +~~~~json +{ + "code": 200, + "msg": "操作成功" +} +~~~~ + + + +#### 3.9.2 代码实现 + +要实现的操作： + +​ 删除redis中的用户信息 + +BlogLoginController + +~~~~java + @PostMapping("/logout") + public ResponseResult logout(){ + return blogLoginService.logout(); + } +~~~~ + +BlogLoginService + +~~~~java +ResponseResult logout(); +~~~~ + +BlogLoginServiceImpl + +~~~~java + @Override + public ResponseResult logout() { + //获取token 解析获取userid + Authentication authentication = SecurityContextHolder.getContext().getAuthentication(); + LoginUser loginUser = (LoginUser) authentication.getPrincipal(); + //获取userid + Long userId = loginUser.getUser().getId(); + //删除redis中的用户信息 + redisCache.deleteObject("bloglogin:"+userId); + return ResponseResult.okResult(); + } +~~~~ + +SecurityConfig + +要关闭默认的退出登录功能。并且要配置我们的退出登录接口需要认证才能访问 + +~~~~java + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 + .antMatchers("/login").anonymous() + //注销接口需要认证才能访问 + .antMatchers("/logout").authenticated() + //jwt过滤器测试用，如果测试没有问题吧这里删除了 + .antMatchers("/link/getAllLink").authenticated() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().permitAll(); + + //配置异常处理器 + http.exceptionHandling() + .authenticationEntryPoint(authenticationEntryPoint) + .accessDeniedHandler(accessDeniedHandler); + //关闭默认的注销功能 + http.logout().disable(); + //把jwtAuthenticationTokenFilter添加到SpringSecurity的过滤器链中 + http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); + //允许跨域 + http.cors(); + } +~~~~ + + + +### 3.10 查询评论列表接口 + +#### 3.10.1 需求 + +​ 文章详情页面要展示这篇文章下的评论列表。 + +​ 效果如下: + +![image-20220208214106296](img/image-20220208214106296.png) + + + + + +#### 3.10.2 评论表分析 + +​ 通过需求去分析需要有哪些字段。 + +​ 建表SQL及初始化数据见：SGBlog\资源\SQL\sg_comment.sql + +​ **顺便生成下对应的代码** + +#### 3.10.3 接口设计 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------------------- | ----------------- | +| GET | /comment/commentList | 不需要token请求头 | + +Query格式请求参数： + +articleId:文章id + +pageNum: 页码 + +pageSize: 每页条数 + + + +响应格式: + +~~~~json +{ + "code": 200, + "data": { + "rows": [ + { + "articleId": "1", + "children": [ + { + "articleId": "1", + "content": "你说啥？", + "createBy": "1", + "createTime": "2022-01-30 10:06:21", + "id": "20", + "rootId": "1", + "toCommentId": "1", + "toCommentUserId": "1", + "toCommentUserName": "sg333", + "username": "sg333" + } + ], + "content": "asS", + "createBy": "1", + "createTime": "2022-01-29 07:59:22", + "id": "1", + "rootId": "-1", + "toCommentId": "-1", + "toCommentUserId": "-1", + "username": "sg333" + } + ], + "total": "15" + }, + "msg": "操作成功" +} +~~~~ + + + +#### 3.10.4 代码实现 + +##### 3.10.4.1 不考虑子评论 + +CommentController + +~~~~java +@RestController +@RequestMapping("/comment") +public class CommentController { + + @Autowired + private CommentService commentService; + + @GetMapping("/commentList") + public ResponseResult commentList(Long articleId,Integer pageNum,Integer pageSize){ + return commentService.commentList(articleId,pageNum,pageSize); + } +} + +~~~~ + + + +CommentService + +~~~~java +public interface CommentService extends IService { + + ResponseResult commentList(Long articleId, Integer pageNum, Integer pageSize); +} + +~~~~ + + + +CommentServiceImpl + +~~~~java +@Service("commentService") +public class CommentServiceImpl extends ServiceImpl implements CommentService { + + @Autowired + private UserService userService; + + @Override + public ResponseResult commentList(Long articleId, Integer pageNum, Integer pageSize) { + //查询对应文章的根评论 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + //对articleId进行判断 + queryWrapper.eq(Comment::getArticleId,articleId); + //根评论 rootId为-1 + queryWrapper.eq(Comment::getRootId,-1); + + //分页查询 + Page page = new Page(pageNum,pageSize); + page(page,queryWrapper); + + List commentVoList = toCommentVoList(page.getRecords()); + + return ResponseResult.okResult(new PageVo(commentVoList,page.getTotal())); + } + + private List toCommentVoList(List list){ + List commentVos = BeanCopyUtils.copyBeanList(list, CommentVo.class); + //遍历vo集合 + for (CommentVo commentVo : commentVos) { + //通过creatyBy查询用户的昵称并赋值 + String nickName = userService.getById(commentVo.getCreateBy()).getNickName(); + commentVo.setUsername(nickName); + //通过toCommentUserId查询用户的昵称并赋值 + //如果toCommentUserId不为-1才进行查询 + if(commentVo.getToCommentUserId()!=-1){ + String toCommentUserName = userService.getById(commentVo.getToCommentUserId()).getNickName(); + commentVo.setToCommentUserName(toCommentUserName); + } + } + return commentVos; + } +} + + +~~~~ + + + +CommentVo + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class CommentVo { + private Long id; + //文章id + private Long articleId; + //根评论id + private Long rootId; + //评论内容 + private String content; + //所回复的目标评论的userid + private Long toCommentUserId; + private String toCommentUserName; + //回复目标评论id + private Long toCommentId; + + private Long createBy; + + private Date createTime; + + private String username; +} + +~~~~ + + + +##### 3.10.4.2 查询子评论 + +CommentVo在之前的基础上增加了 private List children; + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class CommentVo { + private Long id; + //文章id + private Long articleId; + //根评论id + private Long rootId; + //评论内容 + private String content; + //所回复的目标评论的userid + private Long toCommentUserId; + private String toCommentUserName; + //回复目标评论id + private Long toCommentId; + + private Long createBy; + + private Date createTime; + + private String username; + + private List children; +} + +~~~~ + + + +CommentServiceImpl + +~~~~java +@Service("commentService") +public class CommentServiceImpl extends ServiceImpl implements CommentService { + + @Autowired + private UserService userService; + + @Override + public ResponseResult commentList(Long articleId, Integer pageNum, Integer pageSize) { + //查询对应文章的根评论 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + //对articleId进行判断 + queryWrapper.eq(Comment::getArticleId,articleId); + //根评论 rootId为-1 + queryWrapper.eq(Comment::getRootId,-1); + + //分页查询 + Page page = new Page(pageNum,pageSize); + page(page,queryWrapper); + + List commentVoList = toCommentVoList(page.getRecords()); + + //查询所有根评论对应的子评论集合，并且赋值给对应的属性 + for (CommentVo commentVo : commentVoList) { + //查询对应的子评论 + List children = getChildren(commentVo.getId()); + //赋值 + commentVo.setChildren(children); + } + + return ResponseResult.okResult(new PageVo(commentVoList,page.getTotal())); + } + + /** + * 根据根评论的id查询所对应的子评论的集合 + * @param id 根评论的id + * @return + */ + private List getChildren(Long id) { + + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + queryWrapper.eq(Comment::getRootId,id); + queryWrapper.orderByAsc(Comment::getCreateTime); + List comments = list(queryWrapper); + + List commentVos = toCommentVoList(comments); + return commentVos; + } + + private List toCommentVoList(List list){ + List commentVos = BeanCopyUtils.copyBeanList(list, CommentVo.class); + //遍历vo集合 + for (CommentVo commentVo : commentVos) { + //通过creatyBy查询用户的昵称并赋值 + String nickName = userService.getById(commentVo.getCreateBy()).getNickName(); + commentVo.setUsername(nickName); + //通过toCommentUserId查询用户的昵称并赋值 + //如果toCommentUserId不为-1才进行查询 + if(commentVo.getToCommentUserId()!=-1){ + String toCommentUserName = userService.getById(commentVo.getToCommentUserId()).getNickName(); + commentVo.setToCommentUserName(toCommentUserName); + } + } + return commentVos; + } +} +~~~~ + + + + + +### 3.11 发表评论接口 + +#### 3.11.1 需求 + +​ 用户登录后可以对文章发表评论，也可以对评论进行回复。 + +​ 用户登录后也可以在友链页面进行评论。 + +#### 3.11.2 接口设计 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------- | ----------- | +| POST | /comment | 需要token头 | + +##### 请求体： + +回复了文章： + +~~~~json +{"articleId":1,"type":0,"rootId":-1,"toCommentId":-1,"toCommentUserId":-1,"content":"评论了文章"} +~~~~ +回复了某条评论： +~~~~json +{"articleId":1,"type":0,"rootId":"3","toCommentId":"3","toCommentUserId":"1","content":"回复了某条评论"} +~~~~ + + + +如果是友链评论，type应该为1 + + + +##### 响应格式： + +~~~~java +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +#### 3.11.3 代码实现 + +CommentController + +~~~~java + @PostMapping + public ResponseResult addComment(@RequestBody Comment comment){ + return commentService.addComment(comment); + } +~~~~ + +CommentService + +~~~~java +ResponseResult addComment(Comment comment); +~~~~ + +CommentServiceImpl + +~~~~java + @Override + public ResponseResult addComment(Comment comment) { + //评论内容不能为空 + if(!StringUtils.hasText(comment.getContent())){ + throw new SystemException(AppHttpCodeEnum.CONTENT_NOT_NULL); + } + save(comment); + return ResponseResult.okResult(); + } +~~~~ + + + +SecurityUtils + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +public class SecurityUtils +{ + + /** + * 获取用户 + **/ + public static LoginUser getLoginUser() + { + return (LoginUser) getAuthentication().getPrincipal(); + } + + /** + * 获取Authentication + */ + public static Authentication getAuthentication() { + return SecurityContextHolder.getContext().getAuthentication(); + } + + public static Boolean isAdmin(){ + Long id = getLoginUser().getUser().getId(); + return id != null && 1L == id; + } + + public static Long getUserId() { + return getLoginUser().getUser().getId(); + } +} +~~~~ + +配置MP字段自动填充 + +~~~~java +@Component +public class MyMetaObjectHandler implements MetaObjectHandler { + @Override + public void insertFill(MetaObject metaObject) { + Long userId = null; + try { + userId = SecurityUtils.getUserId(); + } catch (Exception e) { + e.printStackTrace(); + userId = -1L;//表示是自己创建 + } + this.setFieldValByName("createTime", new Date(), metaObject); + this.setFieldValByName("createBy",userId , metaObject); + this.setFieldValByName("updateTime", new Date(), metaObject); + this.setFieldValByName("updateBy", userId, metaObject); + } + + @Override + public void updateFill(MetaObject metaObject) { + this.setFieldValByName("updateTime", new Date(), metaObject); + this.setFieldValByName(" ", SecurityUtils.getUserId(), metaObject); + } +} +~~~~ + +用注解标识哪些字段在什么情况下需要自动填充 + +~~~~java + /** + * 创建人的用户id + */ + @TableField(fill = FieldFill.INSERT) + private Long createBy; + /** + * 创建时间 + */ + @TableField(fill = FieldFill.INSERT) + private Date createTime; + /** + * 更新人 + */ + @TableField(fill = FieldFill.INSERT_UPDATE) + private Long updateBy; + /** + * 更新时间 + */ + @TableField(fill = FieldFill.INSERT_UPDATE) + private Date updateTime; +~~~~ + + + + + +### 3.12 友联评论列表 + +#### 3.12.1 需求 + +​ 友链页面也需要查询对应的评论列表。 + + + +#### 3.12.2 接口设计 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ------------------------ | ----------------- | +| GET | /comment/linkCommentList | 不需要token请求头 | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +响应格式: + +~~~~json +{ + "code": 200, + "data": { + "rows": [ + { + "articleId": "1", + "children": [ + { + "articleId": "1", + "content": "回复友链评论3", + "createBy": "1", + "createTime": "2022-01-30 10:08:50", + "id": "23", + "rootId": "22", + "toCommentId": "22", + "toCommentUserId": "1", + "toCommentUserName": "sg333", + "username": "sg333" + } + ], + "content": "友链评论2", + "createBy": "1", + "createTime": "2022-01-30 10:08:28", + "id": "22", + "rootId": "-1", + "toCommentId": "-1", + "toCommentUserId": "-1", + "username": "sg333" + } + ], + "total": "1" + }, + "msg": "操作成功" +} +~~~~ + + + + + +#### 3.12.3 代码实现 + +CommentController 修改了之前的文章评论列表接口，并且增加了新的友联评论接口 + +~~~~java + @GetMapping("/commentList") + public ResponseResult commentList(Long articleId,Integer pageNum,Integer pageSize){ + return commentService.commentList(SystemConstants.ARTICLE_COMMENT,articleId,pageNum,pageSize); + } + @GetMapping("/linkCommentList") + public ResponseResult linkCommentList(Integer pageNum,Integer pageSize){ + return commentService.commentList(SystemConstants.LINK_COMMENT,null,pageNum,pageSize); + } +~~~~ + + + +SystemConstants增加了两个常量 + +~~~~java + /** + * 评论类型为：文章评论 + */ + public static final String ARTICLE_COMMENT = "0"; + /** + * 评论类型为：友联评论 + */ + public static final String LINK_COMMENT = "1"; +~~~~ + + + + + +CommentService修改了commentList方法，增加了一个参数commentType + +~~~~java +ResponseResult commentList(String commentType, Long articleId, Integer pageNum, Integer pageSize); +~~~~ + + + +CommentServiceImpl修改commentList方法的代码，必须commentType为0的时候才增加articleId的判断，并且增加了一个评论类型的添加。 + +~~~~java + @Override + public ResponseResult commentList(String commentType, Long articleId, Integer pageNum, Integer pageSize) { + //查询对应文章的根评论 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + //对articleId进行判断 + queryWrapper.eq(SystemConstants.ARTICLE_COMMENT.equals(commentType),Comment::getArticleId,articleId); + //根评论 rootId为-1 + queryWrapper.eq(Comment::getRootId,-1); + + //评论类型 + queryWrapper.eq(Comment::getType,commentType); + + //分页查询 + Page page = new Page(pageNum,pageSize); + page(page,queryWrapper); + + List commentVoList = toCommentVoList(page.getRecords()); + + //查询所有根评论对应的子评论集合，并且赋值给对应的属性 + for (CommentVo commentVo : commentVoList) { + //查询对应的子评论 + List children = getChildren(commentVo.getId()); + //赋值 + commentVo.setChildren(children); + } + + return ResponseResult.okResult(new PageVo(commentVoList,page.getTotal())); + } +~~~~ + + + + + +### 3.13 个人信息查询接口 + +#### 3.13.1 需求 + +​ 进入个人中心的时候需要能够查看当前用户信息 + +#### 3.13.2 接口设计 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------------- | --------------- | +| GET | /user/userInfo | 需要token请求头 | + +不需要参数 + +响应格式: + +~~~~json +{ + "code":200, + "data":{ + "avatar":"https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fi0.hdslb.com%2Fbfs%2Farticle%2F3bf9c263bc0f2ac5c3a7feb9e218d07475573ec8.gi", + "email":"23412332@qq.com", + "id":"1", + "nickName":"sg333", + "sex":"1" + }, + "msg":"操作成功" +} +~~~~ + + + +#### 3.13.3 代码实现 + + + +UserController + +~~~~java +@RestController +@RequestMapping("/user") +public class UserController { + + @Autowired + private UserService userService; + + @GetMapping("/userInfo") + public ResponseResult userInfo(){ + return userService.userInfo(); + } +} + +~~~~ + + + +UserService增加方法定义 + +~~~~java +public interface UserService extends IService { + + ResponseResult userInfo(); + +} + +~~~~ + + + +UserServiceImpl实现userInfo方法 + +~~~~java + @Override + public ResponseResult userInfo() { + //获取当前用户id + Long userId = SecurityUtils.getUserId(); + //根据用户id查询用户信息 + User user = getById(userId); + //封装成UserInfoVo + UserInfoVo vo = BeanCopyUtils.copyBean(user,UserInfoVo.class); + return ResponseResult.okResult(vo); + } +~~~~ + + + +SecurityConfig配置该接口必须认证后才能访问 + +~~~~java + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 + .antMatchers("/login").anonymous() + //注销接口需要认证才能访问 + .antMatchers("/logout").authenticated() + //个人信息接口必须登录后才能访问 + .antMatchers("/user/userInfo").authenticated() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().permitAll(); + + //配置异常处理器 + http.exceptionHandling() + .authenticationEntryPoint(authenticationEntryPoint) + .accessDeniedHandler(accessDeniedHandler); + //关闭默认的注销功能 + http.logout().disable(); + //把jwtAuthenticationTokenFilter添加到SpringSecurity的过滤器链中 + http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); + //允许跨域 + http.cors(); + } +~~~~ + + + +### 3.14 头像上传接口 + +#### 3.14.1 需求 + +​ 在个人中心点击编辑的时候可以上传头像图片。上传完头像后，可以用于更新个人信息接口。 + + + +#### 3.14.2 OSS + +##### 3.14.2.1 为什么要使用OSS + +​ 因为如果把图片视频等文件上传到自己的应用的Web服务器，在读取图片的时候会占用比较多的资源。影响应用服务器的性能。 + +​ 所以我们一般使用OSS(Object Storage Service对象存储服务)存储图片或视频。 + + + +##### 3.14.2.2 七牛云基本使用测试 + +![image-20220227224537701](img/image-20220227224537701.png) + +![image-20220227224443813](img/image-20220227224443813.png) + + + +秘钥 + +![image-20220228230512598](img/image-20220228230512598.png) + +![image-20220228230933808](img/image-20220228230933808.png) + + + +##### 3.14.2.3 七牛云测试代码编写 + +①添加依赖 + +~~~~xml + + com.qiniu + qiniu-java-sdk + [7.7.0, 7.7.99] + +~~~~ + + + +②复制修改案例代码 + +application.yml + +~~~~yml +oss: + accessKey: xxxx + secretKey: xxxx + bucket: sg-blog +~~~~ + +OSSTest.java + +~~~~java +@SpringBootTest +@ConfigurationProperties(prefix = "oss") +public class OSSTest { + + private String accessKey; + private String secretKey; + private String bucket; + + public void setAccessKey(String accessKey) { + this.accessKey = accessKey; + } + + public void setSecretKey(String secretKey) { + this.secretKey = secretKey; + } + + public void setBucket(String bucket) { + this.bucket = bucket; + } + + @Test + public void testOss(){ + //构造一个带指定 Region 对象的配置类 + Configuration cfg = new Configuration(Region.autoRegion()); + //...其他参数参考类注释 + + UploadManager uploadManager = new UploadManager(cfg); + //...生成上传凭证，然后准备上传 +// String accessKey = "your access key"; +// String secretKey = "your secret key"; +// String bucket = "sg-blog"; + + //默认不指定key的情况下，以文件内容的hash值作为文件名 + String key = "2022/sg.png"; + + try { +// byte[] uploadBytes = "hello qiniu cloud".getBytes("utf-8"); +// ByteArrayInputStream byteInputStream=new ByteArrayInputStream(uploadBytes); + + + InputStream inputStream = new FileInputStream("C:\\Users\\root\\Desktop\\Snipaste_2022-02-28_22-48-37.png"); + Auth auth = Auth.create(accessKey, secretKey); + String upToken = auth.uploadToken(bucket); + + try { + Response response = uploadManager.put(inputStream,key,upToken,null, null); + //解析上传成功的结果 + DefaultPutRet putRet = new Gson().fromJson(response.bodyString(), DefaultPutRet.class); + System.out.println(putRet.key); + System.out.println(putRet.hash); + } catch (QiniuException ex) { + Response r = ex.response; + System.err.println(r.toString()); + try { + System.err.println(r.bodyString()); + } catch (QiniuException ex2) { + //ignore + } + } + } catch (Exception ex) { + //ignore + } + + } +} +~~~~ + + + +#### 3.14.2 接口设计 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------- | --------- | +| POST | /upload | 需要token | + +参数： + +​ img,值为要上传的文件 + +请求头： + +​ Content-Type ：multipart/form-data; + + + +响应格式: + +~~~~json +{ + "code": 200, + "data": "文件访问链接", + "msg": "操作成功" +} +~~~~ + +#### 3.14.3 代码实现 + +~~~~java +@RestController +public class UploadController { + @Autowired + private UploadService uploadService; + + @PostMapping("/upload") + public ResponseResult uploadImg(MultipartFile img){ + return uploadService.uploadImg(img); + } +} + +~~~~ + +~~~~java +public interface UploadService { + ResponseResult uploadImg(MultipartFile img); +} + +~~~~ + + + +~~~~java +@Service +@Data +@ConfigurationProperties(prefix = "oss") +public class OssUploadService implements UploadService { + @Override + public ResponseResult uploadImg(MultipartFile img) { + //判断文件类型 + //获取原始文件名 + String originalFilename = img.getOriginalFilename(); + //对原始文件名进行判断 + if(!originalFilename.endsWith(".png")){ + throw new SystemException(AppHttpCodeEnum.FILE_TYPE_ERROR); + } + + //如果判断通过上传文件到OSS + String filePath = PathUtils.generateFilePath(originalFilename); + String url = uploadOss(img,filePath);// 2099/2/3/wqeqeqe.png + return ResponseResult.okResult(url); + } + + private String accessKey; + private String secretKey; + private String bucket; + + + private String uploadOss(MultipartFile imgFile, String filePath){ + //构造一个带指定 Region 对象的配置类 + Configuration cfg = new Configuration(Region.autoRegion()); + //...其他参数参考类注释 + UploadManager uploadManager = new UploadManager(cfg); + //默认不指定key的情况下，以文件内容的hash值作为文件名 + String key = filePath; + try { + InputStream inputStream = imgFile.getInputStream(); + Auth auth = Auth.create(accessKey, secretKey); + String upToken = auth.uploadToken(bucket); + try { + Response response = uploadManager.put(inputStream,key,upToken,null, null); + //解析上传成功的结果 + DefaultPutRet putRet = new Gson().fromJson(response.bodyString(), DefaultPutRet.class); + System.out.println(putRet.key); + System.out.println(putRet.hash); + return "http://r7yxkqloa.bkt.clouddn.com/"+key; + } catch (QiniuException ex) { + Response r = ex.response; + System.err.println(r.toString()); + try { + System.err.println(r.bodyString()); + } catch (QiniuException ex2) { + //ignore + } + } + } catch (Exception ex) { + //ignore + } + return "www"; + } +} + +~~~~ + + + +PathUtils + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +public class PathUtils { + + public static String generateFilePath(String fileName){ + //根据日期生成路径 2022/1/15/ + SimpleDateFormat sdf = new SimpleDateFormat("yyyy/MM/dd/"); + String datePath = sdf.format(new Date()); + //uuid作为文件名 + String uuid = UUID.randomUUID().toString().replaceAll("-", ""); + //后缀和文件后缀一致 + int index = fileName.lastIndexOf("."); + // test.jpg -> .jpg + String fileType = fileName.substring(index); + return new StringBuilder().append(datePath).append(uuid).append(fileType).toString(); + } +} + +~~~~ + + + +### 3.15 更新个人信息接口 + +#### 3.15.1 需求 + +​ 在编辑完个人资料后点击保存会对个人资料进行更新。 + +#### 3.15.2 接口设计 + +​ + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------------- | --------------- | +| PUT | /user/userInfo | 需要token请求头 | + +参数 + +请求体中json格式数据： + +~~~~json +{ + "avatar":"https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/01/31/948597e164614902ab1662ba8452e106.png", + "email":"23412332@qq.com", + "id":"1", + "nickName":"sg333", + "sex":"1" +} +~~~~ + + + + + +响应格式: + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +#### 3.15.3 代码实现 + +UserController + +~~~~java + @PutMapping("/userInfo") + public ResponseResult updateUserInfo(@RequestBody User user){ + return userService.updateUserInfo(user); + } +~~~~ + +UserService + +~~~~java +ResponseResult updateUserInfo(User user); +~~~~ + + + +UserServiceImpl + +~~~~java + @Override + public ResponseResult updateUserInfo(User user) { + updateById(user); + return ResponseResult.okResult(); + } +~~~~ + +### 3.16 用户注册 + +#### 3.16.1 需求 + +​ 要求用户能够在注册界面完成用户的注册。要求用户名，昵称，邮箱不能和数据库中原有的数据重复。如果某项重复了注册失败并且要有对应的提示。并且要求用户名，密码，昵称，邮箱都不能为空。 + +​ 注意:密码必须密文存储到数据库中。 + +#### 3.16.2 接口设计 + +​ + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------------- | ----------------- | +| POST | /user/register | 不需要token请求头 | + +参数 + +请求体中json格式数据： + +~~~~json +{ + "email": "string", + "nickName": "string", + "password": "string", + "userName": "string" +} +~~~~ + +响应格式: + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +#### 3.16.3 代码实现 + +UserController + +~~~~java + @PostMapping("/register") + public ResponseResult register(@RequestBody User user){ + return userService.register(user); + } +~~~~ + +UserService + +~~~~java +ResponseResult register(User user); +~~~~ + +UserServiceImpl + +~~~~java + @Autowired + private PasswordEncoder passwordEncoder; + @Override + public ResponseResult register(User user) { + //对数据进行非空判断 + if(!StringUtils.hasText(user.getUserName())){ + throw new SystemException(AppHttpCodeEnum.USERNAME_NOT_NULL); + } + if(!StringUtils.hasText(user.getPassword())){ + throw new SystemException(AppHttpCodeEnum.PASSWORD_NOT_NULL); + } + if(!StringUtils.hasText(user.getEmail())){ + throw new SystemException(AppHttpCodeEnum.EMAIL_NOT_NULL); + } + if(!StringUtils.hasText(user.getNickName())){ + throw new SystemException(AppHttpCodeEnum.NICKNAME_NOT_NULL); + } + //对数据进行是否存在的判断 + if(userNameExist(user.getUserName())){ + throw new SystemException(AppHttpCodeEnum.USERNAME_EXIST); + } + if(nickNameExist(user.getNickName())){ + throw new SystemException(AppHttpCodeEnum.NICKNAME_EXIST); + } + //... + //对密码进行加密 + String encodePassword = passwordEncoder.encode(user.getPassword()); + user.setPassword(encodePassword); + //存入数据库 + save(user); + return ResponseResult.okResult(); + } + +~~~~ + +~~~~java +public enum AppHttpCodeEnum { + // 成功 + SUCCESS(200,"操作成功"), + // 登录 + NEED_LOGIN(401,"需要登录后操作"), + NO_OPERATOR_AUTH(403,"无权限操作"), + SYSTEM_ERROR(500,"出现错误"), + USERNAME_EXIST(501,"用户名已存在"), + PHONENUMBER_EXIST(502,"手机号已存在"), EMAIL_EXIST(503, "邮箱已存在"), + REQUIRE_USERNAME(504, "必需填写用户名"), + CONTENT_NOT_NULL(506, "评论内容不能为空"), + FILE_TYPE_ERROR(507, "文件类型错误，请上传png文件"), + USERNAME_NOT_NULL(508, "用户名不能为空"), + NICKNAME_NOT_NULL(509, "昵称不能为空"), + PASSWORD_NOT_NULL(510, "密码不能为空"), + EMAIL_NOT_NULL(511, "邮箱不能为空"), + NICKNAME_EXIST(512, "昵称已存在"), + LOGIN_ERROR(505,"用户名或密码错误"); + int code; + String msg; + + AppHttpCodeEnum(int code, String errorMessage){ + this.code = code; + this.msg = errorMessage; + } + + public int getCode() { + return code; + } + + public String getMsg() { + return msg; + } +} + +~~~~ + + + + + + + +### 3.17 AOP实现日志记录 + +#### 3.17.1 需求 + +​ 需要通过日志记录接口调用信息。便于后期调试排查。并且可能有很多接口都需要进行日志的记录。 + +​ 接口被调用时日志打印格式如下： + +![image-20220313133714102](img/image-20220313133714102.png) + + + +#### 3.17.2 思路分析 + +​ 相当于是对原有的功能进行增强。并且是批量的增强，这个时候就非常适合用AOP来进行实现。 + +​ + +#### 3.17.3 代码实现 + +日志打印格式 + +~~~~java + log.info("=======Start======="); + // 打印请求 URL + log.info("URL : {}",); + // 打印描述信息 + log.info("BusinessName : {}", ); + // 打印 Http method + log.info("HTTP Method : {}", ); + // 打印调用 controller 的全路径以及执行方法 + log.info("Class Method : {}.{}", ); + // 打印请求的 IP + log.info("IP : {}",); + // 打印请求入参 + log.info("Request Args : {}",); + // 打印出参 + log.info("Response : {}", ); + // 结束后换行 + log.info("=======End=======" + System.lineSeparator()); +~~~~ + + + + + + + +### 3.18 更新浏览次数 + +#### 3.18.1 需求 + +​ 在用户浏览博文时要实现对应博客浏览量的增加。 + +#### 3.18.2 思路分析 + +​ 我们只需要在每次用户浏览博客时更新对应的浏览数即可。 + +​ 但是如果直接操作博客表的浏览量的话，在并发量大的情况下会出现什么问题呢？ + +​ 如何去优化呢？ + +​ + +①在应用启动时把博客的浏览量存储到redis中 + +②更新浏览量时去更新redis中的数据 + +③每隔10分钟把Redis中的浏览量更新到数据库中 + +④读取文章浏览量时从redis读取 + + + +#### 3.18.3 铺垫知识 + +##### 3.18.3.1 CommandLineRunner实现项目启动时预处理 + +​ 如果希望在SpringBoot应用启动时进行一些初始化操作可以选择使用CommandLineRunner来进行处理。 + +​ 我们只需要实现CommandLineRunner接口，并且把对应的bean注入容器。把相关初始化的代码重新到需要重新的方法中。 + +​ 这样就会在应用启动的时候执行对应的代码。 + +~~~~java +@Component +public class TestRunner implements CommandLineRunner { + @Override + public void run(String... args) throws Exception { + System.out.println("程序初始化"); + } +} + +~~~~ + + + +##### 3.18.3.2 定时任务 + +​ 定时任务的实现方式有很多，比如XXL-Job等。但是其实核心功能和概念都是类似的，很多情况下只是调用的API不同而已。 + +​ 这里就先用SpringBoot为我们提供的定时任务的API来实现一个简单的定时任务，让大家先对定时任务里面的一些核心概念有个大致的了解。 + +实现步骤 + +① 使用@EnableScheduling注解开启定时任务功能 + +​ 我们可以在配置类上加上@EnableScheduling + +~~~~java +@SpringBootApplication +@MapperScan("com.sangeng.mapper") +@EnableScheduling +public class SanGengBlogApplication { + public static void main(String[] args) { + SpringApplication.run(SanGengBlogApplication.class,args); + } +} +~~~~ + +② 确定定时任务执行代码，并配置任务执行时间 + +​ 使用@Scheduled注解标识需要定时执行的代码。注解的cron属性相当于是任务的执行时间。目前可以使用 0/5 * * * * ? 进行测试，代表从0秒开始，每隔5秒执行一次。 + +​ 注意：对应的bean要注入容器，否则不会生效。 + +~~~~java +@Component +public class TestJob { + + @Scheduled(cron = "0/5 * * * * ?") + public void testJob(){ + //要执行的代码 + System.out.println("定时任务执行了"); + } +} + +~~~~ + + + +###### 3.18.3.2.1 cron 表达式语法 + +​ cron表达式是用来设置定时任务执行时间的表达式。 + +​ 很多情况下我们可以用 ： [在线Cron表达式生成器](https://www.bejson.com/othertools/cron/) 来帮助我们理解cron表达式和书写cron表达式。 + +​ 但是我们还是有需要学习对应的Cron语法的，这样可以更有利于我们书写Cron表达式。 + + + +如上我们用到的 0/5 * * * * ? *，cron表达式由七部分组成，中间由空格分隔，这七部分从左往右依次是： + +秒（0~59），分钟（0~59），小时（0~23），日期（1-月最后一天），月份（1-12），星期几（1-7,1表示星期日），年份（一般该项不设置，直接忽略掉，即可为空值） + + + +通用特殊字符：, - * / (可以在任意部分使用) + +> * + +星号表示任意值，例如： + +``` +* * * * * ? +``` + +表示 “ 每年每月每天每时每分每秒 ” 。 + + + +> , + +可以用来定义列表，例如 ： + +``` +1,2,3 * * * * ? +``` + +表示 “ 每年每月每天每时每分的每个第1秒，第2秒，第3秒 ” 。 + + + +> - + +定义范围，例如： + +``` +1-3 * * * * ? +``` + +表示 “ 每年每月每天每时每分的第1秒至第3秒 ”。 + + + +> / + +每隔多少，例如 + +``` +5/10 * * * * ? +``` + +表示 “ 每年每月每天每时每分，从第5秒开始，每10秒一次 ” 。即 “ / ” 的左侧是开始值，右侧是间隔。如果是从 “ 0 ” 开始的话，也可以简写成 “ /10 ” + + + + + + + + + +日期部分还可允许特殊字符： ? L W + +星期部分还可允许的特殊字符: ? L # + + + +> ? + +只可用在日期和星期部分。表示没有具体的值，使用?要注意冲突。日期和星期两个部分如果其中一个部分设置了值，则另一个必须设置为 “ ? ”。 + +例如： + +~~~~ +0\* * * 2 * ? + 和 +0\* * * ? * 2 +~~~~ + +同时使用?和同时不使用?都是不对的 + +例如下面写法就是错的 + +~~~~ +* * * 2 * 2 + 和 +* * * ? * ? + +~~~~ + + + + + +> W + +只能用在日期中，表示当月中最接近某天的工作日 + +``` +0 0 0 31W * ? +``` + +表示最接近31号的工作日，如果31号是星期六，则表示30号，即星期五，如果31号是星期天，则表示29号，即星期五。如果31号是星期三，则表示31号本身，即星期三。 + + + + + + + + + +> L + +表示最后（Last）,只能用在日期和星期中 + + + +在日期中表示每月最后一天，在一月份中表示31号，在六月份中表示30号 + +也可以表示每月倒是第N天。例如： L-2表示每个月的倒数第2天 + + + + 0 0 0 LW * ? + LW可以连起来用，表示每月最后一个工作日，即每月最后一个星期五 + + + +在星期中表示7即星期六 + + +~~~~ +0 0 0 ? * L +表示每个星期六 +0 0 0 ? * 6L +若前面有其他值的话，则表示最后一个星期几，即每月的最后一个星期五 +~~~~ + + + + + + +> # + +只能用在星期中，表示第几个星期几 + +~~~~ +0 0 0 ? * 6#3 +表示每个月的第三个星期五。 +~~~~ + + + + + + + +#### 3.18.4 接口设计 + +​ + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ----------------------------- | ----------------- | +| PUT | /article/updateViewCount/{id} | 不需要token请求头 | + +参数 + +​ 请求路径中携带文章id + +响应格式: + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +#### 3.18.5 代码实现 + +##### ①在应用启动时把博客的浏览量存储到redis中 + +​ 实现CommandLineRunner接口，在应用启动时初始化缓存。 + +~~~~java +@Component +public class ViewCountRunner implements CommandLineRunner { + + @Autowired + private ArticleMapper articleMapper; + + @Autowired + private RedisCache redisCache; + + @Override + public void run(String... args) throws Exception { + //查询博客信息 id viewCount + List
articles = articleMapper.selectList(null); + Map viewCountMap = articles.stream() + .collect(Collectors.toMap(article -> article.getId().toString(), article -> { + return article.getViewCount().intValue();// + })); + //存储到redis中 + redisCache.setCacheMap("article:viewCount",viewCountMap); + } +} + +~~~~ + + + +##### ②更新浏览量时去更新redsi中的数据 + +RedisCache增加方法 + +~~~~java + public void incrementCacheMapValue(String key,String hKey,long v){ + redisTemplate.boundHashOps(key).increment(hKey, v); + } +~~~~ + +ArticleController中增加方法更新阅读数 + +~~~~java + @PutMapping("/updateViewCount/{id}") + public ResponseResult updateViewCount(@PathVariable("id") Long id){ + return articleService.updateViewCount(id); + } +~~~~ + +ArticleService中增加方法 + +~~~~java +ResponseResult updateViewCount(Long id); +~~~~ + +ArticleServiceImpl中实现方法 + +~~~~java + @Override + public ResponseResult updateViewCount(Long id) { + //更新redis中对应 id的浏览量 + redisCache.incrementCacheMapValue("article:viewCount",id.toString(),1); + return ResponseResult.okResult(); + } +~~~~ + + + + + + + +##### ③定时任务每隔10分钟把Redis中的浏览量更新到数据库中 + +Article中增加构造方法 + +~~~~java + public Article(Long id, long viewCount) { + this.id = id; + this.viewCount = viewCount; + } +~~~~ + + + + + +~~~~java +@Component +public class UpdateViewCountJob { + + @Autowired + private RedisCache redisCache; + + @Autowired + private ArticleService articleService; + + @Scheduled(cron = "0/5 * * * * ?") + public void updateViewCount(){ + //获取redis中的浏览量 + Map viewCountMap = redisCache.getCacheMap("article:viewCount"); + + List
articles = viewCountMap.entrySet() + .stream() + .map(entry -> new Article(Long.valueOf(entry.getKey()), entry.getValue().longValue())) + .collect(Collectors.toList()); + //更新到数据库中 + articleService.updateBatchById(articles); + + } +} + +~~~~ + + + +##### ④读取文章浏览量时从redis读取 + +~~~~java + @Override + public ResponseResult getArticleDetail(Long id) { + //根据id查询文章 + Article article = getById(id); + //从redis中获取viewCount + Integer viewCount = redisCache.getCacheMapValue("article:viewCount", id.toString()); + article.setViewCount(viewCount.longValue()); + //转换成VO + ArticleDetailVo articleDetailVo = BeanCopyUtils.copyBean(article, ArticleDetailVo.class); + //根据分类id查询分类名 + Long categoryId = articleDetailVo.getCategoryId(); + Category category = categoryService.getById(categoryId); + if(category!=null){ + articleDetailVo.setCategoryName(category.getName()); + } + //封装响应返回 + return ResponseResult.okResult(articleDetailVo); + } + +~~~~ + + + + + +## 4. Swagger2 + +### 4.1 简介 + +​ Swagger 是一套基于 OpenAPI 规范构建的开源工具，可以帮助我们设计、构建、记录以及使用 Rest API。 + +### 4.2 为什么使用Swagger + +​ 当下很多公司都采取前后端分离的开发模式，前端和后端的工作由不同的工程师完成。在这种开发模式下，维持一份及时更新且完整的 Rest API 文档将会极大的提高我们的工作效率。传统意义上的文档都是后端开发人员手动编写的，相信大家也都知道这种方式很难保证文档的及时性，这种文档久而久之也就会失去其参考意义，反而还会加大我们的沟通成本。而 Swagger 给我们提供了一个全新的维护 API 文档的方式，下面我们就来了解一下它的优点： + +1.代码变，文档变。只需要少量的注解，Swagger 就可以根据代码自动生成 API 文档，很好的保证了文档的时效性。 +2.跨语言性，支持 40 多种语言。 +3.Swagger UI 呈现出来的是一份可交互式的 API 文档，我们可以直接在文档页面尝试 API 的调用，省去了准备复杂的调用参数的过程。 + + + +### 4.3 快速入门 + +#### 4.3.1 引入依赖 + +~~~~xml + + io.springfox + springfox-swagger2 + + + io.springfox + springfox-swagger-ui + + +~~~~ + + + +#### 4.3.2 启用Swagger2 + +​ 在启动类上或者配置类加 @EnableSwagger2 注解 + +~~~~java +@SpringBootApplication +@MapperScan("com.sangeng.mapper") +@EnableScheduling +@EnableSwagger2 +public class SanGengBlogApplication { + public static void main(String[] args) { + SpringApplication.run(SanGengBlogApplication.class,args); + } +} +~~~~ + + + +#### 4.3.3 测试 + +​ 访问：http://localhost:7777/swagger-ui.html 注意其中localhost和7777要调整成实际项目的域名和端口号。 + + + +### 4.4 具体配置 + + + +#### 4.4.1 Controller配置 + +##### 4.4.1 @Api 注解 + +属性介绍： + +tags 设置标签 + +description 设置描述信息 + +~~~~java +@RestController +@RequestMapping("/comment") +@Api(tags = "评论",description = "评论相关接口") +public class CommentController { +} +~~~~ + + + + + +#### 4.4.2 接口配置 + +##### 4.4.2.1 接口描述配置@ApiOperation + +~~~~java + @GetMapping("/linkCommentList") + @ApiOperation(value = "友链评论列表",notes = "获取一页友链评论") + public ResponseResult linkCommentList(Integer pageNum,Integer pageSize){ + return commentService.commentList(SystemConstants.LINK_COMMENT,null,pageNum,pageSize); + } +~~~~ + + + +##### 4.4.2.2 接口参数描述 + + @ApiImplicitParam 用于描述接口的参数，但是一个接口可能有多个参数，所以一般与 @ApiImplicitParams 组合使用。 + +~~~~java + @GetMapping("/linkCommentList") + @ApiOperation(value = "友链评论列表",notes = "获取一页友链评论") + @ApiImplicitParams({ + @ApiImplicitParam(name = "pageNum",value = "页号"), + @ApiImplicitParam(name = "pageSize",value = "每页大小") + } + ) + public ResponseResult linkCommentList(Integer pageNum,Integer pageSize){ + return commentService.commentList(SystemConstants.LINK_COMMENT,null,pageNum,pageSize); + } +~~~~ + + + +#### 4.4.3 实体类配置 + +##### 4.4.3.1 实体的描述配置@ApiModel + +@ApiModel用于描述实体类。 + +~~~~java +@Data +@AllArgsConstructor +@NoArgsConstructor +@ApiModel(description = "添加评论dto") +public class AddCommentDto{ + //.. +} +~~~~ + + + +##### 4.4.3.2 实体的属性的描述配置@ApiModelProperty + +@ApiModelProperty用于描述实体的属性 + +~~~~java + @ApiModelProperty(notes = "评论类型（0代表文章评论，1代表友链评论）") + private String type; +~~~~ + + + + + + + +#### 4.4.4 文档信息配置 + +~~~~java +@Configuration +public class SwaggerConfig { + @Bean + public Docket customDocket() { + return new Docket(DocumentationType.SWAGGER_2) + .apiInfo(apiInfo()) + .select() + .apis(RequestHandlerSelectors.basePackage("com.sangeng.controller")) + .build(); + } + + private ApiInfo apiInfo() { + Contact contact = new Contact("团队名", "http://www.my.com", "my@my.com"); + return new ApiInfoBuilder() + .title("文档标题") + .description("文档描述") + .contact(contact) // 联系方式 + .version("1.1.0") // 版本 + .build(); + } +} +~~~~ + + + +## 5. 博客后台 + +### 5.0 准备工作 + +前端工程启动 + +npm install + +npm run dev + + + +①创建启动类 + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +@SpringBootApplication +@MapperScan("com.sangeng.mapper") +public class BlogAdminApplication { + public static void main(String[] args) { + SpringApplication.run(BlogAdminApplication.class, args); + } +} + +~~~~ + +②创建application.yml配置文件 + +~~~~yml +server: + port: 8989 +spring: + datasource: + url: jdbc:mysql://localhost:3306/sg_blog?characterEncoding=utf-8&serverTimezone=UTC + username: root + password: root + driver-class-name: com.mysql.cj.jdbc.Driver + servlet: + multipart: + max-file-size: 2MB + max-request-size: 5MB + +mybatis-plus: + configuration: + # 日志 + log-impl: org.apache.ibatis.logging.stdout.StdOutImpl + global-config: + db-config: + logic-delete-field: delFlag + logic-delete-value: 1 + logic-not-delete-value: 0 + id-type: auto + + +~~~~ + +③ SQL语句 + +​ SQL脚本：SGBlog\资源\SQL\sg_tag.sql + +④ 创建实体类，Mapper，Service + +​ 注意思考这些文件应该写在哪个模块下？ + + + +Tag + +~~~~java + +@SuppressWarnings("serial") +@Data +@AllArgsConstructor +@NoArgsConstructor +@TableName("sg_tag") +public class Tag { + @TableId + private Long id; + + + private Long createBy; + + private Date createTime; + + private Long updateBy; + + private Date updateTime; + //删除标志（0代表未删除，1代表已删除） + private Integer delFlag; + //备注 + private String remark; + //标签名 + private String name; + + + +} + +~~~~ + + +TagMapper +~~~~java +/** + * 标签(Tag)表数据库访问层 + * + * @author makejava + * @since 2022-07-19 22:33:35 + */ +public interface TagMapper extends BaseMapper { + +} + + + +~~~~ + + +TagService +~~~~java +/** + * 标签(Tag)表服务接口 + * + * @author makejava + * @since 2022-07-19 22:33:38 + */ +public interface TagService extends IService { + +} + +~~~~ + + +TagServiceImpl +~~~~java +/** + * 标签(Tag)表服务实现类 + * + * @author makejava + * @since 2022-07-19 22:33:38 + */ +@Service("tagService") +public class TagServiceImpl extends ServiceImpl implements TagService { + +} + + +~~~~ + + + +⑤ 创建Controller测试接口 + +​ 注意思考这些文件应该写在哪个模块下？ + +TagController /content/tag +~~~~java +@RestController +@RequestMapping("/content/tag") +public class TagController { + @Autowired + private TagService tagService; + + @GetMapping("/list") + public ResponseResult list(){ + return ResponseResult.okResult(tagService.list()); + } +} + + +~~~~ + + + +⑥添加security相关类 + +~~~~java +@Configuration +public class SecurityConfig extends WebSecurityConfigurerAdapter { + + @Override + @Bean + public AuthenticationManager authenticationManagerBean() throws Exception { + return super.authenticationManagerBean(); + } + + @Autowired + private JwtAuthenticationTokenFilter jwtAuthenticationTokenFilter; + @Autowired + AuthenticationEntryPoint authenticationEntryPoint; + @Autowired + AccessDeniedHandler accessDeniedHandler; + + + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 +// .antMatchers("/login").anonymous() +// //注销接口需要认证才能访问 +// .antMatchers("/logout").authenticated() +// .antMatchers("/user/userInfo").authenticated() +// .antMatchers("/upload").authenticated() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().permitAll(); + + //配置异常处理器 + http.exceptionHandling() + .authenticationEntryPoint(authenticationEntryPoint) + .accessDeniedHandler(accessDeniedHandler); + //关闭默认的注销功能 + http.logout().disable(); + //把jwtAuthenticationTokenFilter添加到SpringSecurity的过滤器链中 + http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); + //允许跨域 + http.cors(); + } + + @Bean + public PasswordEncoder passwordEncoder(){ + return new BCryptPasswordEncoder(); + } +} + +~~~~ + + + +~~~~java +@Component +public class JwtAuthenticationTokenFilter extends OncePerRequestFilter { + + @Autowired + private RedisCache redisCache; + + @Override + protected void doFilterInternal(HttpServletRequest request, HttpServletResponse response, FilterChain filterChain) throws ServletException, IOException { + //获取请求头中的token + String token = request.getHeader("token"); + if(!StringUtils.hasText(token)){ + //说明该接口不需要登录 直接放行 + filterChain.doFilter(request, response); + return; + } + //解析获取userid + Claims claims = null; + try { + claims = JwtUtil.parseJWT(token); + } catch (Exception e) { + e.printStackTrace(); + //token超时 token非法 + //响应告诉前端需要重新登录 + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.NEED_LOGIN); + WebUtils.renderString(response, JSON.toJSONString(result)); + return; + } + String userId = claims.getSubject(); + //从redis中获取用户信息 + LoginUser loginUser = redisCache.getCacheObject("login:" + userId); + //如果获取不到 + if(Objects.isNull(loginUser)){ + //说明登录过期 提示重新登录 + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.NEED_LOGIN); + WebUtils.renderString(response, JSON.toJSONString(result)); + return; + } + //存入SecurityContextHolder + UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(loginUser,null,null); + SecurityContextHolder.getContext().setAuthentication(authenticationToken); + + filterChain.doFilter(request, response); + } + + +} + +~~~~ + + + +### 5.1 后台登录 + +​ 后台的认证授权也使用SpringSecurity安全框架来实现。 + +#### 5.1.0 需求 + +​ 需要实现登录功能 + +​ 后台所有功能都必须登录才能使用。 + +#### 5.1.1 接口设计 + +| 请求方式 | 请求路径 | +| -------- | ----------- | +| POST | /user/login | + +请求体： + +~~~~json +{ + "userName":"sg", + "password":"1234" +} +~~~~ + +响应格式： + +~~~~json +{ + "code": 200, + "data": { + "token": "eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiI0ODBmOThmYmJkNmI0NjM0OWUyZjY2NTM0NGNjZWY2NSIsInN1YiI6IjEiLCJpc3MiOiJzZyIsImlhdCI6MTY0Mzg3NDMxNiwiZXhwIjoxNjQzOTYwNzE2fQ.ldLBUvNIxQCGemkCoMgT_0YsjsWndTg5tqfJb77pabk" + }, + "msg": "操作成功" +} +~~~~ + +#### 5.1.2 思路分析 + +登录 + +​ ①自定义登录接口 + +​ 调用ProviderManager的方法进行认证 如果认证通过生成jwt + +​ 把用户信息存入redis中 + +​ ②自定义UserDetailsService + +​ 在这个实现类中去查询数据库 + +​ 注意配置passwordEncoder为BCryptPasswordEncoder + +校验： + +​ ①定义Jwt认证过滤器 + +​ 获取token + +​ 解析token获取其中的userid + +​ 从redis中获取用户信息 + +​ 存入SecurityContextHolder + +#### 5.1.3 准备工作 + +①添加依赖 + +前面已经添加过相关依赖，不需要做什么处理 + +~~~~xml + + + org.springframework.boot + spring-boot-starter-data-redis + + + + com.alibaba + fastjson + 1.2.33 + + + + io.jsonwebtoken + jjwt + 0.9.0 + +~~~~ + + + + + +#### 5.1.4 登录接口代码实现 + +##### LoginController + +复制一份BlogLoginController ，命名为LoginController，其中注入 LoginService + +请求地址修改为/user/login即可 + + + +~~~~java +@RestController +public class LoginController { + @Autowired + private LoginService loginService; + + @PostMapping("/user/login") + public ResponseResult login(@RequestBody User user){ + if(!StringUtils.hasText(user.getUserName())){ + //提示 必须要传用户名 + throw new SystemException(AppHttpCodeEnum.REQUIRE_USERNAME); + } + return loginService.login(user); + } + +} +~~~~ + + + +##### LoginService + +复制一份BlogLoginService命名为LoginService即可 + +~~~~java +public interface LoginService { + ResponseResult login(User user); + +} + +~~~~ + + + +##### SecurityConfig + +之前已经复制过了 + + + + + +##### SystemLoginServiceImpl + +复制一份，LoginServiceImpl，命名为SystemLoginServiceImpl 实现 LoginService + +login方法中存redis的key的前缀修改为login + +返回的数据中只要返回token + + + +~~~~java +@Service +public class SystemLoginServiceImpl implements LoginService { + + @Autowired + private AuthenticationManager authenticationManager; + + @Autowired + private RedisCache redisCache; + + @Override + public ResponseResult login(User user) { + UsernamePasswordAuthenticationToken authenticationToken = new UsernamePasswordAuthenticationToken(user.getUserName(),user.getPassword()); + Authentication authenticate = authenticationManager.authenticate(authenticationToken); + //判断是否认证通过 + if(Objects.isNull(authenticate)){ + throw new RuntimeException("用户名或密码错误"); + } + //获取userid 生成token + LoginUser loginUser = (LoginUser) authenticate.getPrincipal(); + String userId = loginUser.getUser().getId().toString(); + String jwt = JwtUtil.createJWT(userId); + //把用户信息存入redis + redisCache.setCacheObject("login:"+userId,loginUser); + + //把token封装 返回 + Map map = new HashMap<>(); + map.put("token",jwt); + return ResponseResult.okResult(map); + } +} +~~~~ + + + +##### UserDetailServiceImpl + +复用原来的即可 + +##### LoginUser + +复用原来的即可 + + + + + +### 5.2 后台权限控制及动态路由 + +#### 需求 + +​ 后台系统需要能实现不同的用户权限可以看到不同的功能。 + +​ 用户只能使用他的权限所允许使用的功能。 + + + +#### 功能设计 + +​ 之前在我的SpringSecurity的课程中就介绍过RBAC权限模型。没有学习过的可以去看下 [RBAC权限模型](https://www.bilibili.com/video/BV1mm4y1X7Hc?p=28) 。这里我们就是在RBAC权限模型的基础上去实现这个功能。 + +​ + +#### 表分析 + +​ 通过需求去分析需要有哪些字段。 + +​ 建表SQL及初始化数据见：SGBlog\资源\SQL\sg_menu.sql + + + +#### 接口设计 + +##### getInfo接口 + +是 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------- | --------------- | +| GET | /getInfo | 需要token请求头 | + +请求参数： + +无 + +响应格式: + +如果用户id为1代表管理员，roles 中只需要有admin，permissions中需要有所有菜单类型为C或者F的，状态为正常的，未被删除的权限 + +~~~~json +{ + "code":200, + "data":{ + "permissions":[ + "system:user:list", + "system:role:list", + "system:menu:list", + "system:user:query", + "system:user:add" + //此次省略1000字 + ], + "roles":[ + "admin" + ], + "user":{ + "avatar":"http://r7yxkqloa.bkt.clouddn.com/2022/03/05/75fd15587811443a9a9a771f24da458d.png", + "email":"23412332@qq.com", + "id":1, + "nickName":"sg3334", + "sex":"1" + } + }, + "msg":"操作成功" +} +~~~~ + + + +##### getRouters接口 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ----------- | --------------- | +| GET | /getRouters | 需要token请求头 | + +请求参数： + +无 + +响应格式: + +​ 前端为了实现动态路由的效果，需要后端有接口能返回用户所能访问的菜单数据。 + +​ 注意：**返回的菜单数据需要体现父子菜单的层级关系** + +​ 如果用户id为1代表管理员，menus中需要有所有菜单类型为C或者M的，状态为正常的，未被删除的权限 + +​ 数据格式如下： + +~~~~json +{ + "code":200, + "data":{ + "menus":[ + { + "children":[], + "component":"content/article/write/index", + "createTime":"2022-01-08 11:39:58", + "icon":"build", + "id":2023, + "menuName":"写博文", + "menuType":"C", + "orderNum":"0", + "parentId":0, + "path":"write", + "perms":"content:article:writer", + "status":"0", + "visible":"0" + }, + { + "children":[ + { + "children":[], + "component":"system/user/index", + "createTime":"2021-11-12 18:46:19", + "icon":"user", + "id":100, + "menuName":"用户管理", + "menuType":"C", + "orderNum":"1", + "parentId":1, + "path":"user", + "perms":"system:user:list", + "status":"0", + "visible":"0" + }, + { + "children":[], + "component":"system/role/index", + "createTime":"2021-11-12 18:46:19", + "icon":"peoples", + "id":101, + "menuName":"角色管理", + "menuType":"C", + "orderNum":"2", + "parentId":1, + "path":"role", + "perms":"system:role:list", + "status":"0", + "visible":"0" + }, + { + "children":[], + "component":"system/menu/index", + "createTime":"2021-11-12 18:46:19", + "icon":"tree-table", + "id":102, + "menuName":"菜单管理", + "menuType":"C", + "orderNum":"3", + "parentId":1, + "path":"menu", + "perms":"system:menu:list", + "status":"0", + "visible":"0" + } + ], + "createTime":"2021-11-12 18:46:19", + "icon":"system", + "id":1, + "menuName":"系统管理", + "menuType":"M", + "orderNum":"1", + "parentId":0, + "path":"system", + "perms":"", + "status":"0", + "visible":"0" + } + ] + }, + "msg":"操作成功" +} +~~~~ + + + +#### 代码实现 + +##### 准备工作 + +​ 生成menu和role表对于的类 + +##### getInfo接口 + + + +```java +@Data +@Accessors(chain = true) +@AllArgsConstructor +@NoArgsConstructor +public class AdminUserInfoVo { + + private List permissions; + + private List roles; + + private UserInfoVo user; +} +``` + + + +~~~~java +@RestController +public class LoginController { + @Autowired + private LoginService loginService; + + @Autowired + private MenuService menuService; + + @Autowired + private RoleService roleService; + + @PostMapping("/user/login") + public ResponseResult login(@RequestBody User user){ + if(!StringUtils.hasText(user.getUserName())){ + //提示 必须要传用户名 + throw new SystemException(AppHttpCodeEnum.REQUIRE_USERNAME); + } + return loginService.login(user); + } + + @GetMapping("getInfo") + public ResponseResult getInfo(){ + //获取当前登录的用户 + LoginUser loginUser = SecurityUtils.getLoginUser(); + //根据用户id查询权限信息 + List perms = menuService.selectPermsByUserId(loginUser.getUser().getId()); + //根据用户id查询角色信息 + List roleKeyList = roleService.selectRoleKeyByUserId(loginUser.getUser().getId()); + + //获取用户信息 + User user = loginUser.getUser(); + UserInfoVo userInfoVo = BeanCopyUtils.copyBean(user, UserInfoVo.class); + //封装数据返回 + + AdminUserInfoVo adminUserInfoVo = new AdminUserInfoVo(perms,roleKeyList,userInfoVo); + return ResponseResult.okResult(adminUserInfoVo); + } + +} +~~~~ + + + + + +RoleServiceImpl selectRoleKeyByUserId方法 + +~~~~java +@Service("menuService") +public class MenuServiceImpl extends ServiceImpl implements MenuService { + + @Override + public List selectPermsByUserId(Long id) { + //如果是管理员，返回所有的权限 + if(id == 1L){ + LambdaQueryWrapper wrapper = new LambdaQueryWrapper<>(); + wrapper.in(Menu::getMenuType,SystemConstants.MENU,SystemConstants.BUTTON); + wrapper.eq(Menu::getStatus,SystemConstants.STATUS_NORMAL); + List menus = list(wrapper); + List perms = menus.stream() + .map(Menu::getPerms) + .collect(Collectors.toList()); + return perms; + } + //否则返回所具有的权限 + return getBaseMapper().selectPermsByUserId(id); + } +} +~~~~ + +MenuMapper + +~~~~java +/** + * 菜单权限表(Menu)表数据库访问层 + * + * @author makejava + * @since 2022-08-09 22:32:07 + */ +public interface MenuMapper extends BaseMapper { + + List selectPermsByUserId(Long userId); +} + +~~~~ + +~~~~xml + + + + + + +~~~~ + + + + + +MenuServiceImpl selectPermsByUserId方法 + +~~~~java +@Service("roleService") +public class RoleServiceImpl extends ServiceImpl implements RoleService { + + @Override + public List selectRoleKeyByUserId(Long id) { + //判断是否是管理员 如果是返回集合中只需要有admin + if(id == 1L){ + List roleKeys = new ArrayList<>(); + roleKeys.add("admin"); + return roleKeys; + } + //否则查询用户所具有的角色信息 + return getBaseMapper().selectRoleKeyByUserId(id); + } +} +~~~~ + +~~~~java +public interface RoleMapper extends BaseMapper { + + List selectRoleKeyByUserId(Long userId); +} + +~~~~ + +~~~~xml + + + + + +~~~~ + + + + + +##### getRouters接口 + +RoutersVo + +~~~~java +@Data +@AllArgsConstructor +@NoArgsConstructor +public class RoutersVo { + + private List menus; +} + +~~~~ + + + +LoginController + +~~~~java + @GetMapping("getRouters") + public ResponseResult getRouters(){ + Long userId = SecurityUtils.getUserId(); + //查询menu 结果是tree的形式 + List menus = menuService.selectRouterMenuTreeByUserId(userId); + //封装数据返回 + return ResponseResult.okResult(new RoutersVo(menus)); + } + +~~~~ + +MenuService + +~~~~java +public interface MenuService extends IService { + + List selectPermsByUserId(Long id); + + List selectRouterMenuTreeByUserId(Long userId); +} + +~~~~ + +MenuServiceImpl + +~~~~java +@Override + public List selectRouterMenuTreeByUserId(Long userId) { + MenuMapper menuMapper = getBaseMapper(); + List menus = null; + //判断是否是管理员 + if(SecurityUtils.isAdmin()){ + //如果是 获取所有符合要求的Menu + menus = menuMapper.selectAllRouterMenu(); + }else{ + //否则 获取当前用户所具有的Menu + menus = menuMapper.selectRouterMenuTreeByUserId(userId); + } + + //构建tree + //先找出第一层的菜单 然后去找他们的子菜单设置到children属性中 + List menuTree = builderMenuTree(menus,0L); + return menuTree; + } + + private List builderMenuTree(List menus, Long parentId) { + List menuTree = menus.stream() + .filter(menu -> menu.getParentId().equals(parentId)) + .map(menu -> menu.setChildren(getChildren(menu, menus))) + .collect(Collectors.toList()); + return menuTree; + } + + /** + * 获取存入参数的 子Menu集合 + * @param menu + * @param menus + * @return + */ + private List getChildren(Menu menu, List menus) { + List childrenList = menus.stream() + .filter(m -> m.getParentId().equals(menu.getId())) + .map(m->m.setChildren(getChildren(m,menus))) + .collect(Collectors.toList()); + return childrenList; + } +~~~~ + +MenuMapper.java + +~~~~java + List selectAllRouterMenu(); + + List selectRouterMenuTreeByUserId(Long userId); +~~~~ + + + +MenuMapper.xml + +~~~~xml + + +~~~~ + + + +查询的列： + +SELECT DISTINCT m.id, m.parent_id, m.menu_name, m.path, m.component, m.visible, m.status, IFNULL(m.perms,'') AS perms, m.is_frame, m.menu_type, m.icon, m.order_num, m.create_time + +注意需要按照parent_id和order_num排序 + + + + + +### 5.3 退出登录接口 + +#### 5.3.1 接口设计 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ------------ | --------------- | +| POST | /user/logout | 需要token请求头 | + +响应格式: + +~~~~json +{ + "code": 200, + "msg": "操作成功" +} +~~~~ + + + +#### 5.3.2 代码实现 + +要实现的操作： + +​ 删除redis中的用户信息 + +LoginController + +~~~~java + @PostMapping("/user/logout") + public ResponseResult logout(){ + return loginServce.logout(); + } +~~~~ + +LoginService + +~~~~java +ResponseResult logout(); +~~~~ + +SystemLoginServiceImpl + +~~~~java + @Override + public ResponseResult logout() { + //获取当前登录的用户id + Long userId = SecurityUtils.getUserId(); + //删除redis中对应的值 + redisCache.deleteObject("login:"+userId); + return ResponseResult.okResult(); + } +~~~~ + +SecurityConfig + +要关闭默认的退出登录功能。并且要配置我们的退出登录接口需要认证才能访问 + +~~~~java + @Override + protected void configure(HttpSecurity http) throws Exception { + http + //关闭csrf + .csrf().disable() + //不通过Session获取SecurityContext + .sessionManagement().sessionCreationPolicy(SessionCreationPolicy.STATELESS) + .and() + .authorizeRequests() + // 对于登录接口 允许匿名访问 + .antMatchers("/user/login").anonymous() +// //注销接口需要认证才能访问 +// .antMatchers("/logout").authenticated() +// .antMatchers("/user/userInfo").authenticated() +// .antMatchers("/upload").authenticated() + // 除上面外的所有请求全部不需要认证即可访问 + .anyRequest().authenticated(); + + //配置异常处理器 + http.exceptionHandling() + .authenticationEntryPoint(authenticationEntryPoint) + .accessDeniedHandler(accessDeniedHandler); + //关闭默认的注销功能 + http.logout().disable(); + //把jwtAuthenticationTokenFilter添加到SpringSecurity的过滤器链中 + http.addFilterBefore(jwtAuthenticationTokenFilter, UsernamePasswordAuthenticationFilter.class); + //允许跨域 + http.cors(); + } +~~~~ + + + + + + + + + + + +### 5.4 查询标签列表 + +#### 5.4.0 需求 + +​ 为了方便后期对文章进行管理，需要提供标签的功能，一个文章可以有多个标签。 + +​ 在后台需要分页查询标签功能，要求能根据标签名进行分页查询。 **后期可能会增加备注查询等需求**。 + +​ 注意：不能把删除了的标签查询出来。 + +#### 5.4.1 标签表分析 + +​ 通过需求去分析需要有哪些字段。 + +#### 5.4.2 接口设计 + + + +| 请求方式 | 请求路径 | +| -------- | ---------------- | +| Get | content/tag/list | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +name：标签名 + +remark：备注 + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "rows":[ + { + "id":4, + "name":"Java", + "remark":"sdad" + } + ], + "total":1 + }, + "msg":"操作成功" +} +~~~~ + + + +#### 5.4.3 代码实现 + +Controller + +~~~~java +@RestController +@RequestMapping("/content/tag") +public class TagController { + @Autowired + private TagService tagService; + + @GetMapping("/list") + public ResponseResult list(Integer pageNum, Integer pageSize, TagListDto tagListDto){ + return tagService.pageTagList(pageNum,pageSize,tagListDto); + } +} + + +~~~~ + + + +Service + +```java +public interface TagService extends IService { + + ResponseResult pageTagList(Integer pageNum, Integer pageSize, TagListDto tagListDto); +} + +``` + +~~~~java +@Service("tagService") +public class TagServiceImpl extends ServiceImpl implements TagService { + + @Override + public ResponseResult pageTagList(Integer pageNum, Integer pageSize, TagListDto tagListDto) { + //分页查询 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + queryWrapper.eq(StringUtils.hasText(tagListDto.getName()),Tag::getName,tagListDto.getName()); + queryWrapper.eq(StringUtils.hasText(tagListDto.getRemark()),Tag::getRemark,tagListDto.getRemark()); + + Page page = new Page<>(); + page.setCurrent(pageNum); + page.setSize(pageSize); + page(page, queryWrapper); + //封装数据返回 + PageVo pageVo = new PageVo(page.getRecords(),page.getTotal()); + return ResponseResult.okResult(pageVo); + } +} +~~~~ + + + +### 5.5 新增标签 + +#### 5.5.0 需求 + +​ 点击标签管理的新增按钮可以实现新增标签的功能。 + +#### 5.5.1 接口设计 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ------------ | --------------- | +| POST | /content/tag | 需要token请求头 | + +请求体格式: + +~~~~json +{"name":"c#","remark":"c++++"} +~~~~ + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +#### 5.5.2 测试 + +测试时注意，添加到数据库中的记录有没有 创建时间，更新时间，创建人，更新人字段。 + + + + + +### 5.6 删除标签 + +#### 5.6.1 接口设计 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ----------------- | --------------- | +| DELETE | /content/tag/{id} | 需要token请求头 | + +请求参数在path中 + +例如：content/tag/6 代表删除id为6的标签数据 + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +#### 5.6.2 测试 + +注意测试删除后在列表中是否查看不到该条数据 + +数据库中该条数据还是存在的，只是修改了逻辑删除字段的值 + + + + + +### 5.7 修改标签 + +#### 5.7.1 接口设计 + +##### 5.7.1.1 获取标签信息 + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ----------------- | --------------- | +| GET | /content/tag/{id} | 需要token请求头 | + +请求参数在path中 + +例如：content/tag/6 代表获取id为6的标签数据 + + + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "id":4, + "name":"Java", + "remark":"sdad" + }, + "msg":"操作成功" +} +~~~~ + + + +##### 5.7.1.2 修改标签接口 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ------------ | --------------- | +| PUT | /content/tag | 需要token请求头 | + +请求体格式： + +~~~~json +{"id":7,"name":"c#","remark":"c++++"} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.8 写博文 + +#### 5.8.1 需求 + +​ 需要提供写博文的功能，写博文时需要关联分类和标签。 + +​ 可以上传缩略图，也可以在正文中添加图片。 + +​ 文章可以直接发布，也可以保存到草稿箱。 + + + +#### 5.8.2 表分析 + +​ 标签和文章需要关联所以需要一张关联表。 + +​ SQL脚本：SGBlog\资源\SQL\sg_article_tag.sql + + + +#### 5.8.2 接口设计 + +​ 思考下需要哪些接口才能实现这个功能？ + + + +##### 5.8.2.1 查询所有分类接口 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | --------------------------------- | --------------- | +| GET | /content/category/listAllCategory | 需要token请求头 | + +请求参数： + +​ 无 + + + + + +响应格式： + +~~~~json +{ + "code":200, + "data":[ + { + "description":"wsd", + "id":1, + "name":"java" + }, + { + "description":"wsd", + "id":2, + "name":"PHP" + } + ], + "msg":"操作成功" +} +~~~~ + + + +##### 5.8.2.2 查询所有标签接口 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ----------------------- | --------------- | +| GET | /content/tag/listAllTag | 需要token请求头 | + +请求参数: + +​ 无 + +响应格式： + +~~~~json +{ + "code":200, + "data":[ + { + "id":1, + "name":"Mybatis" + }, + { + "id":4, + "name":"Java" + } + ], + "msg":"操作成功" +} +~~~~ + + + + + +##### 5.8.2.3 上传图片 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | -------- | --------------- | +| POST | /upload | 需要token请求头 | + +参数： + +​ img,值为要上传的文件 + +请求头： + +​ Content-Type ：multipart/form-data; + + + +响应格式: + +~~~~json +{ + "code": 200, + "data": "文件访问链接", + "msg": "操作成功" +} +~~~~ + + + +##### 5.8.2.4 新增博文 + + + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ---------------- | --------------- | +| POST | /content/article | 需要token请求头 | + +请求体格式： + +~~~~json +{ + "title":"测试新增博文", + "thumbnail":"https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/08/21/4ceebc07e7484beba732f12b0d2c43a9.png", + "isTop":"0", + "isComment":"0", + "content":"# 一级标题\n## 二级标题\n![Snipaste_20220228_224837.png](https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/08/21/c3af554d4a0f4935b4073533a4c26ee8.png)\n正文", + "tags":[ + 1, + 4 + ], + "categoryId":1, + "summary":"哈哈", + "status":"1" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +#### 5.8.3 代码实现 + + + +##### 5.8.3.1 查询所有分类接口 + +CategoryController + + + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +@RestController +@RequestMapping("/content/category") +public class CategoryController { + @Autowired + private CategoryService categoryService; + + @GetMapping("/listAllCategory") + public ResponseResult listAllCategory(){ + List list = categoryService.listAllCategory(); + return ResponseResult.okResult(list); + } + + +} + +~~~~ + + + +CategoryVo修改,增加description属性 + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class CategoryVo { + + private Long id; + private String name; + //描述 + private String description; +} +~~~~ + +CategoryService增加listAllCategory方法 + +~~~~java +public interface CategoryService extends IService { + + + ResponseResult getCategoryList(); + + List listAllCategory(); +} + +~~~~ + +SystemConstants中增加常量 + +~~~~java + /** 正常状态 */ + public static final String NORMAL = "0"; +~~~~ + + + + + +CategoryServiceImpl增加方法 + +~~~~java + @Override + public List listAllCategory() { + LambdaQueryWrapper wrapper = new LambdaQueryWrapper<>(); + wrapper.eq(Category::getStatus, SystemConstants.NORMAL); + List list = list(wrapper); + List categoryVos = BeanCopyUtils.copyBeanList(list, CategoryVo.class); + return categoryVos; + } +~~~~ + + + + + +##### 5.8.3.2 查询所有标签接口 + +TagVo + +~~~~java +@Data +@AllArgsConstructor +@NoArgsConstructor +public class TagVo { + private Long id; + + //标签名 + private String name; + + + +} + +~~~~ + + + +TagController + +~~~~java + @GetMapping("/listAllTag") + public ResponseResult listAllTag(){ + List list = tagService.listAllTag(); + return ResponseResult.okResult(list); + } +~~~~ + + + +TagService 增加listAllTag方法 + +~~~~java +List listAllTag(); + +~~~~ + +TagServiceImpl + +~~~~java + @Override + public List listAllTag() { + LambdaQueryWrapper wrapper = new LambdaQueryWrapper<>(); + wrapper.select(Tag::getId,Tag::getName); + List list = list(wrapper); + List tagVos = BeanCopyUtils.copyBeanList(list, TagVo.class); + return tagVos; + } +~~~~ + + + + + +##### 5.8.3.3 上传图片接口 + +在sangeng-admin中增加UploadController + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +@RestController +public class UploadController { + + @Autowired + private UploadService uploadService; + + @PostMapping("/upload") + public ResponseResult uploadImg(@RequestParam("img") MultipartFile multipartFile) { + try { + return uploadService.uploadImg(multipartFile); + } catch (IOException e) { + e.printStackTrace(); + throw new RuntimeException("文件上传上传失败"); + } + } +} +~~~~ + + + + + + + +##### 5.8.3.4 新增博文接口 + + + +ArticleController + +~~~~java +/** + * @Author 三更 B站： https://space.bilibili.com/663528522 + */ +@RestController +@RequestMapping("/content/article") +public class ArticleController { + + @Autowired + private ArticleService articleService; + + @PostMapping + public ResponseResult add(@RequestBody AddArticleDto article){ + return articleService.add(article); + } + + +} + +~~~~ + + + +AddArticleDto + +注意增加tags属性用于接收文章关联标签的id + +~~~~java +@Data +@AllArgsConstructor +@NoArgsConstructor +public class AddArticleDto { + + private Long id; + //标题 + private String title; + //文章内容 + private String content; + //文章摘要 + private String summary; + //所属分类id + private Long categoryId; + + //缩略图 + private String thumbnail; + //是否置顶（0否，1是） + private String isTop; + //状态（0已发布，1草稿） + private String status; + //访问量 + private Long viewCount; + //是否允许评论 1是，0否 + private String isComment; + private List tags; + +} + +~~~~ + + + + + + + +Article 修改这样创建时间创建人修改时间修改人可以自动填充 + +~~~~java + @TableField(fill = FieldFill.INSERT) + private Long createBy; + @TableField(fill = FieldFill.INSERT) + private Date createTime; + @TableField(fill = FieldFill.INSERT_UPDATE) + private Long updateBy; + @TableField(fill = FieldFill.INSERT_UPDATE) + private Date updateTime; +~~~~ + + + + + +ArticleService增加方法 + +~~~~java +ResponseResult add(AddArticleDto article); +~~~~ + + + +创建ArticleTag表相关的实体类，mapper，service,serviceimpl等 + +```java +@TableName(value="sg_article_tag") +@Data +@AllArgsConstructor +@NoArgsConstructor +public class ArticleTag implements Serializable { + private static final long serialVersionUID = 625337492348897098L; + + /** + * 文章id + */ + private Long articleId; + /** + * 标签id + */ + private Long tagId; + + + +} +``` + + + + + +ArticleServiceImpl增加如下代码 + +~~~~java + @Autowired + private ArticleTagService articleTagService; + + @Override + @Transactional + public ResponseResult add(AddArticleDto articleDto) { + //添加 博客 + Article article = BeanCopyUtils.copyBean(articleDto, Article.class); + save(article); + + + List articleTags = articleDto.getTags().stream() + .map(tagId -> new ArticleTag(article.getId(), tagId)) + .collect(Collectors.toList()); + + //添加 博客和标签的关联 + articleTagService.saveBatch(articleTags); + return ResponseResult.okResult(); + } +~~~~ + + + + + + + +### 5.9 导出所有分类到Excel + +#### 5.9.1 需求 + + + +​ 在分类管理中点击导出按钮可以把所有的分类导出到Excel文件中。 + +​ + +#### 5.9.2 技术方案 + +​ 使用EasyExcel实现Excel的导出操作。 + +​ https://github.com/alibaba/easyexcel + +​ https://easyexcel.opensource.alibaba.com/docs/current/quickstart/write#%E7%A4%BA%E4%BE%8B%E4%BB%A3%E7%A0%81-1 + +#### 5.9.3 接口设计 + +​ + +| 请求方式 | 请求地址 | 请求头 | +| -------- | ------------------------ | --------------- | +| GET | /content/category/export | 需要token请求头 | + +请求参数： + +​ 无 + + + + + +响应格式： + +成功的话可以直接导出一个Excel文件 + + + +失败的话响应格式如下： + +~~~~json +{ + "code":500, + "msg":"出现错误" +} +~~~~ + + + +#### 5.9.4 代码实现 + +工具类方法修改 + +WebUtils + +~~~~java + public static void setDownLoadHeader(String filename, HttpServletResponse response) throws UnsupportedEncodingException { + response.setContentType("application/vnd.openxmlformats-officedocument.spreadsheetml.sheet"); + response.setCharacterEncoding("utf-8"); + String fname= URLEncoder.encode(filename,"UTF-8").replaceAll("\\+", "%20"); + response.setHeader("Content-disposition","attachment; filename="+fname); + } +~~~~ + + + +CategoryController + +~~~~java + @GetMapping("/export") + public void export(HttpServletResponse response){ + try { + //设置下载文件的请求头 + WebUtils.setDownLoadHeader("分类.xlsx",response); + //获取需要导出的数据 + List categoryVos = categoryService.list(); + + List excelCategoryVos = BeanCopyUtils.copyBeanList(categoryVos, ExcelCategoryVo.class); + //把数据写入到Excel中 + EasyExcel.write(response.getOutputStream(), ExcelCategoryVo.class).autoCloseStream(Boolean.FALSE).sheet("分类导出") + .doWrite(excelCategoryVos); + + } catch (Exception e) { + //如果出现异常也要响应json + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR); + WebUtils.renderString(response, JSON.toJSONString(result)); + } + } +~~~~ + + + + + +ExcelCategoryVo + +~~~~java +@Data +@NoArgsConstructor +@AllArgsConstructor +public class ExcelCategoryVo { + @ExcelProperty("分类名") + private String name; + //描述 + @ExcelProperty("描述") + private String description; + + //状态0:正常,1禁用 + @ExcelProperty("状态0:正常,1禁用") + private String status; +} + +~~~~ + + + +### 5.10 权限控制 + +#### 5.10.1 需求 + +​ 需要对导出分类的接口做权限控制。 + +sg eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiJkZGJkNjM5MWJiZTA0NmMzOTc4NDg1ZTcxNWQ3YjQ0MSIsInN1YiI6IjEiLCJpc3MiOiJzZyIsImlhdCI6MTY2MjI0NDE4NywiZXhwIjoxNjYyMzMwNTg3fQ.z4JGwFN3lWyVbOCbhikCe-O4D6SvCQFEE5eQY3jDJkw + +sangeng + +eyJhbGciOiJIUzI1NiJ9.eyJqdGkiOiI0Y2I1ZjhmMTc0Mjk0NzM0YjI4Y2M1NTQzYjQ2Yjc1YyIsInN1YiI6IjYiLCJpc3MiOiJzZyIsImlhdCI6MTY2MjI0NDQzMywiZXhwIjoxNjYyMzMwODMzfQ.yEkbyGYXBp5ndnyq-3acdgpvqx2mnI8B9fK9f3Y6Jco + +#### 5.10.2 代码实现 + + + +SecurityConfig + +~~~~java +@EnableGlobalMethodSecurity(prePostEnabled = true) +~~~~ + + + + + +UserDetailsServiceImpl + +~~~~java +@Service +public class UserDetailsServiceImpl implements UserDetailsService { + + @Autowired + private UserMapper userMapper; + + @Autowired + private MenuMapper menuMapper; + + @Override + public UserDetails loadUserByUsername(String username) throws UsernameNotFoundException { + //根据用户名查询用户信息 + LambdaQueryWrapper queryWrapper = new LambdaQueryWrapper<>(); + queryWrapper.eq(User::getUserName,username); + User user = userMapper.selectOne(queryWrapper); + //判断是否查到用户 如果没查到抛出异常 + if(Objects.isNull(user)){ + throw new RuntimeException("用户不存在"); + } + //返回用户信息 + if(user.getType().equals(SystemConstants.ADMAIN)){ + List list = menuMapper.selectPermsByUserId(user.getId()); + return new LoginUser(user,list); + } + return new LoginUser(user,null); + } +} + +~~~~ + + + +LoginUser + +增加属性 + +~~~~java +private List permissions; +~~~~ + + + + + +PermissionService + +hasPermisson + +~~~~java + +@Service("ps") +public class PermissionService { + + /** + * 判断当前用户是否具有permission + * @param permission 要判断的权限 + * @return + */ + public boolean hasPermission(String permission){ + //如果是超级管理员 直接返回true + if(SecurityUtils.isAdmin()){ + return true; + } + //否则 获取当前登录用户所具有的权限列表 如何判断是否存在permission + List permissions = SecurityUtils.getLoginUser().getPermissions(); + return permissions.contains(permission); + } +} +~~~~ + + + +CategoryController + +~~~~java + + @PreAuthorize("@ps.hasPermission('content:category:export')") + @GetMapping("/export") + public void export(HttpServletResponse response){ + try { + //设置下载文件的请求头 + WebUtils.setDownLoadHeader("分类.xlsx",response); + //获取需要导出的数据 + List categoryVos = categoryService.list(); + + List excelCategoryVos = BeanCopyUtils.copyBeanList(categoryVos, ExcelCategoryVo.class); + //把数据写入到Excel中 + EasyExcel.write(response.getOutputStream(), ExcelCategoryVo.class).autoCloseStream(Boolean.FALSE).sheet("分类导出") + .doWrite(excelCategoryVos); + + } catch (Exception e) { + //如果出现异常也要响应json + ResponseResult result = ResponseResult.errorResult(AppHttpCodeEnum.SYSTEM_ERROR); + WebUtils.renderString(response, JSON.toJSONString(result)); + } + } +~~~~ + + + + + +### 5.11 文章列表 + +#### 5.10.1 需求 + +​ 为了对文章进行管理，需要提供文章列表， + +​ 在后台需要分页查询文章功能，要求能根据标题和摘要**模糊查询**。 + +​ 注意：不能把删除了的文章查询出来 + + + +#### 5.10.2 接口设计 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | --------------------- | --------------- | +| Get | /content/article/list | 是 | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +title：文章标题 + +summary：文章摘要 + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "rows":[ + { + "categoryId":"1", + "content":"嘻嘻嘻嘻嘻嘻", + "createTime":"2022-01-24 07:20:11", + "id":"1", + "isComment":"0", + "isTop":"1", + "status":"0", + "summary":"SpringSecurity框架教程-Spring Security+JWT实现项目级前端分离认证授权", + "thumbnail":"https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/01/31/948597e164614902ab1662ba8452e106.png", + "title":"SpringSecurity从入门到精通", + "viewCount":"161" + } + ], + "total":"1" + }, + "msg":"操作成功" +} +~~~~ + + + +​ + +### 5.12 修改文章 + +#### 5.12.1 需求 + +​ 点击文章列表中的修改按钮可以跳转到写博文页面。回显示该文章的具体信息。 + +​ 用户可以在该页面修改文章信息。点击更新按钮后修改文章。 + + + + + +#### 5.12.2 分析 + +​ 这个功能的实现首先需要能够根据文章id查询文章的详细信息这样才能实现文章的回显。 + +​ 如何需要提供更新文章的接口。 + + + +#### 5.12.3 接口设计 + +##### 5.12.3.1 查询文章详情接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | -------------------- | --------------- | +| Get | content/article/{id} | 是 | + +Path格式请求参数： + +id: 文章id + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "categoryId":"1", + "content":"xxxxxxx", + "createBy":"1", + "createTime":"2022-08-28 15:15:46", + "delFlag":0, + "id":"10", + "isComment":"0", + "isTop":"1", + "status":"0", + "summary":"啊实打实", + "tags":[ + "1", + "4", + "5" + ], + "thumbnail":"https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/08/28/7659aac2b74247fe8ebd9e054b916dbf.png", + "title":"委屈饿驱蚊器", + "updateBy":"1", + "updateTime":"2022-08-28 15:15:46", + "viewCount":"0" + }, + "msg":"操作成功" +} +~~~~ + + + +##### 5.12.3.2 更新文章接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | --------------- | --------------- | +| PUT | content/article | 是 | + +请求体参数格式： + +~~~~json +{ + "categoryId":"1", + "content":"![Snipaste_20220228_224837.png](https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/08/28/f3938a0368c540ee909ba7f7079a829a.png)\n\n# 十大\n## 时代的", + "createBy":"1", + "createTime":"2022-08-28 15:15:46", + "delFlag":0, + "id":"10", + "isComment":"0", + "isTop":"1", + "status":"0", + "summary":"啊实打实2", + "tags":[ + "1", + "4", + "5" + ], + "thumbnail":"https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/08/28/7659aac2b74247fe8ebd9e054b916dbf.png", + "title":"委屈饿驱蚊器", + "updateBy":"1", + "updateTime":"2022-08-28 15:15:46", + "viewCount":"0" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.13 删除文章 + +#### 5.13.1 需求 + +​ 点击文章后面的删除按钮可以删除该文章 + +​ 注意：是逻辑删除不是物理删除 + +#### 5.13.2 接口设计 + +​ + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | -------------------- | --------------- | +| DELETE | content/article/{id} | 是 | + +Path请求参数： + +id：要删除的文章id + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + + + +### 5.14 菜单列表 + +#### 5.14.1 需求 + +​ 需要展示菜单列表，不需要分页。 + +​ 可以针对菜单名进行模糊查询 + +​ 也可以针对菜单的状态进行查询。 + +​ 菜单要按照父菜单id和orderNum进行排序 + +#### 5.14.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------- | --------------- | +| GET | system/menu/list | 是 | + +Query请求参数： + +status : 状态 + +menuName： 菜单名 + +响应格式： + +~~~~json +{ + "code":200, + "data":[ + { + "component":"content/article/write/index", + "icon":"build", + "id":"2023", + "isFrame":1, + "menuName":"写博文", + "menuType":"C", + "orderNum":0, + "parentId":"0", + "path":"write", + "perms":"content:article:writer", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "icon":"system", + "id":"1", + "isFrame":1, + "menuName":"系统管理", + "menuType":"M", + "orderNum":1, + "parentId":"0", + "path":"system", + "perms":"", + "remark":"系统管理目录", + "status":"0", + "visible":"0" + }, + { + "icon":"table", + "id":"2017", + "isFrame":1, + "menuName":"内容管理", + "menuType":"M", + "orderNum":4, + "parentId":"0", + "path":"content", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"system/user/index", + "icon":"user", + "id":"100", + "isFrame":1, + "menuName":"用户管理", + "menuType":"C", + "orderNum":1, + "parentId":"1", + "path":"user", + "perms":"system:user:list", + "remark":"用户管理菜单", + "status":"0", + "visible":"0" + }, + { + "component":"system/role/index", + "icon":"peoples", + "id":"101", + "isFrame":1, + "menuName":"角色管理", + "menuType":"C", + "orderNum":2, + "parentId":"1", + "path":"role", + "perms":"system:role:list", + "remark":"角色管理菜单", + "status":"0", + "visible":"0" + }, + { + "component":"system/menu/index", + "icon":"tree-table", + "id":"102", + "isFrame":1, + "menuName":"菜单管理", + "menuType":"C", + "orderNum":3, + "parentId":"1", + "path":"menu", + "perms":"system:menu:list", + "remark":"菜单管理菜单", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1001", + "isFrame":1, + "menuName":"用户查询", + "menuType":"F", + "orderNum":1, + "parentId":"100", + "path":"", + "perms":"system:user:query", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1002", + "isFrame":1, + "menuName":"用户新增", + "menuType":"F", + "orderNum":2, + "parentId":"100", + "path":"", + "perms":"system:user:add", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1003", + "isFrame":1, + "menuName":"用户修改", + "menuType":"F", + "orderNum":3, + "parentId":"100", + "path":"", + "perms":"system:user:edit", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1004", + "isFrame":1, + "menuName":"用户删除", + "menuType":"F", + "orderNum":4, + "parentId":"100", + "path":"", + "perms":"system:user:remove", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1005", + "isFrame":1, + "menuName":"用户导出", + "menuType":"F", + "orderNum":5, + "parentId":"100", + "path":"", + "perms":"system:user:export", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1006", + "isFrame":1, + "menuName":"用户导入", + "menuType":"F", + "orderNum":6, + "parentId":"100", + "path":"", + "perms":"system:user:import", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1007", + "isFrame":1, + "menuName":"重置密码", + "menuType":"F", + "orderNum":7, + "parentId":"100", + "path":"", + "perms":"system:user:resetPwd", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1008", + "isFrame":1, + "menuName":"角色查询", + "menuType":"F", + "orderNum":1, + "parentId":"101", + "path":"", + "perms":"system:role:query", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1009", + "isFrame":1, + "menuName":"角色新增", + "menuType":"F", + "orderNum":2, + "parentId":"101", + "path":"", + "perms":"system:role:add", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1010", + "isFrame":1, + "menuName":"角色修改", + "menuType":"F", + "orderNum":3, + "parentId":"101", + "path":"", + "perms":"system:role:edit", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1011", + "isFrame":1, + "menuName":"角色删除", + "menuType":"F", + "orderNum":4, + "parentId":"101", + "path":"", + "perms":"system:role:remove", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1012", + "isFrame":1, + "menuName":"角色导出", + "menuType":"F", + "orderNum":5, + "parentId":"101", + "path":"", + "perms":"system:role:export", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1013", + "isFrame":1, + "menuName":"菜单查询", + "menuType":"F", + "orderNum":1, + "parentId":"102", + "path":"", + "perms":"system:menu:query", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1014", + "isFrame":1, + "menuName":"菜单新增", + "menuType":"F", + "orderNum":2, + "parentId":"102", + "path":"", + "perms":"system:menu:add", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1015", + "isFrame":1, + "menuName":"菜单修改", + "menuType":"F", + "orderNum":3, + "parentId":"102", + "path":"", + "perms":"system:menu:edit", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"", + "icon":"#", + "id":"1016", + "isFrame":1, + "menuName":"菜单删除", + "menuType":"F", + "orderNum":4, + "parentId":"102", + "path":"", + "perms":"system:menu:remove", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"content/article/index", + "icon":"build", + "id":"2019", + "isFrame":1, + "menuName":"文章管理", + "menuType":"C", + "orderNum":0, + "parentId":"2017", + "path":"article", + "perms":"content:article:list", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"content/category/index", + "icon":"example", + "id":"2018", + "isFrame":1, + "menuName":"分类管理", + "menuType":"C", + "orderNum":1, + "parentId":"2017", + "path":"category", + "perms":"content:category:list", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"content/link/index", + "icon":"404", + "id":"2022", + "isFrame":1, + "menuName":"友链管理", + "menuType":"C", + "orderNum":4, + "parentId":"2017", + "path":"link", + "perms":"content:link:list", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "component":"content/tag/index", + "icon":"button", + "id":"2021", + "isFrame":1, + "menuName":"标签管理", + "menuType":"C", + "orderNum":6, + "parentId":"2017", + "path":"tag", + "perms":"content:tag:index", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "icon":"#", + "id":"2028", + "isFrame":1, + "menuName":"导出分类", + "menuType":"F", + "orderNum":1, + "parentId":"2018", + "path":"", + "perms":"content:category:export", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "icon":"#", + "id":"2024", + "isFrame":1, + "menuName":"友链新增", + "menuType":"F", + "orderNum":0, + "parentId":"2022", + "path":"", + "perms":"content:link:add", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "icon":"#", + "id":"2025", + "isFrame":1, + "menuName":"友链修改", + "menuType":"F", + "orderNum":1, + "parentId":"2022", + "path":"", + "perms":"content:link:edit", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "icon":"#", + "id":"2026", + "isFrame":1, + "menuName":"友链删除", + "menuType":"F", + "orderNum":1, + "parentId":"2022", + "path":"", + "perms":"content:link:remove", + "remark":"", + "status":"0", + "visible":"0" + }, + { + "icon":"#", + "id":"2027", + "isFrame":1, + "menuName":"友链查询", + "menuType":"F", + "orderNum":2, + "parentId":"2022", + "path":"", + "perms":"content:link:query", + "remark":"", + "status":"0", + "visible":"0" + } + ], + "msg":"操作成功" +} +~~~~ + + + + + +### 5.15 新增菜单 + +#### 5.15.1 需求 + +​ 可以新增菜单 + +#### 5.15.2 接口设计 + +​ + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | --------------- | --------------- | +| POST | content/article | 是 | + +请求体参数： + +​ Menu类对应的json格式 + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +### 5.16 修改菜单 + +#### 5.16.1 需求 + +​ 能够修改菜单，但是修改的时候不能把父菜单设置为当前菜单，如果设置了需要给出相应的提示。并且修改失败。 + +#### 5.16.2 接口设计 + +##### 5.16.2.1 根据id查询菜单数据 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------- | --------------- | +| Get | system/menu/{id} | 是 | + +Path格式请求参数： + +id: 菜单id + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "icon":"table", + "id":"2017", + "menuName":"内容管理", + "menuType":"M", + "orderNum":"4", + "parentId":"0", + "path":"content", + "remark":"", + "status":"0", + "visible":"0" + }, + "msg":"操作成功" +} +~~~~ + + + +##### 5.16.2.2 更新菜单 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------- | --------------- | +| PUT | system/menu | 是 | + +请求体参数： + +​ Menu类对应的json格式 + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + +如果把父菜单设置为当前菜单: + +~~~~java +{ + "code":500, + "msg":"修改菜单'写博文'失败，上级菜单不能选择自己" +} +~~~~ + + + +### 5.17 删除菜单 + +#### 5.17.1 需求 + +​ 能够删除菜单，但是如果要删除的菜单有子菜单则提示：存在子菜单不允许删除 并且删除失败。 + +#### 5.17.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------------------ | --------------- | +| DELETE | content/article/{menuId} | 是 | + +Path参数： + +menuId：要删除菜单的id + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + +如果要删除的菜单有子菜单则 + +~~~~java +{ + "code":500, + "msg":"存在子菜单不允许删除" +} +~~~~ + + + + + +### 5.18 角色列表 + +#### 5.18.1 需求 + +​ 需要有角色列表分页查询的功能。 + +​ 要求能够针对角色名称进行模糊查询。 + +​ 要求能够针对状态进行查询。 + +​ 要求按照role_sort进行升序排列。 + +#### 5.18.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------- | --------------- | +| GET | system/role/list | 是 | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +roleName：角色名称 + +status：状态 + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "rows":[ + { + "id":"12", + "roleKey":"link", + "roleName":"友链审核员", + "roleSort":"1", + "status":"0" + } + ], + "total":"1" + }, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.19 改变角色状态 + +#### 5.19.1 需求 + +​ 要求能够修改角色的停启用状态 + +#### 5.19.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------------------ | --------------- | +| PUT | system/role/changeStatus | 是 | + +请求体： + +~~~~json +{"roleId":"11","status":"1"} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.20 新增角色！！ + +#### 5.20.1 需求 + +​ 需要提供新增角色的功能。新增角色时能够直接设置角色所关联的菜单权限。 + +#### 5.20.2 接口设计 + +##### 5.20.2.1 获取菜单树接口 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------------------- | --------------- | +| GET | /system/menu/treeselect | 是 | + +无需请求参数 + +响应格式： + +~~~~json +{ + "code":200, + "data":[ + { + "children":[], + "id":"2023", + "label":"写博文", + "parentId":"0" + }, + { + "children":[ + { + "children":[ + { + "children":[], + "id":"1001", + "label":"用户查询", + "parentId":"100" + }, + { + "children":[], + "id":"1002", + "label":"用户新增", + "parentId":"100" + }, + { + "children":[], + "id":"1003", + "label":"用户修改", + "parentId":"100" + }, + { + "children":[], + "id":"1004", + "label":"用户删除", + "parentId":"100" + }, + { + "children":[], + "id":"1005", + "label":"用户导出", + "parentId":"100" + }, + { + "children":[], + "id":"1006", + "label":"用户导入", + "parentId":"100" + }, + { + "children":[], + "id":"1007", + "label":"重置密码", + "parentId":"100" + } + ], + "id":"100", + "label":"用户管理", + "parentId":"1" + }, + { + "children":[ + { + "children":[], + "id":"1008", + "label":"角色查询", + "parentId":"101" + }, + { + "children":[], + "id":"1009", + "label":"角色新增", + "parentId":"101" + }, + { + "children":[], + "id":"1010", + "label":"角色修改", + "parentId":"101" + }, + { + "children":[], + "id":"1011", + "label":"角色删除", + "parentId":"101" + }, + { + "children":[], + "id":"1012", + "label":"角色导出", + "parentId":"101" + } + ], + "id":"101", + "label":"角色管理", + "parentId":"1" + }, + { + "children":[ + { + "children":[], + "id":"1013", + "label":"菜单查询", + "parentId":"102" + }, + { + "children":[], + "id":"1014", + "label":"菜单新增", + "parentId":"102" + }, + { + "children":[], + "id":"1015", + "label":"菜单修改", + "parentId":"102" + }, + { + "children":[], + "id":"1016", + "label":"菜单删除", + "parentId":"102" + } + ], + "id":"102", + "label":"菜单管理", + "parentId":"1" + } + ], + "id":"1", + "label":"系统管理", + "parentId":"0" + }, + { + "children":[ + { + "children":[], + "id":"2019", + "label":"文章管理", + "parentId":"2017" + }, + { + "children":[ + { + "children":[], + "id":"2028", + "label":"导出分类", + "parentId":"2018" + } + ], + "id":"2018", + "label":"分类管理", + "parentId":"2017" + }, + { + "children":[ + { + "children":[], + "id":"2024", + "label":"友链新增", + "parentId":"2022" + }, + { + "children":[], + "id":"2025", + "label":"友链修改", + "parentId":"2022" + }, + { + "children":[], + "id":"2026", + "label":"友链删除", + "parentId":"2022" + }, + { + "children":[], + "id":"2027", + "label":"友链查询", + "parentId":"2022" + } + ], + "id":"2022", + "label":"友链管理", + "parentId":"2017" + }, + { + "children":[], + "id":"2021", + "label":"标签管理", + "parentId":"2017" + } + ], + "id":"2017", + "label":"内容管理", + "parentId":"0" + } + ], + "msg":"操作成功" +} +~~~~ + + + + + +##### 5.20.2.2 新增角色接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------- | --------------- | +| POST | system/role | 是 | + +请求体： + +~~~~json +{ + "roleName":"测试新增角色", + "roleKey":"wds", + "roleSort":0, + "status":"0", + "menuIds":[ + "1", + "100" + ], + "remark":"我是角色备注" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + + + +### 5.21 修改角色 + +#### 5.21.1 需求 + +​ 需要提供修改角色的功能。修改角色时可以修改角色所关联的菜单权限 + +#### 5.21.2 接口设计 + +##### 5.21.2.1 角色信息回显接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------- | --------------- | +| Get | system/role/{id} | 是 | + +Path格式请求参数： + +id: 角色id + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "id":"11", + "remark":"嘎嘎嘎", + "roleKey":"aggag", + "roleName":"嘎嘎嘎", + "roleSort":"5", + "status":"0" + }, + "msg":"操作成功" +} +~~~~ + +##### 5.21.2.2 加载对应角色菜单列表树接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------------------------------ | --------------- | +| Get | /system/menu/roleMenuTreeselect/{id} | 是 | + +Path格式请求参数： + +id: 角色id + +响应格式： + +字段介绍 + +​ menus：菜单树。 + +​ checkedKeys：角色所关联的菜单权限id列表。 + +~~~~json +{ + "code":200, + "data":{ + "menus":[ + { + "children":[], + "id":"2023", + "label":"写博文", + "parentId":"0" + }, + { + "children":[ + { + "children":[ + { + "children":[], + "id":"1001", + "label":"用户查询", + "parentId":"100" + }, + { + "children":[], + "id":"1002", + "label":"用户新增", + "parentId":"100" + }, + { + "children":[], + "id":"1003", + "label":"用户修改", + "parentId":"100" + }, + { + "children":[], + "id":"1004", + "label":"用户删除", + "parentId":"100" + }, + { + "children":[], + "id":"1005", + "label":"用户导出", + "parentId":"100" + }, + { + "children":[], + "id":"1006", + "label":"用户导入", + "parentId":"100" + }, + { + "children":[], + "id":"1007", + "label":"重置密码", + "parentId":"100" + } + ], + "id":"100", + "label":"用户管理", + "parentId":"1" + }, + { + "children":[ + { + "children":[], + "id":"1008", + "label":"角色查询", + "parentId":"101" + }, + { + "children":[], + "id":"1009", + "label":"角色新增", + "parentId":"101" + }, + { + "children":[], + "id":"1010", + "label":"角色修改", + "parentId":"101" + }, + { + "children":[], + "id":"1011", + "label":"角色删除", + "parentId":"101" + }, + { + "children":[], + "id":"1012", + "label":"角色导出", + "parentId":"101" + } + ], + "id":"101", + "label":"角色管理", + "parentId":"1" + }, + { + "children":[ + { + "children":[], + "id":"1013", + "label":"菜单查询", + "parentId":"102" + }, + { + "children":[], + "id":"1014", + "label":"菜单新增", + "parentId":"102" + }, + { + "children":[], + "id":"1015", + "label":"菜单修改", + "parentId":"102" + }, + { + "children":[], + "id":"1016", + "label":"菜单删除", + "parentId":"102" + } + ], + "id":"102", + "label":"菜单管理", + "parentId":"1" + } + ], + "id":"1", + "label":"系统管理", + "parentId":"0" + }, + { + "children":[ + { + "children":[], + "id":"2019", + "label":"文章管理", + "parentId":"2017" + }, + { + "children":[ + { + "children":[], + "id":"2028", + "label":"导出分类", + "parentId":"2018" + } + ], + "id":"2018", + "label":"分类管理", + "parentId":"2017" + }, + { + "children":[ + { + "children":[], + "id":"2024", + "label":"友链新增", + "parentId":"2022" + }, + { + "children":[], + "id":"2025", + "label":"友链修改", + "parentId":"2022" + }, + { + "children":[], + "id":"2026", + "label":"友链删除", + "parentId":"2022" + }, + { + "children":[], + "id":"2027", + "label":"友链查询", + "parentId":"2022" + } + ], + "id":"2022", + "label":"友链管理", + "parentId":"2017" + }, + { + "children":[], + "id":"2021", + "label":"标签管理", + "parentId":"2017" + } + ], + "id":"2017", + "label":"内容管理", + "parentId":"0" + } + ], + "checkedKeys":[ + "1001" + ] + }, + "msg":"操作成功" +} +~~~~ + + + + + +##### 5.21.2.3 更新角色信息接口 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------- | --------------- | +| PUT | system/role | 是 | + +请求体： + +~~~~json +{ + "id":"13", + "remark":"我是角色备注", + "roleKey":"wds", + "roleName":"测试新增角色", + "roleSort":0, + "status":"0", + "menuIds":[ + "1", + "100", + "1001" + ] +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + + + + + +### 5.22 删除角色 + +#### 5.22.1 需求 + +​ 删除固定的某个角色（逻辑删除） + +#### 5.22.2 接口设计 + +​ + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------- | --------------- | +| DELETE | system/role/{id} | 是 | + +Path请求参数： + +id：要删除的角色id + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.23 用户列表 + +#### 5.23.1 需求 + +​ 需要用户分页列表接口。 + +​ 可以根据用户名模糊搜索。 + +​ 可以进行手机号的搜索。 + +​ 可以进行状态的查询。 + +#### 5.23.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------- | --------------- | +| GET | system/user/list | 是 | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +userName：用户名 + +phonenumber：手机号 + +status:状态 + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "rows":[ + { + "avatar":"http://r7yxkqloa.bkt.clouddn.com/2022/03/05/75fd15587811443a9a9a771f24da458d.png", + "createTime":"2022-01-05 17:01:56", + "email":"23412332@qq.com", + "id":"1", + "nickName":"sg3334", + "phonenumber":"18888888888", + "sex":"1", + "status":"0", + "updateBy":"1", + "updateTime":"2022-03-13 21:36:22", + "userName":"sg" + } + ], + "total":"1" + }, + "msg":"操作成功" +} +~~~~ + + + +### 5.24 新增用户！！！ + + + +#### 5.24.1 需求 + +​ 需要新增用户功能。新增用户时可以直接关联角色。 + +​ 注意：新增用户时注意密码加密存储。 + +​ 用户名不能为空，否则提示：必需填写用户名 + +​ 用户名必须之前未存在，否则提示：用户名已存在 + +​ 手机号必须之前未存在，否则提示：手机号已存在 + +​ 邮箱必须之前未存在，否则提示：邮箱已存在 + +#### 5.24.2 接口设计 + +##### 5.24.2.1 查询角色列表接口 + +注意：查询的是所有状态正常的角色 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------------------ | --------------- | +| GET | /system/role/listAllRole | 是 | + + + +响应格式： + +~~~~json +{ + "code":200, + "data":[ + { + "createBy":"0", + "createTime":"2021-11-12 18:46:19", + "delFlag":"0", + "id":"1", + "remark":"超级管理员", + "roleKey":"admin", + "roleName":"超级管理员", + "roleSort":"1", + "status":"0", + "updateBy":"0" + }, + { + "createBy":"0", + "createTime":"2021-11-12 18:46:19", + "delFlag":"0", + "id":"2", + "remark":"普通角色", + "roleKey":"common", + "roleName":"普通角色", + "roleSort":"2", + "status":"0", + "updateBy":"0", + "updateTime":"2022-01-02 06:32:58" + }, + { + "createTime":"2022-01-06 22:07:40", + "delFlag":"0", + "id":"11", + "remark":"嘎嘎嘎", + "roleKey":"aggag", + "roleName":"嘎嘎嘎", + "roleSort":"5", + "status":"0", + "updateBy":"1", + "updateTime":"2022-09-12 10:00:25" + }, + { + "createTime":"2022-01-16 14:49:30", + "delFlag":"0", + "id":"12", + "roleKey":"link", + "roleName":"友链审核员", + "roleSort":"1", + "status":"0", + "updateTime":"2022-01-16 16:05:09" + } + ], + "msg":"操作成功" +} +~~~~ + + + + + + + +##### 5.24.2.2 新增用户 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------- | --------------- | +| POST | system/user | 是 | + +请求体： + +~~~~json +{ + "userName":"wqeree", + "nickName":"测试新增用户", + "password":"1234343", + "phonenumber":"18889778907", + "email":"233@sq.com", + "sex":"0", + "status":"0", + "roleIds":[ + "2" + ] +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.25 删除用户 + +#### 5.25.1 需求 + +删除固定的某个用户（逻辑删除） + +#### 5.25.2 接口设计 + +不能删除当前操作的用户 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------------- | --------------- | +| DELETE | /system/user/{id} | 是 | + +Path请求参数： + +id：要删除的用户id + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.26 修改用户 + +#### 5.26.1 需求 + +需要提供修改用户的功能。修改用户时可以修改用户所关联的角色。 + +#### 5.26.2 接口设计 + +##### 5.26.2.1 根据id查询用户信息回显接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------------- | --------------- | +| Get | /system/user/{id} | 是 | + +Path格式请求参数： + +id: 用户id + +响应格式： + +roleIds：用户所关联的角色id列表 + +roles：所有角色的列表 + +user：用户信息 + +~~~~json +{ + "code":200, + "data":{ + "roleIds":[ + "11" + ], + "roles":[ + { + "createBy":"0", + "createTime":"2021-11-12 18:46:19", + "delFlag":"0", + "id":"1", + "remark":"超级管理员", + "roleKey":"admin", + "roleName":"超级管理员", + "roleSort":"1", + "status":"0", + "updateBy":"0" + }, + { + "createBy":"0", + "createTime":"2021-11-12 18:46:19", + "delFlag":"0", + "id":"2", + "remark":"普通角色", + "roleKey":"common", + "roleName":"普通角色", + "roleSort":"2", + "status":"0", + "updateBy":"0", + "updateTime":"2022-01-02 06:32:58" + }, + { + "createTime":"2022-01-06 22:07:40", + "delFlag":"0", + "id":"11", + "remark":"嘎嘎嘎", + "roleKey":"aggag", + "roleName":"嘎嘎嘎", + "roleSort":"5", + "status":"0", + "updateBy":"1", + "updateTime":"2022-09-11 20:34:49" + }, + { + "createTime":"2022-01-16 14:49:30", + "delFlag":"0", + "id":"12", + "roleKey":"link", + "roleName":"友链审核员", + "roleSort":"1", + "status":"0", + "updateTime":"2022-01-16 16:05:09" + } + ], + "user":{ + "email":"weq@2132.com", + "id":"14787164048663", + "nickName":"sg777", + "sex":"0", + "status":"0", + "userName":"sg777" + } + }, + "msg":"操作成功" +} +~~~~ + + + +##### 5.26.2.2 更新用户信息接口 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------ | --------------- | +| PUT | /system/user | 是 | + +请求体： + +~~~~json +{ + "email":"weq@2132.com", + "id":"14787164048663", + "nickName":"sg777", + "sex":"1", + "status":"0", + "userName":"sg777", + "roleIds":[ + "11" + ] +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +### 5.27 分页查询分类列表 + +#### 5.27.1 需求 + +​ 需要分页查询分类列表。 + +​ 能根据分类名称进行模糊查询。 + +​ 能根据状态进行查询。 + +#### 5.27.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | --------------------- | --------------- | +| GET | content/category/list | 是 | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +name：分类名 + +status: 状态 + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "rows":[ + { + "description":"wsd", + "id":"1", + "name":"java", + "status":"0" + }, + { + "description":"wsd", + "id":"2", + "name":"PHP", + "status":"0" + } + ], + "total":"2" + }, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.28 新增分类 + +#### 5.28.1 需求 + +​ 需要新增分类功能 + +#### 5.28.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------------- | --------------- | +| POST | /content/category | 是 | + +请求体： + +~~~~json +{ + "name":"威威", + "description":"是的", + "status":"0" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.29 修改分类 + +#### 5.29.1 需求 + +​ 需要提供修改分类的功能 + +#### 5.29.2 接口设计 + +##### 5.29.2.1 根据id查询分类 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | --------------------- | --------------- | +| Get | content/category/{id} | 是 | + +Path格式请求参数： + +id: 分类id + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "description":"qwew", + "id":"4", + "name":"ww", + "status":"0" + }, + "msg":"操作成功" +} +~~~~ + + + + + +##### 5.29.2.2 更新分类 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------------- | --------------- | +| PUT | /content/category | 是 | + +请求体： + +~~~~json +{ + "description":"是的", + "id":"3", + "name":"威威2", + "status":"0" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.30 删除分类 + +#### 5.30.1 需求 + +​ 删除某个分类（逻辑删除） + +#### 5.30.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ---------------------- | --------------- | +| DELETE | /content/category/{id} | 是 | + +Path请求参数： + +id：要删除的分类id + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + +### 5.31 分页查询友链列表 + +#### 5.31.1 需求 + +​ 需要分页查询友链列表。 + +​ 能根据友链名称进行模糊查询。 + +​ 能根据状态进行查询。 + +#### 5.31.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------------ | --------------- | +| GET | /content/link/list | 是 | + +Query格式请求参数： + +pageNum: 页码 + +pageSize: 每页条数 + +name：友链名 + +status:状态 + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "rows":[ + { + "address":"https://www.baidu.com", + "description":"sda", + "id":"1", "logo":"https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fn1.itc.cn%2Fimg8%2Fwb%2Frecom%2F2016%2F05%2F10%2F146286696706220328.PNG&refer=http%3A%2F%2Fn1.itc.cn&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1646205529&t=f942665181eb9b0685db7a6f59d59975", + "name":"sda", + "status":"0" + } + ], + "total":"1" + }, + "msg":"操作成功" +} +~~~~ + + + +### 5.32 新增友链 + +#### 5.32.1 需求 + +​ 需要新增友链功能 + +#### 5.32.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------- | --------------- | +| POST | /content/link | 是 | + +请求体： + +~~~~json +{ + "name":"sda", + "description":"weqw", + "address":"wewe", + "logo":"weqe", + "status":"2" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +### 5.33 修改友链 + +#### 5.33.1 需求 + +​ 需要提供修改友链的功能 + +#### 5.33.2 接口设计 + +##### 5.33.2.1 根据id查询友联 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ----------------- | --------------- | +| Get | content/link/{id} | 是 | + +Path格式请求参数： + +id: 友链id + +响应格式： + +~~~~json +{ + "code":200, + "data":{ + "address":"wewe", + "description":"weqw", + "id":"4", + "logo":"weqe", + "name":"sda", + "status":"2" + }, + "msg":"操作成功" +} +~~~~ + + + + + +##### 5.33.2.2 修改友链 + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------- | --------------- | +| PUT | /content/link | 是 | + +请求体： + +~~~~json +{ + "address":"https://www.qq.com", + "description":"dada2", + "id":"2", + "logo":"https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fn1.itc.cn%2Fimg8%2Fwb%2Frecom%2F2016%2F05%2F10%2F146286696706220328.PNG&refer=http%3A%2F%2Fn1.itc.cn&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1646205529&t=f942665181eb9b0685db7a6f59d59975", + "name":"sda", + "status":"0" +} +~~~~ + + + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + +### 5.34 删除友链 + +#### 5.34.1 需求 + +​ 删除某个友链（逻辑删除） + +#### 5.34.2 接口设计 + + + +| 请求方式 | 请求路径 | 是否需求token头 | +| -------- | ------------------ | --------------- | +| DELETE | /content/link/{id} | 是 | + +Path请求参数： + +id：要删除的友链id + +响应格式： + +~~~~json +{ + "code":200, + "msg":"操作成功" +} +~~~~ + + + + + diff --git a/sql/sg_article.sql b/sql/sg_article.sql new file mode 100644 index 0000000000000000000000000000000000000000..40a8c4b20679c3df7d305dc59e9b256101743ee4 --- /dev/null +++ b/sql/sg_article.sql @@ -0,0 +1,49 @@ +/* +SQLyog v10.2 +MySQL - 5.5.40 : Database - sg_blog +********************************************************************* +*/ + +/*!40101 SET NAMES utf8 */; + +/*!40101 SET SQL_MODE=''*/; + +/*!40014 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0 */; +/*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */; +/*!40101 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO' */; +/*!40111 SET @OLD_SQL_NOTES=@@SQL_NOTES, SQL_NOTES=0 */; +CREATE DATABASE /*!32312 IF NOT EXISTS*/`sg_blog` /*!40100 DEFAULT CHARACTER SET utf8mb4 */; + +USE `sg_blog`; + +/*Table structure for table `sg_article` */ + +DROP TABLE IF EXISTS `sg_article`; + +CREATE TABLE `sg_article` ( + `id` bigint(200) NOT NULL AUTO_INCREMENT, + `title` varchar(256) DEFAULT NULL COMMENT '标题', + `content` longtext COMMENT '文章内容', + `summary` varchar(1024) DEFAULT NULL COMMENT '文章摘要', + `category_id` bigint(20) DEFAULT NULL COMMENT '所属分类id', + `thumbnail` varchar(256) DEFAULT NULL COMMENT '缩略图', + `is_top` char(1) DEFAULT '0' COMMENT '是否置顶（0否，1是）', + `status` char(1) DEFAULT '1' COMMENT '状态（0已发布，1草稿）', + `view_count` bigint(200) DEFAULT '0' COMMENT '访问量', + `is_comment` char(1) DEFAULT '1' COMMENT '是否允许评论 1是，0否', + `create_by` bigint(20) DEFAULT NULL, + `create_time` datetime DEFAULT NULL, + `update_by` bigint(20) DEFAULT NULL, + `update_time` datetime DEFAULT NULL, + `del_flag` int(1) DEFAULT '0' COMMENT '删除标志（0代表未删除，1代表已删除）', + PRIMARY KEY (`id`) +) ENGINE=InnoDB AUTO_INCREMENT=8 DEFAULT CHARSET=utf8mb4 COMMENT='文章表'; + +/*Data for the table `sg_article` */ + +insert into `sg_article`(`id`,`title`,`content`,`summary`,`category_id`,`thumbnail`,`is_top`,`status`,`view_count`,`is_comment`,`create_by`,`create_time`,`update_by`,`update_time`,`del_flag`) values (1,'SpringSecurity从入门到精通','## 课程介绍\n![image20211219121555979.png](https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/01/31/e7131718e9e64faeaf3fe16404186eb4.png)\n\n## 0. 简介1\n\n​ **Spring Security** 是 Spring 家族中的一个安全管理框架。相比与另外一个安全框架**Shiro**，它提供了更丰富的功能，社区资源也比Shiro丰富。\n\n​ 一般来说中大型的项目都是使用**SpringSecurity** 来做安全框架。小项目有Shiro的比较多，因为相比与SpringSecurity，Shiro的上手更加的简单。\n\n​ 一般Web应用的需要进行**认证**和**授权**。\n\n​ **认证：验证当前访问系统的是不是本系统的用户，并且要确认具体是哪个用户**\n\n​ **授权：经过认证后判断当前用户是否有权限进行某个操作**\n\n​ 而认证和授权也是SpringSecurity作为安全框架的核心功能。\n\n\n\n## 1. 快速入门\n\n### 1.1 准备工作\n\n​ 我们先要搭建一个简单的SpringBoot工程\n\n① 设置父工程 添加依赖\n\n~~~~\n \n org.springframework.boot\n spring-boot-starter-parent\n 2.5.0\n \n \n \n org.springframework.boot\n spring-boot-starter-web\n \n \n org.projectlombok\n lombok\n true\n \n \n~~~~\n\n② 创建启动类\n\n~~~~\n@SpringBootApplication\npublic class SecurityApplication {\n\n public static void main(String[] args) {\n SpringApplication.run(SecurityApplication.class,args);\n }\n}\n\n~~~~\n\n③ 创建Controller\n\n~~~~java\n\nimport org.springframework.web.bind.annotation.RequestMapping;\nimport org.springframework.web.bind.annotation.RestController;\n\n@RestController\npublic class HelloController {\n\n @RequestMapping(\"/hello\")\n public String hello(){\n return \"hello\";\n }\n}\n\n~~~~\n\n\n\n### 1.2 引入SpringSecurity\n\n​ 在SpringBoot项目中使用SpringSecurity我们只需要引入依赖即可实现入门案例。\n\n~~~~xml\n \n org.springframework.boot\n spring-boot-starter-security\n \n~~~~\n\n​ 引入依赖后我们在尝试去访问之前的接口就会自动跳转到一个SpringSecurity的默认登陆页面，默认用户名是user,密码会输出在控制台。\n\n​ 必须登陆之后才能对接口进行访问。\n\n\n\n## 2. 认证\n\n### 2.1 登陆校验流程\n![image20211215094003288.png](https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/01/31/414a87eeed344828b5b00ffa80178958.png)','SpringSecurity框架教程-Spring Security+JWT实现项目级前端分离认证授权',1,'https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/01/31/948597e164614902ab1662ba8452e106.png','1','0',105,'0',NULL,'2022-01-23 23:20:11',NULL,NULL,0),(2,'weq','adadaeqe','adad',2,'https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/01/15/fd2e9460c58a4af3bbeae5d9ed581688.png','1','0',22,'0',NULL,'2022-01-21 14:58:30',NULL,NULL,1),(3,'dad','asdasda','sadad',1,'https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/01/15/737a0ed0b8ea430d8700a12e76aa1cd1.png','1','0',33,'0',NULL,'2022-01-18 14:58:34',NULL,NULL,1),(5,'sdad','![Snipaste_20220115_165812.png](https://sg-blog-oss.oss-cn-beijing.aliyuncs.com/2022/01/15/1d9d283f5d874b468078b183e4b98b71.png)\r\n\r\n## sda \r\n\r\n222\r\n### sdasd newnewnew',NULL,2,'','1','0',44,'0',NULL,'2022-01-17 14:58:37',NULL,NULL,0); + +/*!40101 SET SQL_MODE=@OLD_SQL_MODE */; +/*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */; +/*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */; +/*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */; diff --git a/sql/sg_article_tag.sql b/sql/sg_article_tag.sql new file mode 100644 index 0000000000000000000000000000000000000000..b9a05ce58cea766eb30527e92833f6145c7773f8 --- /dev/null +++ b/sql/sg_article_tag.sql @@ -0,0 +1,36 @@ +/* +SQLyog v10.2 +MySQL - 5.5.40 : Database - sg_blog +********************************************************************* +*/ + +/*!40101 SET NAMES utf8 */; + +/*!40101 SET SQL_MODE=''*/; + +/*!40014 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0 */; +/*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */; +/*!40101 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO' */; +/*!40111 SET @OLD_SQL_NOTES=@@SQL_NOTES, SQL_NOTES=0 */; +CREATE DATABASE /*!32312 IF NOT EXISTS*/`sg_blog` /*!40100 DEFAULT CHARACTER SET utf8mb4 */; + +USE `sg_blog`; + +/*Table structure for table `sg_article_tag` */ + +DROP TABLE IF EXISTS `sg_article_tag`; + +CREATE TABLE `sg_article_tag` ( + `article_id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '文章id', + `tag_id` bigint(20) NOT NULL DEFAULT '0' COMMENT '标签id', + PRIMARY KEY (`article_id`,`tag_id`) +) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8mb4 COMMENT='文章标签关联表'; + +/*Data for the table `sg_article_tag` */ + +insert into `sg_article_tag`(`article_id`,`tag_id`) values (1,4),(2,1),(2,4),(3,4),(3,5); + +/*!40101 SET SQL_MODE=@OLD_SQL_MODE */; +/*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */; +/*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */; +/*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */; diff --git a/sql/sg_category.sql b/sql/sg_category.sql new file mode 100644 index 0000000000000000000000000000000000000000..bc759a3de73fd0fb2c8bb82acca9c6306692815c --- /dev/null +++ b/sql/sg_category.sql @@ -0,0 +1,44 @@ +/* +SQLyog v10.2 +MySQL - 5.5.40 : Database - sg_blog +********************************************************************* +*/ + +/*!40101 SET NAMES utf8 */; + +/*!40101 SET SQL_MODE=''*/; + +/*!40014 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0 */; +/*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */; +/*!40101 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO' */; +/*!40111 SET @OLD_SQL_NOTES=@@SQL_NOTES, SQL_NOTES=0 */; +CREATE DATABASE /*!32312 IF NOT EXISTS*/`sg_blog` /*!40100 DEFAULT CHARACTER SET utf8mb4 */; + +USE `sg_blog`; + +/*Table structure for table `sg_category` */ + +DROP TABLE IF EXISTS `sg_category`; + +CREATE TABLE `sg_category` ( + `id` bigint(200) NOT NULL AUTO_INCREMENT, + `name` varchar(128) DEFAULT NULL COMMENT '分类名', + `pid` bigint(200) DEFAULT '-1' COMMENT '父分类id，如果没有父分类为-1', + `description` varchar(512) DEFAULT NULL COMMENT '描述', + `status` char(1) DEFAULT '0' COMMENT '状态0:正常,1禁用', + `create_by` bigint(200) DEFAULT NULL, + `create_time` datetime DEFAULT NULL, + `update_by` bigint(200) DEFAULT NULL, + `update_time` datetime DEFAULT NULL, + `del_flag` int(11) DEFAULT '0' COMMENT '删除标志（0代表未删除，1代表已删除）', + PRIMARY KEY (`id`) +) ENGINE=InnoDB AUTO_INCREMENT=15 DEFAULT CHARSET=utf8mb4 COMMENT='分类表'; + +/*Data for the table `sg_category` */ + +insert into `sg_category`(`id`,`name`,`pid`,`description`,`status`,`create_by`,`create_time`,`update_by`,`update_time`,`del_flag`) values (1,'java',-1,'wsd','0',NULL,NULL,NULL,NULL,0),(2,'PHP',-1,'wsd','0',NULL,NULL,NULL,NULL,0); + +/*!40101 SET SQL_MODE=@OLD_SQL_MODE */; +/*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */; +/*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */; +/*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */; diff --git a/sql/sg_comment.sql b/sql/sg_comment.sql new file mode 100644 index 0000000000000000000000000000000000000000..77cbddb6ffe3805f4752a5bb98eb796f8adfd74f --- /dev/null +++ b/sql/sg_comment.sql @@ -0,0 +1,46 @@ +/* +SQLyog v10.2 +MySQL - 5.5.40 : Database - sg_blog +********************************************************************* +*/ + +/*!40101 SET NAMES utf8 */; + +/*!40101 SET SQL_MODE=''*/; + +/*!40014 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0 */; +/*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */; +/*!40101 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO' */; +/*!40111 SET @OLD_SQL_NOTES=@@SQL_NOTES, SQL_NOTES=0 */; +CREATE DATABASE /*!32312 IF NOT EXISTS*/`sg_blog` /*!40100 DEFAULT CHARACTER SET utf8mb4 */; + +USE `sg_blog`; + +/*Table structure for table `sg_comment` */ + +DROP TABLE IF EXISTS `sg_comment`; + +CREATE TABLE `sg_comment` ( + `id` bigint(20) NOT NULL AUTO_INCREMENT, + `type` char(1) DEFAULT '0' COMMENT '评论类型（0代表文章评论，1代表友链评论）', + `article_id` bigint(20) DEFAULT NULL COMMENT '文章id', + `root_id` bigint(20) DEFAULT '-1' COMMENT '根评论id', + `content` varchar(512) DEFAULT NULL COMMENT '评论内容', + `to_comment_user_id` bigint(20) DEFAULT '-1' COMMENT '所回复的目标评论的userid', + `to_comment_id` bigint(20) DEFAULT '-1' COMMENT '回复目标评论id', + `create_by` bigint(20) DEFAULT NULL, + `create_time` datetime DEFAULT NULL, + `update_by` bigint(20) DEFAULT NULL, + `update_time` datetime DEFAULT NULL, + `del_flag` int(1) DEFAULT '0' COMMENT '删除标志（0代表未删除，1代表已删除）', + PRIMARY KEY (`id`) +) ENGINE=InnoDB AUTO_INCREMENT=31 DEFAULT CHARSET=utf8mb4 COMMENT='评论表'; + +/*Data for the table `sg_comment` */ + +insert into `sg_comment`(`id`,`type`,`article_id`,`root_id`,`content`,`to_comment_user_id`,`to_comment_id`,`create_by`,`create_time`,`update_by`,`update_time`,`del_flag`) values (1,'0',1,-1,'asS',-1,-1,1,'2022-01-29 07:59:22',1,'2022-01-29 07:59:22',0),(2,'0',1,-1,'[哈哈]SDAS',-1,-1,1,'2022-01-29 08:01:24',1,'2022-01-29 08:01:24',0),(3,'0',1,-1,'是大多数',-1,-1,1,'2022-01-29 16:07:24',1,'2022-01-29 16:07:24',0),(4,'0',1,-1,'撒大声地',-1,-1,1,'2022-01-29 16:12:09',1,'2022-01-29 16:12:09',0),(5,'0',1,-1,'你再说什么',-1,-1,1,'2022-01-29 18:19:56',1,'2022-01-29 18:19:56',0),(6,'0',1,-1,'hffd',-1,-1,1,'2022-01-29 22:13:52',1,'2022-01-29 22:13:52',0),(9,'0',1,2,'你说什么',1,2,1,'2022-01-29 22:18:40',1,'2022-01-29 22:18:40',0),(10,'0',1,2,'哈哈哈哈[哈哈]',1,9,1,'2022-01-29 22:29:15',1,'2022-01-29 22:29:15',0),(11,'0',1,2,'we全文',1,10,3,'2022-01-29 22:29:55',1,'2022-01-29 22:29:55',0),(12,'0',1,-1,'王企鹅',-1,-1,1,'2022-01-29 22:30:20',1,'2022-01-29 22:30:20',0),(13,'0',1,-1,'什么阿是',-1,-1,1,'2022-01-29 22:30:56',1,'2022-01-29 22:30:56',0),(14,'0',1,-1,'新平顶山',-1,-1,1,'2022-01-29 22:32:51',1,'2022-01-29 22:32:51',0),(15,'0',1,-1,'2222',-1,-1,1,'2022-01-29 22:34:38',1,'2022-01-29 22:34:38',0),(16,'0',1,2,'3333',1,11,1,'2022-01-29 22:34:47',1,'2022-01-29 22:34:47',0),(17,'0',1,2,'回复weqedadsd',3,11,1,'2022-01-29 22:38:00',1,'2022-01-29 22:38:00',0),(18,'0',1,-1,'sdasd',-1,-1,1,'2022-01-29 23:18:19',1,'2022-01-29 23:18:19',0),(19,'0',1,-1,'111',-1,-1,1,'2022-01-29 23:22:23',1,'2022-01-29 23:22:23',0),(20,'0',1,1,'你说啥？',1,1,1,'2022-01-30 10:06:21',1,'2022-01-30 10:06:21',0),(21,'0',1,-1,'友链添加个呗',-1,-1,1,'2022-01-30 10:06:50',1,'2022-01-30 10:06:50',0),(22,'1',1,-1,'友链评论2',-1,-1,1,'2022-01-30 10:08:28',1,'2022-01-30 10:08:28',0),(23,'1',1,22,'回复友链评论3',1,22,1,'2022-01-30 10:08:50',1,'2022-01-30 10:08:50',0),(24,'1',1,-1,'友链评论4444',-1,-1,1,'2022-01-30 10:09:03',1,'2022-01-30 10:09:03',0),(25,'1',1,22,'收到的',1,22,1,'2022-01-30 10:13:28',1,'2022-01-30 10:13:28',0),(26,'0',1,-1,'sda',-1,-1,1,'2022-01-30 10:39:05',1,'2022-01-30 10:39:05',0),(27,'0',1,1,'说你咋地',1,20,14787164048662,'2022-01-30 17:19:30',14787164048662,'2022-01-30 17:19:30',0),(28,'0',1,1,'sdad',1,1,14787164048662,'2022-01-31 11:11:20',14787164048662,'2022-01-31 11:11:20',0),(29,'0',1,-1,'你说是的ad',-1,-1,14787164048662,'2022-01-31 14:10:11',14787164048662,'2022-01-31 14:10:11',0),(30,'0',1,1,'撒大声地',1,1,14787164048662,'2022-01-31 20:19:18',14787164048662,'2022-01-31 20:19:18',0); + +/*!40101 SET SQL_MODE=@OLD_SQL_MODE */; +/*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */; +/*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */; +/*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */; diff --git a/sql/sg_link.sql b/sql/sg_link.sql new file mode 100644 index 0000000000000000000000000000000000000000..7c3e57fd64a51d06df89fdea863bd648a8560629 --- /dev/null +++ b/sql/sg_link.sql @@ -0,0 +1,45 @@ +/* +SQLyog v10.2 +MySQL - 5.5.40 : Database - sg_blog +********************************************************************* +*/ + +/*!40101 SET NAMES utf8 */; + +/*!40101 SET SQL_MODE=''*/; + +/*!40014 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0 */; +/*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */; +/*!40101 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO' */; +/*!40111 SET @OLD_SQL_NOTES=@@SQL_NOTES, SQL_NOTES=0 */; +CREATE DATABASE /*!32312 IF NOT EXISTS*/`sg_blog` /*!40100 DEFAULT CHARACTER SET utf8mb4 */; + +USE `sg_blog`; + +/*Table structure for table `sg_link` */ + +DROP TABLE IF EXISTS `sg_link`; + +CREATE TABLE `sg_link` ( + `id` bigint(20) NOT NULL AUTO_INCREMENT, + `name` varchar(256) DEFAULT NULL, + `logo` varchar(256) DEFAULT NULL, + `description` varchar(512) DEFAULT NULL, + `address` varchar(128) DEFAULT NULL COMMENT '网站地址', + `status` char(1) DEFAULT '2' COMMENT '审核状态 (0代表审核通过，1代表审核未通过，2代表未审核)', + `create_by` bigint(20) DEFAULT NULL, + `create_time` datetime DEFAULT NULL, + `update_by` bigint(20) DEFAULT NULL, + `update_time` datetime DEFAULT NULL, + `del_flag` int(1) DEFAULT '0' COMMENT '删除标志（0代表未删除，1代表已删除）', + PRIMARY KEY (`id`) +) ENGINE=InnoDB AUTO_INCREMENT=4 DEFAULT CHARSET=utf8mb4 COMMENT='友链'; + +/*Data for the table `sg_link` */ + +insert into `sg_link`(`id`,`name`,`logo`,`description`,`address`,`status`,`create_by`,`create_time`,`update_by`,`update_time`,`del_flag`) values (1,'sda','https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fn1.itc.cn%2Fimg8%2Fwb%2Frecom%2F2016%2F05%2F10%2F146286696706220328.PNG&refer=http%3A%2F%2Fn1.itc.cn&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1646205529&t=f942665181eb9b0685db7a6f59d59975','sda','https://www.baidu.com','1',NULL,'2022-01-13 08:25:47',NULL,'2022-01-13 08:36:14',0),(2,'sda','https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fn1.itc.cn%2Fimg8%2Fwb%2Frecom%2F2016%2F05%2F10%2F146286696706220328.PNG&refer=http%3A%2F%2Fn1.itc.cn&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1646205529&t=f942665181eb9b0685db7a6f59d59975','dada','https://www.qq.com','1',NULL,'2022-01-13 09:06:10',NULL,'2022-01-13 09:07:09',0),(3,'sa','https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fn1.itc.cn%2Fimg8%2Fwb%2Frecom%2F2016%2F05%2F10%2F146286696706220328.PNG&refer=http%3A%2F%2Fn1.itc.cn&app=2002&size=f9999,10000&q=a80&n=0&g=0n&fmt=jpeg?sec=1646205529&t=f942665181eb9b0685db7a6f59d59975','da','https://www.taobao.com','1',NULL,'2022-01-13 09:23:01',NULL,'2022-01-13 09:23:01',0); + +/*!40101 SET SQL_MODE=@OLD_SQL_MODE */; +/*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */; +/*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */; +/*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */; diff --git a/sql/sg_menu.sql b/sql/sg_menu.sql new file mode 100644 index 0000000000000000000000000000000000000000..b8512546ce968a66056e1477311df13b86310e5a --- /dev/null +++ b/sql/sg_menu.sql @@ -0,0 +1,103 @@ +/* +SQLyog v10.2 +MySQL - 5.5.40 : Database - sg_blog +********************************************************************* +*/ + +/*!40101 SET NAMES utf8 */; + +/*!40101 SET SQL_MODE=''*/; + +/*!40014 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0 */; +/*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */; +/*!40101 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO' */; +/*!40111 SET @OLD_SQL_NOTES=@@SQL_NOTES, SQL_NOTES=0 */; +CREATE DATABASE /*!32312 IF NOT EXISTS*/`sg_blog` /*!40100 DEFAULT CHARACTER SET utf8mb4 */; + +USE `sg_blog`; + +/*Table structure for table `sys_menu` */ + +DROP TABLE IF EXISTS `sys_menu`; + +CREATE TABLE `sys_menu` ( + `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '菜单ID', + `menu_name` varchar(50) NOT NULL COMMENT '菜单名称', + `parent_id` bigint(20) DEFAULT '0' COMMENT '父菜单ID', + `order_num` int(4) DEFAULT '0' COMMENT '显示顺序', + `path` varchar(200) DEFAULT '' COMMENT '路由地址', + `component` varchar(255) DEFAULT NULL COMMENT '组件路径', + `is_frame` int(1) DEFAULT '1' COMMENT '是否为外链（0是 1否）', + `menu_type` char(1) DEFAULT '' COMMENT '菜单类型（M目录 C菜单 F按钮）', + `visible` char(1) DEFAULT '0' COMMENT '菜单状态（0显示 1隐藏）', + `status` char(1) DEFAULT '0' COMMENT '菜单状态（0正常 1停用）', + `perms` varchar(100) DEFAULT NULL COMMENT '权限标识', + `icon` varchar(100) DEFAULT '#' COMMENT '菜单图标', + `create_by` bigint(20) DEFAULT NULL COMMENT '创建者', + `create_time` datetime DEFAULT NULL COMMENT '创建时间', + `update_by` bigint(20) DEFAULT NULL COMMENT '更新者', + `update_time` datetime DEFAULT NULL COMMENT '更新时间', + `remark` varchar(500) DEFAULT '' COMMENT '备注', + `del_flag` char(1) DEFAULT '0', + PRIMARY KEY (`id`) +) ENGINE=InnoDB AUTO_INCREMENT=2034 DEFAULT CHARSET=utf8 COMMENT='菜单权限表'; + +/*Data for the table `sys_menu` */ + +insert into `sys_menu`(`id`,`menu_name`,`parent_id`,`order_num`,`path`,`component`,`is_frame`,`menu_type`,`visible`,`status`,`perms`,`icon`,`create_by`,`create_time`,`update_by`,`update_time`,`remark`,`del_flag`) values (1,'系统管理',0,1,'system',NULL,1,'M','0','0','','system',0,'2021-11-12 10:46:19',0,NULL,'系统管理目录','0'),(100,'用户管理',1,1,'user','system/user/index',1,'C','0','0','system:user:list','user',0,'2021-11-12 10:46:19',1,'2022-07-31 15:47:58','用户管理菜单','0'),(101,'角色管理',1,2,'role','system/role/index',1,'C','0','0','system:role:list','peoples',0,'2021-11-12 10:46:19',0,NULL,'角色管理菜单','0'),(102,'菜单管理',1,3,'menu','system/menu/index',1,'C','0','0','system:menu:list','tree-table',0,'2021-11-12 10:46:19',0,NULL,'菜单管理菜单','0'),(1001,'用户查询',100,1,'','',1,'F','0','0','system:user:query','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1002,'用户新增',100,2,'','',1,'F','0','0','system:user:add','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1003,'用户修改',100,3,'','',1,'F','0','0','system:user:edit','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1004,'用户删除',100,4,'','',1,'F','0','0','system:user:remove','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1005,'用户导出',100,5,'','',1,'F','0','0','system:user:export','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1006,'用户导入',100,6,'','',1,'F','0','0','system:user:import','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1007,'重置密码',100,7,'','',1,'F','0','0','system:user:resetPwd','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1008,'角色查询',101,1,'','',1,'F','0','0','system:role:query','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1009,'角色新增',101,2,'','',1,'F','0','0','system:role:add','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1010,'角色修改',101,3,'','',1,'F','0','0','system:role:edit','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1011,'角色删除',101,4,'','',1,'F','0','0','system:role:remove','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1012,'角色导出',101,5,'','',1,'F','0','0','system:role:export','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1013,'菜单查询',102,1,'','',1,'F','0','0','system:menu:query','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1014,'菜单新增',102,2,'','',1,'F','0','0','system:menu:add','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1015,'菜单修改',102,3,'','',1,'F','0','0','system:menu:edit','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(1016,'菜单删除',102,4,'','',1,'F','0','0','system:menu:remove','#',0,'2021-11-12 10:46:19',0,NULL,'','0'),(2017,'内容管理',0,4,'content',NULL,1,'M','0','0',NULL,'table',NULL,'2022-01-08 02:44:38',1,'2022-07-31 12:34:23','','0'),(2018,'分类管理',2017,1,'category','content/category/index',1,'C','0','0','content:category:list','example',NULL,'2022-01-08 02:51:45',NULL,'2022-01-08 02:51:45','','0'),(2019,'文章管理',2017,0,'article','content/article/index',1,'C','0','0','content:article:list','build',NULL,'2022-01-08 02:53:10',NULL,'2022-01-08 02:53:10','','0'),(2021,'标签管理',2017,6,'tag','content/tag/index',1,'C','0','0','content:tag:index','button',NULL,'2022-01-08 02:55:37',NULL,'2022-01-08 02:55:50','','0'),(2022,'友链管理',2017,4,'link','content/link/index',1,'C','0','0','content:link:list','404',NULL,'2022-01-08 02:56:50',NULL,'2022-01-08 02:56:50','','0'),(2023,'写博文',0,0,'write','content/article/write/index',1,'C','0','0','content:article:writer','build',NULL,'2022-01-08 03:39:58',1,'2022-07-31 22:07:05','','0'),(2024,'友链新增',2022,0,'',NULL,1,'F','0','0','content:link:add','#',NULL,'2022-01-16 07:59:17',NULL,'2022-01-16 07:59:17','','0'),(2025,'友链修改',2022,1,'',NULL,1,'F','0','0','content:link:edit','#',NULL,'2022-01-16 07:59:44',NULL,'2022-01-16 07:59:44','','0'),(2026,'友链删除',2022,1,'',NULL,1,'F','0','0','content:link:remove','#',NULL,'2022-01-16 08:00:05',NULL,'2022-01-16 08:00:05','','0'),(2027,'友链查询',2022,2,'',NULL,1,'F','0','0','content:link:query','#',NULL,'2022-01-16 08:04:09',NULL,'2022-01-16 08:04:09','','0'),(2028,'导出分类',2018,1,'',NULL,1,'F','0','0','content:category:export','#',NULL,'2022-01-21 07:06:59',NULL,'2022-01-21 07:06:59','','0'); + +/*Table structure for table `sys_role` */ + +DROP TABLE IF EXISTS `sys_role`; + +CREATE TABLE `sys_role` ( + `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '角色ID', + `role_name` varchar(30) NOT NULL COMMENT '角色名称', + `role_key` varchar(100) NOT NULL COMMENT '角色权限字符串', + `role_sort` int(4) NOT NULL COMMENT '显示顺序', + `status` char(1) NOT NULL COMMENT '角色状态（0正常 1停用）', + `del_flag` char(1) DEFAULT '0' COMMENT '删除标志（0代表存在 1代表删除）', + `create_by` bigint(20) DEFAULT NULL COMMENT '创建者', + `create_time` datetime DEFAULT NULL COMMENT '创建时间', + `update_by` bigint(20) DEFAULT NULL COMMENT '更新者', + `update_time` datetime DEFAULT NULL COMMENT '更新时间', + `remark` varchar(500) DEFAULT NULL COMMENT '备注', + PRIMARY KEY (`id`) +) ENGINE=InnoDB AUTO_INCREMENT=13 DEFAULT CHARSET=utf8 COMMENT='角色信息表'; + +/*Data for the table `sys_role` */ + +insert into `sys_role`(`id`,`role_name`,`role_key`,`role_sort`,`status`,`del_flag`,`create_by`,`create_time`,`update_by`,`update_time`,`remark`) values (1,'超级管理员','admin',1,'0','0',0,'2021-11-12 10:46:19',0,NULL,'超级管理员'),(2,'普通角色','common',2,'0','0',0,'2021-11-12 10:46:19',0,'2022-01-01 22:32:58','普通角色'),(11,'嘎嘎嘎','aggag',5,'0','0',NULL,'2022-01-06 14:07:40',NULL,'2022-01-07 03:48:48','嘎嘎嘎'),(12,'友链审核员','link',1,'0','0',NULL,'2022-01-16 06:49:30',NULL,'2022-01-16 08:05:09',NULL); + +/*Table structure for table `sys_role_menu` */ + +DROP TABLE IF EXISTS `sys_role_menu`; + +CREATE TABLE `sys_role_menu` ( + `role_id` bigint(20) NOT NULL COMMENT '角色ID', + `menu_id` bigint(20) NOT NULL COMMENT '菜单ID', + PRIMARY KEY (`role_id`,`menu_id`) +) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='角色和菜单关联表'; + +/*Data for the table `sys_role_menu` */ + +insert into `sys_role_menu`(`role_id`,`menu_id`) values (0,0),(2,1),(2,102),(2,1013),(2,1014),(2,1015),(2,1016),(2,2000),(3,2),(3,3),(3,4),(3,100),(3,101),(3,103),(3,104),(3,105),(3,106),(3,107),(3,108),(3,109),(3,110),(3,111),(3,112),(3,113),(3,114),(3,115),(3,116),(3,500),(3,501),(3,1001),(3,1002),(3,1003),(3,1004),(3,1005),(3,1006),(3,1007),(3,1008),(3,1009),(3,1010),(3,1011),(3,1012),(3,1017),(3,1018),(3,1019),(3,1020),(3,1021),(3,1022),(3,1023),(3,1024),(3,1025),(3,1026),(3,1027),(3,1028),(3,1029),(3,1030),(3,1031),(3,1032),(3,1033),(3,1034),(3,1035),(3,1036),(3,1037),(3,1038),(3,1039),(3,1040),(3,1041),(3,1042),(3,1043),(3,1044),(3,1045),(3,1046),(3,1047),(3,1048),(3,1049),(3,1050),(3,1051),(3,1052),(3,1053),(3,1054),(3,1055),(3,1056),(3,1057),(3,1058),(3,1059),(3,1060),(3,2000),(11,1),(11,100),(11,101),(11,102),(11,103),(11,104),(11,105),(11,106),(11,107),(11,108),(11,500),(11,501),(11,1001),(11,1002),(11,1003),(11,1004),(11,1005),(11,1006),(11,1007),(11,1008),(11,1009),(11,1010),(11,1011),(11,1012),(11,1013),(11,1014),(11,1015),(11,1016),(11,1017),(11,1018),(11,1019),(11,1020),(11,1021),(11,1022),(11,1023),(11,1024),(11,1025),(11,1026),(11,1027),(11,1028),(11,1029),(11,1030),(11,1031),(11,1032),(11,1033),(11,1034),(11,1035),(11,1036),(11,1037),(11,1038),(11,1039),(11,1040),(11,1041),(11,1042),(11,1043),(11,1044),(11,1045),(11,2000),(11,2003),(11,2004),(11,2005),(11,2006),(11,2007),(11,2008),(11,2009),(11,2010),(11,2011),(11,2012),(11,2013),(11,2014),(12,2017),(12,2022),(12,2024),(12,2025),(12,2026),(12,2027); + +/*Table structure for table `sys_user_role` */ + +DROP TABLE IF EXISTS `sys_user_role`; + +CREATE TABLE `sys_user_role` ( + `user_id` bigint(20) NOT NULL COMMENT '用户ID', + `role_id` bigint(20) NOT NULL COMMENT '角色ID', + PRIMARY KEY (`user_id`,`role_id`) +) ENGINE=InnoDB DEFAULT CHARSET=utf8 COMMENT='用户和角色关联表'; + +/*Data for the table `sys_user_role` */ + +insert into `sys_user_role`(`user_id`,`role_id`) values (1,1),(2,2),(5,2),(6,12); + +/*!40101 SET SQL_MODE=@OLD_SQL_MODE */; +/*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */; +/*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */; +/*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */; diff --git a/sql/sg_tag.sql b/sql/sg_tag.sql new file mode 100644 index 0000000000000000000000000000000000000000..f6f984e39572da46eacc1108d9a72238c5ec7c0d --- /dev/null +++ b/sql/sg_tag.sql @@ -0,0 +1,42 @@ +/* +SQLyog v10.2 +MySQL - 5.5.40 : Database - sg_blog +********************************************************************* +*/ + +/*!40101 SET NAMES utf8 */; + +/*!40101 SET SQL_MODE=''*/; + +/*!40014 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0 */; +/*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */; +/*!40101 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO' */; +/*!40111 SET @OLD_SQL_NOTES=@@SQL_NOTES, SQL_NOTES=0 */; +CREATE DATABASE /*!32312 IF NOT EXISTS*/`sg_blog` /*!40100 DEFAULT CHARACTER SET utf8mb4 */; + +USE `sg_blog`; + +/*Table structure for table `sg_tag` */ + +DROP TABLE IF EXISTS `sg_tag`; + +CREATE TABLE `sg_tag` ( + `id` bigint(20) NOT NULL AUTO_INCREMENT, + `name` varchar(128) DEFAULT NULL COMMENT '标签名', + `create_by` bigint(20) DEFAULT NULL, + `create_time` datetime DEFAULT NULL, + `update_by` bigint(20) DEFAULT NULL, + `update_time` datetime DEFAULT NULL, + `del_flag` int(1) DEFAULT '0' COMMENT '删除标志（0代表未删除，1代表已删除）', + `remark` varchar(500) DEFAULT NULL COMMENT '备注', + PRIMARY KEY (`id`) +) ENGINE=InnoDB AUTO_INCREMENT=6 DEFAULT CHARSET=utf8mb4 COMMENT='标签'; + +/*Data for the table `sg_tag` */ + +insert into `sg_tag`(`id`,`name`,`create_by`,`create_time`,`update_by`,`update_time`,`del_flag`,`remark`) values (1,'Mybatis',NULL,NULL,NULL,'2022-01-11 09:20:50',0,'weqwe'),(2,'asdas',NULL,'2022-01-11 09:20:55',NULL,'2022-01-11 09:20:55',1,'weqw'),(3,'weqw',NULL,'2022-01-11 09:21:07',NULL,'2022-01-11 09:21:07',1,'qweqwe'),(4,'Java',NULL,'2022-01-13 15:22:43',NULL,'2022-01-13 15:22:43',0,'sdad'),(5,'WAD',NULL,'2022-01-13 15:22:47',NULL,'2022-01-13 15:22:47',0,'ASDAD'); + +/*!40101 SET SQL_MODE=@OLD_SQL_MODE */; +/*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */; +/*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */; +/*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */; diff --git a/sql/sys_user.sql b/sql/sys_user.sql new file mode 100644 index 0000000000000000000000000000000000000000..ecf5bff370e8d6bdb4ce7a8034438e4ec252e967 --- /dev/null +++ b/sql/sys_user.sql @@ -0,0 +1,49 @@ +/* +SQLyog v10.2 +MySQL - 5.5.40 : Database - sg_blog +********************************************************************* +*/ + +/*!40101 SET NAMES utf8 */; + +/*!40101 SET SQL_MODE=''*/; + +/*!40014 SET @OLD_UNIQUE_CHECKS=@@UNIQUE_CHECKS, UNIQUE_CHECKS=0 */; +/*!40014 SET @OLD_FOREIGN_KEY_CHECKS=@@FOREIGN_KEY_CHECKS, FOREIGN_KEY_CHECKS=0 */; +/*!40101 SET @OLD_SQL_MODE=@@SQL_MODE, SQL_MODE='NO_AUTO_VALUE_ON_ZERO' */; +/*!40111 SET @OLD_SQL_NOTES=@@SQL_NOTES, SQL_NOTES=0 */; +CREATE DATABASE /*!32312 IF NOT EXISTS*/`sg_blog` /*!40100 DEFAULT CHARACTER SET utf8mb4 */; + +USE `sg_blog`; + +/*Table structure for table `sys_user` */ + +DROP TABLE IF EXISTS `sys_user`; + +CREATE TABLE `sys_user` ( + `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT '主键', + `user_name` varchar(64) NOT NULL DEFAULT 'NULL' COMMENT '用户名', + `nick_name` varchar(64) NOT NULL DEFAULT 'NULL' COMMENT '昵称', + `password` varchar(64) NOT NULL DEFAULT 'NULL' COMMENT '密码', + `type` char(1) DEFAULT '0' COMMENT '用户类型：0代表普通用户，1代表管理员', + `status` char(1) DEFAULT '0' COMMENT '账号状态（0正常 1停用）', + `email` varchar(64) DEFAULT NULL COMMENT '邮箱', + `phonenumber` varchar(32) DEFAULT NULL COMMENT '手机号', + `sex` char(1) DEFAULT NULL COMMENT '用户性别（0男，1女，2未知）', + `avatar` varchar(128) DEFAULT NULL COMMENT '头像', + `create_by` bigint(20) DEFAULT NULL COMMENT '创建人的用户id', + `create_time` datetime DEFAULT NULL COMMENT '创建时间', + `update_by` bigint(20) DEFAULT NULL COMMENT '更新人', + `update_time` datetime DEFAULT NULL COMMENT '更新时间', + `del_flag` int(11) DEFAULT '0' COMMENT '删除标志（0代表未删除，1代表已删除）', + PRIMARY KEY (`id`) +) ENGINE=InnoDB AUTO_INCREMENT=18 DEFAULT CHARSET=utf8mb4 COMMENT='用户表'; + +/*Data for the table `sys_user` */ + +insert into `sys_user`(`id`,`user_name`,`nick_name`,`password`,`type`,`status`,`email`,`phonenumber`,`sex`,`avatar`,`create_by`,`create_time`,`update_by`,`update_time`,`del_flag`) values (1,'sg','sg333','$2a$10$Jnq31rRkNV3RNzXe0REsEOSKaYK8UgVZZqlNlNXqn.JeVcj2NdeZy','1','0','23412332@qq.com','18888888888','1','https://gimg2.baidu.com/image_search/src=http%3A%2F%2Fi0.hdslb.com%2Fbfs%2Farticle%2F3bf9c263bc0f2ac5c3a7feb9e218d07475573ec8.gi',NULL,'2022-01-05 09:01:56',1,'2022-01-30 15:37:03',0),(3,'sg3','weqe','$2a$10$ydv3rLkteFnRx9xelQ7elOiVhFvXOooA98xCqk/omh7G94R.K/E3O','1','0',NULL,NULL,'0',NULL,NULL,'2022-01-05 13:28:43',NULL,'2022-01-05 13:28:43',0),(4,'sg2','dsadd','$2a$10$kY4T3SN7i4muBccZppd2OOkhxMN6yt8tND1sF89hXOaFylhY2T3he','1','0','23412332@qq.com','19098790742','0',NULL,NULL,NULL,NULL,NULL,0),(5,'sg2233','tteqe','','1','0',NULL,'18246845873','1',NULL,NULL,'2022-01-06 03:51:13',NULL,'2022-01-06 07:00:50',0),(6,'sangeng','sangeng','$2a$10$Jnq31rRkNV3RNzXe0REsEOSKaYK8UgVZZqlNlNXqn.JeVcj2NdeZy','1','0','2312321','17777777777','0',NULL,NULL,'2022-01-16 06:54:26',NULL,'2022-01-16 07:06:34',0),(14787164048662,'weixin','weixin','$2a$10$y3k3fnMZsBNihsVLXWfI8uMNueVXBI08k.LzWYaKsW8CW7xXy18wC','0','0','weixin@qq.com',NULL,NULL,NULL,-1,'2022-01-30 17:18:44',-1,'2022-01-30 17:18:44',0); + +/*!40101 SET SQL_MODE=@OLD_SQL_MODE */; +/*!40014 SET FOREIGN_KEY_CHECKS=@OLD_FOREIGN_KEY_CHECKS */; +/*!40014 SET UNIQUE_CHECKS=@OLD_UNIQUE_CHECKS */; +/*!40111 SET SQL_NOTES=@OLD_SQL_NOTES */; diff --git "a/sql/\350\257\264\346\230\216.txt" "b/sql/\350\257\264\346\230\216.txt" new file mode 100644 index 0000000000000000000000000000000000000000..4adc2f530dde4b5268d89e6f6db0a8ba689f8f05 --- /dev/null +++ "b/sql/\350\257\264\346\230\216.txt" @@ -0,0 +1 @@ +sg_menu.sql里面包含好几张表 \ No newline at end of file