連結到第一部分：REST API 和下一個測試任務 好吧，我們的應用程式正在運行，我們可以從中獲得某種回應，但這給我們帶來了什麼？它沒有做任何有用的工作。說到做到，讓我們實現一些有用的東西。首先，讓我們在 build.gradle 中加入一些新的依賴項，它們對我們很有用：
![Java-университет]()
![REST API 和資料驗證 - 1]()
已修改的類以藍色突出顯示，新的類以綠色突出顯示，如果你工作可以獲得這樣的指示使用git 儲存庫，但git 不是我們文章的主題，因此我們不會詳細討論它。因此，目前我們有一個端點支援 GET 和 POST 兩種方法。順便說一句，關於端點的一些有趣的資訊。例如，為什麼我們不為 GET 和 POST 分配單獨的端點，例如 getAllEmployees 或 createEmployees？一切都非常簡單——用一個點來處理所有請求會更加方便。路由基於 HTTP 方法進行，而且很直觀，無需記住 getAllEmployees、getEmployeeByName、get...update...create...delete... 的所有變體，讓我們測試一下我們得到了什麼。我已經在上一篇文章中寫道，我們需要 Postman，現在是時候安裝它了。在程式介面中，我們建立一個新的POST請求 ![REST API 和資料驗證 - 2]()
並嘗試發送它。如果一切順利，我們將在螢幕右側看到 Status 201。但例如，發送了相同的內容但沒有唯一的號碼（我們對此進行了驗證），我得到了不同的答案：好吧，讓我們檢查一下我們的完整選擇是如何工作的- 我們為同一端點 ![REST API 和資料驗證 - 3]()
創建一個GET 方法並發送它。 ![REST API 和資料驗證 - 4]()
我真誠地希望您一切順利，就像我一樣，我們下一篇文章再見。
implementation 'org.apache.commons:commons-lang3:3.12.0'
implementation 'org.apache.commons:commons-collections4:4.4'
implementation 'org.springframework.boot:spring-boot-starter-validation'{
"firstName": String,
"lastName": String,
"department": String,
"salary": String
"hired": String //"yyyy-mm-dd"
"tasks": [
]
}@Entity
@Data
@Accessors(chain = true)
public class Employee {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
@JsonIgnore
Long id;
@NotBlank
@Column(unique = true)
private String uniqueNumber;
private String firstName;
private String lastName;
private String department;
private Double salary;
private LocalDate hired;
@OneToMany
@JoinColumn(name = "employee_id")
List<Task> tasks = new ArrayList<>();
}@Entity
@Data
@Accessors(chain = true)
public class Task {
@Id
@GeneratedValue(strategy = GenerationType.IDENTITY)
private Long taskId;
}
public List<Employee> getAllEmployees() {
return employeeRepository.findAll();
}@PostMapping("${application.endpoint.employee}")
public ResponseEntity<?> createOrUpdateEmployee(@RequestBody final Employee employee) {
try {
employeeService.save(employee);
} catch (ValidationException e) {
return ResponseEntity.badRequest().body(e.getViolations());
}
return ResponseEntity.status(HttpStatus.CREATED).build();
}application:
endpoint:
root: api/v1
employee: ${application.endpoint.root}/employees
task: ${application.endpoint.root}/tasks@RestController
@RequestMapping("${application.endpoint.employee}")
@RequiredArgsConstructor
public class EmployeeController {
private final EmployeeService employeeService;
@GetMapping
public ResponseEntity<List<Employee>> getEmployees() {
return ResponseEntity.ok().body(employeeService.getAllEmployees());
}
@PostMapping
public ResponseEntity<?> createOrUpdateEmployee(@RequestBody final Employee employee) {
try {
employeeService.save(employee);
} catch (ValidationException e) {
return ResponseEntity.badRequest().body(e.getViolations());
}
return ResponseEntity.status(HttpStatus.CREATED).build();
}
}import com.example.demo.exception.ValidationException;
import com.example.demo.persistence.entity.Employee;
import lombok.RequiredArgsConstructor;
import org.apache.commons.collections4.CollectionUtils;
import org.springframework.stereotype.Service;
import java.util.List;
import java.util.Set;
import javax.validation.ConstraintViolation;
import javax.validation.Validator;
@Service
@RequiredArgsConstructor
public class ValidationService {
private final Validator validator;
public boolean isValidEmployee(Employee employee) throws ValidationException {
Set<Constraintviolation<Employee>> constraintViolations = validator.validate(employee);
if (CollectionUtils.isNotEmpty(constraintViolations)) {
throw new ValidationException(buildViolationsList(constraintViolations));
}
return true;
}
private <T> List<Violation> buildViolationsList(Set<Constraintviolation<T>> constraintViolations) {
return constraintViolations.stream()
.map(violation -> new Violation(
violation.getPropertyPath().toString(),
violation.getMessage()
)
)
.toList();
}
}public record Violation(String property, String message) {}@RequiredArgsConstructor
public class ValidationException extends Exception {
@Getter
private final List<Violation> violations;
}@Service
@RequiredArgsConstructor
public class EmployeeService {
private final EmployeeRepository employeeRepository;
private final ValidationService validationService;
public List<Employee> getAllEmployees() {
return employeeRepository.findAll();
}
@Transactional
public void save(Employee employee) throws ValidationException {
if (validationService.isValidEmployee(employee)) {
Employee existingEmployee = employeeRepository.findByUniqueNumber(employee.getUniqueNumber());
if (existingEmployee == null) {
employeeRepository.save(employee);
} else {
existingEmployee = updateFields(existingEmployee, employee);
employeeRepository.save(existingEmployee);
}
}
}
private Employee updateFields(Employee existingEmployee, Employee updatedEmployee) {
return existingEmployee.setDepartment(updatedEmployee.getDepartment())
.setSalary(updatedEmployee.getSalary())
//TODO implement tasks merging instead of replacement
.setTasks(updatedEmployee.getTasks());
}
}public interface EmployeeRepository extends JpaRepository<Employee, Long> {
Employee findByUniqueNumber(String uniqueNumber);
}
已修改的類以藍色突出顯示，新的類以綠色突出顯示，如果你工作可以獲得這樣的指示使用git 儲存庫，但git 不是我們文章的主題，因此我們不會詳細討論它。因此，目前我們有一個端點支援 GET 和 POST 兩種方法。順便說一句，關於端點的一些有趣的資訊。例如，為什麼我們不為 GET 和 POST 分配單獨的端點，例如 getAllEmployees 或 createEmployees？一切都非常簡單——用一個點來處理所有請求會更加方便。路由基於 HTTP 方法進行，而且很直觀，無需記住 getAllEmployees、getEmployeeByName、get...update...create...delete... 的所有變體，讓我們測試一下我們得到了什麼。我已經在上一篇文章中寫道，我們需要 Postman，現在是時候安裝它了。在程式介面中，我們建立一個新的POST請求 
並嘗試發送它。如果一切順利，我們將在螢幕右側看到 Status 201。但例如，發送了相同的內容但沒有唯一的號碼（我們對此進行了驗證），我得到了不同的答案：好吧，讓我們檢查一下我們的完整選擇是如何工作的- 我們為同一端點 
創建一個GET 方法並發送它。 
我真誠地希望您一切順利，就像我一樣，我們下一篇文章再見。
GO TO FULL VERSION