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

简介: SI 系列入门 之 手把手构建 Spring MVC 工程太阳火神的美丽人生 (http://blog.csdn.net/opengl_es)本文遵循“署名-非商业用途-保持一致”创作公用协议转载请保留此句:太阳火神的美丽人生 -  本博客专注于 敏捷开发及移动和物联设备研究:iOS、Android、Html5、Arduino、pcDuino,否则,出自本博客的文章拒绝转载或再转载,谢谢合作。

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 的上传,分享给大家。



目录
相关文章
|
15天前
|
Java API 数据库
构建RESTful API已经成为现代Web开发的标准做法之一。Spring Boot框架因其简洁的配置、快速的启动特性及丰富的功能集而备受开发者青睐。
【10月更文挑战第11天】本文介绍如何使用Spring Boot构建在线图书管理系统的RESTful API。通过创建Spring Boot项目,定义`Book`实体类、`BookRepository`接口和`BookService`服务类,最后实现`BookController`控制器来处理HTTP请求,展示了从基础环境搭建到API测试的完整过程。
31 4
|
17天前
|
Java API 数据库
如何使用Spring Boot构建RESTful API,以在线图书管理系统为例
【10月更文挑战第9天】本文介绍了如何使用Spring Boot构建RESTful API,以在线图书管理系统为例,从项目搭建、实体类定义、数据访问层创建、业务逻辑处理到RESTful API的实现,详细展示了每个步骤。通过Spring Boot的简洁配置和强大功能,开发者可以高效地开发出功能完备、易于维护的Web应用。
47 3
|
1天前
|
JavaScript 安全 Java
如何使用 Spring Boot 和 Ant Design Pro Vue 构建一个具有动态路由和菜单功能的前后端分离应用。
本文介绍了如何使用 Spring Boot 和 Ant Design Pro Vue 构建一个具有动态路由和菜单功能的前后端分离应用。首先,创建并配置 Spring Boot 项目,实现后端 API;然后,使用 Ant Design Pro Vue 创建前端项目,配置动态路由和菜单。通过具体案例,展示了如何快速搭建高效、易维护的项目框架。
77 62
|
8天前
|
自然语言处理 Java API
Spring Boot 接入大模型实战:通义千问赋能智能应用快速构建
【10月更文挑战第23天】在人工智能(AI)技术飞速发展的今天,大模型如通义千问(阿里云推出的生成式对话引擎)等已成为推动智能应用创新的重要力量。然而,对于许多开发者而言,如何高效、便捷地接入这些大模型并构建出功能丰富的智能应用仍是一个挑战。
40 6
|
18天前
|
Java API Spring
springboot学习七:Spring Boot2.x 拦截器基础入门&实战项目场景实现
这篇文章是关于Spring Boot 2.x中拦截器的入门教程和实战项目场景实现的详细指南。
14 0
springboot学习七:Spring Boot2.x 拦截器基础入门&实战项目场景实现
|
18天前
|
Java API Spring
springboot学习六:Spring Boot2.x 过滤器基础入门&实战项目场景实现
这篇文章是关于Spring Boot 2.x中过滤器的基础知识和实战项目应用的教程。
16 0
springboot学习六:Spring Boot2.x 过滤器基础入门&实战项目场景实现
|
Java 测试技术 Spring
Spring入门&控制反转(或依赖注入)&AOP的关键概念& 多配置文件&与web集成(二)
Spring入门&控制反转(或依赖注入)&AOP的关键概念& 多配置文件&与web集成
|
3月前
|
XML Java 数据库
Spring5入门到实战------15、事务操作---概念--场景---声明式事务管理---事务参数--注解方式---xml方式
这篇文章是Spring5框架的实战教程,详细介绍了事务的概念、ACID特性、事务操作的场景,并通过实际的银行转账示例,演示了Spring框架中声明式事务管理的实现,包括使用注解和XML配置两种方式,以及如何配置事务参数来控制事务的行为。
Spring5入门到实战------15、事务操作---概念--场景---声明式事务管理---事务参数--注解方式---xml方式
|
SQL Java 关系型数据库
Spring入门&控制反转(或依赖注入)&AOP的关键概念& 多配置文件&与web集成(一)
Spring入门&控制反转(或依赖注入)&AOP的关键概念& 多配置文件&与web集成
130 0
|
2月前
|
SQL 监控 druid
springboot-druid数据源的配置方式及配置后台监控-自定义和导入stater(推荐-简单方便使用)两种方式配置druid数据源
这篇文章介绍了如何在Spring Boot项目中配置和监控Druid数据源,包括自定义配置和使用Spring Boot Starter两种方法。