SpringMVC传统风格控制器和基于注解的控制器
SpringMVC的DispatcherServlet
之前说过springMVC是使用Servlet作为控制器,就是这个用于调度的DispatcherServlet了。这个是servlet,可以根据URI调用相应的action,接受请求做出相应。要使用这个servlet,需要在部署描述符(web.xml文件)中使用servlet和servlet-mapping元素来配置:
<!--配置前端控制器 -->
<servlet>
<servlet-name>springDispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!--指定springmvc配置文件位置 -->
<!-- <init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param> -->
<!--使用默认配置:位置/WEB-INF/<servlet-name>-servlet.xml -->
<load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
<servlet-name>springDispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
load-on-start元素是可选的,如果它存在,则它将在应用程序启动的时候装载servlet并调用它的init方法。若不存在,则在该servlet 的第一个请求时加载。 url-pattern 值为/ ,表明所有请求都交给这个调度servlet来处理。
DispatcherServlet将使用SpringMVC诸多的默认组件,在默认情况下,它会寻找在应用程序的WEB-INF目录下的一个配置文件,该配置文件命名是有要求的:
servletName-servlet.xml
其中,servletName是部署描述符中的DispatcherServlet的名称。
其实可以把这个配置文件放在应用程序目录中的任何地方,只需要告诉DispatcherServlet在哪里可以找到这个配置文件即可.我们使用servlet声明下的一个init-param元素可以做到这一点。init-param拥有一个名为contextConfigLocation的param-name元素,其param-value元素则包含配置文件的路径。
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
旧版springMVC程序开发
在spring2.5前,开发一个控制器唯一的方法是实现org.springframework.web.servlet.mvc.Controller接口。这个接口公开了一个handlerRequest方法。方法签名如下:
ModelAndView handlerRequest(HttpServletRequest request,HttpServletResponse response)
实现类可以访问对应请求和响应,还必须返回一个ModelAndView对象,它包含视图路径和模型数据。
值得说的是:springMVC依赖于Apache Commons Logging组件,没有这个jar,springMVC就无法正常工作。
还需要在springMVC的配置文件中配置请求和所对应的控制器:
Spring MVC配置文件
<?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:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd"> <!--name:请求URI value:对应的控制器-->
<bean name="/save" class="cn,lynu.controller.SaveController"></bean> </beans>
实现Controller接口只能处理一个单一动作(action),也就是在handlerRequest方法中处理动作。而实现注解的控制器可以支持多个请求动作,而且无需实现任何接口。
基于注解的控制器
使用基于注解的控制器的优点:
其一:一个控制器类可以处理多个动作(而实现了Controller接口的实现类只能处理一个动作)。这就允许将相关的操作写在同一个类中,从而减少应用中类的数量。
其二:基于注解的控制器的请求不需要配置在配置文件中。使用@RequestMapping可以对一个方法进行请求映射。
Spring使用扫描机制来找到程序中所有的基于注解的控制器,为了spring可以找到你的控制器,需要完成两件事:
- 在配置文件中声明使用context,也就是引入spring-context约束。
- 使用组件扫描标签:<context-component-scan>
<!-- 配置扫描的包-->
<context:component-scan base-package="cn.lynu.controller"></context:component-scan>
@RequestMapping注解
@RequestMapping注解的作用同其名字一样:映射一个请求和一个方法。可以使用@RequestMapping注解一种方法或类。使用该注解的value属性将URI映射到方法上,由于value属性是默认属性,所以只有唯一的属性,则可以省略属性名称,但是有多个属性时,就必须写入value属性名称。请求映射到值可以是一个空字符串,此时该方法被映射到以下地址:
http://domain/context
RequestMapping除了具有value属性外,还有其他属性,如:method属性用来指示方法仅处理哪些HTTP方法。
如果使用该注解注解一个类,在这种情况下,该类的所有方法都将映射为相对于类级别的请求,也就是访问需要加上类的请求地址。
请求处理方法
每个请求处理方法都可以有任意多个不同类型的参数,以及一个多种类型的返回结果。
部分可以出现在请求处理方法的形参:
- javax.servlet.ServletRequest 或 javax.servlet.http.HttpServletRequest
- javax.servlet.ServletRresponse或 javax.servlet.http.HttpServletResponse
- javax.servlet.http.HttpSession
- java.io.InputStram 或 java.io.Reader
- java.io.OutputStream 或 java.io.Writer
- java.util.Map/org.springframework.ui.Model
- org.springframework.ui.ModelMap
- org.springframework.web.servlet.ModelAndView
- POJO/表单对象
- @PathVariable,@RequestParam,@RequestHeader,@RequestBody,@CookieValue注释的对象
...
部分可以做为处理方法返回类型的对象:
- ModelAndView
- void
- Model
- 包含模型数据的Map
- 包含逻辑视图名的String
- ModelMap
- Callable
...
配置处理静态资源和功能
因为我们将DispatcherServlet的servletMapping设置为“/”,所有的请求都会交给spring处理,所以为了可以正确处理静态资源,需要在springMVC的配置文件配置<mvc:default-servlet-handler/>,表明静态资源需要单独处理(不通过DispatcherServlet)
我们在配置一个<mvc:annotation-driven/>,用于支持一些功能,如JSR303校验,注册用于控制器注解的bean对象等等,这个标签较为有用。
这两个标签较为常用,所以一般都需要配置:
<!--两个标准配置 -->
<!-- 将springmvc不能处理的请求交给tomcat -->
<mvc:default-servlet-handler/>
<!-- 能支持springmvc更高级的一些功能,JSR303校验,快捷的ajax...映射动态请求 -->
<mvc:annotation-driven/>
使用注解进行依赖注入
之前我们说过了最基本的构造注入和setter注入,使用注解也是可以的,我之前在使用SSH整合的时候在Controller中使用 @Resource和service层使用@Service ,其实也可以使用@Autowired 和service层使用@Service。其实 @Resource和@Autowired作用是一样的,@Resource还需要指定name值,所以我们使用@Autowired即可。
重定向传值
我们都知道请求域中的数据再转发之后还可以获得,但是重定向之后就不行了,原理这里就不分析了。在springMVC 3.1版本之后可以添加一个新的参数类型org.springframework.web.servlet.mvc.support.RedirectAttributes。这称之为通过Flash属性提供一种重定向传值的方法。
@RequestMapping("/testRedirect")
public String testRedirect(RedirectAttributes redirectAttributes) {
redirectAttributes.addFlashAttribute("userName", "lz");
return "redirect:/WEB-INF/view/success.jsp";
}
重定向目标方如果是Controller,则使用Map/Model/ModelMap根据key取值即可,无法使用RedirectAttributes对象取到这个值;如果目标方是JSP,使用EL(${sessionScope.org.springframework.web.servlet.support.SessionFlashMapManager.FLASH_MAPS[0].userName})直接将数据取出来即可。
请求参数和路径变量
请求参数和路径变量都可以用于发送值给服务器,二者都是URL的一部分。
请求参数使用key=value形式,并用“&” 分割。在传统servlet编程中,可以使用HttpServletRequest的getParameter方法获得一个请求参数值。springMVC提供了一个更为简单的方法,使用org.springframework.web.bind.annotation.RequestParam注解类型来注解方法参数。
/**
* 测试@RequestParam
*/
@RequestMapping("/testRequestParam")
public String testRequestParam(@RequestParam("userName")String userName,
@RequestParam(value="age",required=false,defaultValue="0")Integer age) {
System.out.println("userName:"+userName+" age:"+age);
return SUCCESS;
}
required=false表明这个属性不是必须的,默认情况下,required=true如果没有传入该值,会报异常。defaultValue说明如果该参数不存在的情况下的默认值。
请求URL:
<a href="h/testRequestParam?userName=lz&age=21">使用RequestParam注解</a><br><br>
路径变量类似于请求参数,但没有key部分,只有一个值。如以下的URL:
<a href="h/rest/1">REST get</a><br><br>
为了使用路径变量,首先需要在RequestMapping注解的值属性中添加一个变量,该变量必须放在花括号之间。@PathVariable注解来获得路径变量。
@RequestMapping(value="/rest/{id}",method=RequestMethod.PUT)
public String testRESTPut(@PathVariable("id")Integer id) {
System.out.println("id是:"+id);
return SUCCESS;
}
可以看到路径参数的对应形参类型可以不是String类型,springMVC会尽力转成我们所需的类型。
而且路径参数可以有多个:/rest/{id}/{userName}
但是路径参数可能会带来一个问题就是:在某些特殊情况下,如一个应用程序被部署为默认上下文(默认上下文路径就是一个空字符串),这种情况下,页面中的CSS/JS等路径如果使用相对路径就会找不到
,这时我们使用JSTL的<c:url value=“”>来解析URL可修复该问题:
<style type="text/css" href="<c:url value='/css/main.css'/>"></style>
@ModelAttribute
SpringMVC每次调用请求处理方法的时候,都会创建一个Model类型的实例,如果需要使用Model对象,只需在方法形参添加一个Model类型的参数即可。我们还可以通过@ModelAttribute注解来访问Model实例,这个注解是org.springframeword.eb.bind.annotation包的成员.
可以使用@ModelAttribute注解来修饰方法或方法的形参。
@ModelAttribute注解来修饰形参
@RequestMapping("/testModelAttribute")
public String testModelAttribute(@ModelAttribute("user")User user,Model model) {
System.out.println(user);
return SUCCESS;
}
表示将user对象放入到Model中,key为user,值为user对象,实际上可以不指定key,这时将使用参数类型首字母小写的key名。
@ModelAttribute注解来修饰非请求方法
修饰方法,但是这个方法只能是一个非请求的处理方法。被@ModelAttribute注解的方法会在每次调用该控制器类的请求处理方法之前被调用,这意味着,被@ModelAttribute注解的方法会多次被调用,不论是否需要。
被@ModelAttribute注解的方法可以返回一个对象或void类型。
1.如果返回一个对象,则这个会自动添加到Model中。
@ModelAttribute
public User getUser() {
//模拟从数据库中获得数据
return new User(1, "lz", 21);
}
2.如果返回void,则需要添加一个Model类型的参数,需要自行将实例添加到Model中。
@ModelAttribute
public void getUser(Model model) {
model.addAttribute(new User(1, "lz", 21));
}
推荐使用返回为void自行添加入Model的方式,因为这样我们可以进行判断空值就不放入Model:
@ModelAttribute
public void getUser(@RequestParam(value="id",required=false) Integer id,Model model) {
if(id==null) {
return;
}
model.addAttribute(new User(1,'"lz",21));
}
因为被@ModelAttribute注解的方法会多次被调用,有这样的需求可能会用到:
表单提交过来的值,我们不想让其修改某一项(如password),如果只是根据表单传过来的值封装为一个POJO,那么这个POJO的password项是为null的,因为我们不想让用户修改,所以这项就不会显示出来,但是用户填完表单之后需要修改保存进数据库,如果password为null,就将密码搞掉了,这并不是我们想要的,这是可以使用@ModelAttribute注解来修饰非请求方法,我们在表单添加一个隐藏域,隐藏域值就是id吧,@ModelAttribute注解修饰的非请求方法会在请求方法之前调用,所以我们可以拿着这个id从数据库中查出该用户,然后将其存入Model,请求处理方法在从Model中拿到该对象根据表单提交过来的值覆盖对应的值即可,这样就不将password值置为空了。
/**
* 测试ModelAttribute
*/
@ModelAttribute
public User getUser(@RequestParam(value="id",required=false)Integer id) {
if(id==null){
return;
}
//模拟从数据库中获得数据
return new User(1, "lz", 21);
}
@RequestMapping("/testModelAttribute")
public String testModelAttribute(User user) {
System.out.println(user);
return SUCCESS;
}
一定要加上required=false,因为其他请求方法之前也会调用该方法,所以不设置为false会报异常,其他的请求处理方法就用不成了。
在页面上使用一个表单来供用户修改除了password的值:
<form action="h/testModelAttribute" method="post">
<input name="id" type="hidden" value="1"/>
姓名:<input type="text" name="userName" value="lz"/></br>
<input type="submit" value="Submit"/>
</form><br><br>
这样修改保存在数据库中的password值也不会置空了。
最新文章
- C和C++混合编程中的extern ";C"; {}
- MySQL操作类(本人自己写的)
- 浅析Dagger2的使用
- MSDN for VS2012 的安装
- NSUserDefaults简介及使用
- html和css中的技巧
- HDOJ2021发工资咯:)
- JS当前日期相加相减
- RAII(Resource Acquisition Is Initialization)资源获得式初始化
- 反对抄袭 正解spring的@Autowired 不要相信网上的错误版本
- 转Delphi中Memo显示行号列号
- 将bbr功能合入到centos7.3
- 版本控制工具--svn和git的使用(一) -----版本控制的好处以及分类
- Go语言编程读书笔记:Go channel(2)
- A股主要指数的市盈率(PE)估值高度
- mips32和x86下的大小端模式判定
- win2008 server ping不同
- Word 2003-在一个方框里打勾或打叉
- Spring Security构建Rest服务-0102-Spring Social开发第三方登录之qq登录
- java-mybaits-00102-mybatis框架原理