写点什么

java 后端博客系统文章系统——No4

用户头像
猿灯塔
关注
发布于: 2020 年 07 月 13 日
java 后端博客系统文章系统——No4

这一期我们的目标是完成后端博客系统的博客发布功能。


按照我们前面的设定,我们的后端博客系统需要完成最简单的博文发布,我们也得有后台管理界面,同时需要将用户权限这些都附带上,但是由于时间关系,我们后端默认账户就是管理员吧,毕竟这一期的重点是实现博客的发布。

 

 

我们需要发布博文,那么后端必不可少的是登录和发布系统,至于其他的我们可以先缓一缓,毕竟我也没想好后端页面怎么设计,嘿嘿。


前面我看了一下,确实是完美兼容 WordPress 还是有很多难度,毕竟很多技术细节我们并不知道,不过,至少说目前我们已经兼容了博客文章,剩下的只需要一点点的适配就能大概完成任务。


不多说了,我们先完成后端登录功能。

 

后端登录

后端登录,我们不可能说一味的兼容 WordPress,还有一些技术上面的设计理念可能也不是那么那啥,所以我们需要拿出一些自己的玩意。首先还是老规矩,从 Dao→Service→Controller。


  • Dao 按照老规矩就是对数据库的操作,所以我们只需要写上接口和 mapper 就行了。

  • Service 层还是一样进行单元数据操作。

  • Controller 是 web 应用的入口地点。

 

有了上面的这些我们只需要进行一个登录验证,也就是前面说过的密码规则验证,不过具体代码如下:

 

 

虽然说很多东西我们在前端或者是客户端已经做了限制,但是为了防止别人搞事情我们还是需要这样做才行。

 

Spring-Fox,Api 测试页面

什么是 Spring-Fox 呢?Springfox 的前身是 swagger-springmvc,是一个开源的 API doc 框架,可以将我们的 Controller 的方法以文档的形式展现。


为什么我们要大费周章的做这些呢?


  • 它可以帮助我们归类 web 访问入口

  • 它可以整理接口

  • 它可以···

 

确实语言描述是我的弱点,不过呢,我这个理工直男癌就需要直截了当的说出来,没时间解释,直接上图。


 

正如上面的截图所示,我们首先应该找到对应的 spring-fox 的说明文档,然后仔细一看网上分为两个版本,一个是开源中国的引入说明,一个是Spring-Fox官方的使用说明,那么肯定选择官方的。


按照官方文档,我们简单总结一下:

  • 版本选择(Release 或者 Snapshot,推荐使用 Release)

  • 依赖引入(maven 或者 gradle)

  • swagger 设置

  • 重要细节(Spring-Fox 官方文档中没有指明!!!)

 

按照官方文档说明的是,他们的 demo 是在 SpringBoot 下面实现的,现在我们需要单一的拆分出来,可以看成我们的项目就是 Spring-Mvc,所以一些细节需要改变,当然当中一个很重要的细节官方文档也是没有指明,所以看官们且看我细细道来。

 

 

首先我们引入引来资源,通读全文最基本的依赖是:springfox-swagger、springfox-swagger-ui,所以我们直接老规矩,在 gradle 的配置文件中引入依赖:

 

 

在引入上面的基本依赖后,我们查看他们关联的依赖可以发现这些依赖里面还有引入 jackson,这个时候我们可以选择提升我们的 Jackson 或者不管他们也行,不过我还是吧 Jackson 的版本提升了:

 

 

 

根据官方文档我们可以看到有一个 swagger 设置需要先引入后,才能让我们设定的东西生效,所以我们先引入设置:

 

 

设置完成上面的东西后,我们需要干什么呢? 上面我们很明显的看到我们 @configuration 是一个 spring 框架的注解,顾名思义肯定就应该是一个 spring 的设置。同时我们可以在 idea 的编辑器中看到类名有一层淡黄色的标记,然后选中类名按下代码提示(Alt+Enter)会有提示告诉我们这个设置没有使用,然后自动完成后会给我们自动添加到 Spring 的 ApplicationContext 中作为 CodeContext 使用。

 

当然,上面的是懒人做事这样做的后果会是导致 apiInfo 的设置不能生效。

 

那么正常一点的应该是怎么做呢?按照 Spring 的思想来说,我们需要在 Spring 的设置文件中直接引入 bean。所以我们在 spring-web.xml 中插入对应的 bean,如下:

 

 

通过这样的在 spring 的配置文件中设置后,我们感觉应该是能用的,所以我们可以先跑起来看看

 

按照官方文档我们完全设定了后,我们可以看到就算我们在代码中引入了配置后,一样的在里面不能看到网页的接口列表(只看得到上面的标题栏,下面的是空白),然后我们仔细的查看网页的请求会发现

 

 

这个请求是 404。说实话这个错误困扰了我很久,同时这个问题前面我处理的时候还是有一系列的综合问题,后面整个工程师重建后完成的


但是现在这个问题简单直接找到问题所在了,那就是在我们 spring 的设置中,关于 web 的设置我们都是在 spring-web.xml 中完成的,同时里面的东西我们需要改动一下才能适应现在的需要,如下:

 

 

也就是说,我们除了要在 Spring 的配置文件中引入 bean 来初始化 swagger 相关的东西以外,我们还需要在 web 扫描那里添加 springfox 的扫描。所以我们 spring-fox 的设置相关的完成了。

 

 

从前面的学习中我们可以明白我们所有的网络请求都是在 controller 中来实现的,所以我们这里需要通过对 controller 做适当的修改才能实现 SpringFox 的使用。具体的直接仍代码上来,大家详细的看看就行了,不需要什么深入钻研。

 

 

至此我们的 Spring-Fox 简单实用已经完成,后续的操作我们在需要的地方再查找资料就行了。

 

总结

本期项目都是简单的介绍了一些东西,主要有:


  • 登录密码校验规则(MD5→SHA256)

  • Spring-Fox 的引入

  • Spring-Fox 在非 springBoot 中的使用

  • Spring-Fox 的使用

 

用户头像

猿灯塔

关注

猿灯塔-做程序员的引导者! 2020.04.02 加入

我们立志作为IT行业知识大海的一座座灯塔,为想在这个行业中奋斗的你们指明正确的方向,引领大家一起前进。

评论

发布
暂无评论
java 后端博客系统文章系统——No4