SpringMVC 从HelloWorld开始

背景

Spring 框架提供了构建Web 应用程序的全功能MVC 模块。使用Spring 可插入的MVC 架构，可以选择是使用内置的Spring Web 框架还是Struts 这样的Web 框架。通过策略接口，Spring 框架是高度可配置的，而且包含多种视图技术，例如JavaServer Pages（JSP）技术、Velocity、Tiles、iText 和POI。Spring MVC 框架并不知道使用的视图，所以不会强迫您只使用JSP 技术。Spring MVC 分离了控制器、模型对象、分派器以及处理程序对象的角色，这种分离让它们更容易进行定制。

什么是spring

Spring是一个开源框架，Spring是于2003 年兴起的一个轻量级的Java 开发框架，由Rod Johnson 在其著作Expert One-On-One J2EE Development and Design中阐述的部分理念和原型衍生而来。它是为了解决企业应用开发的复杂性而创建的。框架的主要优势之一就是其分层架构，分层架构允许使用者选择使用哪一个组件，同时为 J2EE 应用程序开发提供集成的框架。Spring使用基本的JavaBean来完成以前只可能由EJB完成的事情。然而，Spring的用途不仅限于服务器端的开发。从简单性、可测试性和松耦合的角度而言，任何Java应用都可以从Spring中受益。Spring的核心是控制反转（IoC）和面向切面（AOP）。简单来说，Spring是一个分层的JavaSE/EE full-stack(一站式) 轻量级开源框架。
轻量级：与EJB对比，依赖资源少，销毁的资源少。
分层：一站式，每一个层都提供的解决方案

       web层：struts，spring-MVC

       service层：spring

       dao层：hibernate，mybatis ， jdbcTemplate --> spring-data

spring核心

Spring的核心是控制反转（IoC）和面向切面（AOP）

spring优点

方便解耦，简化开发（高内聚低耦合）

Spring就是一个大工厂（容器），可以将所有对象创建和依赖关系维护，交给Spring管理

spring工厂是用于生成bean

AOP编程的支持

Spring提供面向切面编程，可以方便的实现对程序进行权限拦截、运行监控等功能

声明式事务的支持

只需要通过配置就可以完成对事务的管理，而无需手动编程

方便程序的测试

Spring对Junit4支持，可以通过注解方便的测试Spring程序

方便集成各种优秀框架

Spring不排斥各种优秀的开源框架，其内部提供了对各种优秀框架（如：Struts、Hibernate、MyBatis、Quartz等）的直接支持

降低JavaEE API的使用难度

Spring 对JavaEE开发中非常难用的一些API（JDBC、JavaMail、远程调用等），都提供了封装，使这些API应用难度大大降低

基于spring3.2 的采用annotation 方式搭建springMVC
环境

上官网下载对应的zip包当然该zip 并非最新的。
下载地址
解压之后得到目录：

打开libs 会看到会多jar ,这里边包括了所有的jar 和source 和doc。当然我们只是需要使用jar 就可以了。
项目完整结构如下：

导入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包放入其中。

配置文件及编写代码

　　web.xml（WEB-INF下）

<?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_2_5.xsd"
    id="WebApp_ID" version="2.5">
    
    <!-- 配置DispatchcerServlet -->
    <servlet>
        <servlet-name>springDispatcherServlet</servlet-name>
        <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
        <!-- 配置Spring mvc下的配置文件的位置和名称 -->
        <init-param>
            <param-name>contextConfigLocation</param-name>
            <param-value>classpath:springmvc.xml</param-value>
        </init-param>
        <load-on-startup>1</load-on-startup>
    </servlet>
    
    <servlet-mapping>
        <servlet-name>springDispatcherServlet</servlet-name>
        <url-pattern>/</url-pattern>
    </servlet-mapping>
    
</web-app>

这个org.springframework.web.servlet.DispatcherServle即为springMVC的核心控制器。
其中init-param中配置的是spring的配置文件的文件路径。

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

<?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-4.0.xsd
        http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc-4.0.xsd">
        
        
        <!-- 配置自动扫描的包 -->
        <context:component-scan base-package="com.springmvc.springmvc"></context:component-scan>
        
        <!-- 配置视图解析器 如何把handler 方法返回值解析为实际的物理视图 -->
        <bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
            <property name = "prefix" value="/WEB-INF/views/"></property>
            <property name = "suffix" value = ".jsp"></property>
        </bean>
</beans>

其中schemaLocation和xmlns建议直接拷贝。

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

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

HelloWorld.java（com.springmvc.controller下）

package com.springmvc.controller;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

@Controller
public class HelloWorld {

     /** 
     * 1.使用@RequestMapping注解来映射请求的url
     * 2.返回值会通过视图解析器解析为实际的物理视图，对于InternalResourceViewResolver视图解析器，
     *     会做如下解析：通过prefix+returnVal+suffix 拼接出来的实际的物理视图，然后做转化操作。
     *  prefix：/WEB-INF/views/
     *  reuturnVal:success
     *  suffix:.jsp
     * */
    // 接收请求的路径http://localhost:8080/hello
    // 响应返回的视图物理位置：/WEB-INF/views/success.jsp
    @RequestMapping("/hello")
    public String hello(){
        System.out.println("hello word...");
        return "success";
    }
}

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

<%@ page language="java" contentType="text/html; charset=ISO-8859-1"
    pageEncoding="ISO-8859-1"%>
<!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=ISO-8859-1">
<title>Insert title here</title>
</head>
<body>

<a href="hello">hello action</a>

</body>
</html>

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

在WEB-INF/下创建views文件夹，在views文件夹中添加success.jsp页面，页面内添加内容"Success Page ..."

运行测试项目是否正常运行。

点击“hello action”链接后：

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中只有

<servlet-mapping>
     <servlet-name>springDispatcherServlet</servlet-name>
     <url-pattern>/</url-pattern>
</servlet-mapping>

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

<servlet-mapping>
     <servlet-name>default</servlet-name>
     <url-pattern>*.css</url-pattern>
</servlet-mapping>

<servlet-mapping>
      <servlet-name>default</servlet-name>
      <url-pattern>*.gif</url-pattern>
</servlet-mapping>

<servlet-mapping>
    <servlet-name>default</servlet-name>
     <url-pattern>*.jpg</url-pattern>
</servlet-mapping>

<servlet-mapping>
     <servlet-name>default</servlet-name>
     <url-pattern>*.js</url-pattern>
</servlet-mapping>

<servlet-mapping>
      <servlet-name>default</servlet-name>
      <url-pattern>*.html</url-pattern>
</servlet-mapping>

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

其他更详细的操作，请查看博主的另一篇文章：文章地址

大尧酱

发布了48 篇原创文章 · 获赞 94 · 访问量 5万+

私信关注