学习SpringMVC——从HelloWorld开始

时间 2019-12-09

标签学习 springmvc helloworld 开始栏目 Spring 繁體版

原文原文链接

前言：

　　时隔十二年，中国女排最终过关斩将，用3:1的成绩证实了本身的实力，霸气夺冠，为中国赢得了一枚意义很是的金牌。这是一次全民的狂欢，一场视听盛宴，带给咱们不只是熠熠生辉的金牌，更传递出的是一种女排精神。css

　　往往得分的时候，总能看到球员们歇斯底里的咆哮和欢呼，由于每一分都来的太不容易。html

　　其实码农也是如此，往往解决掉一个bug的时候，心里的舒畅和激动，好似经历了没有尽头的爬坡，几度已经快精疲力尽或是达到了精神崩溃的边缘以后，陡然迎来了下坡，这种感受比如赛场上女将们得分后已经没法用言语来表达心情，而只能靠咆哮来传递心里的喜悦。java

　　话很少说，从今天起，准备好好审视并学习Spring mvc。web

　　虽然从学java的第一个程序——helloworld至今，已经有好几个年头了。当时本身找资料，看视频，学习了java的输入输出流，多线程，网络编程等等，而三大框架（Struts、Hibernate、Spring）基本只是开了个头就出来实习了，尤为对于Spring更是没有进行系统的学习，虽然在实习的时候经过看项目，基本明白了spring mvc编程的框架是怎么回事，遇到需求知道如何写代码，在哪写代码，可是仍是缺少一个系统的认识。对于涉及到一些spring的文件配置或工做原理的问题时，就显得有些局促。因此，最近准备好好来学习下现现在在企业级开发中大行其道的Spring MVC。spring

什么是Spring MVC

　　Spring MVC属于SpringFrameWork的后续产品，已经融合在Spring Web Flow里面。Spring 框架提供了构建 Web 应用程序的全功能 MVC 模块。使用 Spring 可插入的 MVC 架构，从而在使用Spring进行WEB开发时，能够选择使用Spring的SpringMVC框架或集成其余MVC开发框架，如Struts1，Struts2等。express

　　今天先从写一个Spring MVC的HelloWorld开始，让咱们看看如何搭建起一个Spring mvc的环境并运行程序。编程

软件参数

　　Eclipse：Mars.1 Release (4.5.1)windows

　　Tomcat： 8.0.36浏览器

　　JDK：1.8.0_60spring-mvc

　　Spring-framework： 4.0.4.RELEASE

新建项目

　　File-New-Other,选择Dynamic web project

　　项目建好以后，目录结构以下：

导入jar包

　　咱们基于Spring mvc框架进行开发，须要依赖一下的spring jar包：

spring-aop-4.0.4.RELEASE.jar
spring-beans-4.0.4.RELEASE.jar
spring-context-4.0.4.RELEASE.jar
spring-core-4.0.4.RELEASE.jar
spring-expression-4.0.4.RELEASE.jar
spring-web-4.0.4.RELEASE.jar
spring-webmvc-4.0.4.RELEASE.jar
commons-logging-1.1.1.jar（用来打印log）

　　在WEB-INF目录下新建lib文件夹，并将上面的jar包放入其中。

　　jar包能够点击这里下载。

配置文件及编写代码

web.xml（WEB-INF下）

1 <?xml version="1.0" encoding="UTF-8"?>
 2 <web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 3     xmlns="http://java.sun.com/xml/ns/javaee"
 4     xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
 5     id="WebApp_ID" version="2.5">
 6     
 7     <!-- 配置DispatchcerServlet -->
 8     <servlet>
 9         <servlet-name>springDispatcherServlet</servlet-name>
10         <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
11         <!-- 配置Spring mvc下的配置文件的位置和名称 -->
12         <init-param>
13             <param-name>contextConfigLocation</param-name>
14             <param-value>classpath:springmvc.xml</param-value>
15         </init-param>
16         <load-on-startup>1</load-on-startup>
17     </servlet>
18     
19     <servlet-mapping>
20         <servlet-name>springDispatcherServlet</servlet-name>
21         <url-pattern>/</url-pattern>
22     </servlet-mapping>
23     
24 </web-app>

注意：1. line12-15用于配置spring mvc的配置文件的位置和名称，这里说明会新建一个springmvc.xml的配置文件

　　　2. 咱们也能够不新建springmvc.xml，而是用默认的，默认的配置文件格式为/WEB-INF/[servlet-name]-servlet.xml，对应这里的就是springDispatcherServlet-servlet.xml

　　　3. 这里的servlet-mapping表示拦截的模式，这里是“/”，表示对于全部的请求的拦截，包括静态资源如html, js, jpg等。这时候对于静态资源的访问就会报404的错误。关于如何解决后面会介绍

Springmvc.xml（scr下）

　　在src目录下新建springmvc.xml

1 <?xml version="1.0" encoding="UTF-8"?>
 2 <beans xmlns="http://www.springframework.org/schema/beans"
 3     xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 4     xmlns:context="http://www.springframework.org/schema/context"
 5     xmlns:mvc="http://www.springframework.org/schema/mvc"
 6     xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
 7         http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context-4.0.xsd
 8         http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
 9         
10         
11         <!-- 配置自动扫描的包 -->
12         <context:component-scan base-package="com.jackie.springmvc"></context:component-scan>
13         
14         <!-- 配置视图解析器 如何把handler 方法返回值解析为实际的物理视图 -->
15         <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
16             <property name = "prefix" value="/WEB-INF/views/"></property>
17             <property name = "suffix" value = ".jsp"></property>
18         </bean>
19 </beans>

注意：1. line12表示spring监听的范围，这里是在com.jackie.springmvc下

　　　2. line15-18,是添加了一个视图解析器，用于把在控制器中handler的结构解析为实际的物理视图，这个要配合controller类来解析，详见下面。

HelloWorld.java（com.jackie.springmvc.handlers下）

1 package com.jackie.springmvc.handlers;
 2 
 3 import org.springframework.stereotype.Controller;
 4 import org.springframework.web.bind.annotation.RequestMapping;
 5 
 6 @Controller
 7 public class HelloWorld {
 8 
 9     /**
10      * 1. 使用RequestMapping注解来映射请求的URL
11      * 2. 返回值会经过视图解析器解析为实际的物理视图, 对于InternalResourceViewResolver视图解析器，会作以下解析
12      * 经过prefix+returnVal+suffix 这样的方式获得实际的物理视图，而后会转发操做
13      * "/WEB-INF/views/success.jsp"
14      * @return
15      */
16     @RequestMapping("/helloworld")
17     public String hello(){
18         System.out.println("hello world");
19         return "success";
20     }
21 }

注意：1. 首先要在类的前面添加“Controller”注解，表示是spring的控制器，这里会写一个方法hello（）

　　　2. hello方法上方有一个@RequestMapping，是用于匹配请求的路径，好比这里匹配的请求路径就是“http://localhost:8080/springTest/springmvc/helloworld”，即当tomcat服务启动后，在浏览器输入这个url时，若是在这个方法打断点了，就会跳入该方法。

　　　3. 这个return的结果不是乱写的，这个返回的字符串就是与上面springmvc.xml中line15-18进行配合的，springmvc.xml中声明了prefix和suffix，而夹在这二者之间的就是这里返回的字符串，因此执行完这个方法后，咱们能够获得这样的请求资源路径“/WEB-INF/views/success.jsp”，这个success.jsp是须要咱们新建的

index.jsp（WebContent下）

　　在新建success.jsp以前，咱们须要有一个入口，也就是这里的index.jsp

1 <%@ page language="java" contentType="text/html; charset=UTF-8"
 2     pageEncoding="UTF-8"%>
 3 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 4 <html>
 5 <head>
 6 <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
 7 <title>Insert title here</title>
 8 </head>
 9 <body>
10 
11 <a href="helloworld">hello world</a>
12 
13 </body>
14 </html>

　　当访问index.jsp时，页面上会展现一个超连接，点击超链后，url中的地址就会发生跳转，由“http://localhost:8080/springTest/index.jsp”跳转到“http://localhost:8080/springTest/helloworld”，而这个url请求就会进入HelloWorld中的hello方法，由于其与该方法上的“/helloworld”匹配。

success.jsp（WEB-INF/views下）

　　该页面是做为请求成功后的相应页面

1 <%@ page language="java" contentType="text/html; charset=ISO-8859-1"
 2     pageEncoding="ISO-8859-1"%>
 3 <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
 4 <html>
 5 <head>
 6 <meta http-equiv="Content-Type" content="text/html; charset=ISO-8859-1">
 7 <title>Insert title here</title>
 8 </head>
 9 <body>
10 
11 <h4>Success Page</h4>
12 
13 </body>
14 </html>

至此，咱们完成了基于Spring mvc框架的HelloWorld程序的开发，包括要依赖的jar包，配置的文件，控制器代码的编写和展现页面的编写等。

除此之外，再介绍下整个配置过程当中遇到的一些小问题：

1. tomcat服务器的添加

　　从前面的介绍能够看出，咱们的程序是经过浏览器发请求来获取想要的页面，那么这里就免不了要有一个web服务器，这里就是tomcat。

　　首先你须要下载个tomcat，而后在eclipse->windows->preference->servers中绑定这个tomcat服务器；

　　其次你须要在你新建的spring mvc项目中添加tomcat的支持，不然在新建的jsp文件中会提示报错“The superclass javax.servlet.http.HttpServlet was not found on the Java Build Path”

　　右键项目->build path->configure build path->add library->server runtime, 选择你的tomcat便可

　　有了tomcat服务器，你就能够在index.jsp上右键run on server,选择你的tomcat服务器，这样就能够启动tomcat服务，帮助你完成网页的请求和响应操做。

2. spring mvc如何访问静态资源

　　关于使用spring mvc处理静态资源，好比html（发现以前的springmvc.xml中<property name = "suffix" value = ".jsp"></property>定义为jsp结尾就能够成功跳转，可是若是改成html并在web-inf下面新建了html文件后，并将suffix这里的".jsp"改成".html"，没法跳转到想要的html页面，而且给出404错误，同时console给出错误信息为：No mapping found for HTTP request with URI [/springTest/WEB-INF/views/result.html] in DispatcherServ）

　　最后发现是须要让spring明确要处理静态资源，原来的web.xml中只有

1 <servlet-mapping>
2     <servlet-name>springDispatcherServlet</servlet-name>
3     <url-pattern>/</url-pattern>
4 </servlet-mapping>

　　其匹配的都是controller中相似@RequestMapping("/springmvc/helloworld")这样的注解配置的请求，而对于相似html/css/jpg等资源的访问就会得不到，因此须要在web.xml中加入如下类型的支持

1 <servlet-mapping>
 2      <servlet-name>default</servlet-name>
 3      <url-pattern>*.css</url-pattern>
 4 </servlet-mapping>
 5 
 6 <servlet-mapping>
 7       <servlet-name>default</servlet-name>
 8       <url-pattern>*.gif</url-pattern>
 9 </servlet-mapping>
10 
11 <servlet-mapping>
12     <servlet-name>default</servlet-name>
13      <url-pattern>*.jpg</url-pattern>
14 </servlet-mapping>
15 
16 <servlet-mapping>
17      <servlet-name>default</servlet-name>
18      <url-pattern>*.js</url-pattern>
19 </servlet-mapping>
20 
21 <servlet-mapping>
22       <servlet-name>default</servlet-name>
23       <url-pattern>*.html</url-pattern>
24 </servlet-mapping>

　　这样就能够保证spring 可以拦截并处理静态资源

　　这里将HelloWorld.java中的hello方法改成：

@RequestMapping("/helloworld")
    public String hello(){
        System.out.println("hello world");
        return "Jackie";
}

　　Springmvc.xml改成：

class="org.springframework.web.servlet.view.InternalResourceViewResolver">
            <property name = "prefix" value="/WEB-INF/views/"></property>
            <property name = "suffix" value = ".jpg"></property>
</bean>

　　表示咱们能够访问jpg静态图片资源了

看到图片若有不适，请经过点赞来缓解症状~~~