一、简述
作为一个JAVA新手,虽然有一些开发的底子,但是在SSM框架的学习中也是步履艰难。俗话说好记性不如烂笔头,在搭建好一个简单的基于SSM框架的小项目后,做以下的整理,文中表达不清楚的地方,还望各位给予建议(学习阶段借鉴雷老师的“SSM高级整合视频教程”,因为本人对版权一事不太清楚,所以此处不在上链接了,有兴趣的同学可以去找一下相关视频)。
项目地址:https://gitee.com/soft_luotuo/SSM_Maven
二、相关工具/技术
- IDE工具:eclipse
- 项目依赖管理:Maven
- 基础框架:SSM(Spring+SpringMVC+Mybatis)
- 数据库:MySql
- 前端框架:bootstrap
- 逆向工程:Mybatis Generator
- 分页插件:pagehelper
三、开发环境
3.1 系统环境
win10 64位
3.2 JDK安装
JDK的下载根据自己的形同是64位还是32位来选择下载,本人电脑是64位的,所以选择如图3.2.1所标注的版本(下载地址:http://www.oracle.com/technetwork/cn/java/javase/downloads/jdk8-downloads-2133151-zhs.html)。
图 3.2.1
下载完成后,双击exe文件,一直选择next完成安装,在安装完成之后就是环境变量的配置,步骤如下:
1)计算机->右键->属性->高级系统设置->高级->环境变量。
2) 在系统变量中选择“新建”按钮(如图3.2.2),在弹出界面中,变量名:JAVA_HOME,变量值:C:\Program Files (x86)\Java\jdk1.8.0_144(这里是我的JDK安装路径,各位根据自己的安装情况来设置)。
图 3.2.2
3) 设置完成JAVA_HOME环境变量后,在环境变量中找到变量名:Path,点击编辑->新建,增加:%JAVA_HOME%\bin(图3.2.3)。
图 3.2.3
4) 重复上述操作,新建变量名:CLASSPATH,变量值:.;%JAVA_HOME%\lib\dt.jar;%JAVA_HOME%\lib\tools.jar;
5) 上述4个步骤设置完毕后,下面进行测试,验证安装是否成功。快捷键WIN+R,打开“运行”,输入“cmd”,在弹出的DOS命令页面输入“java -version”命令,回车,出现如下图3.2.4效果,即说明安装JDK成功。
图 3.2.4
3.3 Eclipse安装
JAVA开发使用的IDE工具也比较多,这里我选用的Eclipse(下载地址:https://www.eclipse.org/downloads/),这里值得注意的是对于新手一定要下载正确的JAVA J2EE版本,错误的版本会在搭建项目中出现的异常情况摸不着头脑,下载完成后,如果不需要修改安装路径,一路next到底即可。
安装完成后,打开Eclipse,选择导航栏Window->Preference,弹出页面找到Java->Installed JREs选项,点击Add按钮,找到JRE安装目录,选择安装的JDK文件(图3.3.1)。
图 3.3.1
3.4 Tomcat安装
我这里选择的是Tomcat7.0的版本,大家可以根据自己情况选择不同的版本(下载地址:http://tomcat.apache.org/download-70.cgi),进入下载页面,选择Core下的符合自己的版本,如图3.4.1是我下载的版本。
图 3.4.1
打开Eclipse中的Window->preference,选择Server选项下的Runtime Environments选项,点击Add按钮添加下载好的本地的Tomcat文件(图3.4.2),至此Tomcat设置完毕。
图 3.4.2
3.5 Maven安装
我这里下载的是Maven-3.5.2版本(下载地址:https://maven.apache.org/download.cgi),大家可根据自己的情况选择其他版本下载。下载后解压到方便记忆的路径,下面开始配置环境变量。
1) 计算机->右键->属性->高级系统设置->环境变量->"系统变量"下"新建“按钮。
2) 变量名:MAVEN_HOME,变量值:D:\Java_Tools\apache-maven-3.5.2-bin\apache-maven-3.5.2。
3) 选择“系统变量”下“Path”->编辑,加入:%MAVEN_HOME%\bin。
设置完成后快捷键WIN+R打开“运行”,输入“cmd”打开DOS命令行页面,输入:mvn -version命令,回车,出现如图3.5.1效果,说明Maven环境配置成功。
图 3.5.1
3.6 Maven数据仓库设置
Maven数据仓库分为:本地仓库(当前用户根目录.m2\repository下),远程仓库(包含:中央仓库(https://repo.maven.apache.org/maven2)、私服、其他公共仓库(阿里云、开源中国等))。当我们引用jar包的时候,Maven会先从本地仓库寻找所需jar包,如果本地仓库中不存在,Maven将会去远程地址下载所需jar包(因为外网地址访问可能受限,这里推荐使用其他公共仓库),下面进行相关配置。
1)打开maven的安装目录(例如:D:\Java_Tools\apache-maven-3.5.2-bin\apache-maven-3.5.2\conf)中的settings.xml文件,修改本地仓库位置到D:\Java_Tools\.m2\repository目录中(注意:Maven安装后默认的本地仓库是用户工作目录下的“.m2/repository“目录,如:C:\Users\Administrator\.m2\repository,因为这个目录中的文件可能会越来越多,为了节省C盘空间,建议自己新建一个单独目录保存本地仓库数据),如图3.6.1。
D:/Java_Tools/.m2/repository
图 3.6.1
2)打开settings.xml,修改mirror镜像信息,如图3.6.2。
alimaven
aliyun maven
Central
http://maven.aliyun.com/nexus/content/repositories/central
图 3.6.2
4)为了防止创建的项目中出现一些异常,下面在Settings.xml中配置maven工程的jdk版本是1.8,如图3.6.3。
jdk-1.8
1.8
true
1.8
1.8
1.8
图 3.6.3
4) 打开Eclipse->window->preferences->Maven->Installations,点击Add添加下载后解压的Maven安装包的位置,勾选新增的Maven版本(如图3.6.4)。
图 3.6.4
4) 打开Eclipse->window->preferences->Maven->User Settings,设置settings.xml的路径(如图3.6.5)。
图 3.6.4
5)配置Maven完成后,查看当前用户目录下是否存在.m2目录(C:\Users\Administrator\.m2),如果不存在,是因为没有执行任何Maven相关的命令,使用任一Maven相关命令后即可出现.m2目录,例如:cmd下执行mvn help:system命令,执行完毕后会发现.m2文件夹已经产生。
四、项目的创建
在3.5和3.6节对Maven环境及数据仓库配置完毕后,下面来创建Maven项目。
1) 打开Eclipse->Project Explorer->右键->New->Other->Maven->Maven Project(图4.1.1),点击Next按钮。
图 4.1.1
2) 在图4.1.2中,创建一个Maven工程,点击Next按钮。
图 4.1.2
3) 在图4.1.3中,按照自己的情况设置Group Id,Artifct Id,Packaging,点击Finish按钮,完成项目的新建(上述三个名词的具体含义,各位自行查找)。
图 4.1.3
4) 选择maven-archetype-webapp,点击next,如图4.1.4。
图 4.1.4
5)下图4.1.5中GroupId为项目的基本的包名,Artifact Id为项目的名称,Packaging为打包方式,点击Finish完成项目的创建。
图 4.1.5
6)项目创建完毕后,Eclipse会根据Settings.xml文件中的镜像仓库地址去查找并下载所需的jar包到本地仓库(D:\java_tools\.m2\repository)中,同时完善项目的整体目录架构,如图4.1.6。
图 4.1.6
7)工程创建完成后,由于默认的servlet版本比较低,所以进行版本的修改,不然可能会提示“Cannot change version of project facet Dynamic web module to 2.3”的错误提示,在当前项目上右键->properties->Project Facets,按照自己的需要修改配置,如图4.1.7和图4.1.8。
图 4.1.7
图 4.1.8
8)修改完成后,如果web.xml提示错误,建议删除web.xml,去掉上图中Dynamic Web Module的勾选,点击Apply按钮,然后再次勾选Dynamic Web Module选择适合版本,点击Apply按钮,这是会出现如图提示,点击图4.1.9标记内容。
图 4.1.9
9)弹出页面中按下图4.1.10操作,然后保存修改即可。
图 4.1.10
10)完成后,运行项目正常显示网页内容,说明工程创建成功。
五、项目配置
5.1 Spring插件配置
下载Spring IDE插件用于web.xml智能提示使用(下载地址:http://spring.io/tools/sts/all),根据自己Eclipse的版本选择下载,如图5.1.1。
图 5.1.1
打开Eclipse->Help->Install New Software,点击Add,添加已下在的本地Spring IDE文件,点击OK,如图5.1.2。
图 5.1.2
选择下图中的文件,去掉最下面复选框的勾选(这个设置会联网更新,因为Spring IDE已下载到本地,故这里不需要联网处理),进行安装,如图5.1..3。
图 5.1..3
5.2 pom.xml中引入相关jar包
包含内容(配置地址:https://mvnrepository.com/):
● Spring
● Spring mvc
● Mybatis
● Mybatis逆向工程包
● 数据库连接、驱动包
● 其他(jstl、junit、servlet-api)
org.springframework
spring-webmvc
5.0.0.RELEASE
org.springframework
spring-jdbc
5.0.0.RELEASE
org.springframework
spring-aspects
5.0.0.RELEASE
org.mybatis
mybatis
3.4.4
org.mybatis
mybatis-spring
1.3.1
com.mchange
c3p0
0.9.5.2
mysql
mysql-connector-java
5.1.44
org.mybatis.generator
mybatis-generator-core
1.3.5
jstl
jstl
1.2
javax.servlet
javax.servlet-api
3.1.0
provided
junit
junit
3.8.1
test
5.3 配置web.xml
注意:Spring mvc对于的xml配置文件,例如:applicationContext.xml中如果报错提示:“cvc-elt.1: 找不到元素 'beans' 的声明”,检查是否缺少“xmlns="http://www.springframework.org/schema/beans"”内容,添加上即可解决。
contextConfigLocation
classpath:applicationContext.xml
org.springframework.web.context.ContextLoaderListener
dispatcherServlet
org.springframework.web.servlet.DispatcherServlet
1
dispatcherServlet
/
CharacterEncodingFilter
org.springframework.web.filter.CharacterEncodingFilter
encoding
utf-8
forceRequestEncoding
true
forceResponseEncoding
true
CharacterEncodingFilter
/*
HiddenHttpMethodFilter
org.springframework.web.filter.HiddenHttpMethodFilter
HiddenHttpMethodFilter
/*
5.4 配置SpringMVC的dispatcherServlet-servlet.xml文件
5.5 配置Spring的配置文件applicationContext.xml
5.6 数据库连接配置文件dbconfig.properties
jdbc.jdbcUrl=jdbc:mysql://localhost:3306/ssm_test
jdbc.driverClass=com.mysql.jdbc.Driver
jdbc.user=root
jdbc.password=123456
5.7 Mybatis的全局配置文件
5.8 Mybatis的逆向工程配置
向pom.xml文件中加入以下代码,配置mybatis-generator的jar包(注意:上面的pom.xml文件配置中已添加)。
org.mybatis.generator
mybatis-generator-core
1.3.5
5.9 逆向工程配置文件(地址:http://www.mybatis.org/generator/)
1) 在项目下创建mbg.xml配置文件。
2) 在com.maven.ssm.test包下创建java测试类MBGTest.java文件,运行生成对应逆向工程设置的文件。
package com.maven.ssm.test;
import java.io.File;
import java.util.ArrayList;
import java.util.List;
import java.util.zip.*;
import org.mybatis.generator.api.MyBatisGenerator;
import org.mybatis.generator.config.Configuration;
import org.mybatis.generator.config.xml.ConfigurationParser;
import org.mybatis.generator.internal.DefaultShellCallback;
public class MBGTest {
public static void main(String[] args) throws Exception {
List warnings = new ArrayList();
boolean overwrite = true;
File configFile = new File("mbg.xml");
ConfigurationParser cp = new ConfigurationParser(warnings);
Configuration config = cp.parseConfiguration(configFile);
DefaultShellCallback callback = new DefaultShellCallback(overwrite);
MyBatisGenerator myBatisGenerator = new MyBatisGenerator(config, callback, warnings);
myBatisGenerator.generate(null);
}
}
3) 配置完成最终项目框架,如图5.9.1
图 5.9.1
六、总结
整个项目的搭建及配置的过程中遇坑无数,各种百度找出问题,其中经常导致错误的反而是漏写一个字母或者是敲错一个字母,所以各位在项目搭建的过程一定要全神贯注,不要像我这样粗心大意。
介于本人的文笔功底太弱,所以不做过多的赘述。上述内容中如有问题请留言指正,相互学习。