学习SpringMVC——从HelloWorld开始

什么是Spring MVC?

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

　　现在开始写一个Spring MVC的HelloWorld!

软件参数

　　Eclipse：Mars.1 Release (4.5.1)

　　Tomcat： 8.0.36

　　JDK：1.8.0_60

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

配置文件及编写代码

　　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" xmlns:web="http://java.sun.com/xml/ns/javaee/web-app_2_5.xsd"
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
	id="WebApp_ID" version="3.0">
	<display-name>SpringMVCHello</display-name>

	<!-- 配置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>/WEB-INF/classes/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>

	<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>

	<welcome-file-list>
		<welcome-file>index.html</welcome-file>
		<welcome-file>index.htm</welcome-file>
		<welcome-file>index.jsp</welcome-file>
		<welcome-file>default.html</welcome-file>
		<welcome-file>default.htm</welcome-file>
		<welcome-file>default.jsp</welcome-file>
	</welcome-file-list>
</web-app>

　　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.baorant.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>

　　

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

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

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

package com.baorant.springmvc.handlers;

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

@Controller
public class HelloWorld {

    /**
     * 1. 使用RequestMapping注解来映射请求的URL
     * 2. 返回值会通过视图解析器解析为实际的物理视图, 对于InternalResourceViewResolver视图解析器，会做如下解析
     * 通过prefix+returnVal+suffix 这样的方式得到实际的物理视图，然后会转发操作
     * "/WEB-INF/views/success.jsp"
     * @return
     */
	@RequestMapping("/helloworld")
    public String hello(){
        System.out.println("hello world");
        return "success";
}
}

　　

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

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

　　　3. 这个return的结果不是乱写的，这个返回的字符串就是与上面springmvc.xml进行配合的，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=UTF-8"
    pageEncoding="UTF-8"%>
<!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=UTF-8">
<title>Insert title here</title>
</head>
<body>

<a href="helloworld">hello world</a>

</body>
</html>

　　

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

　　success.jsp（WEB-INF/views下）

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

<%@ 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>

<h4>Success Page</h4>

</body>
</html>

　　

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