首先,创建Maven Project,packaging为war,修改pom.xml。
<properties> <!-- JDK版本 --> <java.version>1.8</java.version> </properties> <dependencies> <!-- web project基本配置 --> <dependency> <groupId>javax.servlet</groupId> <artifactId>javax.servlet-api</artifactId> <version>3.0.1</version> <scope>provided</scope> </dependency> <dependency> <groupId>javax.servlet.jsp</groupId> <artifactId>jsp-api</artifactId> <version>2.2</version> <scope>provided</scope> </dependency> <dependency> <groupId>jstl</groupId> <artifactId>jstl</artifactId> <version>1.2</version> </dependency> </dependencies>
然后在src/main/webapp下创建META-INF和WEB-INF文件夹,在WEB-INF目录下创建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" id="WebApp_ID" version="3.0"> </web-app>
注意:web.xml 的加载顺序是:ServletContext -> context-param -> listener -> filter -> servlet ,而同个类型之间的实际程序调用的时候的顺序是根据对应的 mapping 的顺序进行调用的。
一、配置Spring
1. 修改pom.xml
在<properties>下添加:
<!-- spring版本 --> <spring.version>4.1.6.RELEASE</spring.version> <!-- junit版本 --> <junit.version>4.12</junit.version>
在<dependencies>下添加:
<!-- 核心容器 之 spring-core --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-core</artifactId> <version>${spring.version}</version> </dependency> <!-- 核心容器 之 spring-beans --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-beans</artifactId> <version>${spring.version}</version> </dependency> <!-- 核心容器 之 spring-context --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context</artifactId> <version>${spring.version}</version> </dependency> <!-- 核心容器 之 spring-context-support --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-context-support</artifactId> <version>${spring.version}</version> </dependency> <!-- 核心容器 之 spring-expression --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-expression</artifactId> <version>${spring.version}</version> </dependency> <!-- spring test --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-test</artifactId> <version>${spring.version}</version> </dependency> <!-- junit --> <dependency> <groupId>junit</groupId> <artifactId>junit</artifactId> <version>${junit.version}</version> <scope>test</scope> </dependency>
2. 修改web.xml,配置Spring环境
<!-- 配置Spring环境 --> <context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath*:applicationContext.xml</param-value> </context-param> <listener> <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class> </listener>
ContextLoaderListener是Spring的监听器,它的作用就是启动Web容器时,自动装配ApplicationContext的配置信息。因为它实现了ServletContextListener这个接口,在web.xml配置这个监听器,启动容器时,就会默认执行它实现的方法。
<context-param>中的classpath是什么,classpath:和classpath*有何区别:
- classpath是指 WEB-INF文件夹下的classes目录,只会到你的class路径中查找找文件;
- 不仅包含class路径,还包括jar文件中(class路径)进行查找。
当有多个配置文件加载时,可以这样配置:
<context-param> <param-name>contextConfigLocation</param-name> <param-value> classpath*:conf/spring/applicationContext_core*.xml, classpath*:conf/spring/applicationContext_dict*.xml, classpath*:conf/spring/applicationContext_hibernate.xml, ...... </param-value> </context-param>
或者
<context-param> <param-name>contextConfigLocation</param-name> <param-value>classpath*:**/applicationContext-*.xml</param-value> </context-param>
"**/"表示的是任意目录;
"**/applicationContext-*.xml"表示任意目录下的以"applicationContext-"开头的XML文件。
3. 在src/main/resources目录下创建applicationContext.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" 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"> <!-- 扫描包下有相关Spring注解的类 --> <context:component-scan base-package="com.linhw.demo.integrate.service.impl"/> </beans>
4. 单元测试
测试从Spring IoC容器中获取Bean实例。
@Service public class UserServiceImpl { }
在src/test/java目录下创建:
@RunWith(SpringJUnit4ClassRunner.class) @ContextConfiguration(locations = { "classpath:applicationContext.xml" }) //加载配置spring配置文件 public class SpringTest { @Autowired private UserServiceImpl userService; @Test public void testSpring(){ System.out.println(userService); } }
二、整合SpringMVC
1. 修改pom.xml
在<dependencies>下添加:
<!-- 整合Spring MVC--> <!-- spring web --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-web</artifactId> <version>${spring.version}</version> </dependency> <!-- spring web mvc --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-webmvc</artifactId> <version>${spring.version}</version> </dependency>
2. 修改web.xml
<!-- Spring MVC 环境 --> <!-- 配置前端控制器DispatcherServlet --> <servlet> <servlet-name>springmvc</servlet-name> <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class> <init-param> <param-name>contextConfigLocation</param-name> <!-- mvc配置文件的文件名以及目录 --> <param-value>classpath:springmvc.xml</param-value> </init-param> </servlet> <servlet-mapping> <servlet-name>springmvc</servlet-name> <url-pattern>*.do</url-pattern> </servlet-mapping>
3. 在src/main/resources目录下创建springmvc.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: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.xsd"> <!--mvc:annotation-driven 会默认加载一些配置,如映射器和适配器--> <mvc:annotation-driven/> <!--批量配置Handler(即Controller),指定扫描的包全称 --> <context:component-scan base-package="com.linhw.demo.integrate.controller"/> <!--配置视图解析器 --> <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver"> <!-- 返回视图页面的前缀 --> <property name="prefix" value="/WEB-INF/jsp/"></property> <!-- 返回页面的后缀 --> <property name="suffix" value=".jsp"></property> </bean> </beans>
4. 在com.linhw.demo.integrate.controller下开发Handler(即Controller)
@Controller public class UserController { @RequestMapping("/showIndex") public Object showIndex(){ ModelAndView view = new ModelAndView(); view.setViewName("index"); return view; } }
5. 在WEB-INF下创建jsp文件夹,在jsp目录创建index.jsp
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> hello Spring MVC! </body> </html>
6. 浏览器访问:http://ip:port/项目名/showIndex.do
三、整合Mybatis
1. 修改pom.xml
在<properties>下添加:
<!-- mybatis版本 --> <mybatis.version>3.5.2</mybatis.version> <!-- mysql driver 版本 --> <mysql.version>5.1.48</mysql.version> <!-- druid 版本 --> <druid.version>1.1.6</druid.version>
在<dependencies>下添加:
<!-- spring-jdbc --> <dependency> <groupId>org.springframework</groupId> <artifactId>spring-jdbc</artifactId> <version>${spring.version}</version> </dependency> <!-- mybatis-spring --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis-spring</artifactId> <version>2.0.1</version> </dependency> <!-- 整合Mybatis --> <!-- mybatis 核心包 --> <dependency> <groupId>org.mybatis</groupId> <artifactId>mybatis</artifactId> <version>${mybatis.version}</version> </dependency> <!-- asm --> <dependency> <groupId>asm</groupId> <artifactId>asm</artifactId> <version>3.3.1</version> </dependency> <!-- cglib --> <dependency> <groupId>cglib</groupId> <artifactId>cglib</artifactId> <version>3.2.7</version> <exclusions> <exclusion> <groupId>org.ow2.asm</groupId> <artifactId>asm</artifactId> </exclusion> </exclusions> </dependency> <!-- javassist --> <dependency> <groupId>org.javassist</groupId> <artifactId>javassist</artifactId> <version>3.23.1-GA</version> </dependency> <!-- log4j --> <dependency> <groupId>log4j</groupId> <artifactId>log4j</artifactId> <version>1.2.17</version> </dependency> <!-- log4j-api --> <dependency> <groupId>org.apache.logging.log4j</groupId> <artifactId>log4j-api</artifactId> <version>2.11.1</version> </dependency> <!-- slf4j-api --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-api</artifactId> <version>1.7.28</version> </dependency> <!-- slf4j-log4j12 --> <dependency> <groupId>org.slf4j</groupId> <artifactId>slf4j-log4j12</artifactId> <version>1.7.28</version> <scope>test</scope> </dependency> <!-- mysql --> <dependency> <groupId>mysql</groupId> <artifactId>mysql-connector-java</artifactId> <version>${mysql.version}</version> </dependency> <!-- druid dataSource --> <dependency> <groupId>com.alibaba</groupId> <artifactId>druid</artifactId> <version>${druid.version}</version> </dependency>
2. 修改applicationContext.xml
<!-- 引入外部property属性文件 --> <context:property-placeholder location="classpath:jdbc.properties" order="1"/> <!-- druid数据源 --> <bean id="dataSource" class="com.alibaba.druid.pool.DruidDataSource" init-method="init" destroy-method="close"> <property name="name" value="${jdbc.name}" /> <property name="driverClassName" value="${jdbc.driverClassName}" /> <property name="url" value="${jdbc.url}" /> <property name="username" value="${jdbc.username}" /> <property name="password" value="${jdbc.password}" /> <!-- initialSize:初始化时建立物理连接的个数。默认0,初始化发生在显示调用init方法,或者第一次getConnection时 --> <property name="initialSize" value="${jdbc.initialSize}" /> <!-- maxActive:最大连接池数量,默认8 --> <property name="maxActive" value="${jdbc.maxActive}" /> <!-- minIdle:最小连接池数量 ,默认8 --> <property name="minIdle" value="${jdbc.minIdle}" /> <!-- maxWait:获取连接时最大等待时间,单位毫秒。配置了maxWait之后,缺省启用公平锁,并发效率会有所下降,如果需要可以通过配置useUnfairLock属性为true使用非公平锁。 --> <property name="maxWait" value="${jdbc.maxWait}" /> <!-- poolPreparedStatements:是否缓存preparedStatement,也就是PSCache。默认false,PSCache对支持游标的数据库性能提升巨大,比如说oracle。在mysql下建议关闭。 --> <property name="poolPreparedStatements" value="${jdbc.poolPreparedStatements}" /> <!-- maxOpenPreparedStatements:要启用PSCache,必须配置大于0,默认-1。当大于0时,poolPreparedStatements自动触发修改为true。在Druid中,不会存在Oracle下PSCache占用内存过多的问题,可以把这个数值配置大一些,比如说100 --> <property name="maxOpenPreparedStatements" value="${jdbc.maxOpenPreparedStatements}" /> <!-- validationQuery:用来检测连接是否有效的sql,要求是一个查询语句。如果validationQuery为null,testOnBorrow、testOnReturn、testWhileIdle都不会起作用。 --> <property name="validationQuery" value="${jdbc.validationQuery}" /> <!-- testOnBorrow:申请连接时执行validationQuery检测连接是否有效,做了这个配置会降低性能。默认true --> <property name="testOnBorrow" value="${jdbc.testOnBorrow}" /> <!-- testOnReturn:归还连接时执行validationQuery检测连接是否有效,做了这个配置会降低性能。默认false --> <property name="testOnReturn" value="${jdbc.testOnReturn}" /> <!-- testWhileIdle:建议配置为true,不影响性能,并且保证安全性。申请连接的时候检测,如果空闲时间大于timeBetweenEvictionRunsMillis,执行validationQuery检测连接是否有效。 --> <property name="testWhileIdle" value="${jdbc.testWhileIdle}" /> <!-- 配置间隔多久才进行一次检测,检测需要关闭的空闲连接,单位是毫秒 --> <property name="timeBetweenEvictionRunsMillis" value="${jdbc.timeBetweenEvictionRunsMillis}" /> <!-- 配置一个连接在池中最小生存的时间,单位是毫秒 --> <property name="minEvictableIdleTimeMillis" value="${jdbc.minEvictableIdleTimeMillis}" /> <!-- filters:属性类型是字符串,通过别名的方式配置扩展插件,常用的插件有: 监控统计用的filter:stat 日志用的filter:log4j防御sql注入的filter:wall --> <property name="filters" value="${jdbc.filters}" /> <!-- 这里配置提交方式,默认就是TRUE,可以不用配置 --> <property name="defaultAutoCommit" value="${jdbc.defaultAutoCommit}" /> </bean> <!-- 创建SqlSessionFactory,同时指定数据源 --> <bean id="sqlSessionFactory" class="org.mybatis.spring.SqlSessionFactoryBean"> <property name="dataSource" ref="dataSource" /> <!--指定mybatis全局配置文件,若其中订制了environment,在spring容器中不再生效 --> <property name="configLocation" value="classpath:mybatis.xml" /> <!--指定实体类映射文件,可以同时指定某一包以及子包下面的所有配置文件,mapperLocations和configLocation有一个即可,当需要为实体类指定别名时,可指定configLocation属性,再在mybatis总配置文件中采用mapper引入实体类映射文件 --> <property name="mapperLocations" value="classpath*:com/linhw/demo/integrate/dao/*.xml"/> </bean> <!-- 注入mybatis的映射器接口 --> <bean class="org.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.linhw.demo.integrate.dao"/> <!-- 这里注意:value是一个bean name, 而不是一个对象,所以不能配置ref="sqlSessionFactory" --> <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" /> </bean>
mybatis中, sessionFactory可由SqlSessionFactoryBuilder来创建。MyBatis-Spring 中,使用了SqlSessionFactoryBean来替代。SqlSessionFactoryBean有一个必须属性dataSource,另外其还有一个通用属性configLocation(用来指定mybatis的xml配置文件路径)。
MyBatis-Spring 提供了一个动态代理的实现:MapperFactoryBean。这个类 可以让你直接注入数据映射器接口到你的 service 层 bean 中。当使用映射器时,你仅仅如调 用你的 DAO 一样调用它们就可以了,但是你不需要编写任何 DAO 实现的代码,因为 MyBatis-Spring 将会为你创建代理。
MapperScannerConfigurer一般用过的最多也就是这3个属性,实际情况下最常用的只有basePackage。
- basePackage:basePackage可以写多个,可以用英文逗号进行分割。每一个路径都可以用直接的包路径,或者Ant风格的表达式。
- annotationClass:该属性实际上就是起到一个过滤的作用,如果设置了该属性,那么MyBatis的接口只有包含该注解,才会被扫描进去。
- sqlSessionFactoryBeanName:通过该属性来指定哪一个sqlSessionFactory(值为SqlSessionFactoryBean <bean>配置中的id属性,value=#id)。
3. 在src/main/resources下创建jdbc.properties、mybatis.xml
jdbc.properties
# DruidDataSource + mysql jdbc.name=druid-1 jdbc.driverClassName=com.mysql.jdbc.Driver jdbc.url=jdbc:mysql://192.168.178.5:12345/ssm?characterEncoding=UTF-8 jdbc.username=root jdbc.password=123456 jdbc.initialSize=1 jdbc.maxActive=10 jdbc.minIdle=1 jdbc.maxWait=10000 jdbc.poolPreparedStatements=true jdbc.maxOpenPreparedStatements=20 jdbc.validationQuery=select 1 from user jdbc.testOnBorrow=true jdbc.testOnReturn=false jdbc.testWhileIdle=true jdbc.timeBetweenEvictionRunsMillis=60000 jdbc.minEvictableIdleTimeMillis=300000 jdbc.filters=stat jdbc.defaultAutoCommit=true
mybatis.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> </configuration>
4. 创建映射接口和xml映射文件
映射接口
public interface UserMapper { public List<User> selectAll(); }
xml映射文件
<?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.linhw.demo.integrate.dao.UserMapper"> <!-- id对应接口的方法名称 --> <select id="selectAll" resultMap="UserInfo"> select * from user </select> <!-- 数据列与实体属性的映射 --> <resultMap type="com.linhw.demo.integrate.pojo.User" id="UserInfo" > <id column="user_id" property="userId" jdbcType="INTEGER"/> <result column="user_name" property="userName" jdbcType="VARCHAR"/> <result column="age" property="age" jdbcType="INTEGER"/> </resultMap> </mapper>
这里就可以直接在service中使用注解注入映射接口。
使用到的实体类:
public class User { private Integer userId; private String userName; private Integer age; public User() { } public User(Integer userId, String userName, Integer age) { this.userId = userId; this.userName = userName; this.age = age; } public Integer getUserId() { return userId; } public void setUserId(Integer userId) { this.userId = userId; } public String getUserName() { return userName; } public void setUserName(String userName) { this.userName = userName; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } @Override public String toString() { return "User [userId=" + userId + ", userName=" + userName + ", age=" + age + "]"; } }
5. 测试
@Service public class UserServiceImpl { @Autowired private UserMapper userMapper; public List<User> findAllUserList(){ return userMapper.selectAll(); } }
UserController.java
@RequestMapping("/userList") public ModelAndView findAllUser(){ ModelAndView view = new ModelAndView(); List<User> list = userServiceImpl.findAllUserList(); view.addObject("list", list); view.setViewName("index"); return view; }
修改index.jsp:
<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%> <%@ taglib uri="http://java.sun.com/jsp/jstl/core" prefix="c"%> <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=UTF-8"> <title>Insert title here</title> </head> <body> hello Spring MVC! <table> <thead> <tr> <th>Id</th> <th>Name</th> <th>Age</th> </tr> </thead> <tbody> <c:forEach items="${list}" var="user"> <tr> <td>${user.userId }</td> <td>${user.userName }</td> <td>${user.age }</td> </tr> </c:forEach> </tbody> </table> </body> </html>
四、【扩展】通用Mapper
通用Mapper是个辅助mybatis极简单表开发的组件。它不是为了替代mybatis,它可以极大的方便开发人员进行ORM,提供极其方便的单表增删改查。
1. 修改pom.xml
在<properties>下添加:
<!-- 通用Mapper版本 --> <tkmybatis.version>4.1.5</tkmybatis.version>
在<dependencies>下添加:
<!-- 通用Mapper --> <dependency> <groupId>tk.mybatis</groupId> <artifactId>mapper</artifactId> <version>${tkmybatis.version}</version> </dependency>
2. 修改实体对象(使用注解)
@Table(name="user") public class User { @Id @GeneratedValue(strategy = GenerationType.IDENTITY) @Column(name="user_id") private Integer userId; @Column(name="user_name") private String userName; @Column(name="age") private Integer age; public User() { } public User(Integer userId, String userName, Integer age) { this.userId = userId; this.userName = userName; this.age = age; } public Integer getUserId() { return userId; } public void setUserId(Integer userId) { this.userId = userId; } public String getUserName() { return userName; } public void setUserName(String userName) { this.userName = userName; } public Integer getAge() { return age; } public void setAge(Integer age) { this.age = age; } @Override public String toString() { return "User [userId=" + userId + ", userName=" + userName + ", age=" + age + "]"; } }
3. 修改映射接口
/** * 通用Mapper提供的tk.mybatis.mapper.common.Mapper已为我们提供了大多数的功能。 */ public interface UserMapper extends Mapper<User>{ public List<User> selectAll(); }
注:xml映射文件并不是必须的,只有要添加自己的查询方法才需要存在。
4. 修改applicationContext.xml
数据源的配置,只需要将org.mybatis.spring.mapper.MapperScannerConfigurer改成tk.mybatis.spring.mapper.MapperScannerConfigurer,然后加一个属性
,也可不加,因为框架提供了默认实现。
<!-- 注入mybatis的映射器接口 --> <!-- 原生mybatis: org.mybatis.spring.mapper.MapperScannerConfigurer 通用Mapper:tk.mybatis.spring.mapper.MapperScannerConfigurer --> <bean class="tk.mybatis.spring.mapper.MapperScannerConfigurer"> <property name="basePackage" value="com.linhw.demo.integrate.dao"/> <!-- 这里注意:value是一个bean name, 而不是一个对象,所以不能配置ref="sqlSessionFactory" --> <property name="sqlSessionFactoryBeanName" value="sqlSessionFactory" /> <!-- 属性配置,如果是默认的,可以不用写 --> <property name="properties"> <value> mappers=tk.mybatis.mapper.common.Mapper </value> </property> </bean>