Spring MVC 中怎么使用 `@PathVariable` 获取 RESTful 路径参数

老宇君_8438

老宇君_8438

2026-08-08

218人浏览

原创

@pathvariable用于从restful url路径提取变量值,支持单个/多个变量绑定、简化写法、类型自动转换及正则约束匹配。

spring mvc 中怎么使用 `@pathvariable` 获取 restful 路径参数

在 Spring MVC 中,@PathVariable 用于从 RESTful 风格的 URL 路径中提取变量值,是构建清晰、语义化接口的关键注解。

基本用法:绑定单个路径变量

当 URL 中包含形如 /users/123 的结构时,可以用 @PathVariable 直接获取 123 这个值:

  • 在控制器方法参数上添加 @PathVariable("id"),并指定与 URL 中花括号内一致的名称
  • URL 映射需使用 {id} 占位符,例如:@GetMapping("/users/{id}")
  • 参数类型会自动转换(如 String → Long),失败时抛出 MethodArgumentTypeMismatchException

简化写法:省略 value 属性

如果方法参数名与路径变量名完全相同,可省略 @PathVariablevalue 属性:

Alibabacloud Sdk Client Initialization For Java
Alibabacloud Sdk Client Initialization For Java

在 Java 中初始化和管理阿里云 SDK客户端。包括单例模式、线程安全、endpoint 与 region 配置、VPC 终端节点、同步与异步等。

下载
  • @GetMapping("/posts/{slug}") + @PathVariable String slug
  • 等价于 @PathVariable("slug") String slug
  • 注意:需开启 Java 编译的 -parameters 参数(JDK 8+ 默认不保留参数名,IDEA 或 Maven 需显式配置)

多个路径变量同时提取

一个 URL 可含多个占位符,对应多个 @PathVariable 参数:

  • 例如:@GetMapping("/users/{userId}/orders/{orderId}")
  • 方法签名可写为:public String getOrder(@PathVariable Long userId, @PathVariable Long orderId)
  • 各参数名需与路径中花括号内的名称严格匹配,顺序无关

配合正则表达式约束路径格式

可在占位符中加入正则,让 Spring 只匹配符合规则的路径,避免无效请求进入方法:

  • @GetMapping("/products/{id:\d+}"):只匹配 id 为纯数字的路径,如 /products/100
  • @GetMapping("/files/{name:[a-z]+\.txt}"):匹配小写字母加 .txt 后缀,如 /files/report.txt
  • 不匹配时直接返回 404,不会调用控制器方法

相关专题

更多
spring框架介绍
spring框架介绍

本专题整合了spring框架相关内容,想了解更多详细内容,请阅读专题下面的文章。

2025.08.06

2091

22

Java Spring Security 与认证授权
Java Spring Security 与认证授权

本专题系统讲解 Java Spring Security 框架在认证与授权中的应用,涵盖用户身份验证、权限控制、JWT与OAuth2实现、跨站请求伪造(CSRF)防护、会话管理与安全漏洞防范。通过实际项目案例,帮助学习者掌握如何 使用 Spring Security 实现高安全性认证与授权机制,提升 Web 应用的安全性与用户数据保护。

2026.01.26

377

25

PHP API接口开发与RESTful实践
PHP API接口开发与RESTful实践

本专题聚焦 PHP在API接口开发中的应用,系统讲解 RESTful 架构设计原则、路由处理、请求参数解析、JSON数据返回、身份验证(Token/JWT)、跨域处理以及接口调试与异常处理。通过实战案例(如用户管理系统、商品信息接口服务),帮助开发者掌握 PHP构建高效、可维护的RESTful API服务能力。

2025.11.26

504

16

Vibeknow在线使用入口合集
Vibeknow在线使用入口合集

本专题汇总了Vibeknow在线创作视频的官方入口及网页版使用教程,涵盖PPT、PDF、Word等文档一键转讲解视频的核心操作,并整理了免费版水印规则与手机端浏览器访问指南,助你快速将知识内容视频化。

2026.09.21

0

20

NumPy随机数文件读写与dtype数据类型
NumPy随机数文件读写与dtype数据类型

本专题整理 NumPy 随机数、文件读写与 dtype 数据类型相关教程,覆盖 Generator/random、随机数种子、正态分布采样、npy/npz/CSV/TXT 保存读取、loadtxt/savetxt、memmap、大文件处理、astype 类型转换、结构化 dtype、整数溢出和精度丢失等场景。

2026.09.21

0

24

NumPy矩阵运算与线性代数计算
NumPy矩阵运算与线性代数计算

本专题整理 NumPy 矩阵运算与线性代数计算相关教程,覆盖矩阵乘法、dot 与 @ 运算符、逆矩阵、行列式、特征值与特征向量、SVD、线性方程组、欧氏距离、矩阵分解和大规模矩阵性能优化等内容,帮助读者掌握 np.linalg 与矩阵计算实战。

2026.09.21

0

20

NumPy广播机制数学运算与统计分析
NumPy广播机制数学运算与统计分析

本专题整理 NumPy 广播机制、数组数学运算与统计分析相关教程,覆盖广播规则、维度对齐、矩阵与数组加减除法、向量化计算、均值方差、分位数、中位数、直方图和 unique 频次统计等场景,帮助读者掌握 ndarray 高效计算与统计处理方法。

2026.09.21

0

17

NumPy数组创建索引切片与数据选择
NumPy数组创建索引切片与数据选择

本专题整理 NumPy 数组创建、索引、切片与数据选择相关教程,覆盖 np.array、zeros/ones、多维数组形状、基础切片、花式索引、布尔索引、条件筛选、视图与副本等常用场景,帮助读者系统掌握 ndarray 数据构造与高效提取方法。

2026.09.21

0

12

Aionclaw智能助手介绍
Aionclaw智能助手介绍

本专题汇总了AionClaw(AI龙虾助手)的功能介绍与在线使用入口。AionClaw是杭州趣猿人工智能有限公司推出的桌面级AI智能体,能直接在电脑上读写文件、运行脚本、操作浏览器,自动交付Word、PPT、Excel等成品。

2026.09.20

20

13

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习