jhipster-spring

JHipster Spring Boot

Develop and customize the Spring Boot backend generated by JHipster, following the layered architecture with Controllers, Services, Repositories, DTOs, and MapStruct Mappers.

When to Use

• When creating new REST endpoints
• When implementing service layer business logic
• When creating custom repository queries
• When defining DTOs and MapStruct mappers
• When customizing generated backend code

Available Operations

1. Create REST controllers with pagination and filtering
2. Implement service layer with transaction management
3. Define DTOs using Java Records
4. Create MapStruct mappers
5. Add custom repository queries with Spring Data JPA

Multi-Step Workflow

Step 1: Understand the Layer Architecture

Controller (web/rest/) --> Service (service/) --> Repository (repository/) --> Entity (domain/)
                            |
                        DTO + Mapper (service/dto/ + service/mapper/)

Step 2: Create the Controller

@RestController
@RequestMapping("/api/v1/demands")
public class DemandResource {

    private final DemandService demandService;

    public DemandResource(DemandService demandService) {
        this.demandService = demandService;
    }

    @GetMapping
    public ResponseEntity<List<DemandDTO>> getAllDemands(
            @RequestParam(required = false) DemandStatus status,
            @org.springdoc.core.annotations.ParameterObject Pageable pageable) {
        Page<DemandDTO> page = demandService.findAll(status, pageable);
        return ResponseEntity.ok()
            .headers(PaginationUtil.generatePaginationHttpHeaders(
                ServletUriComponentsBuilder.fromCurrentRequest(), page))
            .body(page.getContent());
    }

    @PostMapping
    @ResponseStatus(HttpStatus.CREATED)
    public DemandDTO createDemand(@Valid @RequestBody CreateDemandDTO dto) {
        return demandService.create(dto);
    }

    @GetMapping("/{id}")
    public ResponseEntity<DemandDTO> getDemand(@PathVariable Long id) {
        return ResponseUtil.wrapOrNotFound(demandService.findOne(id));
    }

    @PutMapping("/{id}")
    public DemandDTO updateDemand(@PathVariable Long id, @Valid @RequestBody UpdateDemandDTO dto) {
        return demandService.update(id, dto);
    }

    @DeleteMapping("/{id}")
    @ResponseStatus(HttpStatus.NO_CONTENT)
    public void deleteDemand(@PathVariable Long id) {
        demandService.delete(id);
    }
}