Java框架之Spring MVC（二）

一、Spring MVC 验证

JSR 303 是ajvaEE6 中的一项子规范 ,叫 Bean Validation 用于对javaBean中的字段进行校验。

官方的参考实现是: Hibernate Validator ,此实现和 Hibernate ORM 没有任何关系  //http://hibernate.org/validator

Spring 3.x 也大力支持     JSR 303,使用的是  Hibernate Validator

1) 导包

4.3.1.Final 版本为例

// jboss-logging-3.1.0.CR2.jar

hibernate-validator-4.3.1.Final.jar

jboss-logging-3.1.0.jar、

validation-api-1.0.0.GA.jar

2) 配置文件

<mvc:annotation-driven validator="validator" />
    
<bean id="validator" class="org.springframework.validation.beanvalidation.LocalValidatorFactoryBean">
                <property name="providerClass"  value="org.hibernate.validator.HibernateValidator"/>
                <property name="validationMessageSource" ref="validatemessageSource"/> //不设置则默认为classpath下的 ValidationMessages.properties
</bean>
               
<bean id="validatemessageSource" class="org.springframework.context.support.ReloadableResourceBundleMessageSource">  
               <property name="basename" value="classpath:validatemessages"/>  //配置验证信息资源文件的路径
               <property name="fileEncodings" value="utf-8"/>  
               <property name="cacheSeconds" value="120"/>   //缓存时间
</bean>

3) 创建校验信息用的资源文件,本例在类路径(src或config)下直接创建即可

validatemessages.properties 内容

name.not.empty=名字不能为空

age.not.inrange=年龄要在合适的范围内

email.not.correct=邮箱格式不正确

email.not.empty=邮箱不能为空

4) 在实体类上,添加校验

 public class UserInfo {
                    private  int id;
                    
                    @NotNull(message="用户名不能为 null")
                    @NotEmpty(message="{name.not.empty}")
                    @Pattern(regexp="13\d{9}",message="用户名是按手机验证的格式不对")
                    private String userName;   
                    
                    @Size(min=3,max=6,message="{password.not.inrange}")
                    private String password;
                    
                    @NotEmpty(message="{email.not.empty}")
                    @Email(message="{email.not.correct}")
                    private String note;
                    private String aihao;
                        
            //也可以将规则添在get 方法上    

5) 控制器 

//在添加用户这个请求提交上来的时候
@RequestMapping(value="/addUser" ,method=RequestMethod.POST)
public String addUser(Model model, @Valid UserInfo user,BindingResult bResult){
                        if(bResult.hasErrors()){
                            List<ObjectError> errorList=    bResult.getAllErrors();
                            for(ObjectError e:errorList){
                                System.out.println(e.getDefaultMessage());
                            }
                            
                            model.addAttribute("errorList",errorList); //把错误信息传到前台
                            return "user_add";
                        }
                        
                        else{
                            return "success";
                        }
                    } 

说明: BindingResult 是Errors的子类

@Valid  和  BindingResult 的位置不要写反

@Valid  写成了 @Validated 实测也可以

6) 前端页面

<c:forEach var="e" items="${errorList }">
                       ${e.defaultMessage}
                       </c:forEach>
                                   
                   <form action="${pageContext.request.contextPath }/addUser" method="post">
                   账号:    <input type="text" name="userName"  /> 
                   密码:  <input type="text" name="password"  /> 
                   备注:  <input type="text" name="note" /> 
                          <input type=submit value="提交" />
                   </form>

例子 如何详细的显示出错信息

新建页面 user_add_validate.jsp

 <%@ taglib uri="http://www.springframework.org/tags/form" prefix="x" %>
         <x:form method="post" action="${pageContext.request.contextPath }/addUser">
           账号:<x:input path="userName" /> <x:errors path="userName" /><br>
            密码:<x:input path="password" /> <x:errors path="password" /> <br>
           备注:<x:input path="note" /><x:errors path="note" /> <br>
           <input type=submit value="提交" />
    </x:form>

问题:

1) 如果直接访问  user_add_validate.jsp 出现错误 

//java.lang.IllegalStateException: No WebApplicationContext found: no ContextLoaderListener registered?

原因是Spring环境没初始化

<context-param>    
<param-name>contextConfigLocation</param-name>    
<param-value>classpath:springmvc-servlet.xml</param-value>    
</context-param>
<listener>    
         <listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>

2) 需要指定  modelAttribute="user" 这个属性

<x:form method="post" action="${pageContext.request.contextPath }/addUser" modelAttribute="user"  >
//上面也可以写成 commandName="user"

3) 不能直接访问 user_add_validate.jsp 要这样:

@RequestMapping(value="/addUser",method=RequestMethod.GET)
public String addUser(@ModelAttribute("user") UserInfo user){   //@ModelAttribute("user") 必加
                return "user_add_validate";
}

4) 添加用户的方法要如下

@RequestMapping(value="/addUser" ,method=RequestMethod.POST)
                public String addUser( @ModelAttribute("user") @Valid UserInfo user,BindingResult bResult){
                    if(bResult.hasErrors()){
                        return "user_add_validate";
                    }
                    else{
                        return "success";
                    }
                } 

附加：

分组校验

问题: 当一个pojo类被多个业务方法使用,但它的验证规则不同,如何处理？

可以采用分组校验

1)定义分组 (其实就是定义接口,空接口就可以,一个接口就是一个分组)

public interface IVG1, IVG2

2)在pojo类上指定校验属于哪个分组

public class UserInfo(
@NotEmpty(message="用户名不能为 null",groups={IVG1.class})

@Size(min=3,max=6,message="{password.not.inrange}",groups={IVG1.class,IVG2.class})
private String password;
                 ...
            }

3)在业务方法上指定验证的时候使用哪个分组

@RequestMapping(value="/addUser" ,method=RequestMethod.POST)
public String addUser( @ModelAttribute("user") @Validated(value=IVG1.class) UserInfo user,BindingResult bResult){
                    if(bResult.hasErrors()){
                        return "user_add_validate";
                    }
                    else{
                        return "success";
                    }
                } 
//注意,用的是  @Validated 注解 不是 @Valid

二、Spring MVC 数据的回显

（其实上例就是带数据回显的)

pojo类型的数据回显

@RequestMapping(value="/addUser" ,method=RequestMethod.POST)
public String addUser( @ModelAttribute("user") UserInfo user){
                      ....
                    } 

 页面的 from上也要加 modelAttribute 或 commondName

<x:form action="${pageContext.request.contextPath }/test" method="post" modelAttribute="user">
<x:input path="userName" />  //注意,要回显示的数据必须用 这样的标签
<x:input path="password" />
</x:form>

 对于简单类型

用 model.addAttribute(...)  即可

三、Spring MVC 异常处理

SpringMVC 提供全局异常处理器进行统一的异常处理

1) 在controller(Action)内部处理异常

-- login.jsp

 <form action="user/login" method="post" >
                        账号:<input type="text" name="userName" /> 
                        密码:<input type="text" name="password" />
                        <input type="submit" />

-- 自定义异常类 //不定义也可以

public class MyException extends Exception{
                        private String msg;
                        public MyException(String msg){
                            super(msg);
                            this.msg=msg;
                        }
                        
                        public void writeLog(){
                            System.out.println("---异常信息"+this.msg+"已经记录-");
                        }
                    
                    }

-- action 中的处理

@RequestMapping(value="/login")
public String login(HttpSession session,String userName,String password) throws MyException {
                        UserInfo user=new UserDao().getLoginUser(userName, password);
                        if(user==null){
                            throw new MyException("用户登录失败");  //如果登录失败,抛出异常
                            }
                            session.setAttribute("user", user);
                            return "success";
                        }
                        
                        @ExceptionHandler(value={MyException.class}) //这里是进行异常处理的地方
                        public String exectionProcessAAA(MyException e,HttpServletRequest request){
                        request.setAttribute("e_msg", e.getMessage());
                        e.writeLog();
                        return "error" ;  //全局的一个异常处理页面    
                    }

2) 全局异常处理

--在配置文件中加入配置

<bean id="exceptionResolver" class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">     
<property name="exceptionMappings">     
    <props>     
    <prop key="cat.beans.MyException">error_process_1</prop>   //可以看到,可以为每种异常指定一个result视图
    <prop key="java.lang.Exception">error_process_2</prop>     
    <prop key="java.lang.Throwable">error_process_3</prop>     
    </props>     
</property>     
</bean>  

在异常处理页面

${exception.message}  //这样即可取出异常信息

四、Spring MVC 文件上传

1) 单文件上传

== 在配置文件中

<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver" >
                 <property name="defaultEncoding" value="UTF-8" />  //这里面的这些属性可以不用,一个都不写也不会出错
                 <property name="maxUploadSize" value="5400000" />
                 <property name="uploadTempDir" value="uploadTempDir" />
</bean>

== 页面

<form method="post"  action="${pageContext.request.contextPath }/addUserWithImg"    enctype="multipart/form-data" >  
                   <input name="userName" /> 
                   <input name="password"/>  
                   <input name="note"/>  
                   <input type="file" name=upfile />  //注意,这个名字
                   <input type="submit" >
           </form> 

 == 控制层

@RequestMapping(value="/addUserWithImg",method=RequestMethod.POST)
public String addUserWithImg(UserInfo user,MultipartFile upfile /*注意这个名字要和表单元素同名*/ ,HttpServletRequest request ) 
                             throws IllegalStateException, IOException{
       System.out.println(upfile);
       System.out.println("contentType:"+upfile.getContentType()); //image/pjepg
       System.out.println("name:"+upfile.getName()); //photo
       System.out.println("getOriginalFilename:"+upfile.getOriginalFilename()); //zhangsan.jpg
       System.out.println("getSize:"+upfile.getSize());

       new UserDao().addUser(user);
                        
       String path=request.getServletContext().getRealPath("/upload_files");
       File targetFile=new File(path, upfile.getOriginalFilename());
                        
       upfile.transferTo(targetFile);
                
       return "success";
}

2) 多文件上传  

<form method="post"  action="${pageContext.request.contextPath }/addUserWithMultImg"    enctype="multipart/form-data" >  
                       <input name="userName" /> 
                       <input name="password"/>  
                       <input name="note"/>  
                       
                       <input type="file" name=upfiles />
                       <input type="file" name=upfiles />
                       <input type="file" name=upfiles />
                       <input type="file" name=upfiles />
                       
                       <input type="submit" >
               </form> 

//注意要加上  @RequestParam
public String ddUserWithMultImg(UserInfo user,@RequestParam("upfiles") MultipartFile [] upfiles ,HttpServletRequest request )
                                throws IllegalStateException, IOException{
                    new UserDao().addUser(user);
                    String path=request.getServletContext().getRealPath("/upload_files");
                    
                    for(MultipartFile f:upfiles){        
                        if(!f.isEmpty()){
                            File targetFile=new File(path, f.getOriginalFilename());
                            f.transferTo(targetFile);
                        }
                    }
                    
                    return "success";
                }

五、Spring MVC 资源文件的引入

在配置文件中：

<mvc:resources location="/images/" mapping="/images/**" />
<mvc:resources location="/css/" mapping="css/**" />
//也可以放在一个文件夹中,统一的引入,如
<mvc:resources location="/resource/" mapping="resource/**" />

六、Spring MVC 关于json数据处理

1) 传统方式的 ajax访问和响应

//请求发起页面  ajax_test.jsp
$(function(){
$("#btn1").click(function(){
$.ajax({
        url:"testAjax",
        type:"post",
        data:{userName:'admin',password:'123'},
        async:false,
        cache:false,
        dataType:"json",
        success:function(data){
        //alert(data);
        alert(data.id);
        alert(data.note);
                            }
                        });
                    });
                });
        
@RequestMapping("/testAjax")
public void testAjax(HttpServletRequest request,HttpServletResponse response) throws IOException{
                String userName=request.getParameter("userName");
                String password=request.getParameter("password");
                System.out.println(userName+":"+password);
                
                response.setContentType("text/html;charset=utf-8");
            //response.getWriter().print("这是普通数据");
                
                String jsonStr="{"note":"这是备注","id":"90"}";
                response.getWriter().print(jsonStr);
            }

附注: 

@RequestBody 用来处理application/json 类型的请求内容

使用 @ResponseBody 的方式返回json 格式的数据

要导入包 spring mvc 4.1.4

jackson-annotations-2.4.4.jar、

jackson-core-2.4.4.jar、

jackson-databind-2.4.4.jar。

附 3.1 用的是

jackson-core-asl-1.9.11.jar 

jackson-mapper-asl-1.9.11.jar

//例一 从服务端查询出一个userInfo对象返回
             //服务端
                @RequestMapping("/testAjax2") @ResponseBody  //这里用 @ResponseBody 注解声明返回json数据
                public UserInfo testAjax2(UserInfo u) {
                    UserInfo user=new UserDao().getLoginUser(u.getUserName(), u.getPassword());
                    return user;
                }
             //客户端
                 $.ajax({
                    url:"testAjax2",
                    type:"post",
                    data:{userName:'aaa',password:'aaa'},  //在服务端,用的是pojo类型的对象接收的参数
                    async:false,
                    cache:false,
                    dataType:"json",
                       success:function(data){
                        alert(data.id);
                        alert(data.note);
                    }
                });

//例二 从服务端查询一组对象返回
                @RequestMapping("/testAjax3") @ResponseBody
                public List<UserInfo> testAjax2() {
                    List<UserInfo> userList=new UserDao().getAllUser();
                    return userList;
                }
                                        
              $("#btn3").click(function(){
                        $.ajax({
                            url:"testAjax3",
                            type:"post",
            
                            async:false,
                            cache:false,
                            dataType:"json",
                            success:function(userList){ //从服务端返回的是一组对象
                                $.each(userList,function(key,user){
                                    $("#div1").append(user.id +"-"+user.userName+"-"+user.password+"<br />");
                                });
                            }
                        });
                    });

七、Spring MVC中 RESTful 风格

REST这个词，是Roy Thomas Fielding在他2000年的博士论文中提出的，HTTP协议（1.0版和1.1版）的主要设计者、Apache服务器软件的作者之一、Apache基金会的第一任主席。长期以来，软件研究主要关注软件设计的分类、设计方法的演化，很少客观地评估不同的设计选择对系统行为的影响。而相反地，网络研究主要关注系统之间通信行为的细节、如何改进特定通信机制的表现，常常忽视了一个事实，那就是改变应用程序的互动风格比改变互动协议，对整体表现有更大的影响。我这篇文章的写作目的，就是想在符合架构原理的前提下，理解和评估以网络为基础的应用软件的架构设计，得到一个功能强、性能好、适宜通信的架构

REST，即Representational State Transfer的缩写。我们对这个词组的翻译是"表现层状态转化"。 

如果一个架构符合REST原则，就称它为RESTful架构。关于 Representational State Transfer (表现层状态转化) 的理解。

1)REST的名称"表现层状态转化"中，省略了主语。"表现层"其实指的是"资源"（Resources）的"表现层"。

网络上的一个具体信息,可以用一个URI（统一资源定位符）指向它

2) Representation 表现层

"资源"是一种信息实体，它可以有多种外在表现形式。我们把"资源"具体呈现出来的形式，叫做它的"表现层"（Representation）。

比如，文本可以用txt格式表现，也可以用HTML格式、XML格式

URI只代表资源的实体，不代表它的形式。严格地说，有些网址最后的".html"后缀名是不必要的 因为这个后缀名表示格式，属于 "表现层" 范畴，而URI应该只代表"资源"的位置。它的具体表现形式，应该在HTTP请求的头信息中用Accept和Content-Type字段指定，这两个字段才是对"表现层"的描述。

3) State Transfer 状态转化

HTTP协议，是一个无状态协议。这意味着，所有的状态都保存在服务器端。因此，如果客户端想要操作服务器，必须通过某种手段，让服务器端发生"状态转化"（State Transfer）。而这种转化是建立在表现层之上的，所以就是"表现层状态转化"。客户端用到的手段，只能是HTTP协议。具体来说，就是HTTP协议里面，四个表示操作方式的动词：GET、POST、PUT、DELETE。它们分别对应四种基本操作：

GET用来获取资源，POST用来新建资源（也可以用于更新资源），PUT用来更新资源，DELETE用来删除资源。

综合上面的解释，我们总结一下什么是RESTful架构：

（1）每一个URI代表一种资源；

（2）客户端和服务器之间，传递这种资源的某种表现层；

（3）客户端通过四个HTTP动词，对服务器端资源进行操作，实现"表现层状态转化"。

http://localhost:8080/myweb/userAction_show.action?id=5  

rest 风格 

http://www.douban.com/photos/album/49432287/   这是豆瓣上的url rest风格

查询用户

http://localhost:8080/myweb/user/5 

删除用户

http://localhost:8080/myweb/user/5/delete

//例子

@RequestMapping("/get_user/{id}/{flag}")
public String getUser(@PathVariable("id") int idAAA, @PathVariable("flag") String flagAAA){
                        System.out.println(idAAA +":"+flagAAA);
                        return "success";
                    }

 请求的url

http://localhost:8080/springmvc-03/get_user/10/search

如果不传  PathVariable 指定的参数,会报404

八、Spring MVC 拦截器

SpringMVC 中的Interceptor 拦截器也是相当重要和相当有用的，它的主要作用是拦截用户的请求并进行相应的处理。比如通过它来进行权限验证，或者是来判断用户是否登陆，或者是像12306 那样子判断当前时间是否是购票时间。

方式一: 用实现 HandlerInterceptor  接口的方式

方式二: 继承抽象类HandlerInterceptorAdapter  (Spring 提供的类,它实现了 HandlerInterceptor)

方式三: 实现WebRequestInterceptor 接口或继承实现了该接口的类

例子:

1) 拦截器声明

public class MyInterceptor implements HandlerInterceptor {
            /*==在Controller 方法被调用之前执行,一般用来进行身份验证,授权等
              == SpringMVC中的Interceptor 拦截器是链式的，可以同时存在多个Interceptor,并根据声明的前后顺序依次执行
              == 而且所有的Interceptor中的 preHandle 方法都会在 Controller方法调用之前调用
              == SpringMVC的这种Interceptor链式结构也是可以进行中断的，preHandle的返回值为false的时候整个请求就结束了 */
            public boolean preHandle(HttpServletRequest arg0, HttpServletResponse arg1,
                    Object arg2) throws Exception {
                System.out.println("preHandle");
                return true;
            }
        
            /* 一般在处理公用的模型数据,统一指定视图等操作的时候用
             == 在preHandle方法返回值为true的时候才会执行。
             == 它的执行时间是在是在Controller的方法调用之后，DispatcherServlet进行视图的渲染之前执行
             == 可以对ModelAndView进行操作。
             == 这个方法的链式结构跟正常访问的方向是相反的,也就是说先声明的Interceptor拦截器该方法反而会后调用，这跟Struts2里面的拦截器的执行过程有点像          
            */
            public void postHandle(HttpServletRequest arg0, HttpServletResponse arg1,
                    Object arg2, ModelAndView modelAndView) throws Exception {
                System.out.println("postHandle");    
            }
            
            /*
             == 在preHandle方法返回值为true的时候才会执行。
             == 该方法将在整个请求完成之后，也就是DispatcherServlet渲染了视图执行，  
             == 这个方法的主要作用是用于清理资源的，统一的日志及异常处理等    */
            public void afterCompletion(HttpServletRequest arg0,
                    HttpServletResponse arg1, Object arg2, Exception arg3)
                    throws Exception {
                System.out.println("afterCompletion");    
            }
        }

 2) 在配置文件中加入配置

<mvc:interceptors>   
//如果有 多个拦截器,顺序执行   
<mvc:interceptor>   
// 如果不配置或/*,将拦截所有的Controller
<mvc:mapping path="/searchall_forupdate" /> path 配置拦的是请求的url
//<mvc:mapping path="/**" /> 所有的url包扩子url 
<bean class="cat.interceptor.MyInterceptor"></bean>   
</mvc:interceptor>   

</mvc:interceptors> 

//例子,验证用户是否登录
        public class MySessionInterceptor implements HandlerInterceptor {
                    public void afterCompletion(HttpServletRequest arg0,
                            HttpServletResponse arg1, Object arg2, Exception arg3)
                            throws Exception {    }
                
                
                    public void postHandle(HttpServletRequest arg0, HttpServletResponse arg1,
                            Object handler, ModelAndView arg3) throws Exception {}
                
                
                    public boolean preHandle(HttpServletRequest request, HttpServletResponse response,
                            Object obj) throws Exception {
                        String url=request.getRequestURI();
                        System.out.println(url);
                        if(url.contains("login")){  //如果用户发的是登录的请求,则直接放行
                            return true;
                        }
                        else{
                            UserInfo user=(UserInfo)request.getSession().getAttribute("user");
                            if(user!=null){
                                return true;
                            }
                            else{
                                request.setAttribute("msg", "请登录");
                                request.getRequestDispatcher("login.jsp").forward(request, response);
                                return false;
                            }
                        }
                    }

上面的拦截器的配置文件

<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**" />
    <bean class="cat.interceptor.MyInterceptor"></bean>
</mvc:interceptor>
                    
<mvc:interceptor>
<mvc:mapping path="/**" />
    <bean class="cat.interceptor.MySessionInterceptor"></bean>
</mvc:interceptor>
</mvc:interceptors>