这一次，我连 web.xml 都不要了，纯 Java 搭建 SSM 环境

你的名字 2021-10-15 12:59 145阅读 0赞

点击上方 **牧码小子** ，选择 **置顶或者星标**原创技术干货每日送达！

在 Spring Boot 项目中，正常来说是不存在 XML 配置，这是因为 Spring Boot 不推荐使用 XML ，注意，并非不支持，Spring Boot 推荐开发者使用 Java 配置来搭建框架，Spring Boot 中，大量的自动化配置都是通过 Java 配置来实现的，这一套实现方案，我们也可以自己做，即自己也可以使用纯 Java 来搭建一个 SSM 环境，即在项目中，不存在任何 XML 配置，包括 web.xml 。

环境要求：

•使用纯 Java 来搭建 SSM 环境，要求 Tomcat 的版本必须在 7 以上。

## 快速体验 ##

## 1 创建工程 ##

创建一个普通的 Maven 工程（注意，这里可以不必创建 Web 工程），并添加 SpringMVC 的依赖，同时，这里环境的搭建需要用到 Servlet ，所以我们还需要引入 Servlet 的依赖（一定不能使用低版本的 Servlet），最终的 pom.xml 文件如下：

<dependency>	
        <groupId>org.springframework</groupId>	
        <artifactId>spring-webmvc</artifactId>	
        <version>5.1.6.RELEASE</version>	
    </dependency>	
    <dependency>	
        <groupId>javax.servlet</groupId>	
        <artifactId>javax.servlet-api</artifactId>	
        <version>4.0.1</version>	
        <scope>provided</scope>	
    </dependency>

## 2 添加 Spring 配置 ##

工程创建成功之后，首先添加 Spring 的配置文件，如下：

@Configuration	
    @ComponentScan(basePackages = "org.javaboy", useDefaultFilters = true, excludeFilters = {@ComponentScan.Filter(type = FilterType.ANNOTATION, classes = Controller.class)})	
    public class SpringConfig {	
    }

关于这个配置，我说如下几点：

•@Configuration 注解表示这是一个配置类，在我们这里，这个配置的作用类似于 applicationContext.xml•@ComponentScan 注解表示配置包扫描，里边的属性和 xml 配置中的属性都是一一对应的，useDefaultFilters 表示使用默认的过滤器，然后又除去 Controller 注解，即在 Spring 容器中扫描除了 Controller 之外的其他所有 Bean 。

## 3 添加 SpringMVC 配置 ##

接下来再来创建 springmvc 的配置文件：

@Configuration	
    @ComponentScan(basePackages = "org.javaboy",useDefaultFilters = false,includeFilters = {@ComponentScan.Filter(type = FilterType.ANNOTATION,classes = Controller.class)})	
    public class SpringMVCConfig {	
    }

**注意，如果不需要在 SpringMVC 中添加其他的额外配置，这样就可以了。即 视图解析器、JSON 解析、文件上传......等等，如果都不需要配置的话，这样就可以了。**

## 4 配置 web.xml ##

此时，我们并没有 web.xml 文件，这时，我们可以使用 Java 代码去代替 web.xml 文件，这里会用到 WebApplicationInitializer ，具体定义如下：

public class WebInit implements WebApplicationInitializer {	
        public void onStartup(ServletContext servletContext) throws ServletException {	
            //首先来加载 SpringMVC 的配置文件	
            AnnotationConfigWebApplicationContext ctx = new AnnotationConfigWebApplicationContext();	
            ctx.register(SpringMVCConfig.class);	
            // 添加 DispatcherServlet	
            ServletRegistration.Dynamic springmvc = servletContext.addServlet("springmvc", new DispatcherServlet(ctx));	
            // 给 DispatcherServlet 添加路径映射	
            springmvc.addMapping("/");	
            // 给 DispatcherServlet 添加启动时机	
            springmvc.setLoadOnStartup(1);	
        }	
    }

WebInit 的作用类似于 web.xml，这个类需要实现 WebApplicationInitializer 接口，并实现接口中的方法，当项目启动时，onStartup 方法会被自动执行，我们可以在这个方法中做一些项目初始化操作，例如加载 SpringMVC 容器，添加过滤器，添加 Listener、添加 Servlet 等。

**注意：**

由于我们在 WebInit 中只是添加了 SpringMVC 的配置，这样项目在启动时只会去加载 SpringMVC 容器，而不会去加载 Spring 容器。

如果一定要加载 Spring 容器，需要我们修改 SpringMVC 的配置。

在 SpringMVC 配置的包扫描中也去扫描 @Configuration 注解，进而加载 Spring 容器。

还有一种方案可以解决这个问题，就是直接在项目中舍弃 Spring 配置，直接将所有配置放到 SpringMVC 的配置中来完成，这个在 SSM 整合时是没有问题的。

在实际开发中，较多采用第二种方案，第二种方案，SpringMVC 的配置如下：

@Configuration	
    @ComponentScan(basePackages = "org.javaboy")	
    public class SpringMVCConfig {	
    }

这种方案中，所有的注解都在 SpringMVC 中扫描，采用这种方案的话，则 Spring 的配置文件就可以删除了。

## 5 测试 ##

最后，添加一个 HelloController ，然后启动项目进行测试：

@RestController	
    public class HelloController {	
        @GetMapping("/hello")	
        public String hello() {	
            return "hello";	
        }	
    }

启动项目，访问接口，结果如下：

![640?wx\_fmt=png][640_wx_fmt_png]

## 6 其他配置 ##

### 6.1 静态资源过滤 ###

静态资源过滤在 SpringMVC 的 XML 中的配置如下：

<mvc:resources mapping="/**" location="/"/>

在 Java 配置的 SSM 环境中，如果要配置静态资源过滤，需要让 SpringMVC 的配置继承 WebMvcConfigurationSupport ，进而重写 WebMvcConfigurationSupport 中的方法，如下：

@Configuration	
    @ComponentScan(basePackages = "org.javaboy")	
    public class SpringMVCConfig extends WebMvcConfigurationSupport {	
        @Override	
        protected void addResourceHandlers(ResourceHandlerRegistry registry) {	
            registry.addResourceHandler("/js/**").addResourceLocations("classpath:/");	
        }	
    }

重写 addResourceHandlers 方法，在这个方法中配置静态资源过滤，这里我将静态资源放在 resources 目录下，所以资源位置是 `classpath:/` ，当然，资源也可以放在 webapp 目录下，此时只需要修改配置中的资源位置即可。如果采用 Java 来配置 SSM 环境，一般来说，可以不必使用 webapp 目录，除非要使用 JSP 做页面模板，否则可以忽略 webapp 目录。

### 6.2 视图解析器 ###

在 XML 文件中，通过如下方式配置视图解析器：

如果通过 Java 类，一样也可以实现类似功能。

首先为我们的项目添加 webapp 目录，webapp 目录中添加一个 jsp 目录，jsp 目录中添加 jsp 文件：

![640?wx\_fmt=png][640_wx_fmt_png 1]

然后引入 JSP 的依赖：

<dependency>	
        <groupId>javax.servlet.jsp</groupId>	
        <artifactId>javax.servlet.jsp-api</artifactId>	
        <version>2.3.1</version>	
    </dependency>

然后，在配置类中，继续重写方法：

@Configuration	
    @ComponentScan(basePackages = "org.javaboy")	
    public class SpringMVCConfig extends WebMvcConfigurationSupport {	
        @Override	
        protected void configureViewResolvers(ViewResolverRegistry registry) {	
            registry.jsp("/jsp/", ".jsp");	
        }	
    }

接下来，在 Controller 中添加控制器即可访问 JSP 页面：

@Controller	
    public class HelloController2 {	
        @GetMapping("/hello2")	
        public String hello() {	
            return "hello";	
        }	
    }

### 6.3 路径映射 ###

有的时候，我们的控制器的作用仅仅只是一个跳转，就像上面小节中的控制器，里边没有任何业务逻辑，像这种情况，可以不用定义方法，可以直接通过路径映射来实现页面访问。如果在 `XML` 中配置路径映射，如下：

<mvc:view-controller path="/hello" view-name="hello" status-code="200"/>

这行配置，表示如果用户访问 `/hello` 这个路径，则直接将名为 `hello` 的视图返回给用户，并且响应码为 `200`，这个配置就可以替代 `Controller` 中的方法。

相同的需求，如果在 `Java` 代码中，写法如下：

@Configuration	
    @ComponentScan(basePackages = "org.javaboy")	
    public class SpringMVCConfig extends WebMvcConfigurationSupport {	
        @Override	
        protected void addViewControllers(ViewControllerRegistry registry) {	
            registry.addViewController("/hello3").setViewName("hello");	
        }	
    }

此时，用户访问 `/hello3` 接口，就能看到名为 `hello` 的视图文件。

### 6.4 JSON 配置 ###

SpringMVC 可以接收JSON 参数，也可以返回 JSON 参数，这一切依赖于 HttpMessageConverter。

HttpMessageConverter 可以将一个 JSON 字符串转为 对象，也可以将一个对象转为 JSON 字符串，实际上它的底层还是依赖于具体的 JSON 库。

所有的 JSON 库要在 SpringMVC 中自动返回或者接收 JSON，都必须提供和自己相关的 HttpMessageConverter 。

SpringMVC 中，默认提供了 Jackson 和 gson 的 HttpMessageConverter ，分别是：MappingJackson2HttpMessageConverter 和 GsonHttpMessageConverter 。

正因为如此，我们在 SpringMVC 中，如果要使用 JSON ，对于 jackson 和 gson 我们只需要添加依赖，加完依赖就可以直接使用了。具体的配置是在 AllEncompassingFormHttpMessageConverter 类中完成的。

如果开发者使用了 fastjson，那么默认情况下，SpringMVC 并没有提供 fastjson 的 HttpMessageConverter ，这个需要我们自己提供，如果是在 XML 配置中，fastjson 除了加依赖，还要显式配置 HttpMessageConverter，如下：

<mvc:annotation-driven>	
        <mvc:message-converters>	
            <bean class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter">	
            </bean>	
        </mvc:message-converters>	
    </mvc:annotation-driven>

在 Java 配置的 SSM 中，我们一样也可以添加这样的配置：

@Configuration	
    @ComponentScan(basePackages = "org.javaboy")	
    public class SpringMVCConfig extends WebMvcConfigurationSupport {	
        @Override	
        protected void configureMessageConverters(List<HttpMessageConverter<?>> converters) {	
            FastJsonHttpMessageConverter converter = new FastJsonHttpMessageConverter();	
            converter.setDefaultCharset(Charset.forName("UTF-8"));	
            FastJsonConfig fastJsonConfig = new FastJsonConfig();	
            fastJsonConfig.setCharset(Charset.forName("UTF-8"));	
            converter.setFastJsonConfig(fastJsonConfig);	
            converters.add(converter);	
        }	
    }

然后，就可以在接口中直接返回 JSON 了，此时的 JSON 数据将通过 fastjson 生成。

## 总结 ##

好了，本文通过一个简单的例子向读者展示了使用 Java 来配置 Spring+SpringMVC 环境，事实上，只要这两个配置 OK ，再加入 MyBatis 就是非常容易的事了，本文相关的案例松哥已经上传到 GitHub 上了：https://github.com/lenve/javaboy-code-samples。

关于本文，有问题欢迎留言讨论。

![640?wx\_fmt=gif][640_wx_fmt_gif]

●[没有一条路是容易的，特别是转行计算机这条路][Link 1]

●[Spring Boot + Vue 前后端分离开发，权限管理的一点思路][Spring Boot _ Vue]

●[Spring Boot + Vue 前后端分离开发，前端网络请求封装与配置][Spring Boot _ Vue 1]

●[徒手撸一个 Spring Boot 中的 Starter ，解密自动化配置黑魔法！][Spring Boot _ Starter]

●[整理了八个开源的 Spring Boot 学习资源][Spring Boot]

●[Java 开发中到底该不该用 Lombok？][Java _ Lombok]

●[提高性能，MySQL  读写分离环境搭建(二)][MySQL]

●[提高性能，MySQL  读写分离环境搭建(一)][MySQL 1]

●[一个转行程序员的买房经历][Link 2]

![640?wx\_fmt=png][640_wx_fmt_png 2]

![640?wx\_fmt=png][640_wx_fmt_png 3]你点的每个赞，我都认真当成了喜欢

[640_wx_fmt_png]: /images/20211015/ac8ee5134d1741e998db27abfae96cad.png?wx_fmt=png
[640_wx_fmt_png 1]: /images/20211015/91eddacbab484b1e83127f88f4f7ef67.png?wx_fmt=png
[640_wx_fmt_gif]: /images/20211015/c71944ef1334440b8cd2261cd0db0ca2.png?wx_fmt=gif
[Link 1]: http://mp.weixin.qq.com/s?__biz=MzI1NDY0MTkzNQ==&mid=2247485587&idx=1&sn=d957ad182c91524e4cfa051e59078e15&chksm=e9c35af3deb4d3e5d3dd9eb13bf76761e271a99ac17fbd784a91b6c7ebdde0a37127ac55b304&scene=21#wechat_redirect
[Spring Boot _ Vue]: http://mp.weixin.qq.com/s?__biz=MzI1NDY0MTkzNQ==&mid=2247485574&idx=1&sn=ec2938c77641a15b80fdc031ab1cc70c&chksm=e9c35ae6deb4d3f0a5889f312e7f3ad868d7f7d2f028922732ca1077d826258b0df951be547f&scene=21#wechat_redirect
[Spring Boot _ Vue 1]: http://mp.weixin.qq.com/s?__biz=MzI1NDY0MTkzNQ==&mid=2247485556&idx=1&sn=46383960b4702991e45cb3e78c84568d&chksm=e9c35a14deb4d3021d48b9da756731005936bd144f284e70c355fbd970add45db1ec79620054&scene=21#wechat_redirect
[Spring Boot _ Starter]: http://mp.weixin.qq.com/s?__biz=MzI1NDY0MTkzNQ==&mid=2247485546&idx=1&sn=b06b411b6bab393db625ac0c337caa4b&chksm=e9c35a0adeb4d31c198aa703e43b65137652f002041bc02fadec6ac7a5f23fa1f7a76fc90d9f&scene=21#wechat_redirect
[Spring Boot]: http://mp.weixin.qq.com/s?__biz=MzI1NDY0MTkzNQ==&mid=2247485530&idx=1&sn=e2c5b60f391f8d251b186b9f6e697893&chksm=e9c35a3adeb4d32c528ed5511d3f390611d1d2036af6516982c8c7002f50dfff68b8dd3c20bb&scene=21#wechat_redirect
[Java _ Lombok]: http://mp.weixin.qq.com/s?__biz=MzI1NDY0MTkzNQ==&mid=2247485495&idx=1&sn=fbbc4a893c3ace4321f16d7b1109fff5&chksm=e9c35a57deb4d34196bb851a3abe4a1a0756dc38faf12a3608934d4d153fa30be6d83427d5d6&scene=21#wechat_redirect
[MySQL]: http://mp.weixin.qq.com/s?__biz=MzI1NDY0MTkzNQ==&mid=2247485488&idx=1&sn=b0003c3310542c30da6f1226c8764340&chksm=e9c35a50deb4d346523b5d92a52404d70110e56d2a94e8dab7feaf509dc8d865dd5fe7a378f3&scene=21#wechat_redirect
[MySQL 1]: http://mp.weixin.qq.com/s?__biz=MzI1NDY0MTkzNQ==&mid=2247485457&idx=1&sn=dbb1404798bf24ef82e30215cff54b9a&chksm=e9c35a71deb4d36730e78848ac04842364ff029a4c359155d2466a6c4b1f4d842773d1385834&scene=21#wechat_redirect
[Link 2]: http://mp.weixin.qq.com/s?__biz=MzI1NDY0MTkzNQ==&mid=2247485442&idx=1&sn=c1e7dd45997f5a05d765a7f3f5b576f6&chksm=e9c35a62deb4d374c4a5f899a584b89b0a8a2ec15773dcd0e7e45a3aceea828659f6cb66ed0d&scene=21#wechat_redirect
[640_wx_fmt_png 2]: /images/20211015/b2fd59c501a24874aed596b91b49d124.png?wx_fmt=png
[640_wx_fmt_png 3]: /images/20211015/63048c62a619498ba712c3755aab7bed.png?wx_fmt=png