springMVC——獲取客戶端數據

1 前言

springMVC 獲取客戶端數據的方法主要有以下3種:

  • 通過 HttpServletRequest 對象的 getParameter() 方法獲取
  • 通過匹配參數名獲取
  • 通過 POJO 獲取

實驗需要導入的 JAR 包如下:

筆者工作目錄如下:  

首先介紹下本文各節公共的文件,主要有 web.xml、applicationContext.xml、success.jsp,不同的是 Test.java 和 index.jsp,將在各節都介紹。

web.xml

<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" 
	xmlns="http://java.sun.com/xml/ns/javaee" 
	xsi:schemaLocation="http://java.sun.com/xml/ns/javaee http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd" version="3.0"> 
  	<!-- 首頁網頁 -->
	<welcome-file-list>
		<welcome-file>/WEB-INF/view/index.jsp</welcome-file>
	</welcome-file-list>
  
  	<!-- 配置核心(前端)控制器 DispatcherServlet -->
	<servlet>
  		<servlet-name>dispatcherServlet</servlet-name>
  		<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
  		<init-param>
  			<!-- 加載IOC容器配置文件 -->
  			<param-name>contextConfigLocation</param-name>
  			<param-value>classpath:applicationContext.xml</param-value> 
  		</init-param>
  	</servlet>
  	<servlet-mapping>
  		<servlet-name>dispatcherServlet</servlet-name>
  		<url-pattern>/</url-pattern>
  	</servlet-mapping>
  
  	<!-- 配置CharacterEncodingFilter,用於解決後臺中文亂碼 -->
	<filter>
		<filter-name>characterEncodingFilter</filter-name>
		<filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
		<init-param>
			<param-name>encoding</param-name>
			<param-value>UTF-8</param-value>
		</init-param>
		<init-param>
			<param-name>forceEncoding</param-name>
			<param-value>true</param-value>
		</init-param>
	</filter>
	<filter-mapping>
		<filter-name>characterEncodingFilter</filter-name>
		<url-pattern>/*</url-pattern>
	</filter-mapping>
</web-app>

注意:characterEncodingFilter 用於解決客戶端傳遞的中文參數在服務器端亂碼。 

applicationContext.xml

<?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"
	xsi:schemaLocation="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-4.0.xsd">	
	<!-- 掃描組件,將加@Controller註解的類作爲SpringMVC的控制層 -->
	<context:component-scan base-package="com.test"></context:component-scan>
	
	<!-- 配置視圖解析器 -->
	<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
		<property name="prefix" value="/WEB-INF/view/"></property>
		<property name="suffix" value=".jsp"></property>
	</bean>	
</beans>

success.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
	<title>success</title>
</head>
<body>
	<h1>成功</h1>
</body>
</html>

2  通過 HttpServletRequest 對象獲取客戶端數據

index.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
	<title>首頁</title>
</head>
<body>
	<form action="user" method="post"> 
		用戶號:<input type="text" name="uid"><br/>
		用戶名:<input type="text" name="uname"><br/>
		<input type="submit" value="提交"/>
	</form>
</body>
</html>

Test.java

package com.test;

import javax.servlet.http.HttpServletRequest;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class Test {
	
	@RequestMapping(value="user",method=RequestMethod.POST)
	public String addUser(HttpServletRequest request) {
		String id=request.getParameter("uid");
		String name=request.getParameter("uname");
		System.out.println("id="+id+", name="+name);
		return "success";
	}
}

在地址欄輸入:http://localhost:8080/SpringMVC/,並填寫表單,如下:

提交後,跳轉到 success.jsp 頁面,並且控制檯顯示:【id=1001, name=張三】 。

3 通過匹配參數名獲取客戶端數據

參數名匹配是指:客戶端傳遞的參數名服務器端請求方法的形參名進行匹配,將傳遞的參數賦值給同名形參

本節主要介紹 Test.java,index.jsp 同第2節。

3.1 直接匹配

Test.java

package com.test;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class Test {
	
	@RequestMapping(value="user",method=RequestMethod.POST)
	public String addUser(Integer uid,String uname) {
		System.out.println("id="+uid+", name="+uname);
		return "success";
	}
}

注意:若傳遞的參數形參匹配失敗,程序都不會報錯。

  • 傳遞的參數匹配失敗:存在傳遞的參數在形參列表中匹配不到同名形參,如:傳遞的參數中多個 address 參數
  • 形參匹配失敗:存在形參數在傳遞的參數中匹配不到同名參數,如:形參中多個 address 參數

 3.2 @RequestParam

根據傳遞的參數名與 @RequestParam 的 value 屬性值進行匹配,將傳遞的參數賦值給被 @RequestParam 標註的 value 值同名的形參。

Test.java

package com.test;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;
import org.springframework.web.bind.annotation.RequestParam;

@Controller
public class Test {
	
	@RequestMapping(value="user",method=RequestMethod.POST)
	public String addUser(@RequestParam(value="uid")Integer id,@RequestParam(value="uname")String name) {
		System.out.println("id="+id+", name="+name);
		return "success";
	}
}

注意:

  • 若 @RequestParam 中只有 value 一個屬性,可以省略 value,直接顯示其值。
  • 形參列表中,若有一個參數被 @RequestParam 標註,其他參數也要被 @RequestParam 標註,否則會報錯。
  • 若存在傳遞的參數匹配失敗,如:傳遞的參數中多個 address 參數,程序不會報錯。
  • 若存在 value 匹配失敗,如:多了個值爲 address 的 value ,程序會報錯。

思考:也許讀者會疑問,由於 value 值必須要匹配成功,程序員就必須事先知道用戶傳遞的參數名,那爲什麼不用3.1中方法呢?3.1不更簡單麼?在實際應用中,若客戶端傳遞的參數名發生更改,使用3.1中方法,服務器端的方法形參名及其內部形參引用都得同步更改,而3.2中方法只需要更改 value。

拓展

(1)required屬性

當 value 匹配失敗時,若將 @RequestParam 的 required 屬性設置爲 false,程序也不會報錯。使用方式如下:

@RequestMapping(value="user",method=RequestMethod.POST)
public String addUser(@RequestParam("uid")Integer id, @RequestParam(value="address",required=false)String add) {

(2)defaultValue屬性

當 value 匹配失敗時,若給 @RequestParam 的 defaultValue 屬性賦值,程序也不會報錯,並且會給被標註的形參賦默認值。使用方式如下:

@RequestMapping(value="user",method=RequestMethod.POST)
public String addUser(@RequestParam("uid")Integer id,@RequestParam(value="address",defaultValue="北京")String add) {

4 通過 POJO 獲取客戶端數據

POJO(Plain Ordinary Java Object)是【簡單的Java對象】的簡稱,實際就是普通 JavaBeans,其中有一些屬性及其 getter 和 setter 方法,沒有業務邏輯,可以作爲 VO(value-object)或 DTO(Data Transform Object)來使用。

通過 POJO 獲取客戶端數據,即請求方法中通過一個 POJO 形參接收並封裝客戶端傳遞的參數

4.1 普通 POJO

本節主要介紹 User.java、Test.java,index.jsp 同第2節。

User.java

package com.test;

public class User {
	private Integer uid;
	private String uname;
	
	public Integer getUid() {
		return uid;
	}
	
	public void setUid(Integer uid) {
		this.uid = uid;
	}
	
	public String getUname() {
		return uname;
	}
	
	public void setUname(String uname) {
		this.uname = uname;
	}

	@Override
	public String toString() {
		return "User [uid=" + uid + ", uname=" + uname + "]";
	}
}

注意:屬性名必須與傳遞參數名一致。 

Test.java

package com.test;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class Test {
	
	@RequestMapping(value="user",method=RequestMethod.POST)
	public String addUser(User user) {
		System.out.println(user);
		return "success";
	}
}

 

在地址欄輸入:http://localhost:8080/SpringMVC/,並填寫表單,如下:

提交後,跳轉到 success.jsp 頁面,並且控制檯顯示:

User [uid=1001, uname=張三] 

4.2 帶級聯關係的 POJO

帶級聯關係的POJO是指:POJO 的某屬性也是一個 POJO,如:User 的 address 屬性包含 province 和 city 兩個屬性,也是一個POJO。

index.jsp

<%@ page language="java" contentType="text/html; charset=UTF-8" pageEncoding="UTF-8"%>
<html>
<head>
	<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
	<title>首頁</title>
</head>
<body>
	<form action="user" method="post"> 
		用戶號:<input type="text" name="uid"><br/>
		用戶名:<input type="text" name="uname"><br/>
		所在省:<input type="text" name="address.province"><br/>
		所在市:<input type="text" name="address.city"><br/>
		<input type="submit" value="提交"/>
	</form>
</body>
</html>

注意:級聯屬性的 name 值採用級聯表示,如:address.province、address.city,其前綴必須與 User 的 address 屬性同名,後綴必須與 Address 的屬性同名。

Test.java

package com.test;

import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import org.springframework.web.bind.annotation.RequestMethod;

@Controller
public class Test {
	
	@RequestMapping(value="user",method=RequestMethod.POST)
	public String addUser(User user) {
		System.out.println(user);
		return "success";
	}
}

User.java

package com.test;

public class User {
	private Integer uid;
	private String uname;
	private Adderss address;
	
	public Integer getUid() {
		return uid;
	}
	
	public void setUid(Integer uid) {
		this.uid = uid;
	}
	
	public String getUname() {
		return uname;
	}
	
	public void setUname(String uname) {
		this.uname = uname;
	}

	public Adderss getAddress() {
		return address;
	}

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

	@Override
	public String toString() {
		return "User [uid=" + uid + ", uname=" + uname + ", address=" + address + "]";
	}
}

Address.java

package com.test;

public class Adderss {
	private String province;
	private String city;
	
	public String getProvince() {
		return province;
	}
	
	public void setProvince(String province) {
		this.province = province;
	}
	
	public String getCity() {
		return city;
	}
	
	public void setCity(String city) {
		this.city = city;
	}
	
	@Override
	public String toString() {
		return "Adderss [province=" + province + ", city=" + city + "]";
	}
}

在地址欄輸入:http://localhost:8080/SpringMVC/,並填寫表單,如下:

提交後,跳轉到 success.jsp 頁面,並且控制檯顯示:

User [uid=1001, uname=張三, address=Adderss [province=湖北, city=武漢]]

 

發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章