今日重点

  1. 课程发布&课程预览
  2. 课程预览: (校验数据的正确性)
  3. 教育机构提交审核前可使用
  4. 平台运营在提交之后进行审核操作时可以查看
  5. 整体功能需要4张表的内容才能全部展示,所以把这些前端需要展示的热点内容,放置到单独的一张表中 实现业务隔离!
  6. 发布信息表的诞生意义:
  7. 课程相关信息的四张表,由于业务操作存在增删改的时候会导致锁表操作 这会大降低查询效率 所以course_pub表只负责查询(业务角度实现读写分离)
  8. course_pub表 查询改表中的数据前端展示,并发量是会很大的! 可以将此单表的数据放置到ES中构建索引!
  9. 按照业务维度对数据进行读写分 为了后面和索引库进行数据同步 在业务维度进行读写分离 方便 查询 ES 同步
  10. freemaeker介绍 :
  11. 模板引擎:一种基于模板和要改变的数据。生产输出文本(HTML网页,电子邮件,配置文件,源代码等)的通用工具, 不是面向最终用户,而是一个java类库
  12. (FTL 简单 专用的语言)模板中专注于如何展示数据,模板之外可以专注要展示什么数据!
  13. 核心点:
  14. 模板 + 数据模型 = 输出
  15. template +datamodel =html
  16. Freemaker 生成静态化的方式:
  17. 1.SpringMVC+Freemarker
  18. SpringMVC将Freemarker作为视图解析器
  19. 生成的文件位置:在内存中
  20. 项目中使用的场景:课程预览
  21. 整个页面解析是在后端生成,扛不住大并发!
  22. 2.Freemarker的原生API
  23. 生成的文件位置:制定文件生成的位置
  24. API生成的文件形式:
  25. 1.模板文件+数据模型
  26. 2.模板字符串+数据模型
  27. 项目中使用的场景:课程发布
  28. Controller层的数据添加 最终前端页面访问${插值表达式}会变为被引用的key值所对应的value值!
  29. (前端访问数据 是直接对接Controller层而不是直接访问类路径下的静态资源页面)
  30. 访问流程: 前端访问C控制层,控制层 封装组成一个model 然后交给View (模板) 柔和成一个完整的html返回给前端
  31. 前后端开发SpringMVC: Model(javaBean对象) + view(展示) + controller(控制层)
  32. SpringMVC的结果试图器将Model和view结合 生成完整的html页面返回前端
  33. 课程发布流程:
  34. 课程预览交互流程如下:
  35. 后端实现业务:
  36. 常用的java模板引擎还有哪些?(面试)
  37. Jsp、Freemarker、Thymeleaf 、Velocity 等。
  38. 1.Jsp 为 Servlet 专用,不能单独进行使用。
  39. 2.Thymeleaf 为新技术,功能较为强大,但是执行的效率比较低。
  40. 3.Velocity从2010年更新完 2.0 版本后,便没有在更新。Spring Boot 官方在 1.4 版本后对此也不在支持,虽然 Velocity 在 2017 年版本得到迭代,但为时已晚。
  41. 功能足够项目使用,功能较为稳定
  42. freemarker并不关心数据的来源,只是根据模板的内容,将数据模型在模板中显示并输出文件
  43. Freemarker基本语法:
  44. 注释 <#-- xxxxxxx -->
  45. 插值表达式 hello ${name}
  46. FLT指令: <# >FTL指令</#>
  47. 普通文本: <b>普通文本 String 展示:</b>
  48. 遍历集合获得序列编号 变量名_indes +1
  49. 空值处理: ??用在标签,!用在插值表达式
  50. 内建函数: 变量名? + 内嵌函数名称
  51. 集合长度 ?size 数值?c
  52. 静态化测试:
  53. 使用freemarker的原生API将页面生产HTML文件:
  54. 1、根据模板文件生成html文件
  55. 模板文件 + 数据模型 = 静态文件
  56. 2、根据模板字符串生成html文件
  57. 模板字符串 + 数据模型 = 静态文件
  58. 课程预览:
  59. 审核状态要求: 正常业务逻辑
  60. 教学机构再未发布之前可以预览
  61. 运营平台在机构提交后可以进行预览
  62. 使用SpringMVC+Freemarker生成返回完整页面给前端 也就是说前端是不需要操作的 所有成型都是后端实现!
  63. SpringMVC 中controller 多结果视图器并存
  64. * CourseBaseController :
  65. * JackSonResolver (默认)--controller使用的是RestController
  66. * FreemarkerViewResolver
  67. * 1.添加依赖:spring-boot-starter-Freemarker
  68. * 2.添加配置:spring.freemarker.enabled = true
  69. * 3.方法的返回:controller的方法返回为ModelAndView对象
  70. 前端预览使用 :Windows.open方法 而不是异步请求axios 点击预览此课程后会打开新界面展示数据,请求头中是没有Token令牌的!

学习目标
1理解课程发布和预览的功能性需求
2理解课程发布和预览的数据模型
3能够根据文档编写Freemarker入门案例
4掌握FreeMarker基础语法
5掌握FreeMarker原生Api生成静态页面的两种方式
6熟悉课程预览的系统交互
7能够将Freemarker集成到SpringBoot微服务中
8能够实现课程发布查询课程分类信息的Feign接口实现
9能够根据文档定义课程预览接口
10能够完成课程预览的功能实现
11能够根据文档搭建课程预览功能展示环境

1. 课程发布需求概述


课程发布是一个课程从设计、实现、审核、调整后的最终确定的操作,被发布的课程将公布于众,课程发布后,学生将能够通过门户查看该课程的详细内容。
课程发布功能在整个学成在线功能架构中依然处于教学管理模块中的课程管理里,如下图:

Day08-第四章-课程发布-课程预览 - 图1

1.1 课程发布概述


课程发布的功能是还是在课程管理中,而课程管理的相关信息通过调用内容管理微服务来完成业务实现,而内容管理主要需求如下:
课程基础信息管理 对课程的基本信息进行管理,其中包括课程基础信息、课程图片、课程分类信息、课程等级、学习模式课程介绍等内容。
课程营销信息管理 一门课程的除了基本信息之外,还有课程的营销信息,营销信息主要对课程是否收费、课程价格、课程有效期。
课程计划信息管理 课程所关联的课程计划信息,其中包括客户才能计划关联媒资信息管理,课程计划为课程内容的大纲,主要方便学员学习和视频播放列表的展示。
课程教师信息管理 每一门课程都需要相应的讲师信息,在课程信息操作的时候,需要填写教师信息,并保存到数据库中。由于功能上的重复,课上不会安排此功能实现。
课程发布信息管理 课程信息从开始的创建、课程审批、课程预览,最后到课程发布整个流程。课程发布后,学员才可以在门户网站中找到对应课程内容,否则学员是找不到课程信息的。所有内容管理中需要对课程发布后的信息进行统一管理。

1.2 业务介绍


本章,我们来完善课程审核过程实现课程发布功能
1教育机构在课程提交审核前,往往需要看一下课程最终会被发布成什么样子,是否符合所预期,因此需要提供 教学机构课程预览功能来满足该需求,若符合预期,则进行课程提交审核操作。
2平台运营在课程的审核过程中,也需要预览功能来更直观的看到课程内容,因此需要提供平台运营课程预览功能来满足该需求。
3教育机构在课程审核通过后,可进行课程发布操作,这是将是本章的功能实现重点。
4门户能够浏览已发布课程的详细内容
课程发布流程

Day08-第四章-课程发布-课程预览 - 图2

其中,课程提交审核、课程审核 功能在前面的课程中已经介绍过,本章需要完成的需求列表如下:
1、课程预览:包括教育机构提交审核前的课程预览功能、平台运营审核过程中所需的课程预览功能。
2、课程发布:课程发布时形成门户可访问的课程详情页面。
我们经常浏览电商网站,电商网站浏览量最大的页面是什么?商品检索列表、商品详情。对于在线教育网站,课程就是商品。因此,课程详情页的访问流量是巨大的。因此,除了上面的功能性需求,本章我们还需要满足一个非功能性需求
●高性能课程详情页访问。

1.3 业务流程

1.3.1 课程预览


教学机构课程预览流程如下:
1.教育机构用户在课程管理中可对该机构内所管理的课程进行检索。

Day08-第四章-课程发布-课程预览 - 图3

2.点击某课程数据后的预览链接,即可对该课程进行预览,可以看到发布后的详情页面效果。

Day08-第四章-课程发布-课程预览 - 图4

Day08-第四章-课程发布-课程预览 - 图5

平台运营课程预览流程如下:
1.平台运营用户在课程管理中可对所有机构的课程进行检索。
2.点击某课程数据中的预览链接,即可对该课程进行预览,可以看到发布后的详情页面效果。

Day08-第四章-课程发布-课程预览 - 图6

Day08-第四章-课程发布-课程预览 - 图7

1.3.2 课程发布


教学机构课程发布流程如下:
1.教育机构用户在课程管理中可对机构内课程进行检索。

Day08-第四章-课程发布-课程预览 - 图8

2.点击某课程数据后的 发布 链接(审核状态为通过),即可对该课程进行发布。

Day08-第四章-课程发布-课程预览 - 图9

3.通过门户首页,点击课程连接,即可浏览已发布课程的详情页面。

Day08-第四章-课程发布-课程预览 - 图10

4.课程详情页面如下。

Day08-第四章-课程发布-课程预览 - 图11

Day08-第四章-课程发布-课程预览 - 图12

1.4 课程发布的数据模型


课程发布的数据会调用内容管理微服务,这里会使用内容管理 xc_content 数据库。
学成在线数据结构图

Day08-第四章-课程发布-课程预览 - 图13

针对课程发布的业务需求,本次将使用 course_pub 数据库表来存储课程发布的业务数据,数据库表示意图:
内容管理数据模型(表结构)

Day08-第四章-课程发布-课程预览 - 图14

  1. 通过之前的学习,我们已经已经了解到课程相关信息表包含了课程基本信息、营销信息、师资信息以及该课程具体课程计划信息,而**课程发布**的过程会将这些信息表进行汇总,形成课程发布信息。

Day08-第四章-课程发布-课程预览 - 图15

为什么要形成课程发布信息呢?
课程发布信息代表着一次课程输出的最终确定。后续的业务,如课程购买、学习将围绕着该课程发布信息,从业务角度该信息不可轻易修改,只读(若修改,需要重新走审核流程)。
CoursePub表存在的原因:
课程业务表与发布内容相分离,课程业务信息是经常发生变动的,而课程发布信息不会轻易修改,因此形成业务级别的读写分离,两者互不影响。
课程发布的数据最终要存放到索引库中,如果没有CoursePub表,需要查询多表数据向es存放数据,比较麻烦。如果有CoursePub表就可以查询单表数据就可以将es索引数据保存到索引库中。

2. Freemarker 研究


在课程管理中业务 课程发布课程预览,都是将课程的信息输出到具体的页面中来进行展示,最终生成 Html 页面返回给前端,这里是需要技术来做支撑,就是模板引擎技术。学成在线模板引擎技术就采用的是 Freemarker。
Freemarker是模板技术,课程预览 与后续的 课程发布
生成都采用此技术实现 ,其中:
●课程预览,使用Freemarker来页面动态渲染课程预览详情页中的内容,并返回给前端。
●课程详情页,使用Freemarker来用于课程详情页静态页面生成。
具体请学习课程资料中的 学成网-第4章-freemarker

3. 课程预览


课程管理中,教学机构和运营平台都是需要对课程生成的详情页进行预览操作,项目中的课程预览会使用 Freemarker 模板技术来做业务实现,之前已经将 Freemarker 的相关技术学习完后,下面将进行课程预览的相关需求开发。

3.1 需求分析


此模块主要针对教育机构平台运营对课程信息的预览,主要功能包括:
教育机构提交审核前预览
平台运营审核过程中预览

3.2 业务流程描述


1教育机构在课程提交审核前,往往需要看一下课程最终会被发布成什么样子,是否符合所预期,因此需要提供 教学机构课程预览功能来满足该需求,若符合预期,则进行课程提交审核操作。
2平台运营在课程的审核过程中,也需要预览功能来更直观的看到课程内容,因此需要提供平台运营课程预览功能来满足该需求。
教学机构课程预览流程如下:
1.教育机构用户在课程管理中可对该机构内所管理的课程进行检索。

Day08-第四章-课程发布-课程预览 - 图16

2.点击某课程数据后的预览链接,即可对该课程进行预览,可以看到发布后的详情页面效果。

Day08-第四章-课程发布-课程预览 - 图17

Day08-第四章-课程发布-课程预览 - 图18

平台运营课程预览流程如下:
1.平台运营用户在课程管理中可对所有机构的课程进行检索。

Day08-第四章-课程发布-课程预览 - 图19

2.点击某课程数据中的课程名称链接,即可对该课程进行预览,可以看到发布后的详情页面效果。

Day08-第四章-课程发布-课程预览 - 图20

Day08-第四章-课程发布-课程预览 - 图21

3.3 系统交互流程


课程预览交互流程如下:

Day08-第四章-课程发布-课程预览 - 图22

步骤描述:
1.前端对某审核通过的课程执行课程发布操作
2.查询课程基本信息、课程营销、课程计划、教师信息并保存到 课程发布中。
3.远程调用系统管理查询课程分类信息
4.保存课程发布信息
5.获得页面的数据模型(课程发布、课程营销、课程计划、教师信息、课程分类等)
6.使用Spring MVC 结果视图器 Freemarker 选择页面模板,生成静态页面
7.将生成的静态页面返回给前端
上面设计到两个前端系统,这两个前端系统都会调用后端的统一接口 课程预览 ,由内容管理微服务提供。所有本次将开发一个接口来完成两个前端功能需求。
内容管理开发中,需要调用系统管理服务来完成数据的获取。所以本次开发中,需要在两个微服务中,分别进行开发,功能如下:
系统管理服务:开发根据可曾分类 ID 获得课程分类信息的接口。
内容管理服务:开发课程预览的接口。

3.4 项目环境搭建


学成在线的课程预览会在 xc-content-service 微服务工程中,进行开发。在开发前,我们需要将其运行环境先构建出来。
1.数据库环境
2.Freemarker 环境集成

3.4.1 数据库环境


对于内容管理中课程发布数据表已经在之前导入到项目中,所以无需进行导入SQL脚本操作。
数据库内容

Day08-第四章-课程发布-课程预览 - 图23

3.4.2 Freemarker 环境集成


1.xc-content-service引入maven依赖(已经集成,无需引入)

  1. <dependency>
  2. <groupId>org.springframework.boot</groupId>
  3. <artifactId>spring-boot-starter-freemarker</artifactId>
  4. </dependency>

2.新增公共配置 freemarker-config.properties

  1. #开启 freemarker 功能
  2. spring.freemarker.enabled = true
  3. #关闭模板缓存,方便测试
  4. spring.freemarker.cache = false
  5. spring.freemarker.settings.template_update_delay = 0
  6. #页面模板后缀名
  7. spring.freemarker.suffix = .ftl
  8. spring.freemarker.charset = UTF-8
  9. #页面模板位置(默认为 classpath:/templates/)
  10. spring.freemarker.template-loader-path = classpath:/templates/
  11. #关闭项目中的静态资源映射(static、resources文件夹下的资源)
  12. spring.resources.add-mappings = false

3.在 内容管理微服务 xc-content-service 工程的 bootstrap. 配置文件添加依赖配置

  1. #其他配置省略
  2. spring:
  3. application:
  4. name: content-service
  5. jackson:
  6. date-format: yyyy-MM-dd HH:mm:ss
  7. time-zone: GMT+8
  8. cloud:
  9. nacos:
  10. discovery: #配置注册中心
  11. server-addr: 192.168.94.129:8848
  12. namespace: 5c0b093c-4084-46b5-bf33-899321cb7ef5
  13. group: ${group.name}
  14. config: #配置中心
  15. server-addr: 192.168.94.129:8848
  16. namespace: 5c0b093c-4084-46b5-bf33-899321cb7ef5
  17. group: ${group.name}
  18. file-extension: properties
  19. shared-configs:
  20. - dataId: mp-config.properites
  21. group: ${group.name}
  22. - dataId: feign-config.properties
  23. group: ${group.name}
  24. - dataId: ribbon-config.properties
  25. group: ${group.name}
  26. - dataId: freemarker-config.properties
  27. group: ${group.name}

3.将今天下发的 资料/详情页模板/learing_article.ftl 复制到工程中src\main\resources\templates中,此文件为课程详情页freemark模板。

Day08-第四章-课程发布-课程预览 - 图24

PS:由于该模板中需要使用修改的内容太多,会占用课上大量的时间,所有为了节省课上时间,该模板中已经将相应的内容添加上了 Freemarker 的插值表达式,在项目中直接使用。

3.5 课程分类信息业务实现(已实现,无需实现)


在课程预览中,内容管理微服务 远程调用 系统管理服务接口来获得课程分类名称,如下:

Day08-第四章-课程发布-课程预览 - 图25

下面将在系统管理微服务 xc-system-service 中开发此接口。

3.5.1 课程分类接口定义


1.接口参数列表
根据前后端传入参数列表来定义接口
Http接口地址

Day08-第四章-课程发布-课程预览 - 图26

接口传入传出列表

Day08-第四章-课程发布-课程预览 - 图27

2. 接口编写
在 xc-api 工程的 com.xuecheng.api.media 包下定义如下:
●根据 ID 课程分类信息查询

  1. /**
  2. * <p>
  3. * 课程分类服务 Api
  4. * </p>
  5. *
  6. * @Description:
  7. */
  8. @Api(value = "课程分类服务Api" ,tags = "系统-课程分类服务" ,description = "对课程分类信息业务操作")
  9. public interface CourseCategoryApi {
  10. //其他代码省略
  11. @ApiOperation("根据id查询课程分类")
  12. RestResponse<CourseCategoryDTO> getCourseCategoryById(String id);
  13. }

3.5 课程预览业务实现

3.5.1 数据模型(表结构)


内容管理服务的数据库 xc_content 中定义了课程发布表 course_pub。
1.课程发布表说明
课程发布表结构

Day08-第四章-课程发布-课程预览 - 图28

在上图中的表结构中,主要字段为:
1.课程基本信息描述:course_id,company_id,name,users,mt,st 等
2.课程营销信息描述:market (json 数据)
3.课程计划信息描述:teachplan(课程计划树形结构 json 数据)
4.教师信息描述:teachers( json 数据)

3.5.2 远程获得课程分类开发


由于在 CoursePub 中需要将课程分类(大分类、小分类)的名称,这是需要 内容管理微服务 远程调用 系统管理服务接口,来完成课程分类名称的获取,如下图:

Day08-第四章-课程发布-课程预览 - 图29

下面需要在内容管理微服务中创建一下内容:
1.Feign远程调用接口
在 xc-content-service 中创建远程调用的接口,如下:

  1. package com.xuecheng.content.agent;
  2. import com.xuecheng.api.system.model.dto.CourseCategoryDTO;
  3. import com.xuecheng.common.constant.XcFeignServiceNameList;
  4. import com.xuecheng.common.domain.response.RestResponse;
  5. import org.springframework.cloud.openfeign.FeignClient;
  6. import org.springframework.web.bind.annotation.GetMapping;
  7. import org.springframework.web.bind.annotation.PathVariable;
  8. /**
  9. * <p>
  10. * 内容管理对系统管理的 Feign 的远程调用
  11. * </p>
  12. *
  13. * @Description:
  14. */
  15. @FeignClient(value = XcFeignServiceNameList.XC_SYSTEM_SERVICE)
  16. public interface SystemApiAgent {
  17. @GetMapping("/system/l/course-category/{id}")
  18. RestResponse<CourseCategoryDTO> getById(@PathVariable String id);
  19. }

@_FeignClient 需要赋值属性:
value:指定系统管理在注册中心的名称,这里使用 XcFeignServiceNameList 类来获得
@_GetMapping 赋值属性:
由于是微服务的远程调用,需要在系统管理服务根路径下加上 /l 标识。
2.Feign接口服务降级
在内容管理的 bootstrap.yml 中配置 sentinel

  1. # 配置sentinel
  2. spring:
  3. cloud:
  4. sentinel:
  5. transport:
  6. dashboard: 192.168.94.129:8858 #sentinel控制台地址
  7. #开启feign的Sentinel降级
  8. feign:
  9. sentinel:
  10. enabled: true

编写 Sentinel 降级类

  1. package com.xuecheng.content.agent.sentinel;
  2. import com.xuecheng.api.system.model.dto.CourseCategoryDTO;
  3. import com.xuecheng.common.domain.code.CommonErrorCode;
  4. import com.xuecheng.common.domain.response.RestResponse;
  5. import com.xuecheng.content.agent.SystemApiAgent;
  6. import org.springframework.stereotype.Component;
  7. /**
  8. * <p></p>
  9. *
  10. * @Description:
  11. */
  12. @Component
  13. public class SystemApiAgentFallBack implements SystemApiAgent {
  14. @Override
  15. public RestResponse<CourseCategoryDTO> getById(String id) {
  16. return RestResponse.validfail(CommonErrorCode.E_999981);
  17. }
  18. }

在Feign 接口中配置fallback

  1. package com.xuecheng.content.agent;
  2. import com.xuecheng.api.system.model.dto.CourseCategoryDTO;
  3. import com.xuecheng.common.constant.XcFeignServiceNameList;
  4. import com.xuecheng.common.domain.response.RestResponse;
  5. import com.xuecheng.content.agent.sentinel.SystemApiAgentFallBack;
  6. import org.springframework.cloud.openfeign.FeignClient;
  7. import org.springframework.web.bind.annotation.GetMapping;
  8. import org.springframework.web.bind.annotation.PathVariable;
  9. /**
  10. * <p></p>
  11. *
  12. * @Description:
  13. */
  14. @FeignClient(value = XcFeignServiceNameList.XC_SYSTEM_SERVICE,fallback = SystemApiAgentFallBack.class)
  15. public interface SystemApiAgent {
  16. @GetMapping("/system/l/course-category/{id}")
  17. RestResponse<CourseCategoryDTO> getById(@PathVariable String id);
  18. }

3.5.3 模板中表达式解析


在 FreeMarker模板文件中,存在下面表达式,其 key 值如下:
1.课程发布key

  1. ${coursePub.xxxx}

2.课程营销key

  1. ${courseMarket.xxxx}

3.课程模式key值

  1. ${courseTeachModeEnums}

参考项目枚举类 CourseModeEnum 中的数据。
4.课程计划key值

  1. ${teachplanNode}

上面的四个 key 为数据模型中制定的主键值。

3.5.4 课程预览接口定义


1.接口参数列表
根据前后端传入参数列表来定义接口
Http接口地址
GET /content/course/preview/{courseBaseId}/{companyId}
接口传入传出列表

Day08-第四章-课程发布-课程预览 - 图30

Day08-第四章-课程发布-课程预览 - 图31

2. 接口编写
在 xc-api 工程的 com.xuecheng.api.content 包下创建接口类接口定义如下:
●课程预览

  1. @Api(value = "课程基本信息管理Api",tags = "内容-课程基本信息管理",
  2. description = "课程基本信息业务管理")
  3. public interface CourseBaseApi {
  4. //其他代码省略
  5. @ApiOperation(value = "课程预览")
  6. Object previewCourse(Long courseId,Long companyId);
  7. }

3.5.5 课程预览接口开发


1.DAO编写
Mybatis Plus 已经简化了单表操作,它提供的 Api 就可以完成添加数据操作,所有不需要进行编写。
2.service 编写
●对象属性转换器

  1. @Mapper
  2. public interface CoursePubConvert {
  3. CoursePubConvert INSTANCE = Mappers.getMapper(CoursePubConvert.class);
  4. CoursePub courseBase2coursePub(CourseBaseDTO courseBase);
  5. CoursePubDTO entity2dto(CoursePub coursePub);
  6. }

●接口

  1. /**
  2. * <p>
  3. * 课程发布 服务类
  4. * </p>
  5. *
  6. * @author itcast
  7. */
  8. public interface CourseBaseService extends IService<CourseBase> {
  9. /**
  10. * 课程预览
  11. * @param courseId 课程Id
  12. * @param companyId 公司Id
  13. * @return Map 数据模型 Map
  14. */
  15. Map<String, Object> previewCourse(Long courseBaseId, Long companId);
  16. }

●实现类

  1. /**
  2. * <p>
  3. * 课程 服务实现类
  4. * </p>
  5. *
  6. * @author itcast
  7. */
  8. @Service
  9. public class CourseBaseServiceImpl extends ServiceImpl<CourseBaseMapper, CourseBase> implements CourseBaseService {
  10. @Autowired
  11. private CourseBaseService courseBaseService;
  12. @Autowired
  13. private CourseMarketService courseMarketService;
  14. @Autowired
  15. private TeachplanService teachplanService;
  16. @Autowired
  17. private SystemApiAgent systemApiAgent;
  18. /*
  19. * 主方法业务:
  20. * 1.构建CoursePub数据并保存
  21. *
  22. * 2.根据CoursePub内容构架DataMap数据
  23. *
  24. * 3.将DataMap进行返回
  25. * */
  26. @Transactional
  27. public Map<String, Object> preview(Long courseId, Long companyId) {
  28. //1.构建CoursePub数据并保存
  29. CoursePub coursePub = generateCoursePub(courseId,companyId);
  30. // 2.根据CoursePub内容构架DataMap数据
  31. Map<String,Object> dataMap = generateDataMap(coursePub);
  32. // 3.将DataMap进行返回
  33. return dataMap;
  34. }
  35. private Map<String, Object> generateDataMap(CoursePub coursePub) {
  36. // 1.构建数据模型对象
  37. HashMap<String, Object> dataMap = new HashMap<>();
  38. // 2.构建coursePub
  39. dataMap.put(CoursePubTemplateKey.COURSEPUB, coursePub);
  40. // 3.构建courseMarket
  41. String marketJsonString = coursePub.getMarket();
  42. CourseMarket courseMarket = JsonUtil.jsonToObject(marketJsonString, CourseMarket.class);
  43. dataMap.put(CoursePubTemplateKey.COURSEMARKET,courseMarket );
  44. // 4.构建课程计划
  45. String teachplanJsonString = coursePub.getTeachplan();
  46. TeachplanDTO teachplanDTO = JsonUtil.jsonToObject(teachplanJsonString, TeachplanDTO.class);
  47. dataMap.put(CoursePubTemplateKey.TEACHPLANNODE,teachplanDTO );
  48. // 5.构建课程模式
  49. CourseModeEnum[] values = CourseModeEnum.values();
  50. dataMap.put(CoursePubTemplateKey.COURSETEACHMODEENUMS,values );
  51. return dataMap;
  52. }
  53. /*
  54. * 构建CoursePub数据并保存
  55. * 业务分析:
  56. * 1.判断关键数据
  57. * courseId companyId
  58. * 2.判断业务数据
  59. * 课程基础信息
  60. * 判断是否存在
  61. * 判断是否是同一家机构
  62. * 判断是否删除
  63. * 判断审核状态:教学机构课程预览--未提交、审核未通过
  64. * 课程营销
  65. * 判断是否存在:根据courseid
  66. * 课程计划
  67. * 获得课程计划:根据courseId和companyId(树形结构)
  68. * 课程教师
  69. * 判断教师信息是否存在:一定要确保课程最少有一个教师信息
  70. *
  71. * 课程分类数据并完善Coursepub数据
  72. * 调用system服务获得课程分类的名称
  73. *
  74. * 3.保存课程发布数据
  75. * CoursePub数据保存数据库中
  76. * 课程基础信息 课程营销 课程计划 课程教师
  77. *
  78. * 4.将coursePub数据返回
  79. *
  80. * */
  81. private CoursePub generateCoursePub(Long courseId, Long companyId) {
  82. //1.判断关键数据
  83. // courseId companyId
  84. // 2.判断业务数据
  85. // 课程基础信息
  86. // 判断是否存在
  87. // 判断是否是同一家机构
  88. // 判断是否删除
  89. // 判断审核状态:教学机构课程预览--未提交、审核未通过
  90. CourseBaseDTO courseBase = courseBaseService.getCourseBaseById(courseId, companyId);
  91. String auditStatus = courseBase.getAuditStatus();
  92. if (CourseAuditEnum.AUDIT_PASTED_STATUS.getCode().equals(auditStatus)||
  93. CourseAuditEnum.AUDIT_COMMIT_STATUS.getCode().equals(auditStatus)||
  94. CourseAuditEnum.AUDIT_PUBLISHED_STATUS.getCode().equals(auditStatus)
  95. ) {
  96. ExceptionCast.cast(ContentErrorCode.E_120015);
  97. }
  98. // 课程营销
  99. // 判断是否存在:根据courseid (courseBaseService.getCourseBaseById 里已经对其进行判断是否存在)
  100. LambdaQueryWrapper<CourseMarket> marketQueryWrapper = new LambdaQueryWrapper<>();
  101. marketQueryWrapper.eq(CourseMarket::getCourseId, courseId);
  102. CourseMarket courseMarket = courseMarketService.getOne(marketQueryWrapper);
  103. // 课程计划
  104. // 获得课程计划:根据courseId和companyId(树形结构)
  105. TeachplanDTO teachplanTreeNodes = teachplanService.getTreeNodes(courseId, companyId);
  106. // 课程教师
  107. // 判断教师信息是否存在:一定要确保课程最少有一个教师信息
  108. // TODO: 2021/12/17 学员完成
  109. // 课程分类数据并完善Coursepub数据
  110. // 调用system服务获得课程分类的名称
  111. String mt = courseBase.getMt();
  112. String st = courseBase.getSt();
  113. RestResponse<CourseCategoryDTO> mtResponse = systemApiAgent.getCourseCategoryById4s(mt);
  114. if (!(mtResponse.isSuccessful())) {
  115. ExceptionCast.castWithCodeAndDesc(mtResponse.getCode(),mtResponse.getMsg());
  116. }
  117. RestResponse<CourseCategoryDTO> stResponse = systemApiAgent.getCourseCategoryById4s(st);
  118. if (!(stResponse.isSuccessful())) {
  119. ExceptionCast.castWithCodeAndDesc(stResponse.getCode(),stResponse.getMsg());
  120. }
  121. CourseCategoryDTO mtEntity = mtResponse.getResult();
  122. CourseCategoryDTO stEntity = stResponse.getResult();
  123. // 构建coursePub数据并执行保存操作
  124. // 课程基础数据
  125. CoursePub coursePub = CoursePubConvert.INSTANCE.courseBase2coursePub(courseBase);
  126. // 课程营销数据
  127. String marketJsonString = JsonUtil.objectTojson(courseMarket);
  128. coursePub.setMarket(marketJsonString);
  129. coursePub.setPrice(courseMarket.getPrice());
  130. coursePub.setCharge(courseMarket.getCharge());
  131. // 课程计划数据
  132. String teachplanJsonString = JsonUtil.objectTojson(teachplanTreeNodes);
  133. coursePub.setTeachplan(teachplanJsonString);
  134. // 课程教师
  135. // TODO: 2021/12/17 学员完成
  136. // 课程分类数据
  137. coursePub.setMtName(mtEntity.getName());
  138. coursePub.setStName(stEntity.getName());
  139. // 3.保存课程发布数据
  140. // CoursePub数据保存数据库中
  141. // 课程基础信息 课程营销 课程计划 课程教师
  142. // 一个courseBase数据对应一个coursePub数据
  143. LambdaQueryWrapper<CoursePub> pubQueryWrapper = new LambdaQueryWrapper<>();
  144. pubQueryWrapper.eq(CoursePub::getCourseId, courseId);
  145. pubQueryWrapper.eq(CoursePub::getCompanyId, companyId);
  146. CoursePub po = this.getOne(pubQueryWrapper);
  147. boolean result = false;
  148. // 判断课程发布数据是否存在
  149. if (ObjectUtils.isEmpty(po)) {
  150. // 如果不存在
  151. // 创建课程发布数据
  152. // 创建课程发布数据时,要将coursePub和courseBase数据进行关联
  153. coursePub.setCourseId(courseBase.getCourseBaseId());
  154. result = this.save(coursePub);
  155. } else {
  156. // 如果存在
  157. // 修改课程发布数据内容
  158. coursePub.setId(po.getId());
  159. result = this.updateById(coursePub);
  160. }
  161. if (!result) {
  162. ExceptionCast.cast(ContentErrorCode.E_120205);
  163. }
  164. // 4.将coursePub数据返回
  165. return coursePub;
  166. }
  167. }

常量类:

  1. package com.xuecheng.content.common.constant;
  2. /**
  3. * <p>
  4. * 课程发布模板页面中的所有数据模型key值
  5. * </p>
  6. *
  7. * @Description:
  8. */
  9. public interface CoursePubTemplateKey {
  10. /**
  11. * 课程发布的数据模型key值
  12. * */
  13. String COURSEPUB="coursePub";
  14. /**
  15. * 课程营销的数据模型key值
  16. * */
  17. String COURSEMARKET="courseMarket";
  18. /**
  19. * 课程模式的数据模型key值
  20. * */
  21. String COURSETEACHMODEENUMS="courseTeachModeEnums";
  22. /**
  23. * 课程计划的数据模型key值
  24. * */
  25. String TEACHPLANNODE="teachplanNode";
  26. }

3.controller编写

  1. @RestController
  2. public class CourseBaseController implements CourseBaseApi {
  3. /*
  4. * SpringMVC 中controller 多结果视图器并存
  5. * CourseBaseController :
  6. * JackSonResolver (默认)--controller使用的是RestController
  7. * FreemarkerViewResolver
  8. * 1.添加依赖:spring-boot-starter-Freemarker
  9. * 2.添加配置:spring.freemarker.enabled = true
  10. * 3.方法的返回:controller的方法返回为ModelAndView对象
  11. * */
  12. @GetMapping("course/preview/{courseId}/{companyId}")
  13. public Object previewCourse(@PathVariable Long courseId,@PathVariable Long companyId) {
  14. Map<String, Object> dataMap = coursePubService.previewCourse(courseId, companyId);
  15. // 1.使用视图和数据模型对象
  16. ModelAndView modelAndView = new ModelAndView("learing_article",dataMap);
  17. return modelAndView;
  18. }
  19. }

3.5.6 信息接口测试


测试环境需要启动的微服务有:
1.注册中心 Nacos
2.服务网关 xc-gateway-service (端口:63010)
3.媒资管理 xc-media-service (端口:63050)
4.内容管理 xc-content-service (端口:63040)
1. 使用 postman 在请求信息中添加请求参数
GET http://127.0.0.1:63010/content/course/preview/43/1232141425

Day08-第四章-课程发布-课程预览 - 图32

返回内容为渲染后的html

3.5.7 课程预览显示优化


在上面课程预览后,我们只是看到返回静态化后的html代码,并不能看到课程预览的最终效果,如下图:

Day08-第四章-课程发布-课程预览 - 图33

对于高性能课程详情页实现,我们使用 CDN+Nginx缓存实现,这里需要做下面事项:
1.七牛云服务存储相关静态资源
2.Nginx对七牛云的代理

3.5.7.1 静态资源上传


教学机构在将课程发布后,会生成课程详情页。而课程详情页以及页面中所使用的静态资源都需要将其内容提前上传到七牛云存储中,下面我们开始上传静态资源。
1.创建静态页面存储空间
创建存储空间

Day08-第四章-课程发布-课程预览 - 图34

在七牛云中创建存储空间:xc-static-pages
2.上传页面等静态资源
将今天下发资料中的 资料/详情页模板/课程详情页 下的所有资源上传到七牛服务上。

Day08-第四章-课程发布-课程预览 - 图35

针对不同的资源,都会在一定的目录下,所有大家在上传时,一定要添加上传资源的路径,如下:
●CSS 资源路径 CSS资源路径为:css/
路径示意图

Day08-第四章-课程发布-课程预览 - 图36

●img 资源路径 img资源路径为:img/
路径示意图

Day08-第四章-课程发布-课程预览 - 图37

●js资源路径 js资源路径为:js/
路径示意图

Day08-第四章-课程发布-课程预览 - 图38

●pages资源路径 pages资源路径为:pages/
路径示意图

Day08-第四章-课程发布-课程预览 - 图39

●plugins资源路径 plugins资源路径比较多,分别为:

plugins/bootstrap/dist/css/
plugins/bootstrap/dist/js/
plugins/jquery/dist/
plugins/jscookie/
plugins/normalize-css/
plugins/vue/

路径示意图

Day08-第四章-课程发布-课程预览 - 图40

3.访问上传的静态资源页面
在将所有静态资源上传后,我们通过浏览器可以访问器静态资源,例如访问静态资源页面:
复制页面访问连接

Day08-第四章-课程发布-课程预览 - 图41

对静态页的访问

Day08-第四章-课程发布-课程预览 - 图42

如果能看到上面的页面内容,说明静态资源上传成功。

3.5.7.2 Nginx 反向代理配置


在之前对七牛云上的访问静态资源路径,不难发现。其路径为:
http://自己七牛cdn域名/pages/learing_article.html

Day08-第四章-课程发布-课程预览 - 图43

上面的域名为七牛云的 CDN 加速域名,每一个人所创建的存储空间给的域名都不一样。不管生成怎样的域名,都与学成在线网站的标识没有关系。我们现在需要做的就是将上面的路径改为:
http://www.xuecheng.com/cdn/pages/learing_article.html
这是我们就需要使用 Nginx 的反向代理来解决此问题,反向代理示意图如下:

Day08-第四章-课程发布-课程预览 - 图44

●下载Nginx
下载地址:http://nginx.org/en/download.html
下载稳定版本,以nginx/Windows-1.14.2为例,直接下载 nginx-1.14.2.zip
我们也可以直接使用学成在线 \项目前置资料\软件\nginx-1.14.2.zip,复制到合法路径中并解压:
PS:路径中不要有中文和特殊字符

Day08-第四章-课程发布-课程预览 - 图45

●启动Nginx
1.直接双击nginx.exe,双击后一个黑色的弹窗一闪而过

Day08-第四章-课程发布-课程预览 - 图46

2.查看任务管理中,是否有 nginx 程序

Day08-第四章-课程发布-课程预览 - 图47

nginx 的运行程序一共是两个,不能多也不能少。
3.访问 nginx 首页
直接在浏览器地址栏输入网址 http://localhost:80,回车,出现以下页面说明启动成功

Day08-第四章-课程发布-课程预览 - 图48

●配置本地Host文件
windows系统下的 host 文件所在的目录为:C:\Windows\System32\drivers\etc

Day08-第四章-课程发布-课程预览 - 图49

在host文件中,添加下面的域名:

  1. 127.0.0.1 www.xuecheng.com

示意图

Day08-第四章-课程发布-课程预览 - 图50

●配置Nginx
打开nginx配置目录,在配置目录中找到nginx.conf配置文件并打开修改 :
nginx配置文件

Day08-第四章-课程发布-课程预览 - 图51

修改其中的配置内容

  1. #学成门户虚拟主机
  2. server {
  3. listen 80;
  4. server_name www.xuecheng.com;
  5. #对七牛云page资源的配置
  6. location ^~ /cdn/pages/ {
  7. proxy_pass http://自己cdn域名/pages/;
  8. proxy_set_header X-Real-IP $remote_addr;
  9. proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  10. proxy_set_header REMOTE-HOST $remote_addr;
  11. }
  12. #对七牛云css资源的配置
  13. location ^~ /cdn/css/ {
  14. proxy_pass http://自己cdn域名/css/;
  15. proxy_set_header X-Real-IP $remote_addr;
  16. proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  17. proxy_set_header REMOTE-HOST $remote_addr;
  18. }
  19. #对七牛云img资源的配置
  20. location ^~ /cdn/img/ {
  21. proxy_pass http://自己cdn域名/img/;
  22. proxy_set_header X-Real-IP $remote_addr;
  23. proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  24. proxy_set_header REMOTE-HOST $remote_addr;
  25. }
  26. #对七牛云js资源的配置
  27. location ^~ /cdn/js/ {
  28. proxy_pass http://自己cdn域名/js/;
  29. proxy_set_header X-Real-IP $remote_addr;
  30. proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  31. proxy_set_header REMOTE-HOST $remote_addr;
  32. }
  33. #对七牛云plugin资源的配置
  34. location ^~ /cdn/plugins/ {
  35. proxy_pass http://自己cdn域名/plugins/;
  36. proxy_set_header X-Real-IP $remote_addr;
  37. proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  38. proxy_set_header REMOTE-HOST $remote_addr;
  39. }
  40. }

proxy_set_header:即允许重新定义或添加字段传递给代理服务器的请求头。该值可以包含文本、变量和它们的组合。
1)proxy_set_header X-Real-IP $remote_addr;
将$remote_addr的值放进变量X-Real-IP中,此变量名可变,$remote_addr的值为客户端的ip
2)proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
被代理服务可以获得真实客户端的 IP 地址
3)proxy_set_header REMOTE-HOST $remote_addr;
将$remote_addr的值放进变量 REMOTE-HOST 中,可以获得客户端域名地址
●访问测试页面
当我们修改了nginx的配置文件nginx.conf 时,不需要关闭nginx后重新启动nginx,
只需要执行命令相关命令即可让改动生效,命令为:

  1. nginx -s reload

PS:此命令要进入到 nginx 的根目录下来执行,如下图:

Day08-第四章-课程发布-课程预览 - 图52

在此访问 http://www.xuecheng.com/cdn/pages/learing_article.html 地址,得到的内容为:

●使用前端工程进行测试

Day08-第四章-课程发布-课程预览 - 图53
Day08-第四章-课程发布-课程预览 - 图54