博客
关于我
强烈建议你试试无所不能的chatGPT,快点击我
【spring学习笔记】(二)Spring MVC注解配置 参数转换注解@RequestMapping@RequestParam、@PathVariable@MatrixVariable
阅读量:3905 次
发布时间:2019-05-23

本文共 5211 字,大约阅读时间需要 17 分钟。

@


介绍

在Spring MVC项目中,<\context:component-scan>配置标签还会开启@Request-Mapping、@GetMapping等映射注解功能(也就是会注册RequestMappingHandler-Mapping和RequestMappingHandlerAdapter等请求映射和处理等组件),但是< context:component-scan>不支持数据转换或验证等注解功能。 Spring MVC提供了<\mvc:annotation-driven/>配置标签用于全面开启MVC相关的注解功能,该配置会注册用于处理请求映射相关的组件,支持请求注解映射注解(@Request-Mapping、@GetMapping和@PostMapping等)和参数转换注解(@RequestParam、@PathVariable和@ModelAttribute等)。

注册的组件类型包括:
·RequestMappingHandlerMapping:请求映射处理器映射器; ·RequestMappingHandlerAdapter:请求映射处理器适配器; ·ExceptionHandlerExceptionResolver:处理异常信息的异常解析器。
除此之外,< mvc:annotation-driven/>配置还会加载一些数据转换支持的注解实现类,包括:
·支持使用了ConversionService的实例对表单参数进行类型转换;
·支持使用@NumberFormat、@NumberFormat注解的作用是对数据类型进行格式化
·支持使用@Valid对JavaBean进行JSR-303验证;
·支持JSON数据类型转换注解@RequestBody和@ResponseBody。

组件注解

与Spring核心容器一致,配置< context:component-scan>就可以自动扫描和注册对应包下的组件和依赖注入的注解。相比@Component的通用组件注解,Spring MVC项目中可以使用对应不同层级更为精确的组件注解,具体使用如下: ·@Controller:控制器组件;

·@Service:服务组件;
·@Repository:DAO组件;
·@Component:组件的泛型,使用于不好归类的组件类,如一些用于和配置文件对应的类。

请求映射与参数注解

请求映射注解可以使用在类和方法上,基本的注解是@RequestMapping,根据不同的请求类型有不同的子注解,类似@GetMapping、@PostMapping,特定请求注解只接受特定类型的HTTP请求方法,而@RequestMapping可以通用。

参数注解包括请求参数
@RequestParam和路径变量
@PathVariable等。
@RequestMapping:请求映射注解 @RequestMapping可以使用在@Controller注解类的类和方法中。应用在类中作为请求路径的前缀,结合方法中的路径组成完整的请求路径.

@RequestMapping后面可以直接指定路径,也可以使用value属性来指定路径。@RequestMapping是一个通用类型的请求映射,可以对应不同类 型的请求(Spring中使用RequestMethod枚举类维护请求类型),包括GET、HEAD、POST、PUT、PATCH、DELETE、OPTIONS和TRACE。method属性用于指定匹配不同类型的请求,例如: @RequestMapping(value="/helloWithParamObject",method=RequestMethod.GET)

等同于
@GetMapping (value="/helloWithParamObject")

Spring MVC提供了不同类型的子注解可以直接使用,包括@GetMapping、@Post-Mapping、@PutMapping、@DeleteMapping和@PatchMapping。

请求内容的类型配置

在请求映射注解中,可以通过consumes和produces属性指定请求和返回的媒体格式类型。

·consumes:处理请求的提交内容类型(Content-Type),例如application/json、text/html。使用此属性可以缩小请求映射的范围。consumes也支持反向表达,比如!text/plain,指除text/plain以外的任何内容类型。
·produces:返回的内容类型
设置@RequestMapping等注解的headers属性,可以限定映射包含此请求头参数的请求,缩小映射方法的映射范围。

@RequestParam

@RequestParam使用在映射方法的形参中,用来匹配一些简单类型和没有被其他参数解析器解析的请求参数。默认情况下,请求参数与映射方法参数需要同名,如果在请求参数或请求体中不存在同名的参数,则会出错。也就是说,默认@RequestParam注解的参数是必须传值的,否则会抛出异常,请求处理的方法也不会执行。可以通过设置required属性为false取消这个限制,还可以通过value属性设置映射到的前端请求的参数名。例如:

@RequestMapping("/helloWithParam")                                  //映射注解 public ModelAndView helloWithParam(@RequestParam(value="userName",  required=true) String userName) {
//value指定前端请求参数名,required必须检查 ModelAndView modelAndView = new ModelAndView(); //模型视图对象初始化 modelAndView.setViewName("hello"); //设置视图名 return modelAndView; //返回视图模型对象 }

请求参数可以通过GET方式直接在URL中传入,也可以通过POST方式传入。GET在URL中传递的示例如

下: /anno-demo/helloWithParam?userName=Oscar
注意:required不设置,默认参数是必须传值的,所以一般参数非必须时才进行required=false的设置。 映射方法参数的@RequestParam也可以不使用,容器会根据参数名称自动进行匹配。如果方法参数是一个对象类型的话,容器还会将请求中的参数自动装箱,也就是创建该类型的对象,并将前端传递的参数自动匹配到对象的属性中。举例来看注解方法的定义如下:

@RequestMapping("/helloWithParamObject")                    //映射注解   //User类型对象的参数自动装箱   ublic ModelAndView helloWithParamObject(User user) {
} //方法体略

在使用地址/anno-demo/helloWithParamObject?name=Oscar请求时,映射方法的User类型的参数对象会被创建,并且会把前端的name值设置给对象。

路径变量注解:@PathVariable

@PathVariable注解使用在映射方法参数中,用来绑定映射注解中的URL占位符的值并赋给该参数,占位符使用{}的格式。示例如下:

//包含占位符的映射配置 @RequestMapping(value="/helloPathVariable/{userName}")  //参数路径映射  public ModelAndView helloPathVariable(@PathVariable String userName) {
//方法体略 }

当使用/helloPathVariable/user1进行请求访问时,会将路径中的user1的值绑定给上面方法中的参数。

@PathVariable和@RequestParam都是用来传递参数的,@PathVariable常用在REST风格请求的服务中。

矩阵变量注解:@MatrixVariable

在使用@PathVariable注解映射路径变量时,可以结合@MatrixVariable注解在请求URL路径中附加键值对方式的参数传递,路径和参数以分号(;)分隔,参数的键和值以等号(=)分隔。例如,请求路径是/helloMartrixVariable/user1;id=1,这里的user1是路径,id是键值对的参数。在映射方法中的写法如下:

//包含路径占位符的映射注解

@RequestMapping(value="/helloMartrixVariable/{userName}") public ModelAndView helloMartrixVariable(    // 映射方法        @PathVariable String userName,           //路径占位符匹配        //矩阵变量匹配        @MatrixVariable(name="id", pathVar="userName") String userId) {
System.out.println("PathVariable userName:"+userName); //user1System.out.println("MartrixVariable userId:"+userId); // ModelAndView modelAndView = new ModelAndView(); return modelAndView; }

@MatrixVariable注解的name属性指定参数的键的名字,pathVar指定路径变量的名字,在包含多个路径变量时需要使用。如果参数的键和方法的@MatrixVariable注解变量同名且只有一个路径变量时,可以省略name和pathVar属性的配置。 同一个路径地址,可以包含多个路径变量。在同一个路径变量中,可以包含多个键值对的参数,以分号(;)分割。@MatrixVariable注解的方法参数可以得到所有的矩阵变量,键值相同的会合并成集合。如果不同路径变量中都包含同一个键值,在不使用pathVar指定具体哪个路径变量的状况下,返回的键值是一个集合。以某个映射注解的路径配置为例: /depts/{deptId}/users/{userId}

该路径有两个路径占位符,使用矩阵变量的请求路径如下:
/depts/dept001;att1=value1/users/user001;att1=value11;att2=value2
使用MultiValueMap<String,String>类型的参数可以匹配所有的矩阵变量,如果指定@MatrixVariable注解的pathVar属性,则会返回该路径变量的所有矩阵变量,示例如下:

@RequestMapping(value="/depts/{deptId}/users/{userId}") public ModelAndView helloMultiMartrixVariable(       @MatrixVariable MultiValueMap
matrixVars, @MatrixVariable(pathVar="userId") MultiValueMap
userAtts) {
// matrixVars匹配的值是 {att1=[value1,value11], att2=[value2]} // userAtts匹配的值是 {att1=[value11], att2=[value2]} ModelAndView modelAndView = new ModelAndView(); return modelAndView; }

转载地址:http://mxten.baihongyu.com/

你可能感兴趣的文章
zookeeper 安装 使用
查看>>
kafka 安装部署
查看>>
关于吞吐量和延迟的精彩比喻
查看>>
UPYUN基于ngx_lua的动态服务路由方案
查看>>
OpenResty Con 2016 见闻杂记
查看>>
test-nginx 使用文档
查看>>
Understanding Linux CPU stats
查看>>
OSINT + Python = 自定义黑客
查看>>
Nginx Load Balancing — Advanced Configuration
查看>>
nginx负载均衡中RR和ip_hash策略分析
查看>>
scribe、chukwa、kafka、flume日志系统对比
查看>>
基于Nginx1.9+LuaJIT+Kafka的点播监控系统实战
查看>>
Openresty+Lua+Memcached反爬虫策略
查看>>
使用OpenResty控制CDN回源主机
查看>>
nginx+lua+kafka实现日志统一收集汇总
查看>>
【图文直播全文记录】酷狗音乐的大数据实践(纯干货)
查看>>
慧眼云:基于云计算和大数据分析的主动防御实践
查看>>
在Linux安装Python之注意事项
查看>>
一次服务器CPU占用率高的定位分析
查看>>
linux cpu占用率分析
查看>>