Spring MVC的映射请求

时间:2025-01-28 23:02:50

一、SpringMVC常用注解

@Controller 声明Action组件

@Service    声明Service组件    @Service("myMovieLister") 

@Repository 声明Dao组件

@Component   泛指组件, 当不好归类时. 

@RequestMapping("/menu")  请求映射

@Resource  用于注入,( j2ee提供的 ) 默认按名称装配,@Resource(name="beanName") 

@Autowired 用于注入,(srping提供的) 默认按类型装配 

@Transactional( rollbackFor={Exception.class}) 事务管理

@ResponseBody

@Scope("prototype")   设定bean的作用域

@Controller

负责注册一个bean 到spring 上下文中。

@Service    

声明Service组件,例如@Service("myMovieLister") 

@Repository 

声明Dao组件。

@Component   

泛指组件, 当不好归类时使用此注解。

@Resource  

用于注入,( j2ee提供的 ) 默认按名称装配,@Resource(name="beanName") 。

@Autowired 

用于注入,(srping提供的) 默认按类型装配 。

@Transactional( rollbackFor={Exception.class}) 

事务管理。

@Scope("prototype")   

设定bean的作用域。

@RequestMapping

注解为控制器指定可以处理哪些 URL 请求。

@RequestBody

该注解用于读取Request请求的body部分数据,使用系统默认配置的HttpMessageConverter进行解析,然后把相应的数据绑定到要返回的对象上 ,再把HttpMessageConverter返回的对象数据绑定到 controller中方法的参数上。

@ResponseBody

该注解用于将Controller的方法返回的对象,通过适当的HttpMessageConverter转换为指定格式后,写入到Response对象的body数据区。

@ModelAttribute    

在方法定义上使用 @ModelAttribute 注解:Spring MVC 在调用目标处理方法前,会先逐个调用在方法级上标注了@ModelAttribute 的方法。

在方法的入参前使用 @ModelAttribute 注解:可以从隐含对象中获取隐含的模型数据中获取对象,再将请求参数 –绑定到对象中,再传入入参将方法入参对象添加到模型中 。

@RequestParam 

在处理方法入参处使用 @RequestParam 可以把请求参 数传递给请求方法。

@PathVariable

绑定 URL 占位符到入参。

@ExceptionHandler

注解到方法上,出现异常时会执行该方法。

@ControllerAdvice

使一个Contoller成为全局的异常处理类,类中用@ExceptionHandler方法注解的方法可以处理所有Controller发生的异常。





二、@RequestMapping详解

1、映射请求 URL

Spring MVC 使用 @RequestMapping 注解为控制器指定可以处理哪些 URL 请求。在控制器的类定义及方法定义处都可标注。

@RequestMapping

– 类定义处:提供初步的请求映射信息。相对于 WEB 应用的根目录。

– 方法处:提供进一步的细分映射信息。相对于类定义处的 URL。若类定义处未标注 @RequestMapping,则方法处标记的 URL 相对于WEB 应用的根目录。

DispatcherServlet 截获请求后,就通过控制器上@RequestMapping 提供的映射信息确定请求所对应的处理方法。

@RequestMapping("/springmvc")
@Controller
public class HelloWorld { /**
* 1. 使用 @RequestMapping 注解来映射请求的 URL
* 2. 返回值会通过视图解析器解析为实际的物理视图, 对于 InternalResourceViewResolver 视图解析器, 会做如下的解析:
* 通过 prefix + returnVal + 后缀 这样的方式得到实际的物理视图, 然会做转发操作。
*
* /WEB-INF/views/success.jsp------->对应的请求是类的@RequestMapping+方法的@RequestMapping
* 也就是/springmvc/helloworld
*
*/
@RequestMapping("/helloworld")
public String hello(){
System.out.println("hello world");
return "success";
} }

2、映射请求参数、请求方法或请求头

@RequestMapping 的 value、method、params 及 heads分别表示请求 URL、请求方法、请求参数及请求头的映射条件,他们之间是与的关系,联合使用多个条件可让请求映射更加精确化。

示例:

-----

@RequestMapping(value = "/testMethod", method = RequestMethod.POST)

指定请求方式为POST方式,如此便不再响应GET方式的请求。

-----

@RequestMapping(value = "testParamsAndHeaders", params = { "username",

"age!=10" }, headers = { "Accept-Language=en-US,zh;q=0.8" })





默认请求方式为GET方式,且需要有两个参数:username和age,还限定了age不能为10。

"/testParamsAndHeaders?username=atguigu&age=10"这个请求不满足要求,SpringMVC不会处理。





3、通配符

@RequestMapping 支持 Ant 风格的 URL。

---?:匹配文件名中的一个字符

---*:匹配文件名中的任意字符

---**:** 匹配多层路径

示例:

---/user/*/createUser: 可以匹配如下

/user/aaa/createUser、/user/bbb/createUser 等 URL。

---/user/**/createUser: 可以匹配如下

/user/createUser、/user/aaa/bbb/createUser 等 URL。

---/user/createUser??: 可以匹配如下

/user/createUseraa、/user/createUserbb 等 URL,但不匹配/user/createUseraaa。









三、@PathVariable

通过 @PathVariable 可以将 URL 中占位符参数绑定到控制器处理方法的入参中:URL 中的 {xxx} 占位符可以通过@PathVariable("xxx") 绑定到操作方法的入参中。

示例:

@RequestMapping("/testPathVariable/{id}")
public String testPathVariable(@PathVariable("id") Integer id) {
System.out.println("testPathVariable: " + id);
return SUCCESS;
}

假如请求为/testPathVariable/1,那么参数"1"会作为参数传给id作为传入参数。在方法中就可以获取这个参数值。





四、请求处理方法签名

Spring MVC 通过分析处理方法的签名,可以将 HTTP 请求信息绑定到处理方法的相应人参中。必要时可以对方法及方法入参标注相应的注解(@PathVariable、@RequestParam、@RequestHeader 等)、SpringMVC 框架会将 HTTP 请求的信息绑定到相应的方法入参中,并根据方法的返回值类型做出相应的后续处理。





1、@RequestParam

在处理方法入参处使用 @RequestParam 可以把请求参数传递给请求方法。有三个属性:

value:指定参数名

required:说明是否必须。默认为 true, 表示请求参数中必须包含对应的参数,若不存在,将抛出异常

defaultValue:指定请求参数的默认值。

示例

   @RequestMapping(value = "/testRequestParam")
public String testRequestParam(
@RequestParam(value = "username") String un,
@RequestParam(value = "age", required = false, defaultValue = "10") int age) {
System.out.println("testRequestParam, username: " + un + ", age: "
+ age);
return SUCCESS;
}

声明两个输入参数,其中age参数可以缺省,默认为10。如/testRequestParam?username=kang&age=11。





2、@RequestHeader

使用 @RequestHeader 可以绑定请求报头的属性值。请求头包含了若干个属性,服务器可据此获知客户端的信息,通过 @RequestHeader 即可将请求头中的属性值绑定到处理方法的入参中。

示例:

 

       @RequestMapping("/testRequestHeader")
public String testRequestHeader(
@RequestHeader(value = "Accept-Language") String al) {
System.out.println("testRequestHeader, Accept-Language: " + al);
return SUCCESS;
}

3、使用 @CookieValue 绑定请求中的 Cookie 值,可让处理方法入参绑定某个 Cookie 值。

示例:

        @RequestMapping("/testCookieValue")
public String testCookieValue(@CookieValue("JSESSIONID") String sessionId) {
System.out.println("testCookieValue: sessionId: " + sessionId);
return SUCCESS;
}

五、将 POJO 对象绑定为请求参数值

Spring MVC 会按请求参数名和 POJO 属性名进行自动匹配,自动为该对象填充属性值。支持级联属性。

示例:

POJO类:

Address.java

public class Address {

	private String province;
private String city;
//省略了get/set方法
//重写了toString方法
}

User.java

public class User {

	private String username;
private String password;
private String email;
private int age;
private Address address;//持有一个Address的类实例 //省略了get/set方法
//重写了toString方法
}

jsp页面请求:

<form action="/testPojo" method="post">
username: <input type="text" name="username"/>
<br>
password: <input type="password" name="password"/>
<br>
email: <input type="text" name="email"/>
<br>
age: <input type="text" name="age"/>
<br>
city: <input type="text" name="address.city"/>
<br>
province: <input type="text" name="address.province"/>
<br>
<input type="submit" value="Submit"/>
</form>
<br><br>

可以看出name="address.city"和name="address.province"都采用了级联属性。

Spring MVC代码:

@RequestMapping("/testPojo")
public String testPojo(User user) {
System.out.println("testPojo: " + user);
return SUCCESS;
}

这里直接将User类和index.jsp的表单参数名直接对照,从而实现映射。





六、使用 Servlet API 作为入参

MVC 的 Handler 方法可以接受的 ServletAPI 类型的参数如下:

---HttpServletRequest

---HttpServletResponse

---HttpSession

---Locale,InputStream等。

示例:

public void testServletAPI(HttpServletRequest request,
HttpServletResponse response, Writer out) throws IOException {
System.out.println("testServletAPI, " + request + ", " + response);
out.write("hello springmvc");
return SUCCESS;
}