SpringMVC - 2 請求&響應

4.1 普通型別引數傳參

引數名與處理器方法形參名保持一致

訪問URL： http://localhost/requestParam1?name=itheima&age=14

@RequestMapping("/requestParam1")
public String requestParam1(String name ,String age){
    System.out.println("name="+name+",age="+age);
    return "page.jsp";
}

@RequestParam 的使用
 型別： 形參註解
 位置：處理器類中的方法形參前方
 作用：繫結請求引數與對應處理方法形參間的關係

@RequestMapping("/requestParam2")
public String requestParam2(@RequestParam(
                            name = "userName",
                            required = true,
                            defaultValue = "itheima") String name){
    
    System.out.println("name="+name);
    return "page.jsp";
}
 

4.2 POJO型別引數傳參

當POJO中使用簡單型別屬性時， 引數名稱與POJO類屬性名保持一致

訪問URL： http://localhost/requestParam3?name=itheima&age=14

Controller

@RequestMapping("/requestParam3")
public String requestParam3(User user){
    System.out.println("name="+user.getName());
    return "page.jsp";
}

POJO類

public class User {
    private String name;
    private Integer age;
    
    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

}
 

引數衝突
 當POJO型別屬性與其他形參出現同名問題時，將被同時賦值
 建議使用@RequestParam註解進行區分
訪問URL： http://localhost/requestParam4?name=itheima&age=14

@RequestMapping("/requestParam4")
public String requestParam4(User user,String age){
    System.out.println("user.age="+user.getAge()+",age="+age);
    return "page.jsp";
}

複雜POJO型別引數
 當POJO中出現物件屬性時，引數名稱與物件層次結構名稱保持一致

訪問URL： http://localhost/requestParam5?address.province=beijing

public class User {
    private String name;
    private Integer age;

    private Address address;
    
    public Address getAddress() {
        return address;
    }

    public void setAddress(Address address) {
        this.address = address;
    }

    public String getName() {
        return name;
    }

    public void setName(String name) {
        this.name = name;
    }

    public Integer getAge() {
        return age;
    }

    public void setAge(Integer age) {
        this.age = age;
    }

}

@RequestMapping("/requestParam5")
public String requestParam5(User user){
    System.out.println("user.address="+user.getAddress().getProvince());
    return "page.jsp";
}

當POJO中出現List，儲存物件資料，引數名稱與物件層次結構名稱保持一致，使用陣列格式描述集合中物件的位置

訪問URL： http://localhost/requestParam7?addresses[0].province=bj&addresses[1].province=tj

public class User {
    private String name;
    private Integer age;
    private List<Address> addresses;
}

public class Address {
    private String province;
    private String city;
    private String address;
}

@RequestMapping("/requestParam7")
public String requestParam7(User user){
    System.out.println("user.addresses="+user.getAddress());
    return "page.jsp";
}

當POJO中出現Map，儲存物件資料，引數名稱與物件層次結構名稱保持一致，使用對映格式描述集合中物件的位置

訪問URL： http://localhost/requestParam8?addressMap[’home’].province=bj&addressMap[’job’].province=tj

public class User {
    private String name;
    private Integer age;
    private Map<String,Address> addressMap;
}
public class Address {
    private String province;
    private String city;
    private String address;
}

@RequestMapping("/requestParam8")
public String requestParam8(User user){
    System.out.println("user.addressMap="+user.getAddressMap());
    return "page.jsp";
}

4.3 陣列與集合型別引數傳參

陣列型別引數

請求引數名與處理器方法形參名保持一致，且請求引數數量＞ 1個

訪問URL： http://localhost/requestParam9?nick=Jockme&nick=zahc

@RequestMapping("/requestParam9")
public String requestParam9(String[] nick){
    System.out.println(nick[0]+","+nick[1]);
    return "page.jsp";
}

集合型別引數
 儲存簡單型別資料，請求引數名與處理器方法形參名保持一致，且請求引數數量＞ 1個
訪問URL： http://localhost/requestParam10?nick=Jockme&nick=zahc

@RequestMapping("/requestParam10")
public String requestParam10(@RequestParam("nick") List<String> nick){
    System.out.println(nick);
    return "page.jsp";
}

 注意： SpringMVC預設將List作為物件處理，賦值前先建立物件，然後將nick作為物件的屬性進行處理。由於
List是介面，無法建立物件，報無法找到構造方法異常；修復型別為可建立物件的ArrayList型別後，物件可
以建立，但沒有nick屬性，因此資料為空。此時需要告知SpringMVC的處理器nick是一組資料，而不是一個單
一資料。通過@RequestParam註解，將數量大於1個names引數打包成引數陣列後， SpringMVC才能識別該數
據格式，並判定形參型別是否為陣列或集合，並按陣列或集合物件的形式操作資料。

小節
 請求POJO型別引數獲取
 POJO的簡單屬性
 POJO的物件屬性
 POJO的集合屬性（儲存簡單資料）
 POJO的集合屬性（儲存物件資料）
 名稱衝突問題

4.4 型別轉換器

SpringMVC對接收的資料進行自動型別轉換，該工作通過Converter介面實現

• 標量轉換器
   StringToBooleanConverter String→Boolean
   ObjectToStringConverter Object→String
   StringToNumberConverterFactory String→Number（ Integer、 Long等）
   NumberToNumberConverterFactory Number子型別之間(Integer、 Long、 Double等)
   StringToCharacterConverter String→java.lang.Character
   NumberToCharacterConverter Number子型別(Integer、 Long、 Double等)→java.lang.Character
   CharacterToNumberFactory java.lang.Character→Number子型別(Integer、 Long、 Double等)
   StringToEnumConverterFactory String→enum型別
   EnumToStringConverter enum型別→String
   StringToLocaleConverter String→java.util.Local
   PropertiesToStringConverter java.util.Properties→String
   StringToPropertiesConverter String→java.util.Properties

• 集合、陣列相關轉換器
   ArrayToCollectionConverter 陣列→集合（ List、 Set）
   CollectionToArrayConverter 集合（ List、 Set） →陣列
   ArrayToArrayConverter 陣列間
   CollectionToCollectionConverter 集合間（ List、 Set）
   MapToMapConverter Map間
   ArrayToStringConverter 陣列→String型別
   StringToArrayConverter String→陣列， trim後使用“,”split
   ArrayToObjectConverter 陣列→Object
   ObjectToArrayConverter Object→單元素陣列
   CollectionToStringConverter 集合（ List、 Set） →String
   StringToCollectionConverter String→集合（ List、 Set）， trim後使用“,”split
   CollectionToObjectConverter 集合→Object
   ObjectToCollectionConverter Object→單元素集合

• 預設轉換器
   ObjectToObjectConverter Object間
   IdToEntityConverter Id→Entity
   FallbackObjectToStringConverter Object→String

• SpringMVC對接收的資料進行自動型別轉換，該工作通過Converter介面實現

4.5 日期型別格式轉換

• 宣告自定義的轉換格式並覆蓋系統轉換格式

  <!--5.啟用自定義Converter-->
  <mvc:annotation-driven conversion-service="conversionService"/>
  <!--1.設定格式型別Converter，註冊為Bean，受SpringMVC管理-->
  <bean id="conversionService"
        class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
      <!--2.自定義Converter格式型別設定，該設定使用的是同類型覆蓋的思想-->
      <property name="formatters">
          <!--3.使用set保障相同型別的轉換器僅保留一個，避免衝突-->
          <set>
              <!--4.設定具體的格式型別-->
              <bean class="org.springframework.format.datetime.DateFormatter">
                  <!--5.型別規則-->
                  <property name="pattern" value="yyyy-MM-dd"/>
              </bean>
          </set>
      </property>
  </bean>
  

• 日期型別格式轉換（簡化版）
   名稱： @DateTimeFormat
   型別： 形參註解、成員變數註解
   位置：形參前面 或 成員變數上方
   作用：為當前引數或變數指定型別轉換規則
   範例：

  public String requestParam12(@DateTimeFormat(pattern = "yyyy-MM-dd") Date date){
      System.out.println("date="+date);
      return "page.jsp";
  }
  

  @DateTimeFormat(pattern = "yyyy-MM-dd")
  private Date birthday;
  

• 注意：依賴註解驅動支援

  <mvc:annotation-driven />

4.6 自定義型別轉換器

• 自定義型別轉換器，實現Converter介面，並制定轉換前與轉換後的型別

  <!--1.將自定義Converter註冊為Bean，受SpringMVC管理-->
  <bean id="myDateConverter" class="com.itheima.converter.MyDateConverter"/>
  <!--2.設定自定義Converter服務bean-->
  <bean id="conversionService"
        class="org.springframework.context.support.ConversionServiceFactoryBean">
      <!--3.注入所有的自定義Converter，該設定使用的是同類型覆蓋的思想-->
      <property name="converters">
          <!--4.set保障同類型轉換器僅保留一個，去重規則以Converter<S,T>的泛型為準-->
          <set>
              <!--5.具體的型別轉換器-->
              <ref bean="myDateConverter"/>
          </set>
      </property>
  </bean>
  

  //自定義型別轉換器，實現Converter介面，介面中指定的泛型即為最終作用的條件
  //本例中的泛型填寫的是String，Date，最終出現字串轉日期時，該型別轉換器生效
  public class MyDateConverter implements Converter<String, Date> {
      //重寫介面的抽象方法，引數由泛型決定
      public Date convert(String source) {
          DateFormat df = new SimpleDateFormat("yyyy-MM-dd");
          Date date = null;
          //型別轉換器無法預計使用過程中出現的異常，因此必須在型別轉換器內部捕獲，不允許丟擲，框架無法預計此類異常如何處理
          try {
              date = df.parse(source);
          } catch (ParseException e) {
              e.printStackTrace();
          }
          return date;
      }
  }
  

• 通過註冊自定義轉換器，將該功能加入到SpringMVC的轉換服務ConverterService中

  <!--開啟註解驅動，載入自定義格式化轉換器對應的型別轉換服務-->
  <mvc:annotation-driven conversion-service="conversionService"/>
  

4.7 請求對映 @RequestMapping

4.7.1 方法註解

• 名稱： @RequestMapping
   型別： 方法註解
   位置：處理器類中的方法定義上方
   作用：繫結請求地址與對應處理方法間的關係
   範例：
   訪問路徑： /requestURL1

@Controller
@RequestMapping("/user")
public class UserController {
    @RequestMapping("/requestURL2")
    public String requestURL2() {
        return "page.jsp";
    }
}

4.7.2 類註解

名稱： @RequestMapping
 型別： 類註解
 位置：處理器類定義上方
 作用：為當前處理器中所有方法設定公共的訪問路徑字首
 範例：
 訪問路徑： /user/requestURL1

@Controller
@RequestMapping("/user")
public class UserController {
    @RequestMapping("/requestURL2")
    public String requestURL2() {
        return "page.jsp";
    }
}  

• 常用屬性

  @RequestMapping(
      value="/requestURL3", //設定請求路徑，與path屬性、 value屬性相同
      method = RequestMethod.GET, //設定請求方式
      params = "name", //設定請求引數條件
      headers = "content-type=text/*", //設定請求訊息頭條件
      consumes = "text/*", //用於指定可以接收的請求正文型別（MIME型別）
      produces = "text/*" //用於指定可以生成的響應正文型別（MIME型別）
  )
  public String requestURL3() {
      return "/page.jsp";
  }
  

5 響應

5.1 頁面跳轉

• 轉發（預設）

@RequestMapping("/showPage1")
public String showPage1() {
    System.out.println("user mvc controller is running ...");
    return "forward:page.jsp";
}

• 重定向

@RequestMapping("/showPage2")
public String showPage2() {
System.out.println("user mvc controller is running ...");
return "redirect:page.jsp";
}

 注意：頁面訪問地址中所攜帶的 /

5.2 頁面訪問快捷設定 (InternalResourceViewResolver)

展示頁面的儲存位置通常固定，且結構相似，可以設定通用的訪問路徑，簡化頁面配置格式

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/pages/"/>
    <property name="suffix" value=".jsp"/>
/bean>

public String showPage3() {
    return "page";
}

如果未設定了返回值，使用void型別，則預設使用訪問路徑作頁面地址的字首字尾

//最簡頁面配置方式，使用訪問路徑作為頁面名稱，省略返回值
@RequestMapping("/showPage5")
public void showPage5() {
    System.out.println("user mvc controller is running ...");
}

5.3 帶資料頁面跳轉

• 方式一：使用HttpServletRequest型別形參進行資料傳遞

  @RequestMapping("/showPageAndData1")
  public String showPageAndData1(HttpServletRequest request) {
      request.setAttribute("name","itheima");
      return "page";
  }
  

• 方式二：使用Model型別形參進行資料傳遞

  @RequestMapping("/showPageAndData2")
  public String showPageAndData2(Model model) {
      model.addAttribute("name","itheima");
      Book book = new Book();
      book.setName("SpringMVC入門實戰");
      book.setPrice(66.6d);
      model.addAttribute("book",book);
      return "page";
  }
  

• 方式三：使用ModelAndView型別形參進行資料傳遞，將該物件作為返回值傳遞給呼叫者

  //使用ModelAndView形參傳遞引數，該物件還封裝了頁面資訊
  @RequestMapping("/showPageAndData3")
  public ModelAndView showPageAndData3(ModelAndView modelAndView) {
      //ModelAndView mav = new ModelAndView();    替換形參中的引數
      Book book  = new Book();
      book.setName("SpringMVC入門案例");
      book.setPrice(66.66d);
      //新增資料的方式，key對value
      modelAndView.addObject("book",book);
      //新增資料的方式，key對value
      modelAndView.addObject("name","Jockme");
      //設定頁面的方式，該方法最後一次執行的結果生效
      modelAndView.setViewName("page");
      //返回值設定成ModelAndView物件
      return modelAndView;
  }
  

5.4 返回json資料

• 方式一：基於response返回資料的簡化格式，返回JSON資料

  //使用jackson進行json資料格式轉化
  @RequestMapping("/showData3")
  @ResponseBody
  public String showData3() throws JsonProcessingException {
      Book book  = new Book();
      book.setName("SpringMVC入門案例");
      book.setPrice(66.66d);
  
      ObjectMapper om = new ObjectMapper();
      return om.writeValueAsString(book);
  }
  

• 使用SpringMVC提供的訊息型別轉換器將物件與集合資料自動轉換為JSON資料

  //使用SpringMVC註解驅動，對標註@ResponseBody註解的控制器方法進行結果轉換，由於返回值為引用型別，自動呼叫jackson提供的型別轉換器進行格式轉換
  @RequestMapping("/showData4")
  @ResponseBody
  public Book showData4() {
      Book book  = new Book();
      book.setName("SpringMVC入門案例");
      book.setPrice(66.66d);
      return book;
  }
  

  需要手工新增資訊型別轉換器

  <bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
      <property name="messageConverters">
          <list>
              <bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter"/>
          </list>
      </property>
  </bean
  

• 方式三：使用SpringMVC註解驅動簡化配置

  <!--開啟springmvc註解驅動，對@ResponseBody的註解進行格式增強，追加其型別轉換的功能，具體實現由MappingJackson2HttpMessageConverter進行-->
  <mvc:annotation-driven/>
  

6 Servlet相關介面-Servlet相關介面替換方案

HttpServletRequest / HttpServletResponse / HttpSession

• SpringMVC提供訪問原始Servlet介面API的功能，通過形參宣告即可

  @RequestMapping("/servletApi")
  public String servletApi(HttpServletRequest request,
                           HttpServletResponse response, HttpSession session){
      System.out.println(request);
      System.out.println(response);
      System.out.println(session);
      request.setAttribute("name","itheima");
      System.out.println(request.getAttribute("name"));
      return "page.jsp";
  }
  

• Head資料獲取

   名稱： @RequestHeader
   型別： 形參註解
   位置：處理器類中的方法形參前方
   作用：繫結請求頭資料與對應處理方法形參間的關係
   範例：

  @RequestMapping("/headApi")
  public String headApi(@RequestHeader("Accept-Language") String head){
      System.out.println(head);
      return "page.jsp";
  }  
  

• Cookie資料獲取

   名稱： @CookieValue
   型別： 形參註解
   位置：處理器類中的方法形參前方
   作用：繫結請求Cookie資料與對應處理方法形參間的關係
   範例：

  @RequestMapping("/cookieApi")
  public String cookieApi(@CookieValue("JSESSIONID") String jsessionid){
      System.out.println(jsessionid);
      return "page.jsp";
  }  
  

• Session資料獲取

   名稱： @SessionAttribute
   型別： 形參註解
   位置：處理器類中的方法形參前方
   作用：繫結請求Session資料與對應處理方法形參間的關係
   範例：

  @RequestMapping("/sessionApi")
  public String sessionApi(@SessionAttribute("name") String name){
      System.out.println(name);
      return "page.jsp";
  }  
  

• Session資料設定（瞭解）

   名稱： @SessionAttributes
   型別： 類註解
   位置：處理器類上方
   作用：宣告放入session範圍的變數名稱，適用於Model型別資料傳參
   範例：

  @Controller
  @SessionAttributes(names={"name"})
  public class ServletController {
      @RequestMapping("/setSessionData2")
      public String setSessionDate2(Model model) {
          model.addAttribute("name", "Jock2");
          return "page.jsp";
      }
  }  
  

• 註解式引數資料封裝底層原理

   資料的來源不同，對應的處理策略要進行區分
   Head
   Cookie
   Session
   SpringMVC使用策略模式進行處理分發
   頂層介面： HandlerMethodArgumentResolver
   實現類： ……