| Layer
| Vai trò
| ví dụ
|
| controller
| Nhận request từ client và trả response
| @PostMapping
public ApiResponse<PlanningResponse> create(@Valid @RequestBody PlanningCreateRequest req) {
return ApiResponse.ok(service.create(req));
}
|
| service
| Xử lý logic nghiệp vụ
| public PlanningResponse get(Long id) {
PlanningEntity e = repo.findById(id).orElseThrow(() ->
new AppException(ErrorCode.NOT\_FOUND, HttpStatus.NOT\_FOUND, "Planning not found: " + id)
);
return toResponse(e);
}
|
| repository
| Truy cập và thao tác dữ liệu
| public interface PlanQueryRepository {
long count(PlanListFilter filter);
List<PlanListItem> list(PlanListFilter filter);
}
|
| entity
| Mapping bảng database
| public class PlanningEntity {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long id;
}
|
| dto
| Model request và response
| public class PlanListFilter {
private String keyword;
private Integer page = 1; // 1-based
private Integer size = 20;
private String sortBy = "created\_at";
private String sortDir = "desc";
public String getKeyword() { return keyword; }
public void setKeyword(String keyword) { this.keyword = keyword; }
public Integer getPage() { return page; }
public void setPage(Integer page) { this.page = page; }
public Integer getSize() { return size; }
public void setSize(Integer size) { this.size = size; }
public String getSortBy() { return sortBy; }
public void setSortBy(String sortBy) { this.sortBy = sortBy; }
public String getSortDir() { return sortDir; }
public void setSortDir(String sortDir) { this.sortDir = sortDir; }
}
|