在控制器方法中接受请求体

Question

在我的控制器中，我有一个用以下映射映射的方法:@PostMapping（“/”）。

此方法需要一个我试图捕获的请求主体，如下所述：

使用这两种方法对我来说都很好，我只是进退两难，如果直接在实体类中接受请求体是一个好主意和最佳实践的话。

我不想在controller类中公开我的实体类，因为我不确定这是否是一个好主意。

@PostMapping("/")
public String create(@Valid @RequestBody Task task) {


}

java

public final class Task {

@NonNull
private int id;

@NotBlank(message = "Name is a mandatory field")
private String name;

private String decription;

@NotBlank(message = "date is a mandatory field")
private String date;

private boolean status;

@NotBlank(message = "severenes is a mandatory field")
private String severenes;

public Task(int id, String name, String decription, String date, boolean status, String severenes) {
    super();
    this.id = id;
    this.name = name;
    this.decription = decription;
    this.date = date;
    this.status = status;
    this.severenes = severenes;
}

public int getId() {
    return id;
}

public void setId(int id) {
    this.id = id;
}

public String getName() {
    return name;
}

public void setName(String name) {
    this.name = name;
}

public String getDecription() {
    return decription;
}

public void setDecription(String decription) {
    this.decription = decription;
}

public String getDate() {
    return date;
}

public void setDate(String date) {
    this.date = date;
}

public boolean isStatus() {
    return status;
}

public void setStatus(boolean status) {
    this.status = status;
}

public String getSeverenes() {
    return severenes;
}

public void setSeverenes(String severenes) {
    this.severenes = severenes;
}   

@Entity
@Table(name = "tasks")
public class Tasks {

@Id
@GeneratedValue(strategy = GenerationType.SEQUENCE)
@Column(name = "id")
private int id;

@Column(name = "name")
private String name;

@Column(name = "description")
private String description;

@Column(name = "date")
private LocalDateTime date;

@Column(name = "status")
private boolean status;

@Column(name = "severenes")
private String severenes;


public int getId() {
    return id;
}

public void setId(int id) {
    this.id = id;
}

public String getName() {
    return name;
}

public void setName(String name) {
    this.name = name;
}

public String getDescription() {
    return description;
}

public void setDescription(String description) {
    this.description = description;
}

public LocalDateTime getDate() {
    return date;
}

public void setDate(LocalDateTime date) {
    this.date = date;
}

public boolean isStatus() {
    return status;
}

public void setStatus(boolean status) {
    this.status = status;
}

public String getSeverenes() {
    return severenes;
}

public void setSeverenes(String severenes) {
    this.severenes = severenes;
}

这两种方法都给出了相同的结果，更多的是关注要遵循的最佳实践。

Answer 1

更多的是与软件设计原理有关。在本例中，这与关注点的分离有关。让我们假设您直接使用一个Tasks实体来进行DB操作和REST操作，而不是将Task（某种DTO）和Tasks（实体）分开。

• 您有一个在页面上显示任务的UI。
• 您正在数据库中存储任务。
• 要求现在已更改。您不再在数据库中存储任务状态，而是需要从第三方endpoint动态获取它。
• 您需要从Tasks实体字段中删除status字段，但仍需要将其返回到UI。由于您在两个层中使用了相同的实体，因此您不能轻松而明确地删除它，您应该怎么办，一些将来很难维护的变通方法？
• 您需要做更多的工作来提供这一点，一个需求更改会影响更多的层。

• 您有一个在页面上显示任务的UI。
• 您正在数据库中存储任务。
• 要求现在已更改。您不再在数据库中存储任务状态，而是需要从第三方endpoint动态获取它。
• 您需要从任务实体字段中删除状态字段，您可以。
• 已从第三方检索状态字段。
• 您通过聚合来自第三方和任务实体的状态创建了任务对象
• 您只更改了一层而不是两层。UI甚至没有意识到需求被更改，甚至您的逻辑层也不关心它。单一责任原则使您不必害怕变化。

是的，可能会有一些缺点，比如您需要更多的类来表示单个对象，但这就是分离。它使项目具有可维护性，易于重构/更改代码，并最大限度地减少更改的影响。