在准备写代码之前,我们首先得把下列必备的库导入项目:
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一下。