目录
前阵子突发奇想，想学习下springmvc的源码，于是打算用idea搭建一个简易的maven版ssm案例，也就是springmvc+spring+mybatis+maven，因为之前创建过一些spring的小demo，相关的软件环境已经搭建完成，本以为搭建一个入门级的ssm项目应该不难，谁曾想这个过程中遇到了不少千奇百怪的问题，从开始创建到成功运行花了我整整一个下午的时间(我的午觉啊~~~·)，最后项目成功跑起来的时候我长出了一口气，为了以后不在类似的事情上折腾，特此写下这篇文章记录一下搭建过程。
先准备好搭建项目的基本环境
intellij idea：2018.1.1
jdk：1.8
maven：3.6.0
tomcat：7.0及以上
下载安装好软件后，在idea软件设置里做好jdk、maven和tomcat的相关环境配置，这方面网上的资料很多，本文就不介绍了。
搭建好环境后，打开idea，点击new - project
找到maven一栏，因为要搭建的springmvc项目，所以选择webapp模板
填写好groupid和artifactid后，一步步next，最后finish完成
创建成功后，可以看到项目是这样的目录结构
除了配置相关依赖的pom.xml，目录中还有一个文件夹src，src的main目录提供了一个webapp文件夹，webapp文件夹下有一个web-inf文件夹，放置的是前端页面的文件，以及web.xml文件。
除了模版提供的目录结构，为了后面项目能成功运行，我们还需要添加一些文件夹，让项目的目录结构变成这样：
首先，先准备好数据库文件，并初始化一条记录
我要评论drop table if exists `user`;
create table `user` (
`id` int(11) not null auto_increment comment '用户id',
`email` varchar(255) not null comment '用户邮箱',
`username` varchar(255) not null comment '用户昵称',
`role` varchar(255) not null comment '用户身份',
`mobile` varchar(50) default '' comment '手机号码',
primary key (`id`)
) engine=innodb auto_increment=2 default charset=utf-8;
-- ----------------------------
-- records of user
-- ----------------------------
insert into `user` values ('1', '1589585621@qq.com', 'xjt', 'root', '15678635432');
<?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">
<modelversion>4.0.0</modelversion>
<groupid>com.xjt</groupid>
<artifactid>mvcdemo</artifactid>
<version>1.0-snapshot</version>
<packaging>war</packaging>
<name>mvcdemo maven webapp</name>
<!-- 用来设置版本号 -->
<properties>
<srping.version>4.0.2.release</srping.version>
<mybatis.version>3.2.8</mybatis.version>
<slf4j.version>1.7.12</slf4j.version>
<log4j.version>1.2.17</log4j.version>
<druid.version>1.0.9</druid.version>
</properties>
<!-- 用到的jar包 -->
<dependencies>
<!-- 单元测试 -->
<dependency>
<groupid>junit</groupid>
<artifactid>junit</artifactid>
<version>4.11</version>
<!-- 表示开发的时候引入，发布的时候不会加载此包 -->
<scope>test</scope>
</dependency>
<!-- spring框架包 -->
<dependency>
<groupid>org.springframework</groupid>
<artifactid>spring-test</artifactid>
<version>${srping.version}</version>
</dependency>
<dependency>
<groupid>org.springframework</groupid>
<artifactid>spring-core</artifactid>
<version>${srping.version}</version>
</dependency>
<dependency>
<groupid>org.springframework</groupid>
<artifactid>spring-oxm</artifactid>
<version>${srping.version}</version>
</dependency>
<dependency>
<groupid>org.springframework</groupid>
<artifactid>spring-tx</artifactid>
<version>${srping.version}</version>
</dependency>
<dependency>
<groupid>org.springframework</groupid>
<artifactid>spring-jdbc</artifactid>
<version>${srping.version}</version>
</dependency>
<dependency>
<groupid>org.springframework</groupid>
<artifactid>spring-aop</artifactid>
<version>${srping.version}</version>
</dependency>
<dependency>
<groupid>org.springframework</groupid>
<artifactid>spring-context</artifactid>
<version>${srping.version}</version>
</dependency>
<dependency>
<groupid>org.springframework</groupid>
<artifactid>spring-context-support</artifactid>
<version>${srping.version}</version>
</dependency>
<dependency>
<groupid>org.springframework</groupid>
<artifactid>spring-expression</artifactid>
<version>${srping.version}</version>
</dependency>
<dependency>
<groupid>org.springframework</groupid>
<artifactid>spring-orm</artifactid>
<version>${srping.version}</version>
</dependency>
<dependency>
<groupid>org.springframework</groupid>
<artifactid>spring-web</artifactid>
<version>${srping.version}</version>
</dependency>
<dependency>
<groupid>org.springframework</groupid>
<artifactid>spring-webmvc</artifactid>
<version>${srping.version}</version>
</dependency>
<!-- spring框架包 -->
<!-- mybatis框架包 -->
<dependency>
<groupid>org.mybatis</groupid>
<artifactid>mybatis</artifactid>
<version>${mybatis.version}</version>
</dependency>
<dependency>
<groupid>org.mybatis</groupid>
<artifactid>mybatis-spring</artifactid>
<version>1.2.2</version>
</dependency>
<!-- mybatis框架包 -->
<!-- 数据库驱动 -->
<dependency>
<groupid>mysql</groupid>
<artifactid>mysql-connector-java</artifactid>
<version>5.1.35</version>
</dependency>
<!-- 导入dbcp的jar包，用来在applicationcontext.xml中配置数据库 -->
<dependency>
<groupid>commons-dbcp</groupid>
<artifactid>commons-dbcp</artifactid>
<version>1.4</version>
</dependency>
<!-- jstl标签类 -->
<dependency>
<groupid>jstl</groupid>
<artifactid>jstl</artifactid>
<version>1.2</version>
</dependency>
<!-- log -->
<dependency>
<groupid>log4j</groupid>
<artifactid>log4j</artifactid>
<version>${log4j.version}</version>
</dependency>
<dependency>
<groupid>org.slf4j</groupid>
<artifactid>slf4j-api</artifactid>
<version>${slf4j.version}</version>
</dependency>
<dependency>
<groupid>org.slf4j</groupid>
<artifactid>slf4j-log4j12</artifactid>
<version>${slf4j.version}</version>
</dependency>
<!-- 连接池 -->
<dependency>
<groupid>com.alibaba</groupid>
<artifactid>druid</artifactid>
<version>${druid.version}</version>
</dependency>
</dependencies>
<build>
<!-- java编译插件,如果maven的设置里配置好jdk版本就不用 -->
<plugins>
<plugin>
<groupid>org.apache.maven.plugins</groupid>
<artifactid>maven-compiler-plugin</artifactid>
<version>3.2</version>
<configuration>
<source>1.8</source>
<target>1.8</target>
<encoding>utf-8</encoding>
</configuration>
</plugin>
</plugins>
</build>
</project>
注：以下四个配置文件都是放置在resources文件夹下
#日志输出级别
log4j.rootlogger=debug,stdout,d,e
#设置stdout的日志输出控制台
log4j.appender.stdout=org.apache.log4j.consoleappender
#输出日志到控制台的方式，默认为system.out
log4j.appender.stdout.target = system.out
#设置使用灵活布局
log4j.appender.stdout.layout=org.apache.log4j.patternlayout
#灵活定义输出格式
log4j.appender.stdout.layout.conversionpattern=%d{yyyy-mm-dd hh:mm:ss,sss} -[%p] method:[%c (%rms)] - %m%n
driver=com.mysql.jdbc.driver url=jdbc:mysql://localhost:3306/test?characterencoding=utf8&usessl=false #数据库的用户名 username=root #数据库的密码，别像我一样不设置 password= #定义初始连接数 initialsize=0 #定义最大连接数 maxactive=20 #定义最大空闲 maxidle=20 #定义最小空闲 minidle=1 #定义最长等待时间 maxwait=60000
这是spring的核心配置文件，包括spring结合mybatis和数据源的配置信息
<?xml version="1.0" encoding="utf-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
xmlns:tx="http://www.springframework.org/schema/tx" xmlns:context="http://www.springframework.org/schema/context"
xsi:schemalocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
http://www.springframework.org/schema/tx
http://www.springframework.org/schema/tx/spring-tx.xsd http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd">
<!-- 加载properties文件 -->
<bean id="propertyconfigurer" class="org.springframework.beans.factory.config.propertyplaceholderconfigurer">
<property name="location" value="classpath:jdbc.properties"/>
</bean>
<!-- 配置数据源 -->
<bean id="datasource" class="com.alibaba.druid.pool.druiddatasource">
<property name="driverclassname" value="${driver}"/>
<property name="url" value="${url}"/>
<property name="username" value="${username}"/>
<property name="password" value="${password}"/>
</bean>
<!-- mybatis和spring完美整合，不需要mybatis的配置映射文件 -->
<bean id="sqlsessionfactory" class="org.mybatis.spring.sqlsessionfactorybean">
<property name="datasource" ref="datasource"/>
<!-- 扫描model包 -->
<property name="typealiasespackage" value="com.xjt.model"/>
<!-- 扫描sql配置文件:mapper需要的xml文件-->
<property name="mapperlocations" value="classpath:mapper/*.xml"/>
</bean>
<!-- mapper动态代理开发，扫描dao接口包-->
<bean class="org.mybatis.spring.mapper.mapperscannerconfigurer">
<!-- 注入sqlsessionfactory -->
<property name="sqlsessionfactorybeanname" value="sqlsessionfactory"/>
<!-- 给出需要扫描dao接口包 -->
<property name="basepackage" value="com.xjt.dao"/>
</bean>
<!-- 事务管理 -->
<bean id="transactionmanager" class="org.springframework.jdbc.datasource.datasourcetransactionmanager">
<!--数据库连接池-->
<property name="datasource" ref="datasource"/>
</bean>
<?xml version="1.0" encoding="utf-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemalocation="http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/mvc
http://www.springframework.org/schema/mvc/spring-mvc-3.0.xsd">
<!-- 扫描注解，这样com.xjt包下的文件都能被扫描 -->
<context:component-scan base-package="com.xjt"/>
<!-- 开启springmvc注解模式 -->
<mvc:annotation-driven/>
<!-- 静态资源默认servlet配置 -->
<mvc:default-servlet-handler/>
<!-- 配置返回视图的路径，以及识别后缀是jsp文件 -->
<bean class="org.springframework.web.servlet.view.internalresourceviewresolver">
<property name="viewclass" value="org.springframework.web.servlet.view.jstlview"/>
<property name="prefix" value="/web-inf/jsp/"/>
<property name="suffix" value=".jsp"/>
</bean>
</beans>
该文件不是放在resources，而是webapp的web-inf文件夹下，文件内容如下：
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/xmlschema-instance"
xsi:schemalocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_3_1.xsd"
version="3.1">
<display-name>mvcdemo</display-name>
<!--项目的欢迎页，项目运行起来后访问的页面-->
<welcome-file-list>
<welcome-file>index.jsp</welcome-file>
</welcome-file-list>
<!-- 注册servletcontext监听器，创建容器对象，并且将applicationcontext对象放到application域中 -->
<listener>
<listener-class>org.springframework.web.context.contextloaderlistener</listener-class>
</listener>
<!-- 指定spring核心配置文件 -->
<context-param>
<param-name>contextconfiglocation</param-name>
<param-value>classpath:applicationcontext.xml</param-value>
</context-param>
<!-- 解决乱码的过滤器 -->
<filter>
<filter-name>characterencodingfilter</filter-name>
<filter-class>org.springframework.web.filter.characterencodingfilter</filter-class>
<init-param>
<param-name>encoding</param-name>
<param-value>utf-8</param-value>
</init-param>
<init-param>
<param-name>forceencoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>characterencodingfilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
<!-- 配置前端控制器 -->
<servlet>
<servlet-name>springmvc</servlet-name>
<servlet-class>org.springframework.web.servlet.dispatcherservlet</servlet-class>
<!-- 指定配置文件位置和名称 如果不设置,默认找/web-inf/<servlet-name>-servlet.xml -->
<init-param>
<param-name>contextconfiglocation</param-name>
<param-value>classpath:spring-mvc.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
<async-supported>true</async-supported>
</servlet>
<servlet-mapping>
<servlet-name>springmvc</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
上面的配置文件编写好之后，其实我们就可以尝试着启动项目了，启动项目前先把applicationcontext.xml的内容都注释了，然后就可以创建运行环境了。
点击idea右上角的 edit configurations...
选择tomcat server - local，
编辑好项目的启动信息，包括项目名，jdk版本，tomcat以及端口
选择deployment，添加atifact，选择第二项，否则tomcat运行会报错
保存后，启动项目，成功后在浏览器输入，返回结果如下：
这是index.jsp文件中的内容，因为index.jsp是启动页，所以项目启动后返回的结果是启动页的内容
<html> <body> <h2>hello world!</h2> </body> </html>
项目能跑起来，说明我们前端控制器的配置是成功的，接下来要做的是测试能否访问数据库。首先，把基本的类文件创建并编写好代码。
实体类：user.java
package com.xjt.model;
public class user {
private long id;
private string email;
private string mobile;
private string username;
private string role;
public long getid() {
return id;
}
public void setid(long id) {
this.id = id;
}
public string getemail() {
return email;
}
public void setemail(string email) {
this.email = email;
}
public string getmobile() {
return mobile;
}
public void setmobile(string mobile) {
this.mobile = mobile;
}
public string getusername() {
return username;
}
public void setusername(string username) {
this.username = username;
}
public string getrole() {
return role;
}
public void setrole(string role) {
this.role = role;
}
}
dao文件：iuserdao
package com.xjt.dao;
import com.xjt.model.user;
public interface iuserdao {
user selectuser(long id);
}
mapper文件：userdao.xml
位于resources - mapper文件夹下
<?xml version="1.0" encoding="utf-8"?>
<!doctype mapper public "-//mybatis.org//dtd mapper 3.0//en" "http://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!-- 设置为iuserdao接口方法提供sql语句配置 -->
<mapper namespace="com.xjt.dao.iuserdao">
<select id="selectuser" resulttype="user" parametertype="long">
select * from user where id = #{id}
</select>
</mapper>
service接口：iuserservice
package com.xjt.service;
import com.xjt.model.user;
public interface iuserservice {
public user selectuser(long userid);
}
userserviceimpl
package com.xjt.service.impl;
import com.xjt.dao.iuserdao;
import com.xjt.model.user;
import com.xjt.service.iuserservice;
import org.springframework.stereotype.service;
import javax.annotation.resource;
@service("userservice")
public class userserviceimpl implements iuserservice {
@resource
private iuserdao userdao;
public user selectuser(long userid) {
return userdao.selectuser(userid);
}
}
controller文件：usercontroller
package com.xjt.controller;
import com.xjt.model.user;
import com.xjt.service.iuserservice;
import org.springframework.beans.factory.annotation.autowired;
import org.springframework.stereotype.controller;
import org.springframework.web.bind.annotation.requestmapping;
import org.springframework.web.servlet.modelandview;
@controller
@requestmapping("/user")
public class usercontroller {
@autowired
private iuserservice userservice;
@requestmapping("/select")
public modelandview selectuser() throws exception {
modelandview mv = new modelandview();
user user = userservice.selectuser(1);
mv.addobject("user", user);
mv.setviewname("user");
return mv;
}
}
usercontroller定义了一个方法selectuser，读取id为1的user信息，并返回user.jsp页面，访问的路径是/user/select，user.jsp位于 web-inf 的 jsp 文件夹下，代码如下：
<%@ page contenttype="text/html;charset=utf-8" language="java" %>
<html>
<head>
<title>user</title>
</head>
<body>
id:${requestscope.user.id}<br/>
email:${requestscope.user.email}<br/>
username:${requestscope.user.username}<br/>
role:${requestscope.user.role}<br/>
mobile:${requestscope.user.mobile}<br/>
</body>
</html>
都编写完毕以后，撤销applicationcontext.xml文件的注释符号，然后开启项目，成功后在浏览器输入
页面成功的返回了user信息，说明，我们成功访问到了数据库的内容。
至此，ssm项目的搭建大功告成，为了方便大家学习，我把源码放在了github上了，有需要的同学可以自行下载，地址：https://github.com/taoxj/mvcdemo
如对本文有疑问， 点击进行留言回复！！
网友评论