在spring boot中处理rest接口的查询参数,最直接的方式是使用@requestparam注解将url中的键值对绑定到方法参数上。通过设置required属性为false并指定defaultvalue,可以优雅地处理可选参数和默认值逻辑,从而避免手动解析请求字符串。

@RequestParam如何映射单个查询参数
当接口需要接收一个明确的查询参数时,直接在控制器方法的参数列表前添加@RequestParam即可。如果参数名与变量名一致,可以省略参数名;若不一致或需要配置非必填项,则需显式声明。这种方式适用于简单的单值传递场景。

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
@RestController
public class QueryController {
@GetMapping("/search")
public String search(@RequestParam(value = "keyword", required = false, defaultValue = "default") String keyword) {
return "Searching for: " + keyword;
}
}
上述代码定义了一个GET接口,当访问/search?keyword=test时返回对应结果;若未提供该参数,则使用默认值default。这种写法清晰且符合REST规范,适合大多数基础查询需求。
如何处理多个参数或复杂对象绑定
对于包含多个字段的查询条件,除了逐个使用@RequestParam外,还可以利用Java Bean进行自动绑定。Spring MVC会自动将匹配的查询参数注入到对象字段中,前提是字段类型可转换且名称匹配。这种方式减少了方法签名的长度,提升了代码的可读性。

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
public class SearchCriteria {
private String category;
private Integer page;
// getters and setters omitted for brevity
}
@RestController
public class ComplexQueryController {
@GetMapping("/filter")
public String filter(SearchCriteria criteria) {
return "Category: " + criteria.getCategory() + ", Page: " + criteria.getPage();
}
}
当调用/filter?category=books&page=1时,Spring会自动实例化SearchCriteria并填充属性。若某个字段未提供且无默认值,对应属性将为null或基本类型的零值。此方式特别适用于筛选、分页等复合查询场景。
基于程序中某个输入、条件或结果的具体问题
在实际开发中,经常遇到查询参数缺失导致空指针异常的情况。例如,当使用@RequestParam但未设置required=false时,缺少该参数会直接抛出MissingServletRequestParameterException。为了避免此类错误中断流程,应始终根据业务需求明确参数的必要性,并通过默认值或Optional包装来处理潜在的空值风险。


















