Начало работы

Эта статья представляет собой пример демонстрации того, как использовать vert.x zero в вашем проекте.

1. Исходный код

package org.exmaple;

import io.vertx.up.annotations.EndPoint;

import javax.ws.rs.GET;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;

@Path("/up/example")
@EndPoint
public class ZeroExpApi {

    @GET
    @Path("/first/{name}")
    public String sayZero(
            @PathParam("name") final String name) {
        return "Hello " + name;
    }
}

2. Консоль

Затем вы можете запустить свой API с помощью загрузчика. Для получения подробной информации о загрузчике обратитесь к домашней странице этого проекта. Вы должны увидеть следующие журналы в консоли:

...
[ ZERO ] ( 1 Event ) The endpoint org.exmaple.ZeroExpApi scanned 1 events of Event,  ...
...
[ ZERO ] ( Uri Register ) "/up/exmaple/first/:name" has been deployed by ZeroHttpAgent, ...
...

3. Тестирование с помощью curl

curl http://localhost:6083/up/example/first/zero
{"brief":"OK","status":200,"data":"Hello zero"}

4. Советы

Это очень простой демонстрационный API конечной точки. Вот два комментария к этому примеру:

• Все классы API должны быть помечены аннотацией io.vertx.up.annotation.@EndPoint, такие классы могут быть просканированы Zero.
• Zero реализовал часть JSR311, вы можете использовать некоторые аннотации, предоставляемые JSR311, такие как: javax.ws.rs.@GET, java.ws.rs.@Path и т. д.
• Ваш метод должен быть помечен одной из аннотаций метода: как javax.ws.rs.@GET выше, Zero проигнорирует метод, который не был помечен аннотацией HTTP-метода.