SI 系列入门 之 手把手构建 Spring MVC 工程
太阳火神的美丽人生 (http://blog.csdn.net/opengl_es)
本文遵循“署名-非商业用途-保持一致”创作公用协议
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 的上传,分享给大家。