基于Spring MVC+Spring+MyBatis，师说/CMS开源项目环境部署及使用超详细教程

基于Spring MVC+Spring+MyBatis，师说/CMS开源项目环境部署及使用超详细教程

师说CMS是一款使用Java语言开发的CMS开源项目，使用了Spring MVC,Spring,MyBatis等流行框架，提供首页大图管理、目录管理、文章管理和管理员管理等功能。是学习和二次开发的首选，下面教大家如何配置项目环境和使用。

下面是源码链接：

https://gitee.com/shishuo/CMS

目录
一、 环境部署 3

1. 系统依赖 3
2. JDK配置 3
3. Maven配置 5
4. MySQL配置 9
5. Tomcat配置 13
   二、 系统安装 15
6. 部署开发环境 15
7. 数据库配置 16
   三、 使用手册 16

一、环境部署
1.系统依赖
1)JDK 1.8
2)Maven 3.5.2
3)MySQL 5.7.13
4)Tomcat 8.5.11
2.JDK配置
1)检测
先查是否安装有其他版本的JDK，若没有则进行下列步骤，若已安装，则先卸载它（若已安装的JDK版本号为1.8.0.X，可不必卸载，跳过本步骤不再安装JDK）
2)下载
a)进入官网的下载地址jdk1.8下载地址https://www.oracle.com/java/technologies/javase/javase-jdk8-downloads.html；

b)按照红色方框的指示，先选中 [Accept License Agreement]，表示同意安装使用协议；
c)选择Windows x64(即64位操作系统),点击下载；
d)等待下载完成即可。
3)安装
下载之后默认安装即可。注意：安装的时候记住安装路径。例如安装路径是：C:\Program Files\Java\jdk1.8.0_171
4)配置环境变量
a)找到系统环境变量

b)新建JAVA_HOME系统变量
变量名：JAVA_HOME ，变量值：
C:\Program Files\Java\jdk1.8.0_171(自己选择的安装路径！！！)

c)新建CLASSPATH变量
变量名：CLASSPATH , 变量值：
.;%JAVA_HOME%\lib;%JAVA_HOME%\lib\tools.jar
（注意最前面有一点）

d)配置系统环境变量Path
双击Path–>新建–>添加“%JAVA_HOME%\bin”–>将这一行变量上移到最顶端–>完成

e)应用
所有环境变量配置完成之后，应用环境变量即可

3.Maven配置
1)下载与安装
a)前往https://maven.apache.org/download.cgi下载Maven程序

b)将文件解压到D:\Program Files\Apache\maven目录下

c)新建环境变量MAVEN_HOME，赋值D:\Program Files\Apache\maven

d)编辑环境变量Path，追加%MAVEN_HOME%\bin\

e)通过DOS命令检查一下是否安装成功

2)配置Maven本地仓库
a)在D:\Program Files\Apache\目录下新建maven-repository文件夹，该目录用作maven的本地库
b)打开D:\Program Files\Apache\maven\conf\settings.xml文件，查找下面代码：/path/to/local/repo localRepository节点默认是被注释掉的，需要把它移到注释之外，然后将localRepository节点的值改为我们在之前创建的目录D:\Program Files\Apache\maven-repository（注：localRepository节点用于配置本地仓库。当我们从maven中获取jar包的时候，maven首先会在本地仓库中查找，如果本地仓库有则返回；如果没有则从远程仓库中获取包，并在本地库中保存。）
c)运行以下DOS命令：mvn help:system。如果前面的配置成功，那么D:\Program Files\Apache\maven-repository会出现一些文件。
3)配置Eclipse的Maven环境
a)在Eclipse中，打开Window->Preferences->Maven->Installations，右侧点击Add

b)设置maven的安装目录，然后Finish

c)选中刚刚添加的maven，并Apply

d)打开Window->Preferences->Maven->User Settings，配置如下并Apply

4.MySQL配置
1)下载
进入官网找到自己所需的安装包，选择不登陆下载

2)安装
a)双击运行下载好的mysql-installer-community-5.7.19.0.msi，程序运行需要一些时间，请等待一下

b)运行成功之后，进入欢迎的界面.选择我同意协议，不然无法进行下一步

c)开发者默认模式检测以下程序会安装不成功，点击下一步进入下一个安装流程、

d)在安装所选界面能看到我们接下来所需要安装的程序，点击execute，程序安装完成之后，点击next

e)在product configutration（产品配置）页面能看到需要配置的程序，点击next

f)配置mysql server的类型以及网络

g)配置mysql router

h)安装一些server，点击execute，完成之后点击finish

3)配置环境变量
a)mysql默认安装路径是：C:\Program Files\MySQL\MySQL Server 5.7，我的电脑右键->属性->高级系统设置->环境变量->新建MYSQL_HOME,将安装目录输入

b)找到path编辑：输入%MYSQL_HOME%\bin

4)启动
打开cmd输入mysql –u root –p，输入root的密码

5.Tomcat配置
1)下载tomcat8 ：官网地址:http://tomcat.apache.org/下载，根据自己电脑的系统 ,下载对应的版本zip

下一步：

2)解压缩apache-tomcat-8.5.11-windows-x64.zip

3)环境变量配置
在系统变量中 ,新增 CATALINA_HOME,地址就是刚才文件夹
PATH新添%CATALINA_HOME%\bin;%CATALINA_HOME%\lib

4)使用命令行进行安装
在tomcat目录\bin目录中 ,运行命令行 ,输入 service.bat install
稍候提示 the service “tomcat8” has been installed ,则表示成功

5)测试
在tomcat\bin目录 ,双击 tomcat8W.exe 图形界面程序 ,在弹出的图形界面中 ,点击start ,运行tomcat ,浏览器输入localhost:8080 ,访问

出现此页面则成功安装。
二、系统安装
1.部署开发环境
1)下载 Eclipse IDE for Java EE Developers
2)打开eclpse,导入师说CMS
3)File -> Import -> Git -> Projects from Git -> Clone URI
4)然后在URI输入：https://git.oschina.net/shishuo/CMS.git
5)等待eclipse自动下载jar包
6)创建数据库
2.数据库配置
1)修改 shishuocms.properties 里的数据库链接、用户名和密码为生产环境的值
2)创建shishuocms数据库，在数据库中执行/sql/install.sql中的插入语句，创建相应的表格，并插入初始数据信息
三、使用手册
1.管理员模块
1)登陆管理模块
a)管理员登录
激励：在浏览器中输入网址：http://localhost:8080/shishuocms
响应：页面跳转至师说的首页

激励：点击首页界面右下角功能板块的登录链接
响应：页面跳转至师说 CMS 的登录界面

激励：输入用户名、密码以及随机生成的验证码，点击登录按钮
响应：如果用户存在且密码和验证码都正确，则跳转至后台页面；若其中一项不存在或者不正确，则提示“邮箱或密码错误”“验证码错误”信息。

b)安全退出
激励：在成功登录之后，用户点击界面右上角的下拉选项框，点击安全退出按钮
响应：退出后台，页面跳转至师说 CMS 的首页

2)文章管理模块
a)文章列表
激励：进入后台之后，点击左边导航栏的文章列表
响应：界面上列出当前系统中存在的所有文章记录（包括文章名称，显示状态，审核状态，所属目录，最后更新时间，以及操作链接）

b)增加文章
激励：点击增加文章
响应：跳转至文章编辑页面

激励：选择文章的封面，填入文章标题，选择所属目录，添加文章摘要以及文章的正文，选择文章的显示状态，点击发布按钮
响应：弹出“保存成功，将刷新页面”的模态框

激励：点击 OK
响应：当前页面刷新，文章列表更新，出现相应的文章记录，文章增加成功

c)编辑文章
激励：在文章列表中，点击要编辑的文章名称或者记录后边的编辑链接
响应：页面跳转至文章的编辑页面

激励：在这里对想要修改的内容进行相应的编辑，点击发布按钮
响应：弹出“保存成功，将刷新页面”的模态框

激励：点击 OK
响应：当前页面刷新，文章列表中记录更新

d)删除文章
激励：点击想要删除文章后边的删除链接
响应：弹出“是否删除文章”的模态框

激励：点击确定按钮
响应：当前页面刷新，相关的文章记录消失
激励：点击取消按钮
响应：没有操作执行

e)索引文章
i.根据审核状态检索文章
1.全部文章
激励：点击“全部文章”链接
响应：当前页面显示系统中所有的文章记录

2.未审核文章
激励：点击“未审核”链接
响应：当前页面显示出当前系统中所有未被审核的文章记录

3.审核退回文章
激励：点击“审核退回”链接
响应：当前页面显示出当前系统中所有审核被退回的文章记录

ii.根据所属目录检索文章
激励：文章记录后边相应的目录名称链接
响应：当前页面更新目录路径，同时列出了属于该目录的所有文章记录

f)审核文章
激励：点击相应文章记录审核栏里的下拉选项框进行审核状态的选择
响应：相应文章的审核状态被改变且更新

3)首页头条模块
激励：点击左侧导航栏的首页头条按钮
响应：右边页面刷新（头图列表页面）

a)增加头条
激励：当前页面的“增加头图”按钮
响应：页面跳转至添加头图的编辑页面

激励：选择本地的图片文件，或者网络图片的链接，编辑头图名称，点击保存按钮
响应：弹出“保存成功，将刷新页面”模态框

激励：点击 OK 按钮
响应：当前页面刷新，同时头图列表更新，新添加的头图记录被显示出来

b)删除头条
激励：点击相应头图记录后边的删除链接
响应：弹出“是否要删除文件？”模态框

激励：点击 OK 按钮
响应：当前页面刷新，相关头条记录消失
激励：点击 Cancel 按钮
响应：不做任何操作

c)修改头条
激励：点击相应头图记录后边的修改链接
响应：页面跳转至头图的编辑页面

激励：在该页面对想要进行修改的内容进行编辑，点击保存按钮
响应：弹出“保存成功，将刷新页面”模态框

激励：点击 OK
响应：当前页面刷新且头条列表中相关信息更新

d)更新头条排序
激励：编辑头图列表中相应记录的顺序
响应：列表记录更新，按照顺序升序排列

4)目录管理模块
激励：点击左侧导航栏的目录列表按钮
响应：右边页面刷新（目录结构页面：上半部分为添加目录信息的编辑部分，下半部分为目录的结构列表）

a)添加目录
激励：在添加目录模块中，添加目录名称、英文名称，选择其所属的父级标签，选择目录状态，选择该目录下的文章是否需要审核，点击保存按钮
响应：弹出“保存成功”模态框

激励：点击 OK
响应：相关目录被添加进入目录结构中

b)删除目录
激励：点击相关目录记录后边的删除链接
响应：弹出“是否删除文件夹”模态框

激励：点击删除按钮
响应：如果该目录下还有其他的文件，则弹出不能删除的提示模态框；如果没有其他的文件，那么弹出“删除成功”的模态框，相关的目录记录被删除
激励：点击取消按钮
响应：不做任何操作

c)修改目录
激励：点击相关目录记录后边的修改链接
响应：跳转到目录的编辑页面

激励：对想要修改的内容进行编辑，点击更新目录按钮
响应：弹出“保存成功，将刷新页面”模态框

激励：点击 OK 按钮
响应：该目录的相关信息更新

d)查看目录结构
激励：点击目录的名称链接
响应：列出属于该目录的所有子目录记录，同时页面顶部的目录路径更新

激励：点击路径中的目录名称链接
响应：页面列出属于该目录的所有子目录

e)查看目录文件列表
激励：点击目录记录后边的文章列表
响应：页面列出属于该目录的所有文章记录

f)更新目录排序
激励：在一个目录列表中编辑相关目录的顺序编号，点击更新排序
响应：弹出“更新成功”模态框

激励：点击 OK
响应：目录列表中的记录按顺序的升序排序

5)留言管理模块
存在框架但尚未实现该功能。

6)管理员账户管理模块
激励：点击左侧导航栏的管理员管理按钮
响应：右边页面刷新（管理员管理页面）

a)增加管理员
激励：在该页面添加管理员模块中，编辑管理员的用户名以及密码，点击增加按钮
响应：弹出“保存成功，将刷新页面”模态框

激励：点击 OK
响应：相关记录显示在下方的管理员列表里，添加管理员成功

b)删除管理员
激励：点击相应管理员后边的删除链接
响应：弹出“是否删除管理员的”的确认模态框

激励：点击取消按钮
响应：不做操作
激励：点击删除按钮
响应：弹出“删除成功”模态框

激励：点击 OK
响应：相关记录被清除，列表更新（删除自己后，仍能进行除改密码外的操作）

7)管理员权限管理模块
a)增加管理目录
激励：点击管理员后边的权限按钮
响应：页面跳转至管理管权限编辑页面

激励：选择想要为其添加的权限目录，点击增加按钮
响应：该管理员的权限列表更新，相关目录被添加，同时该管理员的可以管理被添加目录下所有文件

b)删除管理目录
激励：点击管理员权限列表中目录记录后边的删除链接
响应：弹出“是否删除博客文件夹”模态框

激励：点击取消按钮
响应：不做操作
激励：点击删除按钮
响应：管理员权限列表更新，相关记录被清除，同时该管理员无法再管理该目录下的所有文章

8)管理员信息管理模块
激励：点击左侧导航栏的修改密码按钮
响应：右边页面刷新（管理员个人信息页面）

a)更改账户密码
激励：在密码栏里输入新的密码，点击修改
响应：弹出“保存成功，将刷新页面”的模态框

激励：点击 OK
响应：密码修改成功（但仍能进行相关管理操作）

2.游客模块
1)查看博文
激励：在浏览器中输入网址：http://localhost:8080/shishuocms
响应：页面跳转至师说的首页，可查看所有文章

2)检索博文
激励：点击页面上方导航栏或者右方中的目录名索引
响应：页面列出相应目录下的所有文章内容，游客可进行浏览