最初の部分へのリンク: REST API と次のテスト タスク さて、アプリケーションは動作しており、アプリケーションから何らかの応答を得ることができますが、これで何が得られるでしょうか? それは何の有益な仕事もしません。言うまでもなく、便利なものを実装しましょう。まず最初に、build.gradle にいくつかの新しい依存関係を追加しましょう。これらは役に立つでしょう。
![Java-университет]()
![REST API とデータ検証 - 1]()
変更されたクラスは青でハイライトされ、新しいクラスは緑でハイライトされています。作業を行うと、このような表示が得られます。 git リポジトリを使用しますが、git はこの記事のトピックではないため、これについては詳しく説明しません。したがって、現時点では GET と POST という 2 つのメソッドをサポートする 1 つのエンドポイントがあります。ところで、エンドポイントに関する興味深い情報がいくつかあります。たとえば、getAllEmployees や createEmployees など、GET と POST に別個のエンドポイントを割り当てなかったのはなぜでしょうか。すべてが非常にシンプルです。すべてのリクエストに対して単一のポイントがある方がはるかに便利です。ルーティングは HTTP メソッドに基づいて行われ、直感的であるため、getAllEmployees、getEmployeeByName、get... update... create... delete... のすべてのバリエーションを覚える必要はありません。取得した内容をテストしてみましょう。前回の記事で Postman が必要になると書きましたが、今度は Postman をインストールします。プログラム インターフェイスで、新しい POST リクエストを作成し ![REST API とデータ検証 - 2]()
、送信しようとします。すべてがうまくいけば、画面の右側にステータス 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 という 2 つのメソッドをサポートする 1 つのエンドポイントがあります。ところで、エンドポイントに関する興味深い情報がいくつかあります。たとえば、getAllEmployees や createEmployees など、GET と POST に別個のエンドポイントを割り当てなかったのはなぜでしょうか。すべてが非常にシンプルです。すべてのリクエストに対して単一のポイントがある方がはるかに便利です。ルーティングは HTTP メソッドに基づいて行われ、直感的であるため、getAllEmployees、getEmployeeByName、get... update... create... delete... のすべてのバリエーションを覚える必要はありません。取得した内容をテストしてみましょう。前回の記事で Postman が必要になると書きましたが、今度は Postman をインストールします。プログラム インターフェイスで、新しい POST リクエストを作成し 
、送信しようとします。すべてがうまくいけば、画面の右側にステータス 201 が表示されます。しかし、たとえば、同じものを送信したものの、（検証済みの）一意の番号がない場合は、別の答えが得られます。では、完全な 
選択がどのように機能するかを確認しましょう。同じエンドポイントに対して GET メソッドを作成し、それを送信します。 。 
私と同じように、あなたにとってもすべてがうまくいくことを心から願っています。また次の記事でお会いしましょう。
GO TO FULL VERSION