rrezartprebreza/spring-boot-skills / skills/spring-boot-3/hateoas
hateoas
VerifiedUse when adding hypermedia links to REST responses, building self-describing APIs, or implementing Spring HATEOAS. Use when you see EntityModel, CollectionModel, or RepresentationModel in the project.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 5.7 KB |
| agents/openai.yaml | config | 182 B |
| examples/bad-hateoas-controller.java | other | 1.6 KB |
| examples/good-hateoas-controller.java | other | 2.0 KB |
| templates/OrderModelAssembler.java | other | 1.9 KB |
examples/good-hateoas-controller.java
View on GitHub// GOOD — RepresentationModelAssembler, conditional links, PagedResourcesAssembler
@Component
@RequiredArgsConstructor
public class OrderModelAssembler
implements RepresentationModelAssembler<Order, EntityModel<OrderResponse>> {
@Override
public EntityModel<OrderResponse> toModel(Order order) {
EntityModel<OrderResponse> model = EntityModel.of(
OrderResponse.from(order),
linkTo(methodOn(OrderController.class).getById(order.getId())).withSelfRel(),
linkTo(methodOn(OrderController.class).list(null, null)).withRel("orders"));
// Conditional action links — only when the action is valid
if (order.getStatus() == OrderStatus.PENDING) {
model.add(linkTo(methodOn(OrderController.class)
.confirm(order.getId())).withRel("confirm"));
model.add(linkTo(methodOn(OrderController.class)
.cancel(order.getId())).withRel("cancel"));
}
if (order.getStatus() == OrderStatus.CONFIRMED) {
model.add(linkTo(methodOn(OrderController.class)
.ship(order.getId())).withRel("ship"));
}
return model;
}
}
@RestController
@RequestMapping("/api/v1/orders")
@RequiredArgsConstructor
public class OrderController {
private final OrderService orderService;
private final OrderModelAssembler assembler;
@GetMapping("/{id}")
public ResponseEntity<EntityModel<OrderResponse>> getById(@PathVariable UUID id) {
Order order = orderService.findById(id);
return ResponseEntity.ok(assembler.toModel(order));
}
@GetMapping
public ResponseEntity<PagedModel<EntityModel<OrderResponse>>> list(
Pageable pageable,
PagedResourcesAssembler<Order> pagedAssembler) {
Page<Order> orders = orderService.findAll(pageable);
PagedModel<EntityModel<OrderResponse>> pagedModel =
pagedAssembler.toModel(orders, assembler);
return ResponseEntity.ok(pagedModel);
}
}
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| receiving-code-reviewobra/superpowersUse when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| requesting-code-reviewobra/superpowersUse when completing tasks, implementing major features, or before merging to verify work meets requirements | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| using-git-worktreesobra/superpowersUse when starting feature work that needs isolation from current workspace or before executing implementation plans - ensures an isolated workspace exists via native tools or git worktree fallback | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| verification-before-completionobra/superpowersUse when about to claim work is complete, fixed, or passing, before committing or creating PRs - requires running verification commands and confirming output before making any success claims; evidence before assertions always | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |