具有可选字段的 ReST 资源/模型

Question

我正在尝试学习如何实现 CRUD ReST API。我使用 JAX-RS 创建了一个简单的应用程序，并正在使用 Postman 测试我的 HTTP 方法。我的问题是，如何为 POST 方法的模型定义可选字段？

例如。 Person 包含 firstName、lastName 作为必填字段，age、gender 作为可选字段。

@XmlRootElement
public class Person {

private long id;
private String firstName;
private String lastName;

public Person() {}

public Person(long id, String firstName, String lastName) {
    this.id = id;
    this.firstName = firstName;
    this.lastName = lastName;
}

//getter and setters omitted

上面是另一个资源的子资源，下面是addPerson服务方法用于POST到HashMap。

public Person addPerson(long userId, Person person) {
    Map<Long, Person> persons = users.get(userId).getPersons();
    person.setId(persons.size() + 1);
    persons.put(person.getId(), person);

    return person;
}

我想过构造一个模型，它的构造函数有多个不同的参数组合来实例化一个模型类，但这似乎效率不高。有人可以建议吗？

进一步编辑：这需要在处理 JSON 时完成。给定两个 JSON 格式的请求：

{
 "firstName": "Jay",
 "lastName": "Kay",
 "age": "13"
}

和

{
 "firstName": "Jay",
 "lastName": "Kay"
 }

两者都应该是可处理的，因为年龄（以及性别）是一个“可选属性”，所以它可以被省略，也可以有一个值。我遇到 JSON 解析器并尝试通读它们，因为这可能是处理此类请求的答案。

Answer 1

在您的 Person 类中添加性别和年龄

@XmlRootElement
public class Person {

    private long id;
    private String firstName;
    private String lastName;
    private int age;
    private String gender;


    public Person() {}

    public Person(long id, String firstName, String lastName) {
        this.id = id;
        this.firstName = firstName;
        this.lastName = lastName;
    }
}

从 Postman 发出请求时，将 age 和 gender 作为键包含在 x-www-form-urlencoded 中。

默认情况下，integer 的值为0，String 的值为空字符串。

在处理请求的方法中，检查 gender 和 age 的值。 如果请求中提供了值，则使用Person 类的设置器相应地设置值。

假设以下是您处理请求的方法：

@POST
@Path("/AddPerson")
@Produces(MediaType.TEXT_PLAIN)

public String addPerson(@FormParam("id") long id, 
    @FormParam("firstName") String firstName,
    @FormParam("lastName") String lastName, 
    @FormParam("age") int age, 
    @FormParam("gender") String gender) {

    Person person = new Person(id,firstName,lastName);

    if(age != 0) {
        person.setAge(age);
    }

    if(!gender.equals("")) {
        person.setGender(gender)
    }

    // Assuming that PersonService class has the addPerson method
    PersonService.addPerson(1,person)

    return "Person with id "+ id + " added";

}