如何用Spring EntityLinks生成指向/profiles/{user-id}/job的REST链接？

首先咱们来拆解下为什么EntityLinks生成的链接不符合预期：

EntityLinks的核心设计是围绕资源实体的主键生成链接，它会自动匹配@ExposesResourceFor标注的控制器中，带有实体主键路径变量（比如{id}）的单资源处理方法。但你的场景存在两个关键不匹配点：

1. 路径变量uniqueId属于UserProfile而非UserJob自身的主键，EntityLinks无法识别这种关联资源的路径变量，因此无法填充该参数；
2. 你期望的/job后缀是方法级的路径，EntityLinks默认只会解析到类级别的@RequestMapping路径（即PROFILES对应的/api/v1/profiles），不会自动拼接方法上的路径后缀。

解决方案1：调整控制器映射适配EntityLinks #

如果一定要用EntityLinks，需要调整UserJobController的映射结构，让路径符合EntityLinks对资源路径的预期——包含父资源（UserProfile）和自身资源（UserJob）的标识，示例如下：

@RestController
@RequestMapping(PROFILES + "/{uniqueId}/jobs") // 嵌套父资源路径
@ExposesResourceFor(UserJob.class)
public class UserJobController {

    // 获取用户所有职位经历：GET /api/v1/profiles/{uniqueId}/jobs
    @GetMapping
    @ResponseStatus(HttpStatus.OK)
    public HttpEntity<List<UserJob>> getUserJobs(@PathVariable String uniqueId) {
        System.out.println("user jobs");
        return new ResponseEntity<>(List.of(new UserJob()), HttpStatus.OK);
    }

    // 获取单个职位经历：GET /api/v1/profiles/{uniqueId}/jobs/{jobId}
    @GetMapping("/{jobId}")
    @ResponseStatus(HttpStatus.OK)
    public HttpEntity<UserJob> getUserJob(@PathVariable String uniqueId, @PathVariable Long jobId) {
        return new ResponseEntity<>(new UserJob(), HttpStatus.OK);
    }
}

此时就能用EntityLinks生成正确链接：

// 生成获取用户所有经历的链接
entityLinks.linkFor(UserJob.class, uniqueId).withRel(REL_EXPERIENCES);
// 输出：http://localhost:8085/api/v1/profiles/theCoder/jobs

解决方案2：继续使用linkTo(methodOn(...))（更适配当前场景） #

如果不想调整现有控制器结构，那EntityLinks确实不适合你的场景——它擅长处理标准单资源路径，而你的路径是基于关联资源标识的自定义路径。这种情况下，linkTo(methodOn(...))反而更准确，因为它直接基于控制器方法签名生成链接，能完美识别所有路径变量和后缀。

另外提个小细节：你的UserJobController用了@PostMapping但方法名是getUserJobs，语义上存在矛盾（PostMapping通常用于创建资源，获取资源建议用@GetMapping），建议调整避免混淆。

内容的提问来源于stack exchange，提问作者The Coder