美文网首页
你的接口参数怎么接收的

你的接口参数怎么接收的

作者: Sui_a346 | 来源:发表于2020-09-13 23:19 被阅读0次

    相信Java后端的同学们会经常看到都会经常看到@RequestBody、@pathvariable、@RequestParam,什么时候该用什么样的注解或者是不用注解。让我们来了解一下。

    RequestParam

    RequestParam会获取url链接上面的参数内容,然后获取匹配的参数作为接口参数传递给方法执行逻辑。如果请求的参数和接口方法参数名称一致,可以不需要显式使用该注解,例子如下:

    package com.example.demo;
    
    import org.springframework.boot.SpringApplication;
    import org.springframework.boot.autoconfigure.SpringBootApplication;
    import org.springframework.web.bind.annotation.GetMapping;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestParam;
    import org.springframework.web.bind.annotation.RestController;
    
    @SpringBootApplication
    @RestController("/")
    public class DemoApplication {
    
        public static void main(String[] args) {
            SpringApplication.run(DemoApplication.class, args);
        }
    
    
        /**
         * 接口参数使用默认
         *
         * @param var1
         * @param var2
         * @return
         */
        @GetMapping("/getTest")
        public String getTest(String var1,String var2) {
            return "getTest: " + var1 + "---" + var2;
        }
    
        @GetMapping("/getTestWithRequestParam")
        public String getTest1(@RequestParam("var3") String var1, String var2) {
            return "getTest: " + var1 + "---" + var2;
        }
    
    }
    
    

    在本地起一个简单的springboot项目之后,简单修改一下代码,分别请求两个接口,大家猜猜分别返回什么?

    请求1: 
        http://localhost:8080/getTest?var1=1&var2=22&var3=333
    返回:
        getTest: 1---22
    
    请求2:
        http://localhost:8080/getTestWithRequestParam?var1=1&var2=22&var3=333
    返回:
        getTest: 333---22
    

    从上面的例子可以看出,如果不指定@RequestParam的值,默认会获取同名参数,如果指定值,则会在url中获取对应名称的值。

    另外,点进@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 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 "\n\t\t\n\t\t\n\ue000\ue001\ue002\n\t\t\t\t\n";
    }
    
    

    PathVariable

    @PathVariable注解相当于一个占位符的操作方式, 可以获取请求路径中的值。

    用法如下:

    @GetMapping("/getTestWithPathParam/{var1}/{var2}")
    public String getTest1(@PathVariable("var1") String var1,@PathVariable("var2") String var2) {
        return "getTest: " + var1 + "---" + var2;
    }
    
    // 请求: http://localhost:8080/getTestWithPathParam/11/22
    // 返回: getTest: 11---22
    

    这种做法将参数也放进了请求映射的路由当中,有时候可以使代码逻辑更加明显。

    如将用户和行为都当成请求连接的一部分@GetMapping("/getTestWithPathParam/{userId}/{action}")


    RequestBody

    @RequestBody直接以String接收前端传过来的参数数据。也就是ajax中的data内容。RequestBody的值,需要配合请求中的 content-type,一般使用application/json,用于接收一个json对象

    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;
    
    @Target({ElementType.PARAMETER})
    @Retention(RetentionPolicy.RUNTIME)
    @Documented
    public @interface RequestBody {
        boolean required() default true;
    }
    

    下面一些示例:

    @PostMapping("/postTest")
    public String postTest(@RequestBody String var1,@RequestBody String var2) {
        return "postTest: " + var1 + "---" + var2;
    }
    
    //请求: POST http://localhost:8080/postTest
    //Content-Type: application/x-www-form-urlencoded
    //var1=1&var2=22
    
    // 返回
    //   postTest: var1=1&var2=22---var1=1&var2=22
    
    // --------------------
    // 请求:POST http://localhost:8080/postTest
    // Content-Type: application/json
    
    //{"var1": "11","var2": "22"}
    
    //返回
    //  报错 Bad Request
    

    总结

    requestParam只会读取url后面的参数,requestBody只会请求body中的data。其实也是算是跟名字描述一样了哈哈。pathVariable根据实际情况可以定义。

    个人在尝试过程中,content-type 如果是 application/x-www-form-urlencoded,其实相当于将url后的参数进行urlencoded之后作为参数。也是一个词如其名了。

    最后,还是建议要多写写,多试试。

    talk is cheap , show me the code
    本文由博客一文多发平台 OpenWrite 发布!

    相关文章

      网友评论

          本文标题:你的接口参数怎么接收的

          本文链接:https://www.haomeiwen.com/subject/uofaektx.html