springbootWeb常用注解使用

简介: 本文概述了Spring Boot Web中处理HTTP请求的常用注解,包括`@PathVariable`、`@RequestHeader`、`@RequestParam`、`@RequestBody`、`@ModelAttribute`和`@CookieValue`的用法及其示例。

@PathVariable 路径变量注解

可以通过使用@PathVariable注解,来获取绑定到URI模板路径变量上的值。一般都是结合着@RequestMapping注解来使用,用于在参数传递的过程中,规范前端发送请求的格式,和数据的验证。

注意的点:@PathVarible注解,如果方法参数为Map,则映射将填充所有路径变量名称和值 @PathVariable Map<String,String> map

@PathVariable注解源码:

package org.springframework.web.bind.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import org.springframework.core.annotation.AliasFor;

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface PathVariable {
   

    @AliasFor("name")
    String value() default "";

    @AliasFor("value")
    String name() default "";

    boolean required() default true;

}

使用:

    @ResponseBody
    @RequestMapping("/role/{name}/{age}")
    public Map getParam01(@PathVariable("name") String name,
                          @PathVariable("age") String age,
                          @PathVariable Map<String,String> map){
   
        Map<Object, Object> map1 = new HashMap<>();
        map1.put("name",name);
        map1.put("age",age);
        map1.put("map",map);
        return map1;
    }

在这里插入图片描述


@RequestHeader 请求标头注解

可以通过@RequestHeader注解来获取请求标头的一些信息,如果方法参数是Map、MultiValueMap或HttpHeaders,则映射将填充所有标头名称和值。

@RequestHeader注解源码:


package org.springframework.web.bind.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import org.springframework.core.annotation.AliasFor;

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface RequestHeader {
   

    @AliasFor("name")
    String value() default "";

    @AliasFor("value")
    String name() default "";

    boolean required() default true;

    String defaultValue() default ValueConstants.DEFAULT_NONE;

}

注意如果获取请求标头的单个信息,或者部分信息的话@RequestHeader(value=“xxxx”),其中xxx需要是请求标头中有的信息,比如host,connection,user-agent…

使用:

    @ResponseBody
    @RequestMapping("/headerMap01")
    public Map<String, String> getParam02(@RequestHeader Map<String,String> mapHeader){
   
        return mapHeader;
    }

    @ResponseBody
    @RequestMapping("/headerMap02")
    public String getParam03(@RequestHeader("host") String host){
   
        return host;
    }

在这里插入图片描述
在这里插入图片描述


@RequestParam 请求域注解

@RequestParam注解,作用和原生的request.getParameter()一样,也是获取请求域对象中的参数值。

@RequestParam注解源码:


package org.springframework.web.bind.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;
import java.util.Map;

import org.springframework.core.annotation.AliasFor;

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface RequestParam {
   

    @AliasFor("name")
    String value() default "";

    @AliasFor("value")
    String name() default "";

    boolean required() default true;

    String defaultValue() default ValueConstants.DEFAULT_NONE;

}

对比@RequestParam注解和request.getParameter() 【基本一样】:

编写表单页面:

    <hr>
    <form action="/reqParam01" method="post">
        <input type="text" name="userName"><br>
        <input type="number" name="userAge"><br>
        <input type="submit" value="提交--使用注解方式">
    </form>
    <hr>
    <form action="/reqParam02" method="post">
        <input type="text" name="userName"><br>
        <input type="number" name="userAge"><br>
        <input type="submit" value="提交--使用request域对象方式">
    </form>

编写请求映射:

     @ResponseBody
    @RequestMapping("/reqParam01")
    public String getParam04(@RequestParam String userName,@RequestParam int userAge){
   
        return "用户名:"+userName+"  用户年龄:"+userAge;
    }

    @ResponseBody
    @RequestMapping("/reqParam02")
    public String getParam05(HttpServletRequest request){
   
        String userName = request.getParameter("userName");
        String userAge = request.getParameter("userAge");
        return "用户名:"+userName+"  用户年龄:"+userAge;
    }

运行测试:
在这里插入图片描述
在这里插入图片描述

在这里插入图片描述


@RequestBody 请求体注解

@RequestBody注解用来获取完整的请求体对象并返回。

@RequestBody注解源码:


package org.springframework.web.bind.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import org.springframework.http.converter.HttpMessageConverter;

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface RequestBody {
   

    boolean required() default true;

}

使用:

做一个表单用来封装请求体:

    <hr>
    <form action="/reqBody" method="post">
        <input type="text" name="user"><br>
        <input type="password" name="upwd"><br>
        男:<input type="radio" name="sex" value="">
        女:<input type="radio" name="sex" value=""><br>
        <select name="address">
            <option value="-----请选择-----" disabled selected>-----请选择-----</option>
            <option value="内蒙古">内蒙古</option>
            <option value="山西">山西</option>
            <option value="湖北">湖北</option>
        </select>
        <input type="submit" value="提交">
    </form>

编写请求映射:

    @ResponseBody
    @RequestMapping("/reqBody")
    public String getParam06(@RequestBody String reqBody){
   
        return reqBody;
    }

在这里插入图片描述

post方式提交所以不是明文。

在这里插入图片描述


@ModelAttribute

@ModelAttribute注解用于将方法的参数或方法的返回值绑定到指定的模型属性上,并返回给Web视图。

@ModelAttribute可用于通过注释@RequestMapping方法的相应参数,使用特定属性名称向web视图显示命令对象。

@ModelAttribute还可以用于通过使用@RequestMapping方法注释控制器类中的访问器方法来向web视图公开引用数据。

@ModelAttribute注解源码:


package org.springframework.web.bind.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import org.springframework.core.annotation.AliasFor;
import org.springframework.ui.Model;

@Target({
   ElementType.PARAMETER, ElementType.METHOD})
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface ModelAttribute {
   

    @AliasFor("name")
    String value() default "";

    @AliasFor("value")
    String name() default "";

    boolean binding() default true;

}

使用1,将其置于方法上:

@ModelAttribute注解注释的方法会在此controller每个方法执行前被执行,因此对于一个controller映射多个URL的用法来说,要谨慎使用。

比如:

     @ModelAttribute
    public void populateModel(@RequestParam String abc, Model model) {
   
        model.addAttribute("attributeName", abc);
    }

    @ResponseBody
    @RequestMapping(value = "/helloWorld")
    public String helloWorld() {
   
        return "helloWorld";
    }

在获得请求/helloWorld后,populateModel方法在helloWorld方法之前先被调用,它把请求参数(/helloWorld?abc=text)加入到一个名为attributeName的model属性中,在它执行后helloWorld被调用,返回视图名helloWorld和model已由@ModelAttribute方法生产好了。

此时,直接访问helloWolrd请求会出错, Resolved [org.springframework.web.bind.MissingServletRequestParameterException: Required request parameter 'abc' for method parameter type String is not present].

在这里插入图片描述

必须在其请求上添加一个名为abc值为任意的请求参数(例如:http://localhost:8080/helloWorld?abc=text)

在这里插入图片描述

使用2,将其置于方法参数上:

将@ModelAttribute放在方法参数上,会获取到对应的参数的值 @ModelAttribute("xxx") 返回方法参数

html表单:

    <hr>
    <form action="/model01" method="post">
        标题:<input type="text" name="title" ><br><br>
        内容:<textarea rows="10" cols="40" name="content"></textarea><br>
        <input type="submit" value="提交">
    </form>

请求映射:

    @ResponseBody
    @RequestMapping("/model01")
    public String getParam07(@ModelAttribute("content") String content,@ModelAttribute("title") String title){
   
        return content+"\n"+title;
    }

在这里插入图片描述
在这里插入图片描述


@CookieValue

@CookieValue注解主要是将请求的Cookie数据,映射到功能处理方法的参数上。

@CookieValue注解源码:


package org.springframework.web.bind.annotation;

import java.lang.annotation.Documented;
import java.lang.annotation.ElementType;
import java.lang.annotation.Retention;
import java.lang.annotation.RetentionPolicy;
import java.lang.annotation.Target;

import org.springframework.core.annotation.AliasFor;

@Target(ElementType.PARAMETER)
@Retention(RetentionPolicy.RUNTIME)
@Documented
public @interface CookieValue {
   

    @AliasFor("name")
    String value() default "";

    @AliasFor("value")
    String name() default "";

    boolean required() default true;

    String defaultValue() default ValueConstants.DEFAULT_NONE;

}

它将一个HTTP cookie绑定于方法的一个参数。

1、value:绑定的参数名称,String类型。

2、required:是否必须包含value,boolean类型,默认为 true,表示请求参数中必须包含对应的参数;若不存在,将抛出异常。

3、defaultValue:默认值,String类型。当没有传参时将使用此值赋值。

使用@CookieValue注解获取sessionId信息:

    @ResponseBody
    @RequestMapping("/cookieMap")
    public String getParam08(@CookieValue("JSESSIONID")String sessionId) {
   
        return sessionId;
    }

启动服务报错了,原因是jsessionId,应该填写实际存在的jsessionid才行(大意了)

在这里插入图片描述

将上面的例子修改如下:

    @ResponseBody
    @RequestMapping("/cookieMap")
    public String getParam08(@CookieValue("Idea-37e99455")String sessionId) {
   
        return sessionId;
    }

成功访问了:

在这里插入图片描述


相关文章
|
10天前
|
弹性计算 人工智能 架构师
阿里云携手Altair共拓云上工业仿真新机遇
2024年9月12日,「2024 Altair 技术大会杭州站」成功召开,阿里云弹性计算产品运营与生态负责人何川,与Altair中国技术总监赵阳在会上联合发布了最新的“云上CAE一体机”。
阿里云携手Altair共拓云上工业仿真新机遇
|
6天前
|
机器学习/深度学习 算法 大数据
【BetterBench博士】2024 “华为杯”第二十一届中国研究生数学建模竞赛 选题分析
2024“华为杯”数学建模竞赛,对ABCDEF每个题进行详细的分析,涵盖风电场功率优化、WLAN网络吞吐量、磁性元件损耗建模、地理环境问题、高速公路应急车道启用和X射线脉冲星建模等多领域问题,解析了问题类型、专业和技能的需要。
2506 14
【BetterBench博士】2024 “华为杯”第二十一届中国研究生数学建模竞赛 选题分析
|
6天前
|
机器学习/深度学习 算法 数据可视化
【BetterBench博士】2024年中国研究生数学建模竞赛 C题:数据驱动下磁性元件的磁芯损耗建模 问题分析、数学模型、python 代码
2024年中国研究生数学建模竞赛C题聚焦磁性元件磁芯损耗建模。题目背景介绍了电能变换技术的发展与应用,强调磁性元件在功率变换器中的重要性。磁芯损耗受多种因素影响,现有模型难以精确预测。题目要求通过数据分析建立高精度磁芯损耗模型。具体任务包括励磁波形分类、修正斯坦麦茨方程、分析影响因素、构建预测模型及优化设计条件。涉及数据预处理、特征提取、机器学习及优化算法等技术。适合电气、材料、计算机等多个专业学生参与。
1519 14
【BetterBench博士】2024年中国研究生数学建模竞赛 C题:数据驱动下磁性元件的磁芯损耗建模 问题分析、数学模型、python 代码
|
8天前
|
编解码 JSON 自然语言处理
通义千问重磅开源Qwen2.5,性能超越Llama
击败Meta,阿里Qwen2.5再登全球开源大模型王座
531 13
|
1月前
|
运维 Cloud Native Devops
一线实战:运维人少,我们从 0 到 1 实践 DevOps 和云原生
上海经证科技有限公司为有效推进软件项目管理和开发工作,选择了阿里云云效作为 DevOps 解决方案。通过云效,实现了从 0 开始,到现在近百个微服务、数百条流水线与应用交付的全面覆盖,有效支撑了敏捷开发流程。
19282 30
|
1月前
|
人工智能 自然语言处理 搜索推荐
阿里云Elasticsearch AI搜索实践
本文介绍了阿里云 Elasticsearch 在AI 搜索方面的技术实践与探索。
18836 20
|
1月前
|
Rust Apache 对象存储
Apache Paimon V0.9最新进展
Apache Paimon V0.9 版本即将发布,此版本带来了多项新特性并解决了关键挑战。Paimon自2022年从Flink社区诞生以来迅速成长,已成为Apache顶级项目,并广泛应用于阿里集团内外的多家企业。
17524 13
Apache Paimon V0.9最新进展
|
8天前
|
人工智能 自动驾驶 机器人
吴泳铭:AI最大的想象力不在手机屏幕,而是改变物理世界
过去22个月,AI发展速度超过任何历史时期,但我们依然还处于AGI变革的早期。生成式AI最大的想象力,绝不是在手机屏幕上做一两个新的超级app,而是接管数字世界,改变物理世界。
458 48
吴泳铭:AI最大的想象力不在手机屏幕,而是改变物理世界
|
1天前
|
云安全 存储 运维
叮咚!您有一份六大必做安全操作清单,请查收
云安全态势管理(CSPM)开启免费试用
355 4
叮咚!您有一份六大必做安全操作清单,请查收
|
2天前
|
存储 关系型数据库 分布式数据库
GraphRAG:基于PolarDB+通义千问+LangChain的知识图谱+大模型最佳实践
本文介绍了如何使用PolarDB、通义千问和LangChain搭建GraphRAG系统,结合知识图谱和向量检索提升问答质量。通过实例展示了单独使用向量检索和图检索的局限性,并通过图+向量联合搜索增强了问答准确性。PolarDB支持AGE图引擎和pgvector插件,实现图数据和向量数据的统一存储与检索,提升了RAG系统的性能和效果。