SSM环境搭建
1. 创建 maven 项目
创建 maven 项目,创建简单工程,打 war 包
创建完之后,项目由于缺少 web.xml 配置文件报错。
在 Project Facets 中,取消 Dynamic Web Module 选项,点击 apply,然后重新选中。点击 Further configuration available,配置 content directory。
点确定后,自动生成 web.xml
2. 引入需要的 jar
在 pom.xml 导入相关的 jar, jar 的坐标在 https://mvnrepository.com/ 在找到。
<dependencies>
<!-- spring,springmvc,spring事务控制,aop -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>4.3.7.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>4.3.7.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-aspects</artifactId>
<version>4.3.7.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context-support</artifactId>
<version>4.3.7.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>4.3.7.RELEASE</version>
</dependency>
<!-- spriingmvc -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.5.4</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.5.4</version>
</dependency>
<!-- mybatis和mybatis-spring整合的jar -->
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.4.2</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>1.3.1</version>
</dependency>
<!-- 数据库连接池,数据库驱动 -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>druid</artifactId>
<version>1.1.10</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.41</version>
</dependency>
<!-- jstl,servlet-api,junit -->
<dependency>
<groupId>jstl</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
<!-- json -->
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.35</version>
</dependency>
</dependencies>
3. 配置 web.xml 文件
一下配置几乎是所有ssm都需要的,以后直接复制即可
<!-- spring 容器 -->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:application.xml</param-value>
</context-param>
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<servlet>
<servlet-name>dispatcher</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 如果不配置,默认用 web.xml同级的目录下 {servlet-name}-servlet.xml作为配置文件 -->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:servlet.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>dispatcher</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
<!-- 编码过滤器 -->
<filter>
<filter-name>encodingFilter</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>forceRequestEncoding</param-name>
<param-value>true</param-value>
</init-param>
<init-param>
<param-name>forceResponseEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
4. 创建 servlet.xml 文件,做 springmvc 的相关配置
<?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/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.3.xsd
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd">
<!-- 两个标准配置 -->
<!-- 将 springmvc 不能处理的请求交给 tomcat -->
<mvc:default-servlet-handler/>
<!-- 映射动态请求 -->
<mvc:annotation-driven />
<!-- 扫描包,去除默认的过滤规则,只扫描 @Controller的类 -->
<context:component-scan base-package="com.ws" use-default-filters="false">
<context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
</context:component-scan>
<!-- 配置页面视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<!-- 这里可以指定其他的文件目录 -->
<property name="prefix" value="/WEB-INF/views/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
</beans>
5. 配置 mybatis 数据源
文件结构下图所示
application.xml
这里 application.xml 没有直接写入 mybatis 的配置,只做了包的扫描,properties 的导入和spring其他的文件的导入。
这么做的好处是为了不让spring文件那么臃肿,便于修改,例如数据源的配置文件为 spring-jdbc,如果以后要加入 dubbo 的话,直接在 spring 文件夹下创建一个 spring-dubbo.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:context="http://www.springframework.org/schema/context"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.3.xsd
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.3.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd">
<!-- 扫描包,去除默认的过滤规则,只扫描除 @Controller之外的类,此处和sptingmvc配置不同 -->
<context:component-scan base-package="com.ws" use-default-filters="false">
<context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
</context:component-scan>
<!-- 引用配置文件 -->
<context:property-placeholder location="classpath:properties/*-config.properties"/>
<!-- 导入spring配置文件 -->
<import resource="classpath:spring/spring-*.xml"/>
</beans>
spring-jdbc.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:context="http://www.springframework.org/schema/context"
xmlns:aop="http://www.springframework.org/schema/aop"
xmlns:tx="http://www.springframework.org/schema/tx"
xsi:schemaLocation="http://www.springframework.org/schema/aop http://www.springframework.org/schema/aop/spring-aop-4.3.xsd
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans-3.2.xsd
http://www.springframework.org/schema/tx http://www.springframework.org/schema/tx/spring-tx-4.3.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.3.xsd">
<!-- 扫描包,去除默认的过滤规则,只扫描除 @Controller之外的类,此处和sptingmvc配置不同 -->
<context:component-scan base-package="com.ws"
use-default-filters="false">
<context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller" />
</context:component-scan>
<!-- 引用配置文件 -->
<context:property-placeholder
location="classpath:*.properties" />
<!-- 配置数据源 -->
<bean id="dataSource"
class="com.alibaba.druid.pool.DruidDataSource">
<property name="url" value="${jdbc.url}"></property>
<property name="driverClassName" value="${jdbc.driverClass}"></property>
<property name="username" value="${jdbc.username}"></property>
<property name="password" value="${jdbc.password}"></property>
<!-- 初始化连接大小 -->
<property name="initialSize" value="${initialSize}"></property>
<!-- 连接池最大数量 -->
<property name="maxActive" value="${maxActive}"></property>
<!-- 连接池最大空闲 -->
<property name="maxIdle" value="${maxIdle}"></property>
<!-- 连接池最小空闲 -->
<property name="minIdle" value="${minIdle}"></property>
<!-- 获取连接最大等待时间 -->
<property name="maxWait" value="${maxWait}"></property>
</bean>
<!-- 配置 spring,mybatis整合 -->
<bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean">
<property name="dataSource" ref="dataSource"></property>
<!-- 指定 mapper,mybatis文件路径 -->
<property name="mapperLocations" value="classpath:mybatis/mappings/*.xml"></property>
<property name="configLocation" value="classpath:/mybatis/mybatis-config.xml"></property>
</bean>
<!-- 扫描basePackage下所有以@MyBatisDao注解的接口 -->
<bean id="appMapperScannerConfigurer" class="org.mybatis.spring.mapper.MapperScannerConfigurer">
<property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" />
<property name="basePackage" value="com.ws" />
<property name="annotationClass" value="com.ws.annotation.MyBatisDao" />
</bean>
<!-- 定义事务 -->
<bean id="appTransactionManager" class="org.springframework.jdbc.datasource.DataSourceTransactionManager">
<property name="dataSource" ref="dataSource" />
</bean>
<!-- 配置 Annotation 驱动,扫描@Transactional注解的类定义事务 -->
<tx:annotation-driven transaction-manager="appTransactionManager" proxy-target-class="true" />
</beans>
db-config.properties
jdbc.url=jdbc:mysql://127.0.0.1:3306/ams
jdbc.driverClass=com.mysql.jdbc.Driver
jdbc.username=root
jdbc.password=123456
#定义初始连接数
initialSize=0
#定义最大连接数
maxActive=20
#定义最大空闲
maxIdle=20
#定义最小空闲
minIdle=1
#定义最长等待时间
maxWait=60000
创建一个 MyBatisDao 的注解
这个注解是为mybatis加载时候只加载 @MyBatisDao 这个注解的接口。(这个配置:<property name="annotationClass" value="com.ws.annotation.MyBatisDao" />)
import org.springframework.stereotype.Repository;
@MyBatisDao
public @interface MyBatisDao {
}
6. 测试 mybatis 配置
AccountEntity.java
private Integer id;
/**
* 用户名
*/
private String username;
/**
* 密码
*/
private String password;
/**
* 姓名
*/
private String name;
/**
* 电话号码
*/
private String phone;
/**
* 盐
*/
private String salt;
/**
* 状态
*/
private String status;
/**
* 创建人
*/
private String createdBy;
/**
* 创建时间
*/
private Date createdDate;
/**
* 创建人
*/
private String updatedBy;
/**
* 创建时间
*/
private Date updatedDate;
// 省略 setter 和 getter
AccountEntityMapper.java
@MyBatisDao
public interface AccountEntityMapper {
int deleteByPrimaryKey(Integer id);
int insert(AccountEntity record);
int insertSelective(AccountEntity record);
AccountEntity selectByPrimaryKey(Integer id);
int updateByPrimaryKeySelective(AccountEntity record);
int updateByPrimaryKey(AccountEntity record);
List<AccountEntity> selectAll();
}
@RunWith(SpringJUnit4ClassRunner.class)
@ContextConfiguration(locations={"classpath:application.xml"})
public class AccountMapperTest {
@Autowired
private AccountEntityMapper accountEntityMapper;
@Test
public void testAccountSelectAll() {
List<AccountEntity> accountList = accountEntityMapper.selectAll();
System.out.println(JSON.toJSONString(accountList));
}
}
7. 测试 springmvc
这里偷懒,直接省略了 service
AccountController.java
@RestController
@RequestMapping("/account")
public class AccountController {
@Resource
private AccountEntityMapper accountEntityMapper;
@RequestMapping("/list")
public List<AccountEntity> list() {
List<AccountEntity> accountList = accountEntityMapper.selectAll();
return accountList;
}
}
另外,这个有一个深坑的问题,在搭建过程中花费了不少时间,由于是在 eclipse 搭建的,eclipse 有自带 jre8,默认的情况下使用 jre8 会报错。换成自己安装的 jdk8 就好了。
java.util.concurrent.ExecutionException: org.apache.catalina.LifecycleException: Failed to start component [StandardEngine[Catalina].StandardHost[localhost].StandardContext[/ssm-crud]]