[java 手把手教程][第二季]java 後端部落格系統文章系統——No4

pc859107393發表於2019-03-01

轉眼間第二季來到了第五章,也是我們部落格系統的第四章。前段時間因為個人私事較多,專案停更了兩期,但是這都不是問題,我們繼續接著走下去。畢竟承諾的事情就得完成。

這一期我們的目標是完成後端部落格系統的部落格釋出功能。

按照我們前面的設定,我們的後端部落格系統需要完成最簡單的博文釋出,我們也得有後臺管理介面,同時需要將使用者許可權這些都附帶上,但是由於時間關係,我們後端預設賬戶就是管理員吧,畢竟這一期的重點是實現部落格的釋出。


博文釋出系統

我們需要釋出博文,那麼後端必不可少的是登入和釋出系統,至於其他的我們可以先緩一緩,畢竟我也沒想好後端頁面怎麼設計,嘿嘿。

前面我看了一下,確實是完美相容WordPress還是有很多難度,畢竟很多技術細節我們並不知道,不過,至少說目前我們已經相容了部落格文章,剩下的只需要一點點的適配就能大概完成任務。

不多說了,我們先完成後端登入功能。

後端登入

後端登入,我們不可能說一味的相容WordPress,還有一些技術上面的設計理念可能也不是那麼那啥,所以我們需要拿出一些自己的玩意。首先還是老規矩,從Dao→Service→Controller。

  • Dao按照老規矩就是對資料庫的操作,所以我們只需要寫上介面和mapper就行了。
  • Service層還是一樣進行單後設資料操作。
  • Controller是web應用的入口地點。
    有了上面的這些我們只需要進行一個登入驗證,也就是前面說過的密碼規則驗證,不過具體程式碼如下:
@RequestMapping(value = "/login"
            , produces = {APPLICATION_JSON_UTF8_VALUE}
            , method = RequestMethod.POST)
    @ApiOperation(
            value = "使用者登入"
            , notes = "使用者登入的介面,輸入使用者名稱和密碼進行登入"
            , response = User.class)
    @ResponseBody
    public Object userLogin(HttpServletRequest request,
                            @ApiParam(value = "使用者名稱不能為空,否則不允許登入"
                                    , required = true) @RequestParam("userLogin") String userLogin,
                            @ApiParam(value = "使用者密碼不能為空且必須為16位小寫MD5,否則不允許登入"
                                    , required = true) @RequestParam("userPass") String userPass) {
        ResponseObj<User> responseObj = new ResponseObj<>();
        User user;
        if (PublicUtil.isJsonRequest(request)) {    //確認是否是post的json提交
            try {
                user = new GsonUtils().jsonRequest2Bean(request.getInputStream(), User.class);  //轉換為指定型別的物件
                userLogin = user.getUserLogin();
                userPass = user.getUserPass();
            } catch (IOException e) {
                e.printStackTrace();
            }
        }

        if (StringUtils.isEmpty(userLogin) || StringUtils.isEmpty(userPass)) {
            responseObj.setCode(ResponseObj.FAILED);
            responseObj.setMsg("使用者名稱和密碼不能為空!請檢查!");
            return new GsonUtils().toJson(responseObj);
        }

        user = userService.findOneById(userLogin);

        if (null == user) {
            responseObj.setCode(ResponseObj.EMPUTY);
            responseObj.setMsg("使用者不存在!請檢查!");
            return new GsonUtils().toJson(responseObj);
        }

        userPass = userPass.toLowerCase();  //將大寫md5轉換為小寫md5

        if (userPass.length() > 16 && userPass.length() == 32) {    //32位小寫轉換為16位小寫
            userPass = userPass.substring(8, 24).toLowerCase();
        } else if (userPass.length() > 32) {
            responseObj.setCode(ResponseObj.FAILED);
            responseObj.setMsg("密碼不規範!請檢查!");
            return new GsonUtils().toJson(responseObj);
        }

        String encryptPassword = EncryptUtils.encryptPassword(userPass, user.getUserActivationKey());

        if (!encryptPassword.equals(user.getUserPass())) {
            responseObj.setCode(ResponseObj.FAILED);
            responseObj.setMsg("使用者名稱和密碼不匹配!請檢查!");
            return new GsonUtils().toJson(responseObj);
        }

        user.setUserPass(request.getSession().getId()); //將sessionId放入使用者資訊中
        user.setUserActivationKey("");  //將使用者註冊的salt清空
        user.setUserUrl("/user/endSupport/index");

        responseObj.setData(user);
        responseObj.setCode(ResponseObj.OK);
        responseObj.setMsg("登入成功");

        return new GsonUtils().toJson(responseObj);
    }複製程式碼

雖然說很多東西我們在前端或者是客戶端已經做了限制,但是為了防止別人搞事情我們還是需要這樣做才行。

Spring-Fox,Api測試頁面

什麼是Spring-Fox呢?Springfox的前身是swagger-springmvc,是一個開源的API doc框架,可以將我們的Controller的方法以文件的形式展現。

為什麼我們要大費周章的做這些呢?

  • 它可以幫助我們歸類web訪問入口
  • 它可以整理介面
  • 它可以···

確實語言描述是我的弱點,不過呢,我這個理工直男癌就需要直截了當的說出來,沒時間解釋,直接上圖。

[java 手把手教程][第二季]java 後端部落格系統文章系統——No4
我的部落格第五章-API_doc框架

正如上面的截圖所示,我們首先應該找到對應的spring-fox的說明文件,然後仔細一看網上分為兩個版本,一個是開源中國的引入說明,一個是Spring-Fox官方的使用說明,那麼肯定選擇官方的。

按照官方文件,我們簡單總結一下:

  • 版本選擇(Release或者Snapshot,推薦使用Release)
  • 依賴引入(maven或者gradle)
  • swagger設定
  • 重要細節(Spring-Fox官方文件中沒有指明!!!)

按照官方文件說明的是,他們的demo是在SpringBoot下面實現的,現在我們需要單一的拆分出來,可以看成我們的專案就是Spring-Mvc,所以一些細節需要改變,當然當中一個很重要的細節官方文件也是沒有指明,所以看官們且看我細細道來。

引入依賴資源

首先我們引入引來資源,通讀全文最基本的依賴是:springfox-swagger、springfox-swagger-ui,所以我們直接老規矩,在gradle的配置檔案中引入依賴:

compile "io.springfox:springfox-swagger2:2.6.1"
compile 'io.springfox:springfox-swagger-ui:2.6.1'複製程式碼

在引入上面的基本依賴後,我們檢視他們關聯的依賴可以發現這些依賴裡面還有引入jackson,這個時候我們可以選擇提升我們的Jackson或者不管他們也行,不過我還是吧Jackson的版本提升了:

compile group: 'com.fasterxml.jackson.core', name: 'jackson-databind', version: '2.8.4'
compile group: 'com.fasterxml.jackson.core', name: 'jackson-annotations', version: '2.8.4'
compile group: 'com.fasterxml.jackson.core', name: 'jackson-core', version: '2.8.4'複製程式碼

swagger設定

根據官方文件我們可以看到有一個swagger設定需要先引入後,才能讓我們設定的東西生效,所以我們先引入設定:

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Import;
import org.springframework.web.servlet.config.annotation.EnableWebMvc;
import org.springframework.web.servlet.config.annotation.ResourceHandlerRegistry;
import org.springframework.web.servlet.config.annotation.WebMvcConfigurerAdapter;
import springfox.documentation.builders.ApiInfoBuilder;
import springfox.documentation.builders.PathSelectors;
import springfox.documentation.builders.RequestHandlerSelectors;
import springfox.documentation.service.ApiInfo;
import springfox.documentation.spi.DocumentationType;
import springfox.documentation.spring.web.plugins.Docket;
import springfox.documentation.swagger2.annotations.EnableSwagger2;

/**
 * Created by mac on 2017/1/8.
 */
@Configuration  //說明這個是spring的設定
@EnableWebMvc   //不是SpringBoot需要引入這個
@EnableSwagger2 //開啟Swagger2
@ComponentScan("cn.acheng1314.controller")  //指定被掃描Controller的位置
public class Swagger2SpringMvc extends WebMvcConfigurerAdapter {

    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)  //Docket,Springfox的私有API設定初始化為Swagger2
                .select()
//                .apis(RequestHandlerSelectors.basePackage("cn.acheng1314.controller"))    //此處設定掃描包和上面設定的掃描包一樣效果
                .paths(PathSelectors.any())
                .build()
                .apiInfo(new ApiInfoBuilder()  //設定API文件的主體說明
                        .title("部落格Apis")
                        .description("雨下一整夜的部落格APIs")
                        .version("1.01")
                        .termsOfServiceUrl("http://acheng1314.cn/")
                        .build())
//                .pathMapping("/")
//                .genericModelSubstitutes(ResponseEntity.class)
//                .alternateTypeRules(
//                        newRule(typeResolver.resolve(DeferredResult.class,
//                                typeResolver.resolve(ResponseEntity.class, WildcardType.class)),
//                                typeResolver.resolve(WildcardType.class)))
                ;
    }

}複製程式碼

設定完成上面的東西后,我們需要幹什麼呢? 上面我們很明顯的看到我們 @configuration是一個spring框架的註解 ,顧名思義肯定就應該是一個spring的設定。同時我們可以在idea的編輯器中看到類名有一層淡黃色的標記,然後選中類名按下程式碼提示(Alt+Enter)會有提示告訴我們這個設定沒有使用,然後自動完成後會給我們自動新增到Spring的ApplicationContext中作為CodeContext使用。

當然,上面的是懶人做事這樣做的後果會是導致apiInfo的設定不能生效。

那麼正常一點的應該是怎麼做呢?按照Spring的思想來說,我們需要在Spring的設定檔案中直接引入bean。所以我們在spring-web.xml中插入對應的bean,如下:

<!--SpringFox設定引入-->
<bean id="SpringFox" class="cn.acheng1314.Swagger2SpringMvc"/>複製程式碼

通過這樣的在spring的配置檔案中設定後,我們感覺應該是能用的,所以我們可以先跑起來看看。

重要細節,我有特殊的裝X技巧

按照官方文件我們完全設定了後,我們可以看到就算我們在程式碼中引入了配置後,一樣的在裡面不能看到網頁的介面列表(只看得到上面的標題欄,下面的是空白),然後我們仔細的檢視網頁的請求會發現

http://localhost:8080/swagger-resources/configuration/ui複製程式碼

這個請求是404。說實話這個錯誤困擾了我很久,同時這個問題前面我處理的時候還是有一系列的綜合問題,後面整個工程師重建後完成的。

但是現在這個問題簡單直接找到問題所在了,那就是在我們spring的設定中,關於web的設定我們都是在spring-web.xml中完成的,同時裡面的東西我們需要改動一下才能適應現在的需要,如下:

<!-- 4.掃描web相關的bean -->
    <context:component-scan base-package="cn.acheng1314.controller">
        <!-- 制定掃包規則 ,只掃描使用@Controller註解的JAVA類 -->
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>

<!--上面的是原來的設定,現在我們新的程式碼如下:-->
<!-- 4.掃描web相關的bean -->
    <context:component-scan base-package="cn.acheng1314.controller,springfox">
        <!-- 制定掃包規則 ,只掃描使用@Controller註解的JAVA類 -->
        <context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
    </context:component-scan>複製程式碼

也就是說,我們除了要在Spring的配置檔案中引入bean來初始化swagger相關的東西以外,我們還需要在web掃描那裡新增springfox的掃描。所以我們spring-fox的設定相關的完成了。

Spring-Fox的使用

從前面的學習中我們可以明白我們所有的網路請求都是在controller中來實現的,所以我們這裡需要通過對controller做適當的修改才能實現SpringFox的使用。具體的直接仍程式碼上來,大家詳細的看看就行了,不需要什麼深入鑽研。


import cn.acheng1314.domain.*;
import cn.acheng1314.domain.Response.HomeBean;
import cn.acheng1314.service.postService.PostService;
import cn.acheng1314.service.userService.UserService;
import cn.acheng1314.utils.GsonUtils;
import cn.acheng1314.utils.PublicUtil;
import io.swagger.annotations.Api;
import io.swagger.annotations.ApiOperation;
import io.swagger.annotations.ApiParam;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.*;
import org.springframework.web.servlet.ModelAndView;

import javax.servlet.http.HttpServletRequest;
import java.util.HashMap;
import java.util.List;

import static org.springframework.http.MediaType.APPLICATION_JSON_UTF8_VALUE;

/**
 * 前端頁面的控制器,部落格系統前端頁面相對較少,所以都扔在這裡了
 * Created by 程 on 2016/11/25.
 */
@Controller
@RequestMapping("/front")
@Api(value = "/front", description = "前臺頁面")
public class FrontWebController {

    @Autowired
    private PostService postService;
    @Autowired
    private UserService userService;

    /**
     * 返回主頁面
     *
     * @return
     */
    @RequestMapping(value = "/main", method = RequestMethod.GET)
    @ApiOperation(
            value = "開啟首頁介面"
            , notes = "首頁web介面,js模板載入網頁資料")
    public ModelAndView frontMain(HttpServletRequest request) throws Exception {
        ModelAndView view = new ModelAndView("frontMain");
        view.addObject("framJson", getFramJson());
        view.addObject("postsJson", findPublishPost(request, 1, 10));
        return view;
    }

    /**
     * 獲取文章分頁列表
     *
     * @param request  使用者請求
     * @param pageNum  當前頁碼
     * @param pageSize 每一頁的長度
     * @return
     * @throws Exception
     */
    @RequestMapping(value = "/findPublishPost"
            , produces = {APPLICATION_JSON_UTF8_VALUE}
            , method = {RequestMethod.GET, RequestMethod.POST})
    @ResponseBody
    @ApiOperation(  //介面描述
            value = "獲取文章分頁列表"  //功能簡介
            , notes = "返回文章列表,分頁載入" //介面功能說明
            , response = PostBean.class,    //返回資料的值說明
            responseContainer = "List") //返回資料型別說明
    public Object findPublishPost(HttpServletRequest request,
                                  @ApiParam(value = "當前頁碼,預設不能為空,否則為1",
                                          required = true,    //引數是否必傳
                                          defaultValue = "1" //引數預設值為1
//            ,allowableValues = "available,pending,sold"   //暫時未知,待查閱文章
//            ,allowMultiple = true    //是否允許allowMultiple型別的引數
                                  ) @RequestParam("pageNum")
                                          int pageNum,
                                  @ApiParam(value = "每一頁的長度,預設不能為空,否則列表條目數量為10",
                                          required = true,    //引數是否必傳
                                          defaultValue = "10" //引數預設值為1
//            ,allowableValues = "available,pending,sold"   //暫時未知,待查閱文章
//            ,allowMultiple = true    //是否允許allowMultiple型別的引數
                                  ) @RequestParam("pageSize")
                                          int pageSize) throws Exception {
        PageSplit page;
        ResponseList<PostBean> list = new ResponseList<>();

        if (PublicUtil.isJsonRequest(request)) {    //確認是否是post的json提交
            page = new GsonUtils().jsonRequest2Bean(request.getInputStream(), PageSplit.class);  //轉換為指定型別的物件
            pageNum = page.getPageNum();
            pageSize = page.getPageSize();
        }
        if (pageNum <= 0) {
            pageNum = 1;
        }
        if (pageSize == 0) {
            pageSize = 10;
        }

        try {
            int toalNum; //總頁碼
            toalNum = postService.getAllCount();    //先把總條數賦值給總頁數,作為快取變數,減少下面演算法的查詢次數

            toalNum = toalNum % pageSize > 0 ? toalNum / pageSize + 1 : toalNum / pageSize;     //在每頁固定條數下能不能分頁完成,有餘則加一頁碼

            List<PostBean> tmp = postService.findAllPublish(pageNum, pageSize);
            if (null == tmp || tmp.size() == 0) {
                list.setCode(ResponseList.EMPUTY);
                list.setMsg(ResponseList.EMPUTY_STR);
                return new GsonUtils().toJson(list);
            }
            list.setCode(ResponseList.OK);
            list.setMsg(ResponseList.OK_STR);
            list.setPageNum(pageNum);
            list.setTotalNum(toalNum);
            list.setPageSize(pageSize);
            list.setData(tmp);
            return new GsonUtils().toJson(list);
        } catch (Exception e) {
            e.printStackTrace();
            //查詢失敗
            list.setCode(ResponseObj.FAILED);
            list.setMsg(ResponseList.FAILED_STR);
            return new GsonUtils().toJson(list);
        }

    }

    /**
     * 查詢最近的文章
     *
     * @return
     */
    @RequestMapping(value = "/findNewPost"
            , produces = {APPLICATION_JSON_UTF8_VALUE}
            , method = {RequestMethod.GET, RequestMethod.POST})
    @ApiOperation(
            value = "獲取最近文章"
            , notes = "獲取最近文章的json,具體欄位請參照輸出的json資料"
            , response = PostBean.class)
    @ResponseBody
    public Object findNewPost() {
        ResponseObj<Object> responseObj = new ResponseObj<>();
        try {
            List<PostBean> allNew = postService.findAllNew();
            if (null == allNew || allNew.isEmpty()) {
                responseObj.setCode(ResponseObj.EMPUTY);
                responseObj.setMsg(ResponseObj.EMPUTY_STR);
            } else {
                responseObj.setCode(ResponseObj.OK);
                responseObj.setMsg(ResponseObj.OK_STR);
                responseObj.setData(allNew);
            }
            return new GsonUtils().toJson(responseObj);
        } catch (Exception e) {
            e.printStackTrace();
            responseObj.setCode(ResponseObj.FAILED);
            responseObj.setMsg(ResponseObj.FAILED_STR);
            return new GsonUtils().toJson(responseObj);
        }
    }

    /**
     * 獲取熱點文章資訊
     *
     * @return
     */
    @RequestMapping(value = "/findHotPost"
            , produces = {APPLICATION_JSON_UTF8_VALUE}
            , method = {RequestMethod.GET, RequestMethod.POST})
    @ApiOperation(
            value = "獲取最熱文章"
            , notes = "獲取最熱文章的json,具體欄位請參照輸出的json資料"
            , response = PostBean.class)
    @ResponseBody
    public Object findHotPost() {
        return findNewPost();
    }

    /**
     * 獲取隨機文章資訊
     *
     * @return 返回json
     */
    @RequestMapping(value = "/findRandomPost"
            , produces = {APPLICATION_JSON_UTF8_VALUE}
            , method = {RequestMethod.GET, RequestMethod.POST})
    @ApiOperation(
            value = "隨機獲取文章"
            , notes = "隨機獲取文章的json,具體欄位請參照輸出的json資料"
            , response = PostBean.class)
    @ResponseBody
    public Object findRandomPost() {
        return findNewPost();
    }

    /**
     * 獲取主頁的json資料,按照道理講這裡應該根據頁面結構拆分組合的
     *
     * @param user 使用者資訊
     * @return 返回首頁json
     */
    @RequestMapping(value = "/home"
            , produces = {APPLICATION_JSON_UTF8_VALUE}
            , method = {RequestMethod.GET, RequestMethod.POST})
    @ResponseBody
    @Deprecated
    public Object getHomeJson(User user) {
        if (null != user) {
            //埋點,AOP日誌記錄
        }
        HomeBean homeBean = new HomeBean(); //首頁內容
        HomeBean.DataBean dataBean = new HomeBean.DataBean();   //首頁下面的Data內容物件
        try {
            int toalNum; //總頁碼

            toalNum = postService.getAllCount();    //先把總條數賦值給總頁數,作為快取變數,減少下面演算法的查詢次數

            toalNum = toalNum % 10 > 0 ? toalNum / 10 + 1 : toalNum / 10;     //在每頁固定條數下能不能分頁完成,有餘則加一頁碼

            List<PostBean> postsData = postService.findAllPublish(1, 10);   //首頁下面的文章內容
            List<PostBean> newData = postService.findAllNew();   //首頁下面的文章內容
            if (null == postsData || postsData.isEmpty()) {
                dataBean.setPosts(null);
            } else {
                dataBean.setPosts(postsData);   //首頁文章列表資訊設定
            }
            if (null == newData || newData.isEmpty()) {
                dataBean.setNewPosts(null);
                dataBean.setHotPosts(null);
                dataBean.setRandomPosts(null);
            } else {
                dataBean.setNewPosts(newData);   //首頁文章列表資訊設定
                dataBean.setHotPosts(newData);
                dataBean.setRandomPosts(newData);
            }
            List<DateCountBean> allPostDateCount = postService.getAllPostDateCount();
            if (null != allPostDateCount && !allPostDateCount.isEmpty()) {
                dataBean.setDate(allPostDateCount);
            } else {
                dataBean.setDate(null);
            }
            //設定作者資訊
            List<HashMap<String, String>> userMeta = userService.getUserMeta(1);
            dataBean.setAuthor(userMeta);

            dataBean.setPageNum(1);
            dataBean.setPageSize(10);
            dataBean.setTotalNum(toalNum);
            homeBean.setData(dataBean);
            homeBean.setCode(ResponseObj.OK);
            homeBean.setMsg(ResponseList.OK_STR);
            return new GsonUtils().toJson(homeBean);
        } catch (Exception e) {
            e.printStackTrace();
            //查詢失敗
            homeBean.setCode(ResponseObj.FAILED);
            homeBean.setMsg(ResponseList.FAILED_STR);
            return new GsonUtils().toJson(homeBean);
        }
    }

    /**
     * 頁面框架的變化資訊
     * 1、個人資訊
     * 2、最新熱點隨機文章資訊
     * 3、標籤資訊
     *
     * @return
     */
    @RequestMapping(value = "/getFramJson"
            , produces = {APPLICATION_JSON_UTF8_VALUE}
            , method = {RequestMethod.GET, RequestMethod.POST})
    @ApiOperation(
            value = "獲取主題框架的json"
            , notes = "整個頁面的主體框架的json資料")
    @ResponseBody
    public Object getFramJson() {
        HomeBean homeBean = new HomeBean(); //首頁內容
        HomeBean.DataBean dataBean = new HomeBean.DataBean();   //首頁下面的Data內容物件
        try {
            List<PostBean> newData = postService.findAllNew();
            if (null == newData || newData.isEmpty()) {
                //頁面上面推薦的文章資訊不為空
                dataBean.setNewPosts(null);
                dataBean.setHotPosts(null);
                dataBean.setRandomPosts(null);
            } else {
                //首頁文章列表資訊設定
                dataBean.setNewPosts(newData);
                dataBean.setHotPosts(newData);
                dataBean.setRandomPosts(newData);
            }

            //日期歸檔
            List<DateCountBean> allPostDateCount = postService.getAllPostDateCount();
            if (null != allPostDateCount && !allPostDateCount.isEmpty()) {
                dataBean.setDate(allPostDateCount);
            } else {
                dataBean.setDate(null);
            }
            //設定作者資訊
            List<HashMap<String, String>> userMeta = userService.getUserMeta(1);
            dataBean.setAuthor(userMeta);

            homeBean.setData(dataBean);
            homeBean.setCode(ResponseObj.OK);
            homeBean.setMsg(ResponseList.OK_STR);
            return new GsonUtils().toJson(homeBean);
        } catch (Exception e) {
            e.printStackTrace();
            //查詢失敗
            homeBean.setCode(ResponseObj.FAILED);
            homeBean.setMsg(ResponseList.FAILED_STR);
            return new GsonUtils().toJson(homeBean);
        }
    }

    /**
     * 根據作者的ID獲取作者的資訊
     *
     * @param userId 作者ID
     * @return 返回作者的json資訊
     */
    @RequestMapping(value = "/getAuthorInfo"
            , produces = {APPLICATION_JSON_UTF8_VALUE}
            , method = {RequestMethod.GET, RequestMethod.POST})
    @ApiOperation(
            value = "獲取作者資訊"
            , notes = "獲取作者基本資訊的json,具體欄位請參照輸出的json資料"
            , response = PostBean.class)
    @ResponseBody
    public Object getAuthorJson(int userId) {
        ResponseObj<Object> responseObj = new ResponseObj<>();
        try {
            List<HashMap<String, String>> userMeta = userService.getUserMeta(userId);
            if (null == userMeta || userMeta.isEmpty()) {
                responseObj.setCode(ResponseObj.EMPUTY);
                responseObj.setMsg(ResponseObj.EMPUTY_STR);
            } else {
                responseObj.setCode(ResponseObj.OK);
                responseObj.setMsg(ResponseObj.OK_STR);
                responseObj.setData(userMeta);
            }
            return new GsonUtils().toJson(responseObj);
        } catch (Exception e) {
            e.printStackTrace();
            responseObj.setCode(ResponseObj.FAILED);
            responseObj.setMsg(ResponseObj.FAILED_STR);
            return new GsonUtils().toJson(responseObj);
        }
    }

    /**
     * RESTful風格的文章頁面
     *
     * @param postId 文章ID
     * @return 返回文章頁面
     */
    @RequestMapping(path = "/post/{postId}", method = RequestMethod.GET)
    @ApiOperation(
            value = "開啟文章詳情web介面"
            , notes = "文章詳情web介面,js模板載入網頁資料")
    public ModelAndView getPostView(@PathVariable int postId) {
        ModelAndView resultView = new ModelAndView("frontPost");
        resultView.addObject("framJson", getFramJson());
        resultView.addObject("postJson", getPostById(postId));
        return resultView;
    }

    /**
     * 根據文章ID獲取文章內容
     *
     * @param postId 文章ID
     * @return 返回文章ID對應的文章內容
     */
    @RequestMapping(value = "/getPost"
            , produces = {APPLICATION_JSON_UTF8_VALUE}
            , method = {RequestMethod.GET, RequestMethod.POST})
    @ApiOperation(
            value = "根據id獲取文章json"
            , notes = "根據文章的ID獲取文章的詳情json"
            , response = PostBean.class)
    @ResponseBody
    public Object getPostById(
            @ApiParam(value = "文章ID", required = true)
            @RequestParam("postId")
                    int postId) {
        ResponseObj<Object> responseObj = new ResponseObj<>();
        try {
            PostBean postBean = postService.findPostById(postId);
            if (null == postBean) {
                responseObj.setCode(ResponseObj.EMPUTY);
                responseObj.setMsg(ResponseObj.EMPUTY_STR);
            } else {
                responseObj.setCode(ResponseObj.OK);
                responseObj.setMsg(ResponseObj.OK_STR);
                responseObj.setData(postBean);
            }
            return new GsonUtils().toJson(responseObj);
        } catch (Exception e) {
            e.printStackTrace();
            responseObj.setCode(ResponseObj.FAILED);
            responseObj.setMsg(ResponseObj.FAILED_STR);
            return new GsonUtils().toJson(responseObj);
        }
    }

}複製程式碼

至此我們的Spring-Fox簡單實用已經完成,後續的操作我們在需要的地方再查詢資料就行了。

總結

本期專案都是簡單的介紹了一些東西,主要有:

  • 登入密碼校驗規則(MD5→SHA256)
  • Spring-Fox的引入
  • Spring-Fox在非springBoot中的使用
  • Spring-Fox的使用

這一期本來是上一週就應該完成的,但是回家懶癌發作又拖了一週,期間女朋友還各種生病,每天也沒心思寫程式碼,很對不起大家了,後面我會更加努力,也感謝一些哥們在我部落格上面的留言鼓勵,謝謝大家。

相關文章