SpringMVC是Spring中用于开发MVC项目的一个框架。
关于MVC
Model-View-Controller,曾经以为构成了一整个应用程序,不过这篇文章里的说明,让我的看法有了一些变化,MVC可以是应用的上层,而在M层之下,还可以有类似于Repository、UnitOfWord等数据访问层与Controller层交互。
SpringMVC
SpringMVC做了这几件事:
- 定义了请求入口处理程序
DispatcherServlet
,并由它来分发请求到不同的Controller
- 定义
Controller
,并定义Controller
要处理哪些请求(C层) Controller
处理请求,并将结果放入View
中返回(V层)- 辅助:如拦截请求进行一些处理,个人认为有点像SpringCore中的PostProcesser功能。
web.xml 程序入口配置
对java web程序的运行其实并不了解,但是整个SpringMVC的开始,是从一个web.xml文件的定义开始的。
其中最重要的就是servlet
标签,其中定义了servlet使用SpringMVC框架中的org.springframework.web.servlet.DispatcherServlet
。然后在request-mapping
配置标签中,引用servlet
定义,分发请求给不同的Controller
<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.xsd">
<display-name>Spring Web MVC Hello World Application</display-name>
<servlet>
<servlet-name>spring</servlet-name>
<servlet-class>
org.springframework.web.servlet.DispatcherServlet
</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring-servlet.xml</param-value>
</init-param>
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>spring</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
比如这里定义了一个叫spring
的servlet,然后在servlet-mapping
中,将所有路径的请求,都交给这个spring
servlet来处理。
还有一个重要的信息是servlet中的servlet-name
,在请求时,请求前需要增加这个名称在URL路径前,才会找到这个servlet。
web.xml的地址
SpringMVC似乎只能通过部署(比如部署到tomcat中)来运行,不像SpringCore程序可以直接运行jar包。
web.xml文件一定要放在工程的WEB-INF目录下,这似乎是一个约定。
而想要做到这点,如果在eclipse中,就需要创建一个WEB-INF文件夹,并配置这个文件夹作为部署文件夹,然后把web.xml放在这个目录中,这样eclipse会原样拷贝这个web.xml文件。
与spring core的结合
在servlet
节点配置中,有一个部分
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:spring-servlet.xml</param-value>
</init-param>
这其实是指定Spring Core的配置文件路径的。这里的classpath前缀语法,应该是SpringCore中Resource中的定位语法。
这也是springMVC和Spring有关联的地方,通过这种方式,SpringMVC应该内部会读取这个配置创建它使用的ApplicationContext。
另外这个配置文件的默认名称是servlet名字-servlet.xml
,默认的路径经过我的测试,应该是WEB-INF
目录,也就是和web.xml同一个目录(也就是说在eclipse中,和web.xml放在一起就好),如果满足这个条件,这个init-param
节点配置是可以省略的。
关于classpath
部署在tomcat中时,最终文件会有WEB-INF/classes
文件夹,所有源码编译出的jar包会在这个路径,这也是运行时的classpath。
如果像这个配置中,指定spring-servlet.xml
是在classpath
中,那么spring-servlet.xml
应该在源码中放置在src/main/java
目录下,也就是和源代码一个目录,因为这个目录生成的文件默认是会放到WEB-INF/classes
文件夹下的
Controller定义
这时就是@Controller
标记需要使用的地方了。
package com.mosakashaka.controller;
@Controller
@RequestMapping("/employee-module")
@SessionAttributes("employee")
public class EmployeeController {
@Autowired
EmployeeManager manager;
@RequestMapping(value = "/getAllEmployees", method = RequestMethod.GET)
public String getAllEmployees(Model model) {
model.addAttribute("employees", manager.getAllEmployees());
return "employeesListDisplay";
}
}
要使Controller被识别,也需要他能被找到,比如在上面的spring-servlet.xml
中配置<context:component-scan base-package="com.mosakashaka" />
。
Controller的路径
通过@RequestMapping
可以指定Controller中的方法对应哪个请求,这个标记可以加载方法或者类上,两者是拼接的关系,也可以只加在一个上面。
返回View
这里的getAllEmployees
方法返回了一个字符串,字符串是由InternalResourceViewResolver
类来找到对应的View文件的(一般是jsp文件)。
InternalResourceViewResolver
配置在spring-servlet.xml
中:
<bean
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/" />
<property name="suffix" value=".jsp" />
</bean>
猜想InternalResourceViewResolver
应该是SpringMVC框架依赖的一个Bean,这里的两个属性,定义了view如何被找到,这里就是在/WEB-INF/views/
文件夹下,将字符串增加.jsp
后缀,就是所需的view了。
结合之前提到的eclipse发布的路径,前面getAllEmployees
方法所需的employeesListDisplay
view于是也可以放在源代码的WEB-INF/views
目录下,叫employeesListDisplay.jsp
。
Controller的参数
似乎java中的参数也是一定程度的动态绑定。比如在Controller中定义这个方法:
@RequestMapping(value = "/addNew", method = RequestMethod.POST)
public String submitForm(@ModelAttribute("employee") EmployeeVO employeeVO, BindingResult result,
SessionStatus status) {
// Store the employee information in database
manager.addEmployee(employeeVO);
// Mark Session Complete
status.setComplete();
return "redirect:addNew/success";
}
@ModelAttribute("employee")
绑定了前台form
中modelAttribute
设定为employee
的对象值。
而BindingResult似乎是框架自带的参数。
与此类似,前面的
public String getAllEmployees(Model model) {
model.addAttribute("employees", manager.getAllEmployees());
return "employeesListDisplay";
}
这里的model应该也是框架中的参数,前台通过jstl可以获取这里设置的参数。
遇到的问题
中文乱码
最终通过设置页面中的charset:
<meta charset="UTF-8">
以及tomcat中的
<Connector port="8080" protocol="HTTP/1.1"
connectionTimeout="20000"
redirectPort="8443" useBodyEncodingForURI="true" URIEncoding="UTF-8" />
解决了。