SpringMVC入門（二）—— 參數的傳遞、Controller方法返回值、json數據交互、異常處理、圖片上傳、攔截器

一、參數的傳遞

1、簡單的參數傳遞

 /* @RequestParam用法：入參名字與方法名參數名不一致時使用{
  *     value:傳入的參數名，required：是否必填,defaultValue:默認值
 * }
 */
 @RequestMapping("itemEdit")
 public ModelAndView itemEdit(@RequestParam(value="id",required=true,defaultValue="1")Integer id){....}

2、Model/ModelMap

/**
 * 演示返回String，通過Model/ModelMap返回數據模型
 * 跳轉修改商品信息頁面
 * @param id
 * @return
 */
 @RequestMapping("itemEdit")
 public String itemEdit(@RequestParam("id")Integer ids,Model m,ModelMap model){ 
     //查詢商品信息
     Item item = itemServices.getItemById(ids);
     //通過Model把商品數據返回頁面
     model.addAttribute("item", item);
     //返回String視圖名字
     return "itemEdit";
 }

3、pojo與包裝pojo

要點：表單提交的name屬性必需與pojo的屬性名稱一致。

/**
 * 演示傳遞pojo參數
 * 更新商品信息
 * @return
 */
 @RequestMapping("updateItem")
 public String updateItem(Item item,Model model){
      //更新商品
      itemServices.update(item);
      //返回商品模型
      model.addAttribute("item", item);
      //返回擔任提示
      model.addAttribute("msg", "修改商品成功");
      //返回修改商品頁面
      return "itemEdit";
 }

4、自定義參數綁定

①自定義轉換器

/**
 * 日期轉換器
 * S:source 要轉換的源類型
 * T:目標，要轉換成的數據類型
 * @author Steven
 */
public class DateConvert implements Converter<String, Date> {

    @Override
    public Date convert(String source) {
        Date result = null;
        try {
            SimpleDateFormat sdf = new SimpleDateFormat("yyyy-MM-dd HH:mm:ss");
            result = sdf.parse(source);
        } catch (ParseException e) {
            e.printStackTrace();
        }
        return result;
    }
}

 ② 配置日期轉換器

<!-- 配置注解驅動，相當於同時使用最新處理器映射跟處理器適配器,對json數據響應提供支持 -->
    <!-- 使用自定義轉換器 -->
    <mvc:annotation-driven conversion-service="MyConvert" />
    
    <!-- 定義轉換器 -->
    <bean id="MyConvert" class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
        <property name="converters">
            <set>
                <bean class="com.cenobitor.springmvc.utils.DateConvert" />
            </set>
        </property>
    </bean>

5、數組參數傳遞

@RequestMapping("/queryItem")
public String queryItem(QueryVo vo,Integer[] ids){
     System.out.println(vo);
     if (ids != null && ids.length > 0){
        for (Integer id : ids) {
            System.out.println(id);
        }
      }
      return "itemList";
}

二、Controller方法返回值

1、返回ModelAndView

@RequestMapping("itemList")
public ModelAndView queryItemList(){

    ModelAndView modelAndView = new ModelAndView();
    modelAndView.setViewName("itemList");
    List<Item> list = itemService.getItemList();
    modelAndView.addObject("itemList",list);
    return modelAndView;
}

2、返回void：使用原始的request、response處理

3、返回String 

①返回視圖的名字

②轉發，跳轉action

@RequestMapping(value = "updateItem",method = RequestMethod.POST)
public String updateItem(Item item, Model model){
　　model.addAttribute("item",item);
　　return "forward:/itemEdit.action";
}

③重定向，跳轉action

return "redirect:/itemEdit.action";

三、json數據交互

1、依賴jar包

jackson-annotation-2.4.0.jar
jackson-cort-2.4.0.jar
jackson-databind-2.4.2.jar

2、代碼演示

/**
 * json數據交互演示
 * @param item2
 * @return
 */
 @RequestMapping("getItem")
 //@ResponseBody把pojo轉成json串響應用戶
 @ResponseBody
 //@RequestBody用於接收用戶傳入json串轉成pojo
 public Item getItem(@RequestBody Item item2) {
      System.out.println("接收到的json商品數據為：" + item2);
      Item item = itemServices.getItemById(3);
      return item;
 }

四、異常處理

1、需實現HandlerExceptionResolver 

/**
 * 全局異常處理器
 * @author Steven
 *
 */
public class CustomerException implements HandlerExceptionResolver {

    @Override
    public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object hanlder,
            Exception e) {
        //記錄日志
        e.printStackTrace();
        //錯誤消息 
        String msg = "很抱歉，系統發生異常了，請聯系管理員";
        
        //響應用戶錯誤提示
        ModelAndView mav = new ModelAndView();
        //返回錯誤消息
        mav.addObject("msg", msg);
        //響應錯誤提示頁面
        mav.setViewName("msg");
        return mav;
    }
}

2、在springmvc.xml中配置全局異常處理器

<!-- 配置全局異常處理器 -->
<bean class="com.cenobitor.exception.CustomerException"/>

五、圖片上傳

1、需要支持的jar包

commons-fileupload-1.2.2.jar
commons-io-2.4.jar

2、配置多媒體解析器

    <!-- 配置多媒體處理器 -->
    <!-- 注意：這里id必須填寫：multipartResolver -->
    <bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
        <!-- 最大上傳文件大小 -->
        <property name="maxUploadSize" value="8388608" />
    </bean>

3、注意事項

① 表單需添加enctype="multipart/form-data" 屬性

② controller層接收的入參需要添加MultipartFile picFile,其中picFile為表單中對應的文件name屬性名。

③ 保存圖片使用絕對路徑，訪問使用虛擬路徑

4、controller代碼

@RequestMapping(value = "updateItem", method = { RequestMethod.POST, RequestMethod.GET })
public String updateItem(Item item, Model model, MultipartFile picFile) throws Exception {

        // 圖片新名字
        String name = UUID.randomUUID().toString();
        // 圖片原名字
        String oldName = picFile.getOriginalFilename();
        // 后綴名
        String exeName = oldName.substring(oldName.lastIndexOf("."));

        File pic = new File("D:\\WebWork\\" + name + exeName);
        // 保存圖片到本地磁盤
        picFile.transferTo(pic); 
        // 更新商品圖片信息
        item.setPic(name + exeName);

        itemServices.update(item);
        model.addAttribute("item", item);
        model.addAttribute("msg", "修改商品成功");
        return "itemEdit";
}

六、攔截器

1、需實現HandlerInterceptor

/**
 * 自定義攔截器
 * @author Steven
 *
 */
public class MyInterceptor1 implements HandlerInterceptor {

    //在preHandle方法返回true並且Controller方法完全執行完后被執行
    //處理異常、記錄日志
    @Override
    public void afterCompletion(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2, Exception arg3)
            throws Exception {
        System.out.println("MyInterceptor1.afterCompletion.....");
    }

    //在Controller方法執行后，返回ModelAndView之前被執行
    //設置或者清理頁面共用參數等等
    @Override
    public void postHandle(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2, ModelAndView arg3)
            throws Exception {
        System.out.println("MyInterceptor1.postHandle.....");
    }

    //在Controller方法執行前被執行
    //登錄攔截、權限認證等等
    @Override
    public boolean preHandle(HttpServletRequest arg0, HttpServletResponse arg1, Object arg2) throws Exception {
        
        System.out.println("MyInterceptor1.preHandle.....");
        
        //返回true放行，false攔截
        return true;
    }

}

2、在springmvc.xml配置攔截器

 

<!-- 攔截器定義 -->
<mvc:interceptors>
        <!-- 定義一個攔截器 -->
        <mvc:interceptor>
            <!-- path配置</**>攔截所有請求，包括二級以上目錄，</*>攔截所有請求，不包括二級以上目錄 -->
            <mvc:mapping path="/**"/>
            <bean class="com.cenobitor.springmvc.interceptor.MyInterceptor1" />
        </mvc:interceptor>
</mvc:interceptors>