Quarkus - 发布JSON Restful服务

目标

    基于实现第一个Hello World发布一个JSON的Restful服务，该服务提供GET,POST,DELETE三个接口，分别是获取水果列表，添加水果，根据水果名字删除水果。

发布Rest服务

POM配置

添加jackson扩展的依赖

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-resteasy-reactive-jackson</artifactId>
</dependency>

Quarkus也支持JSON-B，如果你喜欢JSON-B而不是Jackson，可以添加JSON-B的maven配置，如下：

<dependency>
    <groupId>io.quarkus</groupId>
    <artifactId>quarkus-resteasy-reactive-jsonb</artifactId>
</dependency>

代码开发

我们将创建一个应用程序来管理一个水果列表。

首先，让我们做一个Fruit javabean，如下所示：

public class Fruit {

    private String name;

    private String description;

    public Fruit() {}

    public Fruit(String name, String description) {
        this.name = name;
        this.description = description;
    }

    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;
    }
}

这是非常简单的。需要注意的重要一点是，JSON 序列化层需要具有默认构造函数。

接下来创建一个FruitResouce类来发布Restful接口，代码如下：

@Path("/fruits")
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
public class FruitResource {

    public List<Fruit> fruits = new ArrayList<>();

    public FruitResource() {
        fruits.add(new Fruit("Apple", "苹果"));
        fruits.add(new Fruit("Orange", "桔子"));
    }

    @GET
    public List<Fruit> list() {
        return fruits;
    }

    @POST
    public List<Fruit> add(Fruit fruit) {
        fruits.add(fruit);
        return fruits;
    }

    @DELETE
    public List<Fruit> del(String name) {
        fruits.forEach(e -> {
            if (name.equals(e.getName())) {
                fruits.remove(e);
            }
        });
        return fruits;
    }
}

非常简单，你只需要使用JAX-RS注解来定义你的实现节点。

测试

GET

POST

DELETE

Reponse方式发布Restful接口

创建Animals类

public class Animals {

    private String name;

    private String description;

    public Animals() {}

    public Animals(String name, String description) {
        this.name = name;
        this.description = description;
    }

    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;
    }
}

创建AnimalsResource类

@Path("/animals")
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
public class AnimalsResource {

    private final List<Animals> list = new ArrayList<>();

    public AnimalsResource() {
        list.add(new Animals("Cat", "猫"));
        list.add(new Animals("Dog", "狗"));
        list.add(new Animals("Pig", "猪"));
    }

    @GET
    public Response list() {
        return Response.ok(list).build();
    }
}

测试结果：

响应式编程

你可以使用响应式编程，Quarkus推荐使用Multi，RESTEasy Reactive与Mutiny集成，你的接口可以返回Uni或Multi实例，代码如下：

    @GET
    public Multi<List<Animals>> list() {
        return Multi.createFrom().item(list);
    }

    @GET
    @Path("/{index}")
    public Uni<Animals> getOne(Integer index) {
        return Uni.createFrom().item(list.get(index));
    }