SI 系列入门 之 手把手构建 Spring MVC 工程

太阳火神的美丽人生 (http://blog.csdn.net/opengl_es)

本文遵循“署名-非商业用途-保持一致”创作公用协议

转载请保留此句:太阳火神的美丽人生 -  本博客专注于 敏捷开发及移动和物联设备研究:iOS、Android、Html5、Arduino、pcDuino,否则,出自本博客的文章拒绝转载或再转载,谢谢合作。

SI 前文有述,Spring MVC + MyBatis 的简称,因为 Spring MVC 内部已有注入功能,故不考虑其是否是利用了 Spring (用脚叉子想也是利用了 Spring ,不过想太多,容易遭雷击,那么就当不存在好了,就是 Spring MVC 自已的注入功能)。

大体过程应该是:

一、web.xml 配置

Java Web 容器通过 Web 应用的 web.xml 找到请求响应的 Servlet

1、Java Web 容器收到请求,根据 web.xml 中配置的 Servlet 和匹配模式,找到请求对应的 Servlet ,并将请求转发给该 Servlet 处理;

2、我们配置 Spring MVC 的分发器来处理所有预期的请求匹配模式,web.xml 的完整可用配置如下:

<?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_3_0.xsd"
	id="WebApp_ID" version="3.0">
	<display-name>TestSI</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>TestSI</servlet-name>
		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
		<init-param>
			<!-- 与 Spring 分别指定 上下文配置文件位置 -->
			<param-name>contextConfigLocation</param-name>
			<param-value>classpath:spring-controller.xml, classpath:TestSI-servlet.xml</param-value>
		</init-param>
		<load-on-startup>1</load-on-startup>
	</servlet>

	<servlet-mapping>
		<servlet-name>TestSI</servlet-name>
		<url-pattern>/*</url-pattern>
	</servlet-mapping>

</web-app>

以上完成了 Java Web 部分的配置,请求有人处理了,完事大吉,容器放权,爱谁扎腾谁就来扎腾,它可不爱管这闲事儿,接下来就得 Spring MVC 来扎腾了吧!

3、切忌画蛇添足,把 Spring 的监听器给配上,然后在 Spring 的全局上下文配置文件中配置要注入的 Bean ,结果 Spring MVC 并未用得上注入的 Bean,而是自已创建的;相反,应该把 Spring 配置文件配置给 Spring MVC ,Spring MVC 会根据配置来实现注入,并从注入中找到想要用的 Bean ,这时注入功能才起作用。

二、TestSI-servlet.xml 配置

这里的 TestSI 是根据 Spring MVC 的分发器 DispatcherServlet 在 web.xml 中定义的 <servlet-name/> 来定,就是这个名儿 + -servlet.xml,DispatcherServlet 接受请求后,查找该配置文件,来确定在哪个类包中搜索控制器类,当然这些类是需要注解驱动的:

TestSI-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"
	xmlns:mvc="http://www.springframework.org/schema/mvc"
	xsi:schemaLocation="
           http://www.springframework.org/schema/beans
           http://www.springframework.org/schema/beans/spring-beans-3.1.xsd
           http://www.springframework.org/schema/context
           http://www.springframework.org/schema/context/spring-context-3.1.xsd
           http://www.springframework.org/schema/mvc
           http://www.springframework.org/schema/mvc/spring-mvc-3.1.xsd">

	<!-- 扫描 Controller 的根包 -->
	<context:component-scan base-package="com.testsi.controller" />
	<!-- 简写配置注解驱动 -->
	<mvc:annotation-driven/>

	<!-- 控制器返回字符串匹配页面 -->
	<bean
		class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<property name="prefix" value="/WEB-INF/view/"></property>
		<property name="suffix" value=".jsp"></property>
	</bean>
</beans>

以上配置,DispatcherServlet 就会到 com.testsi.controller 包下去找控制器类中配匹的方法,当然这要当注解,任何类胆缀上 @Controller ,都能成为控制器类,被 DispatcherServlet 搜索到,具体是文件解析还是怎样,俺还没有研究过,那是注解的相关内容,有兴趣后续再研究;

具体到请求分派给哪个控制器的哪个方法,那就要看方法前的注解了,简单地,

@RequestMapping(value = "", method = RequestMethod.GET)

这一行,可以匹配任何内容?关于 @RequestMapping 这个注解,是匹配请求递交下一站的关键,这个也需要深入研究一番。

由上面的 web.xml 中配置可知,TestSI-servlet.xml  配置文件位置在类路径根包下,我们在 Java Resources 下和 src 平级建一个任意名称的目录,它就和 src 起到同样的分组作用,最终这些 Java Resources  下的分组中的内容都会按目录结构拷贝到 WEB-INF/classes 目录下:

当然了,.java 类源文件一定是要编译成 .class 之后才会和 src 同级的其它目录中的内容按原目录结构一同拷入 WEB-INF 中新建的 classes 目录下。

类的包以目录层次来代替存储相应的 .class 文件。

当然了,这些配置文件或一些资源文件,也可以放在类根包之下的任意一级包中,或者在 src 下,与 com 同级,src 就代表了根包,这样,在配置文件中只要使用 classpath: 来限定就可以了,当然还有一种用法 classpath*:,这是表示根包下任何子层级下的这样的结构都能匹配。

在 java 代码中可以使用类加载器的 getResource(“/”) 来获得根包所在磁盘路径,或者 getResource(“”) 可获得当前类所在包路径,有多种用法,可以达到通过类路径来定位类资源的目的,解除了硬编码路径带来的迁移隐患。

三、按以上两步规划,实作细节

上面描述的够多,够细了,我们来看看,有哪些事情是需要实作一下的:

1、就是 web.xml 中两个配置文件的路径,那就按上面图中所示建个目录吧,然后分别把那两个配置文件都按名称建好并放在那个位置;

2、将上面  TestSI-servlet.xml  的内容拷贝粘贴进去,其中需要在 WEB-INF 下建一个 view 子目录,并在其中创建一个 index.jsp 文件;

3、控制器搜索类包的建立 com.testsi.controller,这个在 src 下建就是了;

4、在 com.testsi.controller 下建立 IndexController 类,然后在类上一行输入 @Controller 注解;

@Controller
public class IndexController {

}

5、在 IndexController 类中建立方法 index,并如下图在方法上一行加上 @RequestMapping 注解:

@Controller
public class IndexController {
	@RequestMapping(value = "", method = RequestMethod.GET)
	public String index(HttpServletRequest request) throws Exception {
		return "index";
	}
}

保存后,clean 并自动编译后,出现相应错误提示,提示缺少相应的类库,接下来我们就把需要的类库找齐。

四、最简 Spring MVC 所需类库

1、首先,这些类库可以从 mvnrepository.com 下载,这个Maven 的资源库的优点:

一是能按名称搜到必要的 Jar 包,

二是每一个 Jar 包所依赖的包也提供了列表及下载链接以及 Jar 包的适用版本。

2、我们预先知道要用到 DispatcherServlet ,不过注意其全包结构:org.springframework.web.servlet.DispatcherServlet,所从头手写下来,竟然把 org 写成 com了,导致 Tomcat 6 启动报错找不到这个 DispatcherServlet。

那么我们需要先下载的就是 springframework 中的 spring-webmvc ,其实这些我也花了些时间一点点地找,一点点地加,而没有用别人现成的,就是想知道最简的是什么,由自已实测得来,记忆和理解比较深刻。

下图中的这 7 个 Jar 包,我先搜到的 spring-webmvc 并找到 3.2.9 版本,后发现直接搜 springframework 会找到相关的所有分类。

spring-webmvc 是 web.xml 中配置的,spring-context 和 spring-web 是给类和方法加注解以及参数时,出现的错误提示,并按提示找到的;

其它四个完全是每运行一次提示一次找不到类,就按提示搜到并下载下来,凑齐了最简所需 7 个包。

然而,上面还是有问题的,在控制器中返回 “index" 字符串,会在控制台提示相关警告,而且也无法显示 index.jsp 页:

警告: No mapping found for HTTP request with URI [/TestSI/WEB-INF/view/index.jsp] in DispatcherServlet with name ‘TestSI‘

问题出在 web.xml 中对 DispatcherServlet 的匹配模型的设定面:

	<servlet-mapping>
		<servlet-name>TestSI</servlet-name>
		<url-pattern>/*</url-pattern>
	</servlet-mapping>

“/*”,会将所有的请求都转交给  DispatcherServlet;

“/”,只会将 host/servlet 这种形式的请求转交给 DispatcherServlet 来处理;
这种解释,我尚且也没弄得太清楚,感兴趣可移步这里
改过来,再运行一下吧,保准儿没问题了,有问题的话,那就是还没想到的问题,欢迎回贴。

后续,会接着把今天调通的 Spring MVC 注入 MyBatis 的映射器,再接着以上工程实做一遍,包括 Jar 包等细节问题,从头来过。

下周末见!

工程代码已打包,有空儿研究一下 CSDN 的上传,分享给大家。

时间: 2024-10-25 12:55:29

SI 系列入门 之 手把手构建 Spring MVC 工程的相关文章

[预告]SI 系列入门 之 手把手构建 Spring-MyBatis 工程

本周末 2014-11-30 再利用业务时间继续研究  MyBatis 及  Spring-MyBatis 最简化的 MySql 数据库操作,以及使用 MyBatis Generator 从数据库中自动生成 Java Model.Mapper 等代码,尚不知 Service 是否能自动生成,生成的接口是否以 I 开头. 敬请期待!

使用maven, myeclipse工具构建spring mvc项目

一.使用myeclipse 创建一个新的 maven项目. (ps:1.在filter过滤的时候输入 webapp 选择"maven-archetype-webapp". 2.在main下建一个java文件夹(建source folder可能不能成功)) 具体可参考:http://www.cnblogs.com/waniu/p/3798775.html 二.将project 转变成webproject.(右键--properties--myeclipse--project facets

如何在Spring MVC工程中进行单元测试

直接以代码方式演示如何在Spring MVC工程中进行单元测试: package net.chinaedu.projects.dubhe; import java.util.List; import net.chinaedu.projects.dubhe.publisher.IPublisherService; import net.chinaedu.projects.venus.domain.Publisher; import org.junit.Test; import org.junit.

使用IDEA创建Spring mvc工程及简要分析

需要使用IDEA ultimate版本,才会有Web支持. 0.创建工程 File->New->Project- 一路向下,最后创建一个tomcat server,mac上下载解压即可,非常简单,不详细描述. 完成后,idea会自动下载Spring相关lib,同时创建一个示例工程,下面看看idea到底自动做了哪些配置.对了解整个工程结构,web服务和框架的启动流程非常有用. 1.maven 根据配置的lib版本,会配置一个maven配置文件pom.xml,工程使用maven来进行项目管理,我们

Springboot(一):使用Intellij中的Spring Initializr来快速构建Spring Boot工程

使用Intellij中的Spring Initializr来快速构建Spring Boot工程 New---Project 可以看到图所示的创建功能窗口.其中Initial Service Url指向的地址就是Spring官方提供的Spring Initializr工具地址,所以这里创建的工程实际上也是基于它的Web工具来实现的,也可以将此地址copy到浏览器上试一下,会生成spring boot的项目工程下载 Next,下图可以看到可以编辑我们所创建的工程信息,type类型,language语

Eclipse Maven构建Spring MVC项目

工作中项目开发使用Maven管理项目的构建.打包.编译,框架采用的是Spring MVC框架,并且实现了多模块.多项目的管理.自己也简单的参与了架构的设计.对于初学者来说,使用Maven构建项目并不是一件容易的事情,本文的目的就是引导新手使用maven构建springmvc项目. 准本工作 1.Eclipse 尽量选用较高版本的Eclispse,因为eclipse对于maven的支持比较晚. 2.Maven 安装maven,至于其安装方式这里也就不再多提了,请自行google. 3.Eclips

Eclipse J2EE+Maven+Tomcat(Jetty)构建Spring MVC项目

一步一步的我们试着使用Eclipse J2EE+Maven+Tomcat(Jetty) 搭建留住的web开发平台 Spring MVC的方法. 工具:Eclipse J2EE,Maven,Tomcat Eclipse J2EE+Maven+Tomcat(Jetty):http://www.eclipse.org/downloads/ Maven 3.3.3:http://maven.apache.org/download.cgi Tomcat 7.X:http://tomcat.apache.o

SpringMVC系列(十六)Spring MVC与Struts2的对比

? Spring MVC 的入口是 Servlet, 而 Struts2 是 Filter? Spring MVC 会稍微比 Struts2 快些. Spring MVC 是基于方法设计, 而 Sturts2 是基于类, 每次发一次请求都会实例一个 Action.? Spring MVC 使用更加简洁, 开发效率Spring MVC确实比 struts2 高: 支持 JSR303, 处理 ajax 的请求更方便,只需要使用注解即可完成? Struts2 的 OGNL 表达式使页面的开发效率相比S

[Java] Maven 建立 Spring MVC 工程

GIT: https://github.com/yangyxd/Maven.SpringMVC.Web 1. 建立 WebApp 工程 下一步: 下一步: 选择 maven-archetype-webapp 下一步,设置 Group ID, Artifact Id 以及 package 包名. 点击 Finish 完成. 可以看到有一些错误. 解决办法: 1. 在 Project Explorer 中的项目上点击右键,在弹出菜单上点击 "Properties" , 在属性对话框中,定位