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