第1天-講義項(xiàng)目概述cms接口開發(fā)

受互聯(lián)網(wǎng)概念的催化，中國教育市場(chǎng)的發(fā)展可謂是百花齊放、如火如荼。按照市場(chǎng)領(lǐng)域細(xì)分為：學(xué)前教育、K2教育、高等教育、留學(xué)教育、職業(yè)教育、語言教育、教育以及綜合平臺(tái)，其中，職業(yè)教育和語言教育的市場(chǎng)優(yōu)勢(shì)突出。根據(jù)ysys易觀發(fā)布的數(shù)據(jù)顯示，預(yù)計(jì)2019年中國互聯(lián)網(wǎng)教育市場(chǎng)交易規(guī)模將達(dá)到3718億元，未來三年互聯(lián)網(wǎng)教育市場(chǎng)規(guī)模保持高速增長。學(xué)成借鑒了MOOC（大型開放式網(wǎng)絡(luò)課程，即MOOC（massiveopenonlinecourses））的設(shè)計(jì)思想，是個(gè)提供IT職業(yè)課程學(xué)習(xí)的平臺(tái)，它為即將和已經(jīng)加入IT領(lǐng)域的技術(shù)人才提供學(xué)習(xí)服務(wù)，用戶通過學(xué)習(xí)、當(dāng)前市場(chǎng)的教育模式多種多樣，包括：BC、CC、B2B2C等業(yè)務(wù)模式，學(xué)成采用B2B2C業(yè)務(wù)模式，即向企業(yè)或個(gè)人提供教育平臺(tái)提供教學(xué)服務(wù)，老師和學(xué)生通過平臺(tái)完成整個(gè)教學(xué)和學(xué)習(xí)的過程，市場(chǎng)上類似的平臺(tái)有：網(wǎng)易云課堂、騰訊課堂等，學(xué)成的特點(diǎn)是I職業(yè)課程教學(xué)。功能模塊功能門學(xué)生登錄學(xué)習(xí)中心學(xué)習(xí)課程教學(xué)管理系統(tǒng)管理項(xiàng)目的技術(shù)業(yè)務(wù)流程舉例2、系統(tǒng)應(yīng)用CDN技術(shù)，對(duì)一些、CSS、等資源從CDN調(diào)度6、服務(wù)層將數(shù)據(jù)持久化到數(shù)據(jù)庫各模塊說明如下名功能1用戶用戶層描述了本系統(tǒng)所支持的用戶類型包括：pc用戶、app用戶、h5用戶。pc用戶通過瀏覽器系統(tǒng)、app用戶通過ndi、ios系統(tǒng)，H5用戶通過h5頁面系統(tǒng)。2CDN全稱CotetDlivryNetwork，即內(nèi)容分發(fā)網(wǎng)絡(luò)，本系統(tǒng)所有靜態(tài)資源全部通過CDN加速來提高速度。系統(tǒng)靜態(tài)資源包括：html頁面、js文件、css文件、iage圖片、pd和ppt及o教學(xué)文檔、 等。3系統(tǒng)的CDN層、U層、服務(wù)層及數(shù)據(jù)層均設(shè)置了負(fù)載均衡服務(wù)，上圖僅在U層前邊標(biāo)注了負(fù)載均衡。層負(fù)載均衡+層負(fù)載均衡結(jié)合的方式，4層負(fù)載均衡是指在網(wǎng)絡(luò)傳輸層進(jìn)行流程轉(zhuǎn)發(fā)，根據(jù)P和端口進(jìn)行轉(zhuǎn)發(fā)，層負(fù)載均衡完成HTTP協(xié)議負(fù)載均衡及反向的功能，根據(jù)l進(jìn)行請(qǐng)求轉(zhuǎn)發(fā)。4UIUI層描述了系統(tǒng)向pc用戶、app用戶、h5用戶提供的產(chǎn)品界面。根據(jù)系統(tǒng)功能模塊特點(diǎn)確定了U層包括如下產(chǎn)品界面類型：）面向pc用戶的門戶系統(tǒng)、學(xué)習(xí)中心系統(tǒng)、教學(xué)管理系統(tǒng)、系統(tǒng)。）面向h用戶的門戶系統(tǒng)、學(xué)習(xí)中心系統(tǒng)。3）面向app用戶的門戶系統(tǒng)、學(xué)習(xí)中心系統(tǒng)未在上圖標(biāo)注，在app項(xiàng)目中有詳細(xì)說明。5微服務(wù)層將系統(tǒng)服務(wù)分類三類：前端服務(wù)、后端服務(wù)及系統(tǒng)服服務(wù)：主要為學(xué)習(xí)用戶提供學(xué)習(xí)服務(wù)。后端服務(wù)：主要為管理用戶提供教學(xué)管理服務(wù)。系統(tǒng)服務(wù)：公共服務(wù)，為系統(tǒng)的所有微服務(wù)提供公共服務(wù)功能。服務(wù)網(wǎng)關(guān)：提供服務(wù)路由、負(fù)載均6數(shù)據(jù)數(shù)據(jù)層描述了系統(tǒng)的數(shù)據(jù)的內(nèi)容類型，持久化的業(yè)務(wù)數(shù)據(jù)使用yS和ogDB保存，其中onDB中主要保存系統(tǒng)日志信息。消息隊(duì)列：系統(tǒng)服務(wù)間通信的消息，本身提供消息存取服務(wù)，與微服務(wù)層的系統(tǒng)服務(wù)連接。索引庫：課信息的索引信息，本身提供索引及搜索的服務(wù)，與微服務(wù)層的系統(tǒng)服務(wù)連接。緩：作系統(tǒng)的緩存服務(wù)，課程信息、分類信息、用戶信息等，與微服務(wù)層的所有服務(wù)連接。文件：提供系統(tǒng)靜態(tài)資源文件的分布式服務(wù)，文件服務(wù)器作為CDN服務(wù)器的數(shù)據(jù)來源，CDN上的靜態(tài)資源將最終在文件服務(wù)器上保存多份。流服務(wù)：作為流服務(wù)器，所有的流文件。7統(tǒng)接 、 的賬號(hào)和即可登錄本系統(tǒng)。2） 4）接口，本系統(tǒng)與第平臺(tái)對(duì)接發(fā)送接口。5）郵件接口，本系統(tǒng)需要連接第的smpt郵件服務(wù)器對(duì)外發(fā)送電子郵件。6），本系統(tǒng)與平 H5頁面。7）點(diǎn)播、，前期點(diǎn)播與采用第服務(wù)方式，本系統(tǒng)與第點(diǎn)、服務(wù)對(duì)接，對(duì)外提供點(diǎn)播與服務(wù)。8）OSS 上。9）CDN，本系統(tǒng)與第CDN服務(wù)對(duì)接，使用CDN加速服務(wù)來提高本系統(tǒng)的名功能8DvOs（英文Dvlopment和Oetio的組合）是一組過程、方法與系統(tǒng)的統(tǒng)稱，用于促進(jìn)開發(fā)（應(yīng)用程序/工程）、技術(shù)運(yùn)營和（A）部門之間的溝通、協(xié)作與整合。本項(xiàng)目供了許多開發(fā)、運(yùn)營、 支撐的系統(tǒng)，包括：Eek服務(wù)治理中心：提供服務(wù)治理服務(wù)，包括：服務(wù) 、服務(wù)獲取等。SrigCldC?服務(wù)配置：提供服務(wù)配置管理服務(wù)，包括：配置文件更新、配置文件下發(fā)等。HystrixDsbad服務(wù)熔斷：熔斷的請(qǐng)求響應(yīng)時(shí)間、成功率等。iki服務(wù)追蹤監(jiān)控：服務(wù)調(diào)用鏈路健康情況。Jkis持續(xù)集成服務(wù)：提供系統(tǒng)持續(xù)集成服務(wù)。Git/it代碼管理服務(wù):提供i代碼管理服務(wù)。ELK日志分析服務(wù)提供l日志分析服務(wù)，包括系統(tǒng)運(yùn)行日志分析、告務(wù)。Docke容器化部署服務(wù)：將本系統(tǒng)所有服務(wù)采用容器化部署方式。ve項(xiàng)目管理工具：提供管理項(xiàng)目所有的Java依、目工程打包服務(wù)。重點(diǎn)了解微服務(wù)學(xué)成服務(wù)端基于SpringBoot構(gòu)建，采用SpringCloud微服務(wù)框架。數(shù)據(jù)層：使用SpringDataJPA、Mybatis、SpringDataMongodb業(yè)務(wù)層：SpringIOC、Aop事務(wù)控制、SpringTask任務(wù)調(diào)度、Feign、Ribbon、SpringAMQP、SpringData等控制層：SpringMVC、FastJSON、RestTemplate、SpringSecurityOauth2+JWT等微服務(wù)治理：Eureka、Zuul、Hystrix、SpringCloudCon?g等發(fā)步驟如下：1、需求分梳理用戶的需求，分析業(yè)務(wù)2、接口定根據(jù)需求分析定義接依據(jù)接口進(jìn)行服務(wù)端接口開4、前后端集成測(cè)CMS需求分1、CMSCMS（ContentManagementSystem）即內(nèi)容管理系統(tǒng)，不同的項(xiàng)目對(duì)CMS的定位不同，比如：一個(gè)教育站，有些公司認(rèn)為CMS系統(tǒng)是對(duì)所有的課程資源進(jìn)行管理，而在早期剛開始盛行時(shí)很多公司的業(yè)務(wù)是制作，2、CMS有哪些類型上邊也談到每個(gè)公司對(duì)每個(gè)項(xiàng)目的CS定位不同，CMS基本上分為：針對(duì)數(shù)據(jù)內(nèi)容的管理、針對(duì)前端頁面的管理、針對(duì)樣式風(fēng)格的管理等。比如：一個(gè)給企業(yè)做的公司，其CMS系統(tǒng)主要是頁面管理及樣式風(fēng)格的管理。本項(xiàng)目作為一個(gè)大型的教育平臺(tái)，對(duì)CMS系統(tǒng)的定位是對(duì)各各（子站點(diǎn)）頁面的管理，主要管理由于運(yùn)營本項(xiàng)目CS構(gòu)來分析頁面的管理方案。門戶，是一個(gè)的，一般都有一個(gè)對(duì)外的門戶，學(xué)成門戶效果圖如下導(dǎo)入門戶工本nginx-1.14.0.zip(：3、導(dǎo)入門戶工 配置虛擬主 ssion;ssi_silent_errorson;location/{ index}}F:/teach/xcEdu/xcEduUI/xc-ui-pc-static-portal/ 即為門戶的 本的開發(fā)環(huán)境使用Windows7，修改C:\Windows\System32\drivers\etc\hosts文進(jìn)入瀏覽器，輸入SSI本節(jié)分析首頁的管理方案將頁面拆分成一個(gè)一個(gè)的小頁面，通過cm去管理這些小頁面，當(dāng)要更改部分頁面內(nèi)容時(shí)只需要更改具體某個(gè)小頁面即可。ssi包含類似于jsp頁面中的iclce指令，ssi是在wb服務(wù)端將iclud指定的頁面包含在網(wǎng)頁中，渲染tml應(yīng)給客戶端。nix、ach等多數(shù)wb容器都支持SS指令。<!‐‐#include<!‐‐#include 4、將首頁拆分 ssion;ssi_silent_errorson;ssisi：開啟ss支持ssilsSS輸出錯(cuò)誤信息ssi_types：默認(rèn)為ssi_ypestext/htl，如果需要支持shtml（服務(wù)器執(zhí)行，類似于jsp）則需要設(shè)置為ssi_ypestex/shtml6、測(cè)創(chuàng)建站點(diǎn)一個(gè)有很多子站點(diǎn)，比如：學(xué)成有主門戶、學(xué)習(xí)中心、問答系統(tǒng)等子站點(diǎn)。具體的哪個(gè)頁面是歸屬于具的站點(diǎn)，所以要管理頁面，先要管理頁面所屬的站點(diǎn)。創(chuàng)建模板頁面如何創(chuàng)建呢？比如的商品詳情頁面，每個(gè)頁面的內(nèi)容布局、板式是相同的，不同的只是內(nèi)容，這個(gè)頁面的布局、板式就是頁面模板，模板+數(shù)據(jù)就組成一個(gè)完整的頁面，最終要?jiǎng)?chuàng)建一個(gè)頁面文件需要先定義此頁面的模板，最終拿到頁面的數(shù)據(jù)再結(jié)合模板就拼裝成一個(gè)完整的頁面。創(chuàng)建頁面頁面預(yù)覽覽頁面。頁面發(fā)布前進(jìn)行頁面預(yù)覽的目是為了保證頁面發(fā)布后的正確性。頁面發(fā)布頁面頁面管理員通過頁面預(yù)覽功能預(yù)覽頁面發(fā)布后的頁面頁面發(fā)布成功，用戶即可在瀏覽器瀏覽到發(fā)布的頁面，整個(gè)頁面添加、發(fā)布的過程由于自動(dòng)執(zhí)行，無需人工登錄服務(wù)器操作。CMS服務(wù)端工程1、創(chuàng)建工程代 3、配置編6、自i可以自動(dòng)優(yōu)化導(dǎo)入包，但是有多個(gè)同名的類調(diào)用不同的包，必須自己手動(dòng)AltEtr設(shè)置ie導(dǎo)入包7、代碼模自定義自己的代碼模8、提示忽略大小9、配置虛擬機(jī)內(nèi)-Xms1024m-Xmx4096m-XX:MaxPermSize=1024m-XX:工程結(jié)工程結(jié)果如下導(dǎo)入父工2、點(diǎn)擊ImportModel，選擇parent選擇Maven，下一步3、導(dǎo)入成導(dǎo)入其它工依次導(dǎo) mon、api工程，方法同parent工和的導(dǎo)入安裝1、Mongodb是非關(guān)系型數(shù)據(jù)庫，Json格式數(shù)據(jù),數(shù)據(jù)格式靈活參考“mongodb安裝.md”安裝MongodbServer及Studio3T客戶端MongoDB入導(dǎo)入CMS導(dǎo)入cms數(shù)據(jù)庫使用Studio3T導(dǎo)入cms數(shù)據(jù)2、導(dǎo)入cms數(shù)據(jù)打開窗口，選擇第一個(gè)json頁面查詢接口需求分本次定義頁面查詢接口，本接口供前端請(qǐng)求查詢頁面列表，支持分頁及自定義條件查詢方式。具體需求如下1、分頁查詢CmsPage集合下的數(shù)3、接口基于HttpGet請(qǐng)求，響應(yīng)Json數(shù)模型類介頁面信息如下 (collection="cms_page")publicclassCmsPage{ 頁面名稱、別名 地址、類型（靜態(tài)/動(dòng)態(tài)）、頁面模版、狀//站點(diǎn)privateprivateStringprivateString//privateString//privateString 地privateString //privateString//privateString//類型（靜態(tài)/動(dòng)態(tài)privateString//privateString//privateString//privateString//privateDate//模版privateString// ist<CmsPageParam>//模版文件 privateString//靜態(tài)文件privateString//數(shù)據(jù)privateString}屬性說明1、定義一個(gè)頁面需要指定頁注解說明：@Data、@ToString、@注解表示什么意思@：是 5.2.3mb是一個(gè)實(shí)用的jav工具，使用它可以消除jv代碼的臃腫，mo提供一系列的注解，使用這些注解可以不用定義gtterseter、eul、構(gòu)造方法等，它會(huì)在編譯時(shí)在字節(jié)碼文件自動(dòng)生成這些通用的方法，簡(jiǎn)化開發(fā)的工作。項(xiàng)目地址比如上節(jié)創(chuàng)建的Userst模型，Dt注解可以自動(dòng)生成eter/stte方法，@Stri生成tostring使用方法：定義請(qǐng)求及響應(yīng)類packagepackageimportimportpublicclassQueryPageRequestextendsRequestData//站點(diǎn)privateString//頁面privateString//頁面名privateString//privateString//模版privateString}2、響應(yīng)結(jié)果類型，分頁查詢統(tǒng)一使用定義接1、接口集中管publicpublicinterfaceCmsPageControllerApipublicQueryResponseResultfindList(intpage,intsize,QueryPageRequestqueryPageRequest)}頁面查詢服務(wù)端創(chuàng)建CMS創(chuàng)建CMS工程結(jié)創(chuàng)建maven工程，CMS工程的名稱為xc-service-manage-cms，父工程為xc-framework-parent。<?xml<?xmlversion="1.0"<projectinstance""‐由于cm工程要連接mongodb所以需要在在c服務(wù)端工程添加如下依賴：項(xiàng)目使用spngdtamongodb操作mongodb數(shù)據(jù)庫 工程結(jié)構(gòu)如下3、配置文port:31001name:uri:mongodb://root:123@localhost:27017database:xc_cms4、SpringBoot .cms")//掃描實(shí)體@ComponentScan(basePackages={"com.xuecheng.api"})//掃描接publicclassManageCmsApplication{publicstaticvoidmain(String[]{}}測(cè)試packagepackageimportimportcom.xuecheng.framework. importcom.xuecheng.framework.model.response.QueryResponseResult;importcom.xuecheng.manage_cms.service.PageService;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.web.bind.annotation.PathVariable;importorg.springframework.web.bind.annotation.RestController;publicclassCmsPageControllerimplementsCmsPageControllerApi publicQueryResponseResultfindList(@PathVariable("page")intpage,@PathVariable("size")intsize,QueryPageRequestqueryPageRequest){//暫時(shí)采用測(cè)試數(shù)據(jù)，測(cè)試接口是否可以正常運(yùn)QueryResultqueryResult=newQueryResult();//靜態(tài)數(shù)據(jù)列Listlist=newArrayList();CmsPagecmsPage=newCmsPage();cmsPage.setPageName("測(cè)試頁面QueryResponseResultqueryResponseResult=newreturn}}使用瀏覽器測(cè)輸入：查詢第1頁，每頁顯示10條記錄分頁查詢測(cè)定義Dao本項(xiàng)目使用SpringDataMongodb完成Mongodb數(shù)據(jù)庫的查詢，SpringDataMongodbmongodb的方法publicpublicinterfaceCmsPageRepositoryextendsMongoRepository<CmsPage,String>}測(cè)試程序使用SriBtt和@RuWthSpigRunnrclss)注解，啟動(dòng)測(cè)試類會(huì)從mi下找springBoot啟動(dòng)類，加載spig容器。測(cè)試代碼如下packagepackageimportimportimportimportimportorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.boot.test.context.SpringBootTest;importorg.springframework.data. importpublicclassCmsPageRepositoryTestCmsPageRepositoryCmsPageRepository}publicvoid{intpage=0;//從0開intsize=10;//每頁記Pageablepageable=PageRequest.of(page,size);Page<CmsPage>all=cmsPageRepository.findAll(pageable);}基礎(chǔ)方法測(cè)這里Do接口繼承了MongRepsity，在MongReositry中定義了很多現(xiàn)成的方法，如save、dee等，通過下邊的代碼來測(cè)試這里父類方法。publicvoid//定義實(shí)體CmsPagecmsPage=newCmsPage();cmsPage.setPageName("測(cè)試頁面cmsPage.setPageCreateTime(newDate());List<CmsPageParam>cmsPageParams=newArrayList<>();CmsPageParamcmsPageParam=newCmsPageParam();}publicvoid{}publicvoidtestUpdate()Optional<CmsPage>optional=cmsPageRepository.findOne("5b17a34211fe5e2ee8c116c9");CmsPagecmsPage=optional.get();cmsPage.setPageName(測(cè)試頁面01");}}關(guān)于ponl是jk.引入的類型，Oponl是一個(gè)容器對(duì)象，它包括了我們需要的對(duì)象，使用isPstisPset方法返回lse則表示Oional包含對(duì)象為空，否則可以使用gt()取出對(duì)象進(jìn)行操作。自定義Dao同SpringDataJPA一樣SpringDatamongodb也提供自定義方法的規(guī)則publicpublicinterfaceCmsPageRepositoryextendsMongoRepository<CmsPage,String>//根據(jù)頁面名稱查CmsPagefindByPageName(String//根據(jù)頁面名稱和類型查CmsPagefindByPageNameAndPageType(StringpageName,String//根據(jù)站點(diǎn)和頁面類型查intcountBySiteIdAndPageType(StringsiteId,String//根據(jù)站點(diǎn)和頁面類型分頁查Page<CmsPage>findBySiteIdAndPageType(StringsiteId,StringpageType,Pageable}packageimport importcom.xuecheng.framework. importcom.xuecheng.framework. importcom.xuecheng.framework.model.response.QueryResponseResult;importcom.xuecheng.framework.model.response.QueryResult;importcom.xuecheng.manage_cms.dao.CmsPageRepository;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.data. importorg.springframework.data. importorg.springframework.data. importorg.springframework.stereotype.Service;publicclass{CmsPageRepository頁面列表分頁查@parampage當(dāng)前頁@paramsize頁面顯示個(gè)@paramqueryPageRequest查詢條@return頁面列publicQueryResponseResultfindList(intpage,intsize,QueryPageRequestqueryPageRequest){if(queryPageRequest==null){queryPageRequest=new}if(page<={page=}pagepage1;//為了適應(yīng)mongodb的接口將頁碼減1if(size<=0){size=}//分頁對(duì)Pageablepageable= geRequest(page,//分頁查Page<CmsPage>all=cmsPageRepository.findAll(pageable);QueryResult<CmsPage>cmsPageQueryResult=newQueryResult<CmsPage>();//返回結(jié)returnnew}}packagepackageimportimportcom.xuecheng.framework. importcom.xuecheng.framework.model.response.QueryResponseResult;importcom.xuecheng.manage_cms.service.PageService;importorg.springframework.beans.factory.annotation.Autowired;importorg.springframework.web.bind.annotation.PathVariable;importorg.springframework.web.bind.annotation.RestController;publicclassCmsPageControllerimplements{@AutowiredPageServicepageService; publicQueryResponseResultfindList(@PathVariable("page")intpage,@PathVariable("size")intsize,QueryPageRequestqueryPageRequest){return}}使用瀏覽器測(cè)輸入：查詢第1頁，每頁顯示10條記錄Api請(qǐng)求及響應(yīng)規(guī)1、 、Post請(qǐng)求時(shí)，可以提交form表單數(shù)據(jù)（aplicatio/x-www-form-urlencoded）和Js數(shù)據(jù)（Cotn-ype=aplictio/json），文件等多部件類型（mipar/fom-dat）三種數(shù)據(jù)格式，SrinVC接收J(rèn)s使用@RequesBody注解解析請(qǐng)求的jso數(shù)據(jù)。Api定義1、@PathVariable統(tǒng)一指定參數(shù)名稱，如：@PathVariable("id"2、@RequestParam統(tǒng)一指定參數(shù)名稱，如：頁面查詢接口上邊的代碼是基于服務(wù)端編寫接口，如果前端等待服務(wù)端將接口開發(fā)完畢再去開發(fā)前端內(nèi)容這樣做效率是非常低下的，所以當(dāng)接口定義完成，可以使用工具生成接口文檔，前端查看接口文檔即可進(jìn)行前端開發(fā)，這樣前端和服務(wù)并行開發(fā)，大大提高了生產(chǎn)效率。Swagger介OpenAPI規(guī)范（OpenAPISpeci?cation簡(jiǎn)稱OAS）是Linux的一個(gè)項(xiàng)目，試圖通過定義一種用來描述API格 /OAI/OpenAPI-wr是全球最大的OeAPI規(guī)范（AS）AP開發(fā)工具框架，支持從設(shè)計(jì)和文檔到測(cè)試和部署的整個(gè)AP期的開發(fā)。()SpringBoot可以集成Swagger，生成Swagger接口，SpringBoot是Java領(lǐng)域的，它是Spring項(xiàng)目下快速構(gòu)建Swagger常用注Ai：修飾整個(gè)類，描述Contle的作用AiOpi：描述一個(gè)類的一個(gè)方法，或者說一個(gè)接口ApP