项目的功能架构

项目背景

学成在线借鉴了 MOOC（大型开放式网络课程，即 MOOC（massive open online courses））的设计思想，是一个提供IT职业课程在线学习的平台

功能模块

当前市场的在线教育模式多种多样，包括：B2C、C2C、B2B2C等业务模式，学成在线采用B2B2C业务模式，即向企业或个人提供在线教育平台提供教学服务，老师和学生通过平台完成整个教学和学习的过程

市场上类似的平台有：网易云课堂、腾讯课堂等，学成在线的特点是IT职业课程在线教学。

学成在线包括门户、学习中心、教学管理中、社交系统、系统管理等功能模块

功能模块名称	功能说明
门户	在首页、活动页、专题页等页面提供课程学习入口。
学习中心	学生登录学习中心在线学习课程。
社交系统	社交系统为老师和学生交流搭建沟通的平台，包括：问答系统、评论系统、论坛等，学生和老师 通过问答系统提问问题、回答问题，通过评论系统对老师授课进行评论。
教学管理中心	教师登录教学管理中心进行课程管理、资源管理、考试管理等教学活动。
系统管理中心	系统管理员登录系统管理中心进行分类管理、运维管理等功能。

项目原型

参考课堂资料的“界面原型”。

项目的技术架构

技术架构

学成在线采用当前流行的前后端分离架构开发，由用户层、UI层、微服务层、数据层等部分组成，为PC、App、H5等客户端用户提供服务。下图是系统的技术架构图

业务流程举例：

1. 用户可以通过pc、手机等客户端访问系统进行在线学习。
2. 系统应用CDN技术，对一些图片、CSS、视频等资源从CDN调度访问。
3. 所有的请求全部经过负载均衡器。
4. 对于PC、H5等客户端请求，首先请求UI层，渲染用户界面。
5. 客户端UI请求服务层获取进行具体的业务操作。
6. 服务层将数据持久化到数据库。

各模块说明

序号	名称	功能描述
1	用户层	用户层描述了本系统所支持的用户类型包括：pc用户、app用户、h5用户。pc用户通过浏览器访问系统、app用户通过android、ios手机访问系统，H5用户通过h5页面访问系统
2	CDN	CDN全称Content Delivery Network，即内容分发网络，本系统所有静态资源全部通过CDN加速来提高访问速度。系统静态资源包括：html页面、js文件、css文件、image图片、pdf和ppt及doc教学文档、video视频等
3	负载均衡	系统的CDN层、UI层、服务层及数据层均设置了负载均衡服务，上图仅在UI层前边标注了负载均衡。 每一层的负载均衡会根据系统的需求来确定负载均衡器的类型，系统支持4层负载均衡+7层负载均衡结合的方式，4层负载均衡是指在网络传输层进行流程转发，根据IP和端口进行转发，7层负载均衡完成HTTP协议负载均衡及反向代理的功能，根据url进行请求转发
4	UI层	UI层描述了系统向pc用户、app用户、h5用户提供的产品界面。根据系统功能模块特点确定了UI层包括如下产品界面类型： 1）面向pc用户的门户系统、学习中心系统、教学管理系统、系统管理中心。 2）面向h5用户的门户系统、学习中心系统。 3）面向app用户的门户系统、学习中心系统未在上图标注，在app项目中有详细说明。
5	微服务层	微服务层将系统服务分类三类：前端服务、后端服务及系统服务。 前端服务：主要为学习用户提供学习服务。 后端服务：主要为管理用户提供教学管理服务。 系统服务：公共服务，为系统的所有微服务提供公共服务功能。 服务网关：提供服务路由、负载均衡、认证授权等服务。
6	数据层	数据层描述了系统的数据存储的内容类型，持久化的业务数据使用MySQL和MongoDB保存，其中MongoDB中主要保存系统日志信息。 消息队列：存储系统服务间通信的消息，本身提供消息存取服务，与微服务层的系统服务连接。 索引库：存储课程信息的索引信息，本身提供索引维护及搜索的服务，与微服务层的系统服务连接。 缓存：作为系统的缓存服务，存储课程信息、分类信息、用户信息等，与微服务层的所有服务连接。文件存储：提供系统静态资源文件的分布式存储服务，文件存储服务器作为CDN服务器的数据来源，CDN上的静态资源将最终在文件存储服务器上保存多份。 流媒体服务：作为流媒体服务器，存储所有的流媒体文件。
7	外部系统接口	1）微信、QQ、微博登录接口，本系统和微信、QQ、微博系统对接，用户输入微信、QQ、微博的账号和密码即可登录本系统。2）微信、QQ、微博分享接口，本系统和微信、QQ、微博系统对接，可直接将本系统的课程资源信息分享到微信、QQ、微博。3）支付宝、微信、网银支付接口，本系统提供支付宝、微信、网银三种支付接口。4）短信接口，本系统与第三方平台对接短信发送接口。 5）邮件接口，本系统需要连接第三方的smpt邮件服务器对外发送电子邮件。 6）微信公众号，本系统与微信公众号平台接口，用户通过微信公众号访问H5页面。 7）点播、直播，前期视频点播与直播采用第三方服务方式，本系统与第三方点、直播服务对接，对外提供视频点播与直播服务。 8）OSS存储，前期静态资源文件的存储采用第三方服务方式，本系统与第三方提供的OSS存储服务对接，将系统的静态资源文件存储到第三方提供的OSS存储服务器上。 9）CDN，本系统与第三方CDN服务对接，使用CDN加速服务来提高本系统的访问速度。
8	DevOps	DevOps（英文Development和Operations的组合）是一组过程、方法与系统的统称，用于促进开发（应用程序/软件工程）、技术运营和质量保障（QA）部门之间的沟通、协作与整合。本项目供了许多开发、运营、维护支撑的系统，包括： Eureka服务治理中心：提供服务治理服务，包括：服务注册、服务获取等。 Spring Cloud Config服务配置管理中心：提供服务配置管理服务，包括：配置文件更新、配置文件下发等。Hystrix Dashboard服务熔断监控：监控熔断的请求响应时间、成功率等 。 Zipkin服务追踪监控：监控服务调用链路健康情况。 Jenkins持续集成服务：提供系统持续集成服务。 Git/GitLab代码管理服务:提供git代码管理服务。 ELK日志分析服务:提供elk日志分析服务，包括系统运行日志分析、告警服务。 Docker容器化部署服务：将本系统所有服务采用容器化部署方式。 Maven项目管理工具：提供管理项目所有的Java包依赖、项目工程打包服务。

技术栈

下图是项目技术架构的简图，了解项目所使用的技术栈。

重点了解微服务技术栈：

• 学成在线服务端基于Spring Boot构建，采用Spring Cloud微服务框架。
• 持久层：MySQL、MongoDB、Redis、ElasticSearch
• 数据访问层：使用Spring Data JPA 、Mybatis、Spring Data Mongodb等
• 业务层：Spring IOC、Aop事务控制、Spring Task任务调度、Feign、Ribbon、Spring AMQP、Spring Data Redis等。
• 控制层：Spring MVC、FastJSON、RestTemplate、Spring Security Oauth2+JWT等
• 微服务治理：Eureka、Zuul、Hystrix、Spring Cloud Config等

开发步骤

项目是基于前后端分离的架构进行开发，前后端分离架构总体上包括前端和服务端，通常是多人协作并行开发，开发步骤如下：

1. 需求分析

梳理用户的需求，分析业务流程

2. 接口定义

根据需求分析定义接口

3. 服务端和前端并行开发

依据接口进行服务端接口开发。

前端开发用户操作界面，并请求服务端接口完成业务处理。

4. 前后端集成测试

最终前端调用服务端接口完成业务。

CMS 需求分析

什么是 CMS

1. CMS 是什么？

CMS（Content Management System）即内容管理系统，不同的项目对CMS的定位不同，比如：一个在线教育网站，有些公司认为CMS系统是对所有的课程资源进行管理，而在早期网站刚开始盛行时很多公司的业务是网站制作，当时对CMS的定位是创建网站，即对网站的页面、图片等静态资源进行管理。

2. CMS 有哪些类型？

每个公司对每个项目的CMS定位不同，CMS基本上分为：针对后台数据内容的管理、针对前端页面的管理、针对样式风格的管理等。比如：一个给企业做网站的公司，其CMS系统主要是网站页面管理及样式风格的管理。

3. 本项目 CMS 的定位是什么？

本项目作为一个大型的在线教育平台，对CMS系统的定位是对各网站（子站点）页面的管理，主要管理由于运营需要而经常变动的页面，从而实现根据运营需要快速进行页面开发、上线的需求。

静态门户工程搭建

本项目CMS是对页面进行管理，对页面如何进行管理呢？首先搭建学成网的静态门户工程，根据门户的页面结构来分析页面的管理方案。

门户，是一个网站的入口，一般网站都有一个对外的门户

导入门户工程

1. 安装Nginx
   • 下载nginx：http://nginx.org/en/download.html
   • 原项目下载 nginx-1.14.0.zip(http://nginx.org/download/nginx-1.14.0.zip)。（自己使用nginx-1.14.2版本）
   • 解压nginx-1.14.2.zip到并重名为nginx-1.14.2-xc-edu，移到了D:\development\目录下（本项目专用）
   • 访问测试：http://localhost
2. 导入门户工程
   • 将课程资料【\day01 搭建环境 CMS服务端开发\资料\资料备份\xc-ui-pc-static-portal.rar】中的门户工程解压拷贝到代码目录
   • 使用WebStorm或vsCode打开门户工程，后期会根据开发的推进进行扩充

配置虚拟主机

1. 在nginx中配置虚拟主机，修改\nginx-1.14.2-xc-edu\conf\nginx.conf文件，在alias属性上增加静态门户工程的主目录：

server {
    listen       80;
    server_name  www.xuecheng.com;
    ssi on;
    ssi_silent_errors on;
    location / {
        alias  D:/code/xc-edu-project/xc-edu-project-ui/xc-ui-pc-static-portal/;
        index  index.html index.htm;
    }
}

2. 配置hosts文件，位置：C:\WINDOWS\system32\Drivers\etc\hosts文件

# 学成在线项目配置域名
127.0.0.1  www.xuecheng.com

测试输入：http://www.xuecheng.com

SSI 服务端包含技术

1. 页面内容多如何管理？

将页面拆分成一个一个的小页面，通过cms去管理这些小页面，当要更改部分页面内容时只需要更改具体某个小页面即可。

2. 页面拆出来怎么样通过web服务浏览呢？

使用web服务(例如nginx)的SSI技术，将多个子页面合并渲染输出。

3. SSI是什么？

服务器端内嵌（Server Side Includes，亦简称为SSI）是一种大多数仅应用于互联网上的简单解释性服务器端脚本语言。SSI最常见的用法是将一个或多个文件的内容包含在网页服务器的页面上。

SSI 包含类似于jsp页面中的incluce指令，SSI是在web服务端将include指定 的页面包含在网页中，渲染html网页响应给客户端 。nginx、apache等多数web容器都支持SSI指令。指令格式如下：

<!--#include virtual="/../....html"-->

4. 将首页拆分成

index.html：首页主体内容
include/header.html：头部区域
include/index_banner.html：轮播图
include/index_category.html：左侧列表导航
include/footer.html：页尾

5. 在nginx虚拟主机中开通SSI

server {
    listen       80;
    server_name  www.xuecheng.com;
    ssi on;
    ssi_silent_errors on;
    ......
}

• ssi的配置参数如下：
  • ssi on：开启ssi支持
  • ssi_silent_errors on：默认为off，设置为on则在处理SSI文件出错时不输出错误信息
  • ssi_types：默认为 ssi_types text/html，如果需要支持shtml（服务器执行脚本，类似于jsp）则需要设置为ssi_types text/shtml

6. 测试，去掉某个#include查看页面效果。

CMS 页面管理需求

这些页面的管理流程是什么？

1. 创建站点：一个网站有很多子站点，比如：学成在线有主门户、学习中心、问答系统等子站点。具体的哪个页面是归属于具体的站点，所以要管理页面，先要管理页面所属的站点。
2. 创建模板：页面如何创建呢？比如电商网站的商品详情页面，每个页面的内容布局、板式是相同的，不同的只是内容，这个页面的布局、板式就是页面模板，模板+数据就组成一个完整的页面，最终要创建一个页面文件需要先定义此页面的模板，最终拿到页面的数据再结合模板就拼装成一个完整的页面。
3. 创建页面：创建页面是指填写页面的基本信息，如：页面的名称、页面的url地址等。
4. 页面预览：页面预览是页面发布前的一项工作，页面预览使用静态化技术根据页面模板和数据生成页面内容，并通过浏览器预览页面。页面发布前进行页面预览的目是为了保证页面发布后的正确性。
5. 页面发布：使用计算机技术将页面发送到页面所在站点的服务器，页面发布成功就可以通过浏览器来访问了。

本项目要实现什么样的功能？

1. 页面管理：管理员在后台添加、修改、删除页面信息
2. 页面预览：管理员通过页面预览功能预览页面发布后的效果。
3. 页面发布：管理员通过页面发布功能将页面发布到远程门户服务器。

页面发布成功，用户即可在浏览器浏览到最新发布的页面，整个页面添加、发布的过程由于软件自动执行，无需人工登录服务器操作。

CMS 服务端工程搭建

开发工具配置

1. 复制课程资料准备好的工程代码【\day01 搭建环境 CMS服务端开发\资料\资料备份\基础工程\】到【D:\code\xc-edu-project\xc-edu-project-service\】
2. 配置maven仓库
3. 设置编码UTF-8
4. 配置JDK1.8
5. 自动导入包等自定义配置
6. 配置虚拟机内存
   1. 修改idea64.exe.vmoptions（64位电脑选择此文件）
   2. 一个例子，电脑内存 8G，设置如：-Xms1024m -Xmx4096m -XX:MaxPermSize=1024m -XX:ReservedCodeCacheSize=1024m

导入基础工程

工程结构

CMS及其它服务端工程基于maven进行构建，首先需要创建如下基础工程：

• parent工程：父工程，提供依赖管理。
• common工程：通用工程，提供各层封装
• model工程：模型工程，提供统一的模型类管理
• utils工程：工具类工程，提供本项目所使用的工具类
• Api工程：接口工程，统一管理本项目的服务接口。

基础工程代码及pom.xml配置参考课程资料“基础工程”。

导入工程代码

1. 将课程资料中所有工程拷贝到代码目录
2. 点击Import Model，选择parent工程目录，一直按next导入

3. 依次导入utils、model、common、api工程，方法同parent工和的导入。

CMS系统数据存储选择 - MongoDB

CMS 采用 MongoDB 数据库存储 CMS 页面信息，CMS 选用 Mongodb 的原因如下：

1. Mongodb 是非关系型数据库，存储Json格式数据，数据格式灵活。
2. 相比课程管理等核心数据 CMS 数据不重要，且没有事务管理要求。

安装MongoDB

参考《MongoDb-安装与使用》笔记 或者 课程资料“mongodb安装及入门”文档安装 Mongodb Server 及 Studio 3T 客户端软件。

MongoDB入门

参考《MongoDb-基础》笔记 或者 课程资料“mongodb安装及入门”文档

导入 CMS 数据库

使用 Studio 3T 软件导入 cms 数据库

1. 创建xc_cms数据库

2. 导入cms数据库。

右键数据库，点击导入数据库

打开窗口，选择第一个json，点击下一步

点击“+”号，选择要导入的数据文件（json文件）。再点击Execute执行导入

页面查询接口定义

定义模型

需求分析

在梳理完用户需求后就要去定义前后端的接口，接口定义后前端和后端就可以依据接口去开发功能了。

本次定义页面查询接口，本接口供前端请求查询页面列表，支持分页及自定义条件查询方式。

具体需求如下：

1. 分页查询CmsPage集合下的数据
2. 根据站点Id、模板Id、页面别名查询页面信息
3. 接口基于Http Get请求，响应Json数据

模型类介绍

• CmsSite：站点模型
• CmsTemplate：页面模板
• CmsPage：页面信息

以CmsPage模型类为例说明

@Data
@ToString
@Document(collection = "cms_page")
public class CmsPage {
    /**
     * 页面名称、别名、访问地址、类型（静态/动态）、页面模版、状态
     */
    //站点ID
    private String siteId;
    //页面ID
    @Id
    private String pageId;
    ......
    /* 后面不需要写getter和setter、还有toString() */
}

属性说明：

1. 定义一个页面需要指定页面所属站点

一个站点包括多个页面，比如：学成在线的门户站点（网站）包括了多个页面。

2. 定义一个页面需要指定页面使用的模板

多个页面可以使用相同的模板，比如：商品信息模板，每个商品就是一个页面，所有商品使用同一个商品信息模板

注解说明:

• @Data、@ToString：是Lombok提供的注解，Java的工具类，加上此注解则不需要提供getter、setter和toString()等方法。
• @Document：是Spring Data mongodb提供的注解，最终CMS的开发会使用Mongodb数据库。

Lombok 工具包

简介

Lombok是一个实用的java工具，使用它可以消除java代码的臃肿，Lombok提供一系列的注解，使用这些注解可以不用定义getter/setter、equals、构造方法等，它会在编译时在字节码文件自动生成这些通用的方法，简化开发人员的工作。

项目官方地址：https://www.projectlombok.org/

比如上节创建的UserTest模型，@Data注解可以自动生成getter/setter方法，@ToString生成tostring方法。

使用方法

1. 在项目中添加Lombok的依赖

作用：项目在编译时根据Lombok注解生成通用方法。

<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <version>1.16.16</version>
</dependency>

2. 在IDEA开发工具中添加Lombok插件

作用：使用IDEA开发时根据Lombok注解生成通用方法并提示，不报错。

定义接口

定义CMS系统的请求及响应类

1. 在xc-framework-model模块中，com.xuecheng.framework.domain.cms.request包下创建QueryPageRequest请求模型类，此模型作为查询条件类。为后期扩展需求，请求类型统一继承RequestData类。

package com.xuecheng.framework.domain.cms.request;

import com.xuecheng.framework.model.request.RequestData;
import lombok.Data;
import lombok.ToString;

/**
 * CMS系统查询条件查询类
 */
@Data
public class QueryPageRequest extends RequestData {
    // 站点id
    private String siteId;
    // 页面ID
    private String pageId;
    // 页面名称
    private String pageName;
    // 别名
    private String pageAliase;
    // 模版id
    private String templateId;
}

2. 响应结果类型，分页查询统一使用QueryResponseResult（提供的项目已创建）

定义接口

在 Api接口工程专门定义接口，在Api工程单独定义接口的原因如下：

1. 接口集中管理
2. Api工程的接口将作为各微服务远程调用使用。

页面查询接口定义如下：

public interface CmsPageControllerApi {
    /**
     * 页面查询
     *
     * @param page
     * @param size
     * @param queryPageRequest
     * @return
     */
    public QueryResponseResult findList(int page, int size, QueryPageRequest queryPageRequest);
}

此接口编写后会在CMS服务工程编写Controller类实现此接口。

页面查询服务端开发

创建CMS服务工程

CMS工程结构

1. 创建maven工程， CMS工程的名称为 xc-service-manage-cms，父工程为xc-framework-parent。pom.xml配置如下：

<?xml version="1.0" encoding="UTF-8"?>
<project xmlns="http://maven.apache.org/POM/4.0.0"
         xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
         xsi:schemaLocation="http://maven.apache.org/POM/4.0.0
         http://maven.apache.org/xsd/maven-4.0.0.xsd">
    <parent>
        <artifactId>xc-framework-parent</artifactId>
        <groupId>com.xuecheng</groupId>
        <version>1.0-SNAPSHOT</version>
        <relativePath>../xc-framework-parent/pom.xml</relativePath>
    </parent>
    <modelVersion>4.0.0</modelVersion>
    <artifactId>xc-service-manage-cms</artifactId>
    <name>xc-service-manage-cms</name>
    <packaging>jar</packaging>

    <dependencies>
        <!-- 依赖服务接口 -->
        <dependency>
            <groupId>com.xuecheng</groupId>
            <artifactId>xc-service-api</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
        <!-- 依赖实体工程 -->
        <dependency>
            <groupId>com.xuecheng</groupId>
            <artifactId>xc-framework-model</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
        <!-- 依赖工具、公共工程 -->
        <dependency>
            <groupId>com.xuecheng</groupId>
            <artifactId>xc-framework-utils</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
        <dependency>
            <groupId>com.xuecheng</groupId>
            <artifactId>xc-framework-common</artifactId>
            <version>1.0-SNAPSHOT</version>
        </dependency>
        <!-- 其他Spring boot启动依赖 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-web</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-freemarker</artifactId>
        </dependency>
        <!-- 项目使用spring data mongodb操作mongodb数据库 -->
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-mongodb</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-amqp</artifactId>
        </dependency>
        <dependency>
            <groupId>com.squareup.okhttp3</groupId>
            <artifactId>okhttp</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-test</artifactId>
        </dependency>
    </dependencies>

</project>

注：由于cms工程要连接mongodb所以需要在在cms服务端工程添加spring data mongodb的依赖，用于操作mongodb数据库

2. 创建基本的包结构

• com.xuecheng.manage_cms.config：配置类目录，数据库配置、MQ配置等
• com.xuecheng.manage_cms.dao：dao接口目录
• com.xuecheng.manage_cms.service：service类目录
• com.xuecheng.manage_cms.web.controller：controller类目录

3. 创建 spring boot 配置文件

在classpath下配置application.yml

server:
  port: 31001
spring:
  application:
    name: xc-service-manage-cms
  data:
    mongodb:
      uri: mongodb://root:123@localhost:27017
      database: xc_cms

另外从课程资料下“cms工程配置文件”中拷贝logback-spring.xml到resources文件夹下，此文件为工程的日志配置文件。

<?xml version="1.0" encoding="UTF-8"?>

<configuration>
    <!--定义日志文件的存储地址,使用绝对路径-->
    <property name="LOG_HOME" value="d:/logs"/>

    <!-- Console 输出设置 -->
    <appender name="CONSOLE" class="ch.qos.logback.core.ConsoleAppender">
        <encoder>
            <!--格式化输出：%d表示日期，%thread表示线程名，%-5level：级别从左显示5个字符宽度%msg：日志消息，%n是换行符-->
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
            <charset>utf8</charset>
        </encoder>
    </appender>

    <!-- 按照每天生成日志文件 -->
    <appender name="FILE" class="ch.qos.logback.core.rolling.RollingFileAppender">
        <rollingPolicy class="ch.qos.logback.core.rolling.TimeBasedRollingPolicy">
            <!--日志文件输出的文件名-->
            <fileNamePattern>${LOG_HOME}/xc.%d{yyyy-MM-dd}.log</fileNamePattern>
        </rollingPolicy>
        <encoder>
            <pattern>%d{yyyy-MM-dd HH:mm:ss.SSS} [%thread] %-5level %logger{36} - %msg%n</pattern>
        </encoder>
    </appender>

    <!-- 异步输出 -->
    <appender name="ASYNC" class="ch.qos.logback.classic.AsyncAppender">
        <!-- 不丢失日志.默认的,如果队列的80%已满,则会丢弃TRACT、DEBUG、INFO级别的日志 -->
        <discardingThreshold>0</discardingThreshold>
        <!-- 更改默认的队列的深度,该值会影响性能.默认值为256 -->
        <queueSize>512</queueSize>
        <!-- 添加附加的appender,最多只能添加一个 -->
        <appender-ref ref="FILE"/>
    </appender>


    <logger name="org.apache.ibatis.cache.decorators.LoggingCache" level="DEBUG" additivity="false">
        <appender-ref ref="CONSOLE"/>
    </logger>
    <logger name="org.springframework.boot" level="DEBUG"/>
    <root level="info">
        <!--<appender-ref ref="ASYNC"/>-->
        <appender-ref ref="FILE"/>
        <appender-ref ref="CONSOLE"/>
    </root>
</configuration>

4. 创建 SpringBoot 启动类

• Spring Boot 应用需要创建一个应用启动类，启动过程中会扫描 Bean 并注入 spring 容器
• 注意：此类创建在本工程com.xuecheng.manage_cms包下，名称为 ManageCmsApplication.java:

/**
 * CMS服务工程启动类
 */
@SpringBootApplication
@EntityScan("com.xuecheng.framework.domain.cms") // 扫描实体类所在包
@ComponentScan(basePackages = {"com.xuecheng.api"}) // 扫描接口所在包
@ComponentScan(basePackages = {"com.xuecheng.manage_cms"}) // 扫描本项目下的所有类（其实不写好像也是可以扫描的）
public class ManageCmsApplication {

    public static void main(String[] args) {
        SpringApplication.run(ManageCmsApplication.class, args);
    }

}

测试Controller

使用springMVC完成接口实现开发，这里暂时使用测试数据，稍后会让controller调用service来查询数据。

/**
 * CMS页面控制层
 */
@RestController
@RequestMapping("/cms/page")
public class CmsPageController implements CmsPageControllerApi {

    /**
     * 页面查询
     *
     * @param page
     * @param size
     * @param queryPageRequest
     * @return
     */
    @Override
    @GetMapping("/list/{page}/{size}")
    public QueryResponseResult findList(@PathVariable("page") int page, @PathVariable("size") int size,
                                        QueryPageRequest queryPageRequest) {
        // 暂时采用测试数据，测试接口是否可以正常运行
        QueryResult queryResult = new QueryResult();
        queryResult.setTotal(2);
        // 静态数据列表
        List list = new ArrayList<>();
        CmsPage cmsPage = new CmsPage();
        cmsPage.setPageName("测试页面");
        list.add(cmsPage);
        queryResult.setList(list);
        QueryResponseResult queryResponseResult = new QueryResponseResult(CommonCode.SUCCESS, queryResult);
        return queryResponseResult;
    }
}

dao层

分页查询测试

定义Dao接口

本项目使用Spring Data Mongodb完成Mongodb数据库的查询，Spring Data Mongodb提供一套快捷操作mongodb的方法。

创建Dao接口CmsPageRepository，继承MongoRepository，并指定实体类型和主键类型。

public interface CmsPageRepository extends MongoRepository<CmsPage, String> {
}

编写测试类，分页查询测试

• test下的包路径与main下的包路径保持一致，创建测试类com.xuecheng.manage_cms.dao.CmsPageRepositoryTest
• 测试程序使用@SpringBootTest和@RunWith(SpringRunner.class)注解，启动测试类会从main下找springBoot启动类，加载spring容器。

@SpringBootTest
@RunWith(SpringRunner.class)
public class CmsPageRepositoryTest {

    /* 注入dao接口 */
    @Autowired
    private CmsPageRepository cmsPageRepository;

    /**
     * 分页测试
     */
    @Test
    public void testFindPage() {
        // 设置分页参数，从0开始
        int page = 0;
        int size = 10;
        // 设置分页对象
        Pageable pageable = PageRequest.of(page, size);
        Page<CmsPage> all = cmsPageRepository.findAll(pageable);
        System.out.println("分页查询结果：" + all.toString());
    }
}

基础方法测试

这里Dao接口继承了MongoRepository，在MongoRepository中定义了很多现成的方法，如save、delete等，通过下边的代码来测试这里父类方法。

添加

/**
 * 新增
 */
@Test
public void testInsert() {
    // 定义实体类
    CmsPage cmsPage = new CmsPage();
    cmsPage.setSiteId("s01");
    cmsPage.setTemplateId("t01");
    cmsPage.setPageName("测试页面-插入");
    cmsPage.setPageCreateTime(new Date());

    List<CmsPageParam> cmsPageParams = new ArrayList<>();
    CmsPageParam cmsPageParam = new CmsPageParam();
    cmsPageParam.setPageParamName("param1");
    cmsPageParam.setPageParamValue("value1");
    cmsPageParams.add(cmsPageParam);
    cmsPage.setPageParams(cmsPageParams);

    // 插入操作
    cmsPageRepository.save(cmsPage);
    System.out.println(cmsPage);
}

删除

/**
 * 删除
 */
@Test
public void testDelete() {
    // 根据id删除
    cmsPageRepository.deleteById("5cdb8b556ea6f72098bdd28e");
}

修改

注：修改是先查询数据，再进入插入操作。因为id一致的话，就会去更新。

/**
 * 修改
 */
@Test
public void testUpdate() {
    // 先根据id查询，返回Optional<T>容器对象
    Optional<CmsPage> optional = cmsPageRepository.findById("5cdb8cc36ea6f7298086e3fa");

    // 判断对象是否为空
    if (optional.isPresent()) {
        CmsPage cmsPage = optional.get();
        cmsPage.setPageName("测试修改999");
        cmsPageRepository.save(cmsPage);
    }
}

关于Optional

• Optional是jdk1.8引入的类型，Optional是一个容器对象，它包括了我们需要的对象，使用isPresent方法判断所包含对象是否为空，isPresent方法返回false则表示Optional包含对象为空，否则可以使用get()取出对象进行操作。
• Optional的优点是：
  1. 提醒你非空判断。
  2. 将对象非空检测标准化。

Service层

定义页面查询方法，根据条件查询暂时不实现

/**
 * 页面服务层
 */
@Service
public class PageService {

    /* 注入cms页面dao层 */
    @Autowired
    private CmsPageRepository cmsPageRepository;

    /**
     * 页面列表分页查询
     *
     * @param page             当前页码
     * @param size             页面显示个数
     * @param queryPageRequest 查询条件
     * @return 页面列表
     */
    public QueryResponseResult findList(int page, int size, QueryPageRequest queryPageRequest) {

        // 判断查询条件
        if (queryPageRequest == null) {
            queryPageRequest = new QueryPageRequest();
        }

        // 判断分页参数，如果为空，给默认值
        if (page <= 0) {
            page = 1;
        }
        // 为了适应mongodb的接口将页码减1
        page = page - 1;
        if (size <= 0) {
            size = 10;
        }

        // 创建分页对象
        // Pageable pageable = new PageRequest(page, size); // 此方式过时
        Pageable pageable = PageRequest.of(page, size);

        // 分页查询
        Page<CmsPage> cmsPages = cmsPageRepository.findAll(pageable);

        // 创建返回结果对象
        QueryResult<CmsPage> cmsPageQueryResult = new QueryResult<>();
        // 设置数据列表
        cmsPageQueryResult.setList(cmsPages.getContent());
        // 设置数据总记录数
        cmsPageQueryResult.setTotal(cmsPages.getTotalElements());

        // 返回结果
        return new QueryResponseResult(CommonCode.SUCCESS, cmsPageQueryResult);
    }
}

Controller层

使用springMVC完成接口实现开发

@RestController
@RequestMapping("/cms/page")
public class CmsPageController implements CmsPageControllerApi {

    /* 注入服务层 */
    @Autowired
    private PageService pageService;

    /**
     * 页面查询
     *
     * @param page
     * @param size
     * @param queryPageRequest
     * @return
     */
    @Override
    @GetMapping("/list/{page}/{size}")
    public QueryResponseResult findList(@PathVariable("page") int page, @PathVariable("size") int size,
                                        QueryPageRequest queryPageRequest) {
        // 调用service
        return pageService.findList(page, size, queryPageRequest);
    }
}

使用浏览器测试，输入：http://localhost:31001/cms/page/list/1/10 查询第1页，每页显示10条记录。

接口开发规范

Api请求及响应规范

为了严格按照接口进行开发，提高效率，对请求及响应格式进行规范化。

1. get 请求时，采用key/value格式请求，SpringMVC可采用基本类型的变量接收，也可以采用对象接收。
2. post 请求时，可以提交form表单数据（application/x-www-form-urlencoded）和Json数据（Content-Type=application/json），文件等多部件类型（multipart/form-data）三种数据格式，SpringMVC接收Json数据使用@RequestBody注解解析请求的json数据。
3. 响应结果统一信息为：是否成功、操作代码、提示信息及自定义数据。
4. 响应结果统一格式为json。

Api定义约束

Api 定义使用SpringMVC来完成，由于此接口后期将作为微服务远程调用使用，在定义接口时有如下限制：

1. @PathVariable 统一指定参数名称，如：@PathVariable("id")
2. @RequestParam 统一指定参数名称，如：@RequestParam("id")

页面查询接口测试

上边的代码是基于服务端编写接口，如果前端人员等待服务端人员将接口开发完毕再去开发前端内容这样做效率是非常低下的，所以当接口定义完成，可以使用工具生成接口文档，前端人员查看接口文档即可进行前端开发，这样前端和服务人员并行开发，大大提高了生产效率。

本章节介绍两种接口开发工具，Swagger和Postman。

Swagger

Swagger 介绍

Swagger 的基础介绍与使用详见《Swagger 接口文档工具》笔记

Swagger 接口定义

修改接口工程中页面查询接口CmsPageControllerApi，添加Swagger注解

@Api(value = "cms页面管理接口", description = "cms页面管理接口，提供页面的增、删、改、查")
public interface CmsPageControllerApi {

    @ApiOperation("分页查询页面列表")
    @ApiImplicitParams({
            @ApiImplicitParam(name = "page", value = "页码", required = true, paramType = "path", dataType = "int"),
            @ApiImplicitParam(name = "size", value = "每页记录数", required = true, paramType = "path", dataType = "int")
    })
    public QueryResponseResult findList(int page, int size, QueryPageRequest queryPageRequest);
}

在QueryPageRequest类中使用注解 @ApiModelProperty 对属性注释：

@Data
@ToString
public class QueryPageRequest extends RequestData {
    // 站点id
    @ApiModelProperty("站点id")
    private String siteId;
    // 页面ID
    @ApiModelProperty("页面ID")
    private String pageId;
    // 页面名称
    @ApiModelProperty("页面名称")
    private String pageName;
    // 别名
    @ApiModelProperty("页面别名")
    private String pageAliase;
    // 模版id
    @ApiModelProperty("模版id")
    private String templateId;
}

Swagger 接口配置类

创建 swagger 的配置类，配置生成接口文档的设置

@Configuration
@EnableSwagger2
public class Swagger2Configuration {

    /**
     * 创建API
     */
    @Bean
    public Docket createRestApi() {
        return new Docket(DocumentationType.SWAGGER_2)
                // 用来创建该API的基本信息，展示在文档的页面中（自定义展示的信息）
                .apiInfo(apiInfo())
                // 设置哪些接口暴露给Swagger展示
                .select()
                /*
                 * 1. 扫描所有有注解的api，用这种方式更灵活
                 *      .apis(RequestHandlerSelectors.withMethodAnnotation(ApiOperation.class))
                 * 2. 扫描指定包中的swagger注解
                 *      .apis(RequestHandlerSelectors.basePackage("com.xuecheng"))
                 * 3. 扫描所有
                 *      .apis(RequestHandlerSelectors.any())
                 */
                .apis(RequestHandlerSelectors.basePackage("com.xuecheng"))
                .paths(PathSelectors.any())
                .build();
    }

    /**
     * 添加摘要信息
     */
    private ApiInfo apiInfo() {
        // 用ApiInfoBuilder进行定制
        return new ApiInfoBuilder()
                .title("学成网api文档")  // 设置标题
                .description("学成网api文档")    // 设置描述
                // .termsOfServiceUrl("/")
                .contact(new Contact("MoonZero", null, null))   // 设置作者
                .version("版本号：1.0") // 设置版本
                .build();
    }
}

Swagger接口测试

Swagger 接口生成工作原理：

1. 系统启动，扫描到api工程中的Swagger2Configuration类
2. 在此类中指定了包路径com.xuecheng，找到在此包下及子包下标记有@RestController注解的controller类
3. 根据controller类中的Swagger注解生成接口文档。

启动cms服务工程，查看接口文档，请求：http://localhost:31001/swagger-ui.html

点击“分页查询页面列表”，打开接口详情。使用Swagger工具测试服务接口：

1. 在cms服务接口中打断点
2. 打开接口文档页面，输入请求参数，点击“Try it out”发起请求。

Postman

Postman 是一款功能强大的http接口测试工具，使用 postman 可以完成http各种请求的功能测试。

Postman 的基础介绍与使用详见《Postman 接口测试工具》笔记