Spring温故知新:WEB篇（二）Hello,World!

在准备写代码之前，我们首先得把下列必备的库导入项目：
spring-framework-2.5.6\dist\spring.jar
spring-framework-2.5.6\dist\modules\spring-webmvc.jar
spring-framework-2.5.6\lib\jakarta-commons\commons-logging.jar
spring-framework-2.5.6\lib\j2ee\jstl.jar

      只要把这几个文件拷贝到项目的WebContent\WEB-INF\lib目录下，然后在eclipse里刷新一下项目，就可以自动导入库。

        这时候我们可以开始修改项目的WebContent\WEB-INF文件夹下的web.xml这个配置文件。
        要使用Spring来制作一个web，首先我们得在web.xml里新建一个servlet，这个servlet的作用就是告诉tomcat容器，当一个请求符合某一种规则的时候就用Spring来负责处理这个请求。

        例如我们需要让Spring来接管所有以.do为后缀的url请求，那么就需要修改web.xml为以下内容：
web.xml：

<?xml version="1.0" encoding="UTF-8"?>
<web-app id="WebApp_ID" version="2.4"
	xmlns="http://java.sun.com/xml/ns/j2ee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
	xsi:schemaLocation="http://java.sun.com/xml/ns/j2ee http://java.sun.com/xml/ns/j2ee/web-app_2_4.xsd">
	<display-name>SpringWeb</display-name>
	<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>
	<servlet>
		<servlet-name>dispatcherServlet</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
	</servlet>
	<servlet-mapping>
		<servlet-name>dispatcherServlet</servlet-name>
		<url-pattern>*.do</url-pattern>
	</servlet-mapping>
</web-app>

        如果有servlet编程基础的话就可以知道，servlet-name节点的内容是可以自定义的，不过<servlet>和对应的<servlet-mapping>一定要有相同的servlet-name。它们分别代表了一个servlet的定义和servlet的映射关系。

以上这个servlet的作用，就是告诉tomcat只要url请求是以.do为后缀的，就交给org.springframework.web.servlet.DispatcherServlet这个Spring的类来处理，而DispatcherServlet看字面意思就能明白它的作用就是一个分配器。



        只要在web.xml里成功配置好以后，我们就可以正式进入spring部分。首先我们得在web.xml的同一目录下新建一个dispatcherServlet-servlet.xml文件。

        当然你可以在任意目录新建一个任意文件名的xml，而且一般都会放在WEB-INF文件夹下的一个新建的自定义文件夹里，一般为WEB-INF\conf文件夹。不过这样的话你还得在web.xml文件里修改一下servlet的参数。
这里就把这个内容作为自学内容交给你自己去google吧，学会google要比学会编程更重要啊！

        那么默认情况下是不是这个xml的文件名必须是dispatcherServlet-servlet.xml呢？回答是肯定的。
        在默认情况下，Spring会首先自动查找web.xml同一目录下、而且文件名为servlet的名称再加上-servlet的xml文件。
        这时候你就会发现dispatcherServlet-servlet.xml这个文件名的横杆前部分就是之前web.xml里的servlet-name的值、后半部分就是恒定的servlet这个单词。
        如果之前你自定义了servlet-name，比如改成了bolide74Servlet，那么这里的文件名就必须是bolide74Servlet-servlet.xml。

dispatcherServlet-servlet.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:p="http://www.springframework.org/schema/p"
	xmlns:context="http://www.springframework.org/schema/context"
	xsi:schemaLocation="http://www.springframework.org/schema/beans 
    http://www.springframework.org/schema/beans/spring-beans-2.5.xsd
    http://www.springframework.org/schema/context 
    http://www.springframework.org/schema/context/spring-context-2.5.xsd">
	<!-- 视图 -->
	<bean id="viewResolver"
		class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<!-- 使用标签库，暂时可不用 -->
		<!-- <property name="viewClass" value="org.springframework.web.servlet.view.JstlView"/> -->
		<property name="prefix" value="/WEB-INF/jsp/" />
		<property name="suffix" value=".jsp" />
	</bean>

	<!-- 映射 -->
	<bean id="urlMapping"
		class="org.springframework.web.servlet.handler.SimpleUrlHandlerMapping">
		<property name="mappings">
			<props>
				<prop key="helloWorld.do">helloWorld</prop>
			</props>
		</property>
	</bean>

	<!-- action -->
	<bean id="helloWorld" class="com.iteye.bolide74.action.HelloWorld">
		<property name="viewPage" value="helloWorld" />
	</bean>
</beans>

        你会发现，这个dispatcherServlet-servlet.xml其实就是一个Spring配置文件，里面都是一个个的bean，很亲切吧！
        viewResolver这个bean的作用就是告诉Spring我们的web视图文件都是以.jsp为后缀也就是jsp页面，它们都存放在/WEB-INF/jsp/这个文件夹下面。只要有了这个bean那么接下来的action部分就不用这么麻烦的每次都把jsp页面的路径和文件名都写全了。
        urlMapping就是一个映射表，它告诉了Spring哪种url请求对应了哪一个action，例如我们这里是告诉Spring只要url请求为helloWorld.do，那么调用helloWorld这个bean。
        helloWorld这个bean我就不多做解释了。它的注入参数为viewPage，值为helloWorld。这个helloWorld的值代表了这个action对应的视图文件为/WEB-INF/jsp/helloWorld.jsp，由于上面我们在viewResolver设置过路径和后缀，所以我们这里只需要输入helloWorld就可以了。

最后我们总结一下这个xml的作用，就是告诉Spring我们的视图文件为存放在/WEB-INF/jsp/目录下的所有jsp文件，并且设置当url请求为helloWorld.do的时候就调用helloWorld这个bean来处理，并把helloWorld这个值注入了viewPage这个参数。



接下来我们新建com.iteye.bolide74.action.HelloWorld这个action类：

HelloWorld.java：

package com.iteye.bolide74.action;

import java.util.HashMap;
import java.util.Map;

import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;

import org.springframework.web.servlet.ModelAndView;
import org.springframework.web.servlet.mvc.Controller;

public class HelloWorld implements Controller {
	private String viewPage;

	public String getViewPage() {
		return viewPage;
	}

	public void setViewPage(String viewPage) {
		this.viewPage = viewPage;
	}


	@Override
	public ModelAndView handleRequest(HttpServletRequest arg0,
			HttpServletResponse arg1) throws Exception {
		String msg=arg0.getParameter("msgValue");
		msg="你输入的值为"+msg;
		Map model = new HashMap();
		model.put("msg", msg);
		return new ModelAndView(getViewPage(), model);
	}
}

这个类实现了Controller接口，这个接口是由Spring提供的。它其实是起到了一个代理作用，还记得以前的AOP代理么？忘记了的话可以回头复习一下。

这个类有一个viewPage成员属性，使用了set/get注入。当然你也可以用自定义的属性。它的值代表了这个action所对应的视图文件的文件名，这个我们之前有提到过。

Controller接口有一个handleRequest抽象方法，它的类型为ModelAndView，这个类型是Spring提供的，它的命名就是它的作用，后面我会详细介绍一下这个类型。简单的说就是这个类包含了一个url请求的参数数据和视图内容。如果你知道MVC，那么这个类就包含了其中的M和V而Controller接口就是那个C。
这里的handleRequest方法我们在"原Model"里嵌入了一个msg参数，它的值为HttpServletRequest获取的msgValue这个URL参数的值。


最后在/WEB-INF/jsp/目录下新建一个helloWorld.jsp视图文件：
helloWorld.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>
	<form action="helloWorld.do">
		<input type="text"  name="msgValue"  value="" /> 
		<input type="submit"  value="speak" />
	</form>
	<%=request.getAttribute("msg")%>
</body>
</html>

这个我想都看的懂吧，就是一个传统的jsp页面。里面就一个form，注意到name为msgValue的文本输入框了没？上面的HelloWorld.java的作用获取的就是这里的msgValue的值然后处理了一下再返回给客户端。



好了，大功告成，我们直接F11启动，注意是Run on Server，这时候eclipse会新建一个内置浏览器标签，浏览器里的url地址为http://localhost:8080/SpringWeb/WEB-INF/jsp/helloWorld.jsp但是页面内容却显示的是404错误。
这是由于tomcat的安全机制，客户端是无法直接访问WEB-INF这个文件夹以及它下面的所有文件的，因此我们才会把所有重要的配置文件、视图源码之类的都放在这个文件夹下面。

我们要看到劳动成功，就得在地址栏里输入URL为：http://localhost:8080/SpringWeb/helloWorld.do  如果你全部按步骤进行，那么现在你就能看到页面内容为



在输入框里输入Hello,World!再点击Speak按钮，你就能看到“你输入的值为Hello,World!”
恭喜你，终于入门Spring Web编程了。




最后再抛出一个问题，当你在输入框内输入中文“你好！”的时候，页面返回给你的内容却是一段乱码，这该怎么办呢？这就是我们下一篇必须要解决的问题，你可以先自己google一下。