Maven+SSM框架整合

2019独角兽企业重金招聘Python工程师标准>>>

更新时间：2017.9.14

三个月前写的，当时还是大三，现在在公司实习快两个月了，也学到了很多。公司的项目，首先不会是maven单模块的；另外开发工具一般也会使用idea，eclipse相对开发效率要低得多。

所以写了一个idea+maven多模块+SSM的demo，放在码云上，链接如下，需着可阅。

https://gitee.com/AmosWang/ssm

一、把话Maven+SSM

        闲谈，自己的理解。也看了很多搭建Maven + SSM的网页，pom.xml中引入了很多东西，也不太清楚是干嘛的，还是自己一点一点来，从错误中总能学习更多。

1.1 Maven

    学之前感觉很高大上，又是指令，又是库的，现在虽然理解不是太深，大致知道点，就是通过一个pom.xml引入项目需要的jar包，如果该jar包有依赖的话，maven也会将其引进去【官方说是依赖传递】。

1.2 SSM

    也就是Spring、Spring MVC、MyBatis：

• Spring：理解两个重要概念：
  • IOC（控制反转）：创建对象的过程被反转了，把之前new对象的操作，转化为从配置中装配，或者从注解中装配；
  • AOP（面向切面编程）：是一种运行时，动态将代码切入到类中的指定方法、指定位置上的编程。摘自右边文章：https://www.zhihu.com/question/24863332
• Spring MVC：轻量级 Web 框架；
• MyBatis：Java 持久层框架。

二、开发环境及准备

2.1 深度新版本控

• Eclipse 版本：Neon.3 Release (4.6.3)
• MySQL 版本：mysql-5.7.18-winx64
  • 安装新版本MySQL见我的另一篇博客
    • https://my.oschina.net/AmosWang/blog/918273
• 如果你用的IDEA，开发中可能会遇到点问题
  • IDEA 设置 classpath
    • https://my.oschina.net/AmosWang/blog/1341357

2.2 数据库创建表

DROP TABLE IF EXISTS `product`;
CREATE TABLE `product` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `name` varchar(255) DEFAULT NULL,
  `description` varchar(255) DEFAULT NULL,
  `price` varchar(10) DEFAULT NULL,
  PRIMARY KEY (`id`)
) ENGINE=InnoDB AUTO_INCREMENT=26 DEFAULT CHARSET=utf8;

三、正式开始一步一步创建

3.1 创建Maven web项目

        

3.2 创建没有的文件夹

        用Eclipse创建之后，会发现src/main下边没有java目录，在Eclipse中是直接创建不了的，
        我们打开文件夹创建它。

3.3 配置pom.xml

3.3.1 新建的maven项目是报错的，加入以下依赖即可                

<dependency>
    <groupId>javax.servlet</groupId>
    <artifactId>javax.servlet-api</artifactId>
    <version>3.1.0</version>
    <scope>provided</scope>
</dependency>

3.3.2 Maven默认编译的jdk版本可能是1.6左右，我们将它设置为1.8。注意配置在一对<build>中

<plugins>
    <plugin>
		<groupId>org.apache.maven.plugins</groupId>
		<artifactId>maven-compiler-plugin</artifactId>
		<version>3.6.1</version>
		<configuration>
			<source>1.8</source>
			<target>1.8</target>
		</configuration>
    </plugin>
</plugins>

3.3.3 其他的就不说了，直接上pom.xml

<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/maven-v4_0_0.xsd">
	<modelVersion>4.0.0</modelVersion>
	<groupId>com.amos.ssm</groupId>
	<artifactId>SSM2</artifactId>
	<packaging>war</packaging>
	<version>0.0.1-SNAPSHOT</version>
	<name>SSM2 Maven Webapp</name>
	<url>http://maven.apache.org</url>

	<!-- 版本信息 -->
	<properties>
		<spring.version>4.3.7.RELEASE</spring.version>
		<mysql.version>5.1.38</mysql.version>
		<log4j.version>1.2.17</log4j.version>
	</properties>

	<dependencies>

		<!-- Spring MVC -->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-webmvc</artifactId>
			<version>${spring.version}</version>
		</dependency>

		<!-- 数据库相关 Start -->
		<dependency>
			<groupId>org.springframework</groupId>
			<artifactId>spring-jdbc</artifactId>
			<version>${spring.version}</version>
		</dependency>
		<!-- mysql -->
		<dependency>
			<groupId>mysql</groupId>
			<artifactId>mysql-connector-java</artifactId>
			<version>${mysql.version}</version>
		</dependency>
		<!-- 数据库连接池 -->
		<dependency>
			<groupId>commons-dbcp</groupId>
			<artifactId>commons-dbcp</artifactId>
			<version>1.4</version>
		</dependency>
		<!-- 数据库相关 End -->

		<!-- mybatis-spring -->
		<dependency>
			<groupId>org.mybatis</groupId>
			<artifactId>mybatis-spring</artifactId>
			<version>1.3.0</version>
		</dependency>
		<!-- mybatis核心 -->
		<dependency>
			<groupId>org.mybatis</groupId>
			<artifactId>mybatis</artifactId>
			<version>3.4.1</version>
		</dependency>

		<!-- Base Start -->
		<dependency>
			<groupId>javax.servlet</groupId>
			<artifactId>javax.servlet-api</artifactId>
			<version>3.1.0</version>
			<scope>provided</scope>
		</dependency>
		<dependency>
			<groupId>junit</groupId>
			<artifactId>junit</artifactId>
			<version>3.8.1</version>
			<scope>test</scope>
		</dependency>
		<dependency>
			<groupId>log4j</groupId>
			<artifactId>log4j</artifactId>
			<version>${log4j.version}</version>
		</dependency>
		<!-- Base End -->

	</dependencies>

	<build>
		<finalName>SSM2</finalName>
		<plugins>
			<plugin>
				<groupId>org.apache.maven.plugins</groupId>
				<artifactId>maven-compiler-plugin</artifactId>
				<version>3.6.1</version>
				<configuration>
					<source>1.8</source>
					<target>1.8</target>
				</configuration>
			</plugin>
		</plugins>
		<resources>
			<resource>
				<directory>src/main/java/com/amos/mapping</directory>
				<includes>
					<include>*.xml</include>
				</includes>
				<filtering>true</filtering>
			</resource>
		</resources>
	</build>

</project>

这个时候可能会报错，并且如下Java Resources 目录中的src/main/resources会不见，如下图

解决办法：右键当前项目，然后如下两图

注意：下图勾选的也就是我们通过配置classpath:***-config.xml时的classpath

3.4 创建包以及完整项目目录

         

3.5 创建配置文件

3.5.1 创建jdbc.properties

jdbc.driver=com.mysql.jdbc.Driver
jdbc.url=jdbc:mysql://127.0.0.1:3306/my_ssm?useUnicode=true&characterEncoding=UTF-8
jdbc.username=root
jdbc.password=root
# 初始化物理连接数
jdbc.initialSize=0
# 最大连接池数目
jdbc.maxActive=20
# 最大空闲连接
jdbc.maxIdle=20
# 最小空闲连接
jdbc.minIdle=1
# 获取连接最大等待时间
jdbc.maxWait=60000

3.5.2 创建log4j.properties

# Global logging configuration
log4j.rootLogger=DEBUG,iout

# Console output...
log4j.appender.iout=org.apache.log4j.ConsoleAppender
log4j.appender.iout.layout=org.apache.log4j.PatternLayout
log4j.appender.iout.layout.ConversionPattern=%d{HH:mm:ss} %-5p [%F\:%L] -- %m%n
log4j.logger.org.apache=INFO

log4j.rootLogger=DEBUG,iout  中的iout属于自定义的输出类型；

log4j.appender.iout.layout.ConversionPattern=%d{HH:mm:ss} %-5p [%F\:%L] -- %m%n

上一句是我自定义的输出格式，具体什么意思下边已经列出（干货，哈哈）

# [] - 这些符号会原样输出
# %m 输出代码中指定的消息，也就是输出自定义的信息
# %p 输出优先级，即DEBUG,INFO,WARN,ERROR,FATAL 
# %r 输出自应用启动到输出该log信息耗费的毫秒数 
# %c 输出所属的类目,通常就是所在类的全名 
# %t 输出产生该日志事件的线程名 
# %n 输出一个回车换行符，Windows平台为“\r\n”，Unix平台为“\n” 
# %d 输出日志时间点的日期或时间，默认格式为ISO8601，也可以在其后指定格式 
#    如：%d{yyyy年MM月dd日 HH:mm:ss,SSS}，输出类似：2012年01月05日 22:10:28,921 
# %l 输出日志事件的发生位置，包括类目名、发生的线程，以及在代码中的行数 
#    如：Testlog.main(TestLog.java:10) 
# %F 输出日志消息产生时所在的文件名称 
# %L 输出代码中的行号 
# %x 输出和当前线程相关联的NDC(嵌套诊断环境),像java servlets多客户多线程的应用中 
# %% 输出一个"%"字符 
# 
# 可以在%与模式字符之间加上修饰符来控制其最小宽度、最大宽度、和文本的对齐方式。如： 
#  %5p: 输出category名称，最小宽度是5，category<5，默认的情况下右对齐,左边会有空格
#  %-5p:输出category名称，最小宽度是5，category<5，"-"号指定左对齐,右边会有空格 
#  %.5p:输出category名称，最大宽度是5，category>5，就会将左边多出的字符截掉，<5不会有空格 
#  %20.30p:category名称<20补空格，并且右对齐，>30字符，就从左边交远销出的字符截掉 

3.5.3 创建mybatis-config.xml

<?xml version="1.0" encoding="UTF-8" ?>
<!DOCTYPE configuration PUBLIC "-//mybatis.org//DTD Config 3.0//EN"
  "http://mybatis.org/dtd/mybatis-3-config.dtd">
<configuration>
	<!-- 定义别名 -->
	<typeAliases>
		<typeAlias alias="product" type="com.amos.entity.Product" />
	</typeAliases>
</configuration>

上边这个一般SSM教程的配置文件中是没有的，它呢，也就多了一个功能，定义了个别名。

在ProductMapper.xml中用到了，简单示例如下：

	<insert id="addOne" parameterType="product">
		INSERT INTO PRODUCT
		(NAME,DESCRIPTION,PRICE)
		VALUES(#{name},#{description},#{price})
	</insert>

	<select id="getProductAll" parameterType="product"
		resultMap="ProductResult">
		SELECT ID,NAME,DESCRIPTION,PRICE FROM PRODUCT
	</select>

其中的parameterType="product"的值，本来应该是com.amos.entity.Product，

有了上边那个文件，你懂得。<typeAlias alias="product" type="com.amos.entity.Product" />

3.5.4 创建spring-mvc.xml

<?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:p="http://www.springframework.org/schema/p"
	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/mvc
		http://www.springframework.org/schema/mvc/spring-mvc.xsd 
		http://www.springframework.org/schema/context
		http://www.springframework.org/schema/context/spring-context-4.3.xsd">

	<!-- 本行将使Controller注解有效 -->
	<mvc:annotation-driven />

	<!-- 自动扫描com.amos.controller文件夹 -->
	<context:component-scan base-package="com.amos.controller" />

	<!-- 定义跳转的文件的前后缀,视图模式配置 -->
	<bean
		class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<property name="prefix" value="/WEB-INF/jsp/" />
		<property name="suffix" value=".jsp" />
	</bean>

</beans>

<mvc:annotation-driven /> 这句话目的是使用@Controller的注解有效；

最下边的<bean>是为发出的View请求添加前缀和后缀，也就是Spring MVC中打开**.jsp页面。

3.5.5 创建spring-mybatis.xml

<?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:p="http://www.springframework.org/schema/p"
	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.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-4.3.xsd">

	<!-- 自动扫描文件夹根据注解注册为bean,排除Controller注解的-->
	<context:component-scan base-package="com.amos">
		<context:exclude-filter type="annotation"
			expression="org.springframework.stereotype.Controller" />
	</context:component-scan>

	<!-- 添加JDBC数据源,指定一个配置文件 -->
	<context:property-placeholder location="classpath:jdbc.properties" />

	<!-- 这里用到了DBCP,自动管理数据库连接的释放和断开 -->
	<bean id="dataSource" class="org.apache.commons.dbcp.BasicDataSource"
		destroy-method="close">
		<property name="driverClassName" value="${jdbc.driver}" />
		<property name="url" value="${jdbc.url}" />
		<property name="username" value="${jdbc.username}" />
		<property name="password" value="${jdbc.password}" />
		<!-- 初始化物理连接数 -->
		<property name="initialSize" value="${jdbc.initialSize}" />
		<!-- 连接池最大数量 -->
		<property name="maxActive" value="${jdbc.maxActive}" />
		<!-- 连接池最大空闲 -->
		<property name="maxIdle" value="${jdbc.maxIdle}" />
		<!-- 连接池最小空闲 -->
		<property name="minIdle" value="${jdbc.minIdle}" />
		<!-- 获取连接最大等待时间 -->
		<property name="maxWait" value="${jdbc.maxWait}" />
	</bean>

	<!-- spring和MyBatis完美整合,不需要MyBatis的配置映射文件 -->
	<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
		<property name="dataSource" ref="dataSource" />
		<!-- 加载MyBatis的一个小配置文件 -->
		<property name="configLocation"  value="classpath:mybatis-config.xml"/>
		<!-- 自动扫描mapping.xml文件 -->
		<property name="mapperLocations" value="classpath:com/amos/mapping/*.xml" />
	</bean>

	<!-- 根据指定的Mapper接口生成Bean实例 -->
	<!-- <bean id="productDao" class="org.mybatis.spring.mapper.MapperFactoryBean">
		<property name="mapperInterface" value="com.amos.dao.ProductDao" />
		<property name="sqlSessionFactoryBeanName" ref="sqlSessionFactory" />
	</bean> -->
	<bean class="org.mybatis.spring.mapper.MapperScannerConfigurer">
		<property name="basePackage" value="com.amos.dao"/>
        <!-- 注意:下边这句是在有多个sqlSessionFactory时加的, -->
        <!-- 同时,注意它的name和value,后边的不能是ref -->
        <!-- <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory"/> -->
	</bean>

	<!-- 事务管理 -->
	<tx:annotation-driven transaction-manager="txManager" />
	<bean id="txManager"
		class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
		<property name="dataSource" ref="dataSource" />
	</bean>
</beans>

1. 第一部分目的是排除在spring-mvc中自动扫描、装配、用@Controller注解过的的类；
2. 第二部分就是从jdbc.properties配置文件中获得信息，再用DBCP连接池装配信息；
3. 第三部分就是Spring与MyBatis结合，装配mybatis-config.xml以及用到的**mapper.xml；
4. 第四部分是扫描所有的Dao层接口；
5. 最后就是添加事务管理，本项目没用到。

3.6 创建java类以及视图**.jsp（MVC哟）

3.6.1 实体类（实体层Model）

public class Product implements Serializable {

	private static final long serialVersionUID = -8241663194017896974L;

	private int id;
	private String name;
	private String description;
	private String price;

    // 省略getter和setter方法
    // 省略toString方法

}

3.6.2 MyBatis 操作数据库相关的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">

<mapper namespace="com.amos.dao.ProductDao">

	<resultMap type="product" id="ProductResult">
		<id column="ID" jdbcType="INTEGER" property="id" />
		<result column="NAME" jdbcType="VARCHAR" property="name" />
		<result column="DESCRIPTION" jdbcType="VARCHAR" property="description" />
		<result column="PRICE" jdbcType="VARCHAR" property="price" />
	</resultMap>

	<insert id="addOne" parameterType="product">
		INSERT INTO PRODUCT
		(NAME,DESCRIPTION,PRICE)
		VALUES(#{name},#{description},#{price})
	</insert>

	<select id="getProductAll" parameterType="product"
		resultMap="ProductResult">
		SELECT ID,NAME,DESCRIPTION,PRICE FROM PRODUCT
	</select>

	<delete id="deleteOne" parameterType="int">
		DELETE FROM PRODUCT WHERE
		ID=#{_parameter}
	</delete>

</mapper>

3.6.3 Dao层（持久层的一部分）

public interface ProductDao {

	public void addOne(Product product);

	public List<Product> getProductAll();

	public void deleteOne(int id);

}

3.6.4 Service层（业务层）

public interface ProductService {

	public void addOne(Product product);

	public List<Product> getProductAll();

	public void deleteOne(int id);
}

@Service
public class ProductServiceImpl implements ProductService {

	@Resource
	private ProductDao productDao;

	@Override
	public void addOne(Product product) {

		productDao.addOne(product);
	}

	@Override
	public List<Product> getProductAll() {

		return productDao.getProductAll();
	}

	@Override
	public void deleteOne(int id) {

		productDao.deleteOne(id);
	}

}

3.6.5 Controller层（控制层Controller）

@Controller
public class ProductController {

	@Resource
	ProductService service;

	@RequestMapping("hello")
	public void helloWorld(HttpServletRequest request, HttpServletResponse response) {
		try {
			response.getWriter().write("hello world!");
		} catch (IOException e) {
			e.printStackTrace();
		}
	}

	// 1. Product Form
	@RequestMapping(value = "input")
	public String inputProduct() {
		return "ProductForm";
	}

	// 2. Product Save
	@RequestMapping(value = "save")
	public String saveProduct(Product product, Model model) {

		System.out.println(product);

		service.addOne(product);

		model.addAttribute("product", product);

		return "ProductDetails";
	}

	// Product getAll
	@RequestMapping(value = "getAll")
	public void getProductAll(HttpServletRequest request, HttpServletResponse response) {

		response.setContentType("text/html;charset=utf-8");

		List<Product> list = service.getProductAll();
		StringBuilder str = new StringBuilder();

		for (Product product : list) {
			str.append(product + "<br>");
		}

		try {
			response.getWriter().write(str.toString());
		} catch (IOException e) {
			e.printStackTrace();
		}

	}

}

3.6.6 View层（视图层View）

下边这个名字叫ProductForm.jsp

也就是输入页面，发出*.*.*.*/SSM2/input.do能跳转到这里

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>Spring ProductForm</title>
<style>
body {
	text-align: center
}

#div_form {
	margin: 0 auto;
	width: 500px;
	height: 500px;
}

#div_label {
	width: 350px;
	margin-top: 10px;
	text-align: right;
}
</style>
</head>

<body>
	<div id="div_form">
		<form action="save.do" method="post">
			<fieldset>
				<legend>Add a product</legend>
				<div id="div_label">
					<label>Name:</label> <input type="text" id="name" name="name"
						tabindex="1"><br>
				</div>
				<br>
				<div id="div_label">
					<label>Description:</label> <input type="text" id="description"
						name="description" tabindex="2"><br>
				</div>
				<br>
				<div id="div_label">
					<label>Price:</label> <input type="text" id="price" name="price"
						tabindex="3"><br>
				</div>
				<br> <input type="reset" tabindex="4"> <input
					type="submit" tabindex="5" value="Add Product">
			</fieldset>
		</form>
	</div>
</body>
</html>

下边这个名字叫ProductDetails.jsp

也就是详情页，添加成功的话会调转到这里

<%@ page language="java" import="java.util.*" pageEncoding="UTF-8"%>
<!DOCTYPE HTML>
<html>
<head>
<title>Spring ProductForm</title>
<style>
body {
	text-align: center;
}
</style>
</head>
<body>
	<h4>The product has been saved.</h4>
	<h4>Details:${product.id }</h4>
	<p>Product Name: ${product.name }</p>
	<p>Product Description: ${product.description }</p>
	<p>Product Price:${product.price }</p>
</body>
</html>

3.7 差点忘了web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xmlns="http://java.sun.com/xml/ns/javaee"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
	version="3.0">
	<display-name>Archetype Created Web Application</display-name>

	<!-- Spring和MyBatis的配置文件 -->
	<context-param>
		<param-name>contextConfigLocation</param-name>
		<param-value>classpath:spring-mybatis.xml</param-value>
	</context-param>
	<listener>
		<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
	</listener>

	<!-- 编码过滤器 -->
	<filter>
		<filter-name>encodingFilter</filter-name>
		<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
		<async-supported>true</async-supported>
		<init-param>
			<param-name>encoding</param-name>
			<param-value>UTF-8</param-value>
		</init-param>
	</filter>
	<filter-mapping>
		<filter-name>encodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>

	<!-- SpringMVC 入口 -->
	<servlet>
		<servlet-name>SpringMVC</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
		<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>*.do</url-pattern>
	</servlet-mapping>

	<welcome-file-list>
		<welcome-file>/index.jsp</welcome-file>
	</welcome-file-list>
</web-app>

web.xml是web项目的入口 

1. 第一部分：加载配置文件；
2. 第二部分：用编码过滤器的方式解决乱码：
   • 详见另一篇博客https://my.oschina.net/AmosWang/blog/997634
3. 第三部分：Spring MVC的入口，拦截所有*.do的请求；
4. 第四部分：欢迎页面，也可以设置为input页面哦。

四、好了，大工告成，运行一下吧

输入数据页面：http://localhost:8080/SSM2/input.do

获得所有数据页面：http://localhost:8080/SSM2/getAll.do

能看到这里，相信你一定可以搞定的！加油！

有需要联系的，邮箱：1833063210@qq.com

转载于:https://my.oschina.net/AmosWang/blog/1023571