Skip to content

Spring MVC

Jump to bottom
Calvin Xiao edited this page Nov 15, 2013 · 1 revision

##OverView SpringMVC回归MVC本质，简简单单的Restful式函数，没有任何基类之后，应该是传统Request-Response框架中最好用的了。

##Tips

1.事务失效的惨案

Spring MVC最打击新人的事情，你必须保证spring-mvc.xml的<context:component-scan>只扫描Controller，而 applicationContext.xml里的不包含Controller。否则你定义在applicationContext.xml里的事务就要失效了。方法如下：

spring-mvc.xml:

	<context:component-scan base-package="com.mycompany.myproject" use-default-filters="false">
		<context:include-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
	</context:component-scan>

applicationContext.xml:

	<context:component-scan base-package="org.springside.examples.quickstart">
		<context:exclude-filter type="annotation" expression="org.springframework.stereotype.Controller"/>
	</context:component-scan>

另外，定义在spring-mvc.xml里的对象，在applicationContext*.xml中是不可见的，想共享的东西最好放在applicationContext.xml那边。
而applicationContext*.xml里的一些BeanPostProccesor，也不会作用到spring-mvc.xml定义/扫描到的Bean上，如果有必要就在spring-mvc.xml里重新定义一次，像Shiro的AOP校验权限。

2.Struts2式的Preparable接口——表单仅包含领域对象的部分属性

Struts2有一个很实用的Preparable二次绑定功能： 表单提交时，先绑定一个ID，使用这个ID从数据库里找出对象来，再把表单中的其他属性绑定到这个对象上，对于那些表单中的输入框数量比领域对象的属性数少的情况很实用。

其实Spring MVC也有相同的能力， 见QuickStart示例中的UserAdminController：

先用@ModelAttribute标注如下函数。SpringMVC会在执行任何实际处理函数之前，执行该函数添加model attribute

	@ModelAttribute
	public void getUser(@RequestParam(value = "id", required = false) Long id) {
		if (id != null) {
		     model.addAttribute("user", accountService.getUser(id));
		}
		return null;
	}

再在update函数里，以@ModelAttribute标注表单处理函数的参数。SpringMVC就会按名称"user"取出前面的对象，然后才进行真正的Binding。

	@RequestMapping(value = "update", method = RequestMethod.POST)
	public String update(@Valid @ModelAttribute("user") User user,
                             RedirectAttributes redirectAttributes) {
		accountService.updateUser(user);
		redirectAttributes.addFlashAttribute("message", "更新用户" + user.getLoginName() + "成功");
		return "redirect:/admin/user";
	}

这里有个小坑爹的地方是，这个getUser()会在controller的所有函数前都执行，因此需要进行一下判断RequestParam中是否含id属性的判断，要不你就把update()方法独立到一个Controller中。

另外，你也可以选择不用这个功能，而是自己创建一个Form的DTO，然后用Dozer或手工把属性绑定到领域对象上。

3.Struts2式的FlashAttribute

为了防止用户刷新重复提交，save操作之后一般会redirect到另一个页面，同时带点操作成功的提示信息。因为是Redirect，Request里的attribute不会传递过去，如果放在session中，则需要在显示后及时清理，不然下面每一页都带着这个信息也不对。留意上面UserAdminController例子里那句redirectAttributes.addFlashAttribute()

4.CheckBox/RadioButtons的绑定

在采用ORM的应用中，如和绑定子对象到页面上，以及在表单提交时如何把checkbox的内容重新绑回父对象是一个头痛的问题。

在showcase示例中，User-Role组合中的Role是一个对象而不是简单的枚举(对于简单的枚举，什么都不用做，直接用checkboxes的taglib就可以了。

<form:checkboxes path="permissionList" items="${allPermissions}" itemLabel="displayName" itemValue="value" />

注意，如果使用BootStrap，SpringMVC自带的checkboxes标签并不合用，详见Twitter Bootstrap章节。

而复杂对象时对象就没这么好彩了，详见showcase中的UserControler首先你需要设定不要自动绑定checkbox结果到对象中

	@InitBinder
	protected void initBinder(WebDataBinder binder) {
		binder.setDisallowedFields("roleList");
	}

然后在输入参数中多注入一个roleList, 自行处理：

	@RequestMapping(value = "save/{userId}")
	public String update(@Valid @ModelAttribute("user") User user,
			@RequestParam(value = "roleList") List<Long> checkedRoleList) {
		user.getRoleList().clear();
		for (Long roleId : checkedRoleList) {
			Role role = new Role(roleId);
			user.getRoleList().add(role);
		}

		accountService.saveUser(user);
		return "redirect:/account/user";
	}

5.输出跨域Ajax所需的JsonP

网上说什么扩展JsonView什么的太复杂了，自己拿Jackson生成一个JsonP的字符串返回就好了。 更多JSONP信息见Ajax章节。

6.方法直接返回字符串时，中文字符乱码

因为方法定义直接返回字符串时(Html或Json内容)，调用的是StringHttpMessageConverter，而此Converter默认编码是ISO-85591，需要重新设为UTF-8。

	<mvc:annotation-driven>
		<mvc:message-converters register-defaults="true">
			<bean class="org.springframework.http.converter.StringHttpMessageConverter">
		    	    <constructor-arg value="UTF-8" />
			</bean>
  		</mvc:message-converters>
	</mvc:annotation-driven>

7.Spring MVC与Hibernate Validator的结合

见Validation章节，一般情况下使用JQuery Validation Plugin的客户端认证。为了防止恶意用户的攻击，可以再加上Spring MVC与Hibernate Validator的服务端认证。因为是用来防恶意攻击的，因此直接抛出异常，而不会返回输入页面且输出出错信息(如果Controller方法中有BindingResult的参数，就交由方法内部去处理，否则直接往外抛异常)。

  1. 在spring-mvc.xml中，加入hibernate validator的定义
  2. 在User.java的相关属性加入@NotBlank定义
  3. 在UserDetailController的save方法，加入@Valid定义和BindingResult参数。

8. 异常处理

原来Spring MVC的异常定义比较土，详见Exception handling for rest with spring3.2 ：

  • 按照如下列表，将Spring MVC的标准异常转换为4xx或5xx的http返回码，对异常本身不做处理如记日志，也不会把具体错误信息返回给客户端。
  • 非Spring MVC的异常，可以用@ResponseStatus(value = HttpStatus.NOT_FOUND) 标注返回码，但问题依然是无处理无错误信息。
  • 可以将Controller抛出的异常转到特定View, 保持SiteMesh的装饰效果:
	<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">  
		<property name="exceptionMappings">  
			<props>  
				<prop key="java.lang.Throwable">error/500</prop>
                        </props>
		</property>  
        </bean>
  • 可以在每个Controller内加上一个异常处理方法，并用@ExceptionHandler标注。但此法要每个Controller写，太分散太累了。
 @ExceptionHandler({ CustomException1.class, CustomException2.class })
    public void handleException() {
    }
  • 可以写一个自定义的HandlerExceptionResolver ，替代原来的，将所有的活都包过去。但这个又太集中了，整个War里只有一个Resolver，而且API是基于ModelAndView的，不适合做Restful的输出。

Spring MVC 3.2，终于补上了这块短板，合成了两种写法的优点，可以用@ControllerAdvice定义多个公共的ExceptionHandler类，每个Handler类可以用@ExceptionHandler(MyException1.class, MyException2.class)标注handler方法，只处理自己关心的异常，而且API变成了Restful友好的ResponseEntity。Quickstart中的RestExceptionHandler代码如下：

@ControllerAdvice
public class RestExceptionHandler extends ResponseEntityExceptionHandler {

	@ExceptionHandler(value = { ConstraintViolationException.class })
	public final ResponseEntity<?> handleException(ConstraintViolationException ex, WebRequest request)    {
		return new ResponseEntity(BeanValidators.extractPropertyAndMessage(ex.getConstraintViolations()),
				HttpStatus.BAD_REQUEST);
	}
}

9. WARNING: "Skipping URI variable 'id' since the request contains a bind value

造成这个Warning的原因是requestMapping中的url path如 update/{id}和表单中都有id 变量，这个时候，把url path改成别的名字就好了。

	@RequestMapping(value = "save/{userId}")

10. MediaType

无论Spring还是Jax-RS自带的MediaType类，都没有附加UTF-8的定义，Google Guava的MediaType类的类型又不是字符串，不能直接用于annotation，所以在springside-core里重新封装了一个MediaTypes类

##资料

  • Book: <Pro Spring MVC with Web Flow> 2012
Clone this wiki locally