三分钟学会用SpringMVC搭建最小系统（超详细）

前言

作 Java Web 开发的你，必定据说过SpringMVC的大名，做为如今运用最普遍的Java框架，它到目前为止依然保持着强大的活力和普遍的用户群。

本文介绍如何用eclipse一步一步搭建SpringMVC的最小系统，所谓最小系统，就是足以使项目在SpringMVC框架下成功跑起来，而且可以作一些简单的事情（好比访问页面）的系统。

话很少说，让咱们开始吧。全部的源代码和jar包都会在最后给出。

正文

1. 新建一个项目

Paste_Image.png

咱们用eclipse新建项目，选择Dynamic Web Project(动态的Web项目)。

点击Next

Paste_Image.png

Project name里面写上 springmvc，这就是咱们项目的名称，其余不用改，直接点击Finish 。

Paste_Image.png

OK，项目就建好了。

接下来必定要将项目的字符集改成UTF-8

右键项目——properties

Paste_Image.png

改成UTF-8，点击OK。

2. 编写 web.xml

当咱们打开WebContent/WEB-INF目录的时候，发现里面只有一个lib目录，这是存放各类jar包的地方。咱们知道一个web项目必需要有一个web.xml文件才行。

既然没有，咱们本身写一个咯。

右键WEB-INF——new——file，新建一个web.xml文件。

点击Finish

将如下内容填进去便可。

springmvc

这样就完成了基本的配置，个人意思是说，如今这个项目就已是一个标准的web项目了。

3. 验证web项目是否搭建成功

为了验证到目前为止的正确性，咱们在WebContent目录下面新建一个jsp文件。

名字就叫index.jsp

Paste_Image.png

内容以下：

<%@ page language="java"contentType="text/html; charset=UTF-8"pageEncoding="UTF-8"%>恭喜，web項目已經成功搭建！

咱们如今就将这个项目部署到Tomcat,来验证是否能够跑起来。

在项目上右键——Debug As——Debug on Server

直接点击Finish

通过一段时间，控制台开始打印日志信息，当咱们看到这些信息的时候，说明Tomcat已经启动完毕了。

Paste_Image.png

让咱们打开浏览器，在地址栏输入如下信息

http://localhost:8088/springmvc/index.jsp

我电脑上Tomcat配置的端口号是8088，具体状况视你本身的Tomcat决定，多是8080等。

Paste_Image.png

可见，可以成功访问页面了，这说明咱们到目前为止的操做是正确的。

3. 集成SpringMVC

咱们在web.xml文件里面添加下面的配置

3.1 配置监听器

org.springframework.web.context.ContextLoaderListenerorg.springframework.web.util.IntrospectorCleanupListener

3.2 配置过滤器，解决POST乱码问题

encodingorg.springframework.web.filter.CharacterEncodingFilterencodingUTF-8encoding/*

3.3 配置SpringMVC分发器，拦截全部请求

springmvcorg.springframework.web.servlet.DispatcherServletnamespacedispatcher-servletspringmvc/

在这个配置中，咱们规定了DispatcherServlet的关联 XML 文件名称叫作dispatcher-servlet。

注意，这里的路径是相对于web.xml来讲的，也就是说，这个文件也在WEB-INF的根目录下。

因此，咱们须要在WEB-INF的根目录下新建一个dispatcher-servlet.xml文件。

Paste_Image.png

至此，web.xml文件的编写就告一段落了。

3.4 编写dispatcher-servlet.xml

dispatcher-servlet.xml 的做用就是配置SpringMVC分发器。

配置以下：

根据配置，有三个须要注意的地方。

它会扫描 com.springmvc 包下全部的Java类，但凡是遇到有注解的，好比@Controller，@Service， @Autowired ，就会将它们加入到Spring的bean工厂里面去。

全部的静态资源文件，好比说 js ， css ， images 都须要放在/resources目录下，这个目录如今咱们尚未建。

全部的展现页面，好比jsp文件，都须要放置在/WEB-INF/pages目录下，这个目录如今咱们也没有建。

OK，咱们把对应的目录加上。

首先是Java文件的目录。

Paste_Image.png

咱们在这个地方右键，新建一个 com 包,再在里面建一个 springmvc 包，或者用 . 的方式一块儿建。

Paste_Image.png

点击Finish

Paste_Image.png

根据SpringMVC的分层，咱们在springmvc 包下面建三个包，分别是controller ， service ， dao

Paste_Image.png

这样的话， 当咱们项目一旦启动，springmvc就会扫描这三个包，将里面但凡有注解的类都提取起来，放进Spring容器（或者说Spring的bean工厂），借由Spring容器来统一管理。这也就是你历来没有去new一个Controller的缘由。

接下来，咱们来建静态资源的目录。

在WebContent目录下新建一个resources文件夹。

而后顺便把js，css，img的文件夹都建一下，这里就存放咱们的静态资源文件。

Paste_Image.png

最后，咱们在WEB-INF目录下建一个pages文件夹，做为展现页面的存放目录。

Paste_Image.png

将以前的index.jsp拷贝进来。

Paste_Image.png

这样就配置的差很少了。

5. 导包和验证

咱们将jar包放到lib目录：

Paste_Image.png

而后启动项目，验证一下到目前为止的构建是否正确。

打开Servers视图，点击如图像是甲虫同样的图标。

Paste_Image.png

发现报错了，错误信息以下：

Paste_Image.png

错误：

Could not open ServletContext resource [/WEB-INF/applicationContext.xml]

它说咱们在WEB-INF下面少了一个applicationContext.xml 这个文件，原来，咱们少了对SpringBean工厂的配置，它的意思就是说，咱们要规定一下，在Spring容器启动的时候，须要自动加载哪些东西？

因而，咱们把 applicationContext.xml 加上。

Paste_Image.png

里面咱们啥也不配置，再次启动Tomcat。

Paste_Image.png

这回不报错了。

5. 配置ViewController

咱们知道，WEB-INF目录下的任何资源都是没法直接经过浏览器的url地址去访问的，保证了安全性。这也是咱们为何把页面都放在该目录下的缘由。

为了有所区分，咱们还单独创建了一个pages文件夹，将这些页面保存起来。

Paste_Image.png

如今，为了访问这个页面，咱们须要用到SpringMVC的页面跳起色制。

咱们在Controller包下新建一个ViewController

Paste_Image.png

点击Finish

Paste_Image.png

ViewController 代码：

packagecom.springmvc.controller;importjavax.servlet.http.HttpServletRequest;importorg.springframework.stereotype.Controller;importorg.springframework.web.bind.annotation.RequestMapping;importorg.springframework.web.servlet.ModelAndView;@ControllerpublicclassViewController{@RequestMapping("/view")publicModelAndView view(HttpServletRequest request){        String path = request.getParameter("path") +"";        ModelAndView mav = new ModelAndView();        mav.setViewName(path);returnmav;    }}

我只须要将想要访问的页面放在path里面，经过url传进来就好了。

由于添加了java类，所以咱们从新启动Tomcat。

启动完成后，在地址栏输入：

http://localhost:8088/springmvc/view?path=index

结果：

Paste_Image.png

不要紧，咱们看他报什么错。

message/springmvc/WEB-INF/pagesindex.jsp

pagesindex.jsp是什么鬼？？

原来，在dispatcher-servlet.xml中，咱们少写了一个 "/"

Paste_Image.png

添上去就好了。

Paste_Image.png

保存后，由于修改了XML配置文件，所以咱们仍是须要从新启动Tomcat。

启动完成后，继续！

Paste_Image.png

成功了。

6. 引入静态资源

好比，我在resources/img目录下放了一张图片，怎么引入到index.jsp呢？

Paste_Image.png

background: url(http://localhost:8088/springmvc/resources/img/bg.jpg);background-size:100%100%;

的确，这是一种方式。但是，它有一个缺点就是根路径写死了，咱们确定不但愿这样的。

其实，咱们能够在viewController里面拿到项目根路径，而后传递到jsp页面就OK了。

Paste_Image.png

咱们把调试信息 “恭喜，web項目已經成功搭建！” 删掉。

<%@ page language="java"contentType="text/html; charset=UTF-8"pageEncoding="UTF-8"%>body{background:url(${contextPath}/resources/img/bg.jpg);background-size:100%100%;

}

${contextPath} 能够取到Controller传过来的contextPath值。

 

-----------------------------------------------------------------------------------

完整的项目源码   欢迎你们一块儿学习研究相关技术，源码获取请加求求:2670716182