作者:jiangzz
电话:15652034180
微信:jiangzz_wx
微信公众账号:jiangzz_wy
写久了Spring Boot快速构建,虽然能加速web开发进度,但是给人的感觉Spring Boot就是一个黑盒子,如果想搞明白Spring Boot的原理,每当用户集成一个框架的时候大家必须认真的看一下Spring Boot自动配置的源代码,否则项目不出错还好,一旦出错悲催了,Spring Boot就像是双刃剑有利有弊,个人建议在不熟练掌握Spring IOC/DI 、AOP常规注解和Servlet-3.0规范不建议使用Spring Boot,因为如果这些注解大家都不熟悉,使用Spring Boot 个人觉得是对自己的侮辱,因为在你不明白这些原理之前,就贸然的使用,个人觉得你学到的仅仅是皮毛,很难深入下去。
可参考:《SpringMVC整合MyBatis 基础版本》 查看传统整合.
Maven依赖
<!--AOP aspectjweaver 支持-->
<dependency>
<groupId>org.aspectj</groupId>
<artifactId>aspectjweaver</artifactId>
<version>1.9.4</version>
</dependency>
<!-- webmvc配置-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.1.7.RELEASE</version>
</dependency>
<!--访问RDBMS-MySQL依赖-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-jdbc</artifactId>
<version>5.1.7.RELEASE</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis</artifactId>
<version>3.5.1</version>
</dependency>
<dependency>
<groupId>org.mybatis</groupId>
<artifactId>mybatis-spring</artifactId>
<version>2.0.1</version>
</dependency>
<dependency>
<groupId>mysql</groupId>
<artifactId>mysql-connector-java</artifactId>
<version>5.1.47</version>
</dependency>
<!--Rest Support支持-->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.9.9</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.dataformat</groupId>
<artifactId>jackson-dataformat-xml</artifactId>
<version>2.9.9</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.module</groupId>
<artifactId>jackson-module-parameter-names</artifactId>
<version>2.9.9</version>
</dependency>
<!--文件上传-->
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.4</version>
</dependency>
<!--日志支持-->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>1.7.26</version>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-log4j12</artifactId>
<version>1.7.26</version>
</dependency>
<dependency>
<groupId>log4j</groupId>
<artifactId>log4j</artifactId>
<version>1.2.17</version>
</dependency>
<!-- 编译依赖 -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>javax.servlet-api</artifactId>
<version>3.0.1</version>
<scope>provided</scope>
</dependency>
<dependency>
<groupId>jstl</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
<!--junit测试-->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-test</artifactId>
<version>5.1.7.RELEASE</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>junit</groupId>
<artifactId>junit</artifactId>
<version>4.12</version>
<scope>test</scope>
</dependency>
配置web入口类,等价在web.xml配置
- 方案1
package com.jiangzz;
import com.jiangzz.service.IUserService;
import org.springframework.beans.BeansException;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.web.WebApplicationInitializer;
import org.springframework.web.context.support.AnnotationConfigWebApplicationContext;
import org.springframework.web.filter.CharacterEncodingFilter;
import org.springframework.web.servlet.DispatcherServlet;
import javax.servlet.*;
import java.util.EnumSet;
public class WebMVCWebApplicationInitializer implements WebApplicationInitializer {
public void onStartup(ServletContext servletContext) throws ServletException {
AnnotationConfigWebApplicationContext ctx = new AnnotationConfigWebApplicationContext();
//设置Spring的父类Bean factory
AnnotationConfigApplicationContext parent=new AnnotationConfigApplicationContext();
parent.register(BeanFactoryConfig.class);
parent.refresh();
//注册mvc配置文件
ctx.register(WebMvcConfig.class);
ctx.setParent(parent);
ctx.setServletContext(servletContext);
ctx.refresh();
ServletRegistration.Dynamic servlet = servletContext.addServlet("mvc", new DispatcherServlet(ctx));
servlet.addMapping("/");
servlet.setLoadOnStartup(1);
CharacterEncodingFilter encode = new CharacterEncodingFilter();
encode.setEncoding("utf-8");
FilterRegistration.Dynamic filter = servletContext.addFilter("encode", encode);
filter.addMappingForUrlPatterns(EnumSet.of(DispatcherType.FORWARD,DispatcherType.REQUEST),false,"/*");
}
}
- 方案2
package com.jiangzz;
import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;
public class MvcAnnotationConfigDispatcherServletInitializer extends AbstractAnnotationConfigDispatcherServletInitializer {
@Override
protected Class<?>[] getRootConfigClasses() {
return new Class[]{BeanFactoryConfig.class};
}
@Override
protected Class<?>[] getServletConfigClasses() {
return new Class[]{WebMvcConfig.class};
}
@Override
protected String[] getServletMappings() {
return new String[]{"/"};
}
//给DispatcherServlet添加filter
@Override
protected Filter[] getServletFilters() {
CharacterEncodingFilter encodingFilter = new CharacterEncodingFilter();
encodingFilter.setEncoding("utf-8");
return new Filter[]{encodingFilter};
}
}
- 方案3
package com.jiangzz;
import org.springframework.context.annotation.AnnotationConfigApplicationContext;
import org.springframework.web.context.WebApplicationContext;
import org.springframework.web.context.support.AnnotationConfigWebApplicationContext;
import org.springframework.web.filter.CharacterEncodingFilter;
import org.springframework.web.servlet.support.AbstractDispatcherServletInitializer;
import javax.servlet.Filter;
public class MvcDispatcherServletInitializer extends AbstractDispatcherServletInitializer {
@Override
protected WebApplicationContext createServletApplicationContext() {
AnnotationConfigWebApplicationContext ctx = new AnnotationConfigWebApplicationContext();
ctx.register(WebMvcConfig.class);
return ctx;
}
@Override
protected String[] getServletMappings() {
return new String[]{"/"};
}
@Override
protected WebApplicationContext createRootApplicationContext() {
AnnotationConfigWebApplicationContext ctx = new AnnotationConfigWebApplicationContext();
ctx.register(BeanFactoryConfig.class);
return ctx;
}
@Override
protected Filter[] getServletFilters() {
CharacterEncodingFilter encodingFilter = new CharacterEncodingFilter();
encodingFilter.setEncoding("utf-8");
return new Filter[]{encodingFilter};
}
}
配置 WebMvcConfig等价mvc-servlet.xml配置文件
package com.jiangzz;
import com.fasterxml.jackson.databind.util.Converter;
import com.fasterxml.jackson.module.paramnames.ParameterNamesModule;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.ComponentScans;
import org.springframework.context.annotation.Configuration;
import org.springframework.format.FormatterRegistry;
import org.springframework.format.datetime.DateFormatter;
import org.springframework.http.converter.HttpMessageConverter;
import org.springframework.http.converter.json.Jackson2ObjectMapperBuilder;
import org.springframework.http.converter.json.MappingJackson2HttpMessageConverter;
import org.springframework.http.converter.xml.MappingJackson2XmlHttpMessageConverter;
import org.springframework.web.servlet.config.annotation.*;
import org.springframework.web.servlet.view.json.MappingJackson2JsonView;
import java.text.SimpleDateFormat;
import java.util.Date;
import java.util.List;
@Configuration
@EnableWebMvc
@ComponentScans(
value = {
@ComponentScan("com.jiangzz.controller")
}
)
public class WebMvcConfig implements WebMvcConfigurer {
//构建视图解析器
@Override
public void configureViewResolvers(ViewResolverRegistry registry) {
registry.enableContentNegotiation(new MappingJackson2JsonView());
registry.jsp()
.prefix("/WEB-INF/")
.suffix(".jsp");
}
//日期输出格式化
@Override
public void configureMessageConverters(List<HttpMessageConverter<?>> converters) {
Jackson2ObjectMapperBuilder builder = new Jackson2ObjectMapperBuilder()
.indentOutput(true)
.dateFormat(new SimpleDateFormat("yyyy-MM-dd HH:mm:ss"))
.modulesToInstall(new ParameterNamesModule());
converters.add(new MappingJackson2HttpMessageConverter(builder.build()));
converters.add(new MappingJackson2XmlHttpMessageConverter(builder.createXmlMapper(true).build()));
}
//解决静态资源加载问题
@Override
public void addResourceHandlers(ResourceHandlerRegistry registry) {
registry.addResourceHandler("/static/**")
.addResourceLocations("/static/")
.setCachePeriod(3000);
}
//接收格式控制
@Override
public void addFormatters(FormatterRegistry registry) {
registry.addFormatter(new DateFormatter("yyyy-MM-dd HH:mm:ss"));
}
}
注意:
不推荐使用WebMvcConfigurationSupport
配置MVC 因为这个类对日期接收兼容不是特别好。
配置BeanFactoryConfig等价applicationContex.xml
package com.jiangzz;
import org.apache.ibatis.datasource.unpooled.UnpooledDataSource;
import org.apache.ibatis.session.SqlSessionFactory;
import org.apache.ibatis.session.SqlSessionFactoryBuilder;
import org.mybatis.spring.SqlSessionFactoryBean;
import org.mybatis.spring.annotation.MapperScan;
import org.mybatis.spring.annotation.MapperScans;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.ComponentScans;
import org.springframework.context.annotation.Configuration;
import org.springframework.core.io.Resource;
import org.springframework.core.io.support.PathMatchingResourcePatternResolver;
import org.springframework.jdbc.datasource.DataSourceTransactionManager;
import org.springframework.transaction.PlatformTransactionManager;
import org.springframework.transaction.annotation.EnableTransactionManagement;
import javax.sql.DataSource;
import java.io.IOException;
@Configuration
@ComponentScans(
value = {
@ComponentScan("com.jiangzz.service")
}
)
@MapperScans(
value = {
@MapperScan("com.jiangzz.dao")
}
)
@EnableTransactionManagement
public class BeanFactoryConfig {
@Bean
public DataSource dataSource(){
UnpooledDataSource dataSource = new UnpooledDataSource();
dataSource.setDriver("com.mysql.jdbc.Driver");
dataSource.setUrl("jdbc:mysql://localhost:3306/test");
dataSource.setUsername("root");
dataSource.setPassword("root");
return dataSource;
}
@Bean
public SqlSessionFactoryBean sqlSessionFactoryBean(DataSource dataSource) throws IOException {
SqlSessionFactoryBean sqlSessionFactoryBean = new SqlSessionFactoryBean();
sqlSessionFactoryBean.setDataSource(dataSource);
sqlSessionFactoryBean.setTypeAliasesPackage("com.jiangzz.entities");
// 动态获取SqlMapper
PathMatchingResourcePatternResolver pathResource = new PathMatchingResourcePatternResolver();
sqlSessionFactoryBean.setMapperLocations(pathResource.getResources("classpath*:/mappers/*.xml"));
return sqlSessionFactoryBean;
}
@Bean
public PlatformTransactionManager transactionManager(DataSource dataSource){
DataSourceTransactionManager transactionManager = new DataSourceTransactionManager();
transactionManager.setDataSource(dataSource);
return transactionManager;
}
}
其他bean
- User
public class User implements Serializable {
private Integer id;
private String name;
private Date birthDay;
//...
}
- UserService
@Service
@Transactional(propagation = Propagation.SUPPORTS)
public class UserService implements IUserService {
@Autowired
private IUserDAO userDAO;
@Override
public User queryUserById(Integer id) {
return userDAO.queryUserById(id);
}
@Transactional(propagation = Propagation.REQUIRED)
@Override
public void saveUser(User user) {
userDAO.saveUser(user);
}
}
- IUserDAO
public interface IUserDAO {
public User queryUserById(Integer id);
public void saveUser(User user);
}
- UserDAO.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.jiangzz.dao.IUserDAO">
<select id="queryUserById" resultType="User">
select id,name,birthDay from t_user where id=#{id}
</select>
<insert id="saveUser" parameterType="User" keyProperty="id" useGeneratedKeys="true">
insert into t_user(name,birthDay) values(#{name},#{birthDay})
</insert>
</mapper>
小编寄语
SpringMVC 更多相关配置可以参考 https://docs.spring.io/spring/docs/current/spring-framework-reference/web.html ,如果这篇文章大家不去囫囵吞枣的阅读一遍,大家对于Spring MVC的掌握也仅限于网络上阉割的案例,所以本篇文章只是起到抛砖引玉的效果!