SpringBoot注解@GetMapping处理Get请求

一、如何从URL中获取参数

当你想从URL中获取名为courseId的参数时，可以使用@GetMapping("/course/{courseId}")和@GetMapping("/course")两种办法，主要体现在URL模式和如何获取参数上。

1. 使用@GetMapping("/course/{courseId}"):

   • 这种方式表示你正在定义一个REST风格的API，其中{courseId}是URL的一部分，通常被称为路径变量（path variable）。
   • 你可以通过在方法的参数中加上@PathVariable注解来获取这个路径变量。例如：

     @GetMapping("/course/{courseId}")
     public String getCourse(@PathVariable String courseId) {
         // 使用courseId
     }
     

   • 这种方式适合于当courseId是必需的，并且每个课程的URL都是唯一的情况。

2. 使用@GetMapping("/course"):

   • 这种方式下，URL不直接包含courseId。相反，courseId可以作为请求参数（query parameter）来传递。
   • 你可以通过在方法的参数中加上@RequestParam注解来获取这个请求参数。例如：

     @GetMapping("/course")
     public String getCourse(@RequestParam String courseId) {
         // 使用courseId
     }
     

   • 这种方式适合于当你想要让courseId作为一个可选参数或者你希望从一组标准的URL中筛选特定课程的情况。

二、获取多个参数

当URL中有多个参数时，@GetMapping("/course/{courseId}")和@GetMapping("/course")的使用方式和它们之间的区别仍然基于路径变量（Path Variable）和请求参数（Request Parameter）的概念。这两种方法可以根据参数的性质和用途灵活组合使用。

1. 使用路径变量（Path Variables）:

   • 当你使用@GetMapping("/course/{courseId}")并且URL中有多个参数时，这些参数通常是URL路径的一部分，并且每个参数都是资源定位的关键部分。
   • 例如，如果你有一个URL像这样：/course/{courseId}/module/{moduleId}，你可以这样使用：

     @GetMapping("/course/{courseId}/module/{moduleId}")
     public String getModule(@PathVariable String courseId, @PathVariable String moduleId) {
         // 使用courseId和moduleId
     }
     

   • 在这个例子中，courseId和moduleId都是路径的一部分，用来定位特定的资源。

2. 使用请求参数（Request Parameters）:

   • 当你使用@GetMapping("/course")并且URL中有多个参数时，这些参数通常作为URL的查询字符串（query string）。
   • 例如，URL可能是这样的：/course?courseId=123&moduleId=456，你可以这样使用：

     @GetMapping("/course")
     public String getCourse(@RequestParam String courseId, @RequestParam String moduleId) {
         // 使用courseId和moduleId
     }
     

   • 在这个例子中，courseId和moduleId是作为查询字符串的一部分传递的，通常用于过滤、排序或其他非资源定位的操作。

三、用一个类接收多个参数

对于URL中包含多个请求参数（如 /course?courseId=123&moduleId=456），你可以使用一个Java类来接收所有这些参数。这种方法可以使代码更加整洁，尤其是当处理具有多个参数的复杂请求时。

这里是如何使用一个类来接收所有请求参数的示例：

1. 定义一个类来表示请求参数:
   首先，你需要定义一个类，其属性对应于URL中的请求参数。例如，对于参数courseId和moduleId，你可以定义如下类：

   public class CourseQuery {
       private String courseId;
       private String moduleId;
   
       // 标准的getter和setter方法
       public String getCourseId() {
           return courseId;
       }
   
       public void setCourseId(String courseId) {
           this.courseId = courseId;
       }
   
       public String getModuleId() {
           return moduleId;
       }
   
       public void setModuleId(String moduleId) {
           this.moduleId = moduleId;
       }
   
       // 可以添加构造函数、toString()等
   }
   

2. 在控制器方法中使用这个类:
   接下来，在你的控制器方法中，你可以将这个类作为参数，并使用@ModelAttribute注解（或者不使用任何注解，因为Spring MVC会自动将请求参数绑定到类的属性上）：

   @GetMapping("/course")
   public String getCourse(@ModelAttribute CourseQuery query) {
       // 使用query.getCourseId()和query.getModuleId()
   }
   

   或者，如果你不使用@ModelAttribute注解，Spring MVC默认也会按照相同的方式处理这个参数：

   @GetMapping("/course")
   public String getCourse(CourseQuery query) {
       // 使用query.getCourseId()和query.getModuleId()
   }
   

使用这种方式，你可以轻松地处理包含许多参数的复杂请求，同时保持代码的清晰和可维护性。这也让你能够在需要时对参数进行验证，比如使用Spring的验证框架来确保传入的参数满足特定条件。

四、疑问

Q：定义一个类来表示请求参数时，不需要使用@RequestParam吗？还是说@RequestParam用于简单的类型获取单个参数，比如String？

在定义一个类来表示请求参数时，通常不需要在类的属性上使用@RequestParam注解。当你使用一个类来接收请求参数，Spring MVC的数据绑定机制会自动将请求中的参数名称映射到类的属性上。这是基于类的属性名和请求参数名的匹配来完成的。

使用类接收参数:

• 当你有多个请求参数，并且想要将它们组织在一个类中时，你可以定义一个类，其属性与请求参数的名称相对应。
• 在控制器方法中，你可以使用这个类的实例作为参数，而无需为每个属性单独使用@RequestParam。Spring会自动处理参数到类属性的映射。
• 例如：

  public class CourseQuery {
      private String courseId;
      private String moduleId;
  
      // getter和setter省略
  }
  
  @GetMapping("/course")
  public String getCourse(CourseQuery query) {
      // 使用query.getCourseId()和query.getModuleId()
  }
  

使用@RequestParam:

• @RequestParam通常用于获取单个请求参数，特别是当这个参数是一个简单类型（如String、int等）时。
• 当你只需要从请求中获取一个或少数几个参数，而不是一个复杂对象时，@RequestParam是一个很好的选择。
• 例如：

  @GetMapping("/course")
  public String getCourse(@RequestParam String courseId, @RequestParam String moduleId) {
      // 直接使用courseId和moduleId
  }
  

总结来说，当处理包含多个参数的复杂请求时，使用一个类来封装这些参数可以使代码更加清晰和易于维护。而@RequestParam适用于处理更简单或直接的参数获取需求。在实际的应用中，你可以根据具体情况选择最适合的方法。

Q:假如我已经有一个在/course上的controller了，如下
@PostMapping("/course") public CourseBaseInfoDto createCourseBase(@RequestBody AddCourseDto dto)
我还能继续写
@GetMapping("/course") public String getCourse(@RequestParam String courseId, @RequestParam String moduleId)
吗？

是的，你完全可以在同一个控制器（Controller）中同时定义一个@PostMapping和一个@GetMapping方法，即使它们都映射到了相同的路径（如/course）。这是因为HTTP请求的方法类型（GET、POST等）作为映射的一部分，允许区分不同的操作。在你的例子中，一个方法用于处理POST请求，另一个用于处理GET请求。

1. @PostMapping("/course") 用于创建课程（通常是添加新资源），接收一个请求体（RequestBody）。

2. @GetMapping("/course") 用于获取课程信息（通常是读取资源），接收URL中的请求参数（RequestParam）。

你的控制器可能看起来像这样：

@RestController
@RequestMapping("/path-to-controller")
public class CourseController {

    @PostMapping("/course")
    public CourseBaseInfoDto createCourseBase(@RequestBody AddCourseDto dto) {
        // 创建课程的逻辑
    }

    @GetMapping("/course")
    public String getCourse(@RequestParam String courseId, @RequestParam String moduleId) {
        // 获取课程信息的逻辑
    }
}

在这种配置中，当一个POST请求发送到/course时，createCourseBase方法将被调用；而当一个GET请求发送到/course时，带有请求参数的getCourse方法将被调用。

这种方法是RESTful API设计中的常见实践，它允许你在同一路径上对资源进行不同类型的操作，同时保持了代码的清晰和逻辑的分离。