NoSQL с Hibernate OGM. Часть третья. Создание REST-приложения на WildFly

Реализация проста; с помощью аннотации @ApplicationScoped класс помечается как компонент CDI в области приложения (т. е. один единственный экземпляр этого компонента существует на протяжении всего жизненного цикла приложения). Он получает диспетчер сущностей JPA посредством внедрения зависимостей и использует его для реализации некоторых простых методов CRUD (Create, Read, Update, Delete). 
Обратите внимание, как метод getAll () использует запрос JP-QL для возврата всех объектов person. После выполнения этот запрос будет преобразован в эквивалентный индексный запрос Lucene, который будет выполняться через Hibernate Search. 
Хранилище для походов выглядит очень похоже, поэтому для краткости оно здесь опущено. Вы можете найти  его исходный код  на GitHub. 

Предоставление REST-услуг
JAX-RS упрощает создание веб-сервисов REST. Он определяет декларативную модель программирования, в которой вы аннотируете простые старые классы Java, чтобы обеспечить реализации для операций GET, POST, PUT и т. Д. Конечной точки HTTP. 
Подробное описание JAX-RS выходит за рамки данного руководства, например, обратитесь к руководству по  Java EE 7,  если вы хотите узнать больше. Давайте просто посмотрим на некоторые методы класса ресурсов для управления людьми в качестве примера: 

@Path("/persons")
@Produces("application/json")
@Consumes("application/json")
@Stateless
public class Persons {

    @Inject
    private PersonRepository personRepository;

    @Inject
    private ResourceMapper mapper;

    @Inject
    private UriMapper uris;

    @POST
    @Path("/")
    public Response createPerson(PersonDocument request) {
        Person person = personRepository.create( mapper.toPerson( request ) );
        return Response.created( uris.toUri( person ) ).build();
    }

    @GET
    @Path("/{id}")
    public Response getPerson(@PathParam("id") String id) {
        Person person = personRepository.get( id );
        if ( person == null ) {
            return Response.status( Status.NOT_FOUND ).build();
        }
        else {
            return Response.ok( mapper.toPersonDocument( person ) ).build();
        }
    }

    @GET
    @Path("/")
    public Response listPersons() { … }

    @PUT
    @Path("/{id}")
    public Response updatePerson(PersonDocument request, @PathParam("id") String id) { … }

    @DELETE
    @Path("/{id}")
    public Response deletePerson(@PathParam("id") String id) { … }
}

public class PersonDocument {

    private String firstName;
    private String lastName;
    private Set<URI> organizedHikes;

    // constructors, getters and setters...
}

{
    "firstName": "Saundra",
    "lastName": "Johnson",
    "organizedHikes": [
        "http://myserver/ogm-demo-part3/hike-manager/hikes/456",
        "http://myserver/ogm-demo-part3/hike-manager/hikes/789"
    ]
}

@Mapper(
    // allows to obtain the mapper via @Inject
    componentModel = "cdi",

    // a hand-written mapper class for converting entities to URIs; invoked by the generated
    // toPersonDocument() implementation for mapping the organizedHikes property
    uses = UriMapper.class
)
public interface ResourceMapper {

    PersonDocument toPersonDocument(Person person);

    List<PersonDocument> toPersonDocuments(Iterable<Person> persons);

    @Mapping(target = "date", dateFormat = "yyyy-MM-dd'T'HH:mm:ss.SSSZ")
    HikeDocument toHikeDocument(Hike hike);

    // other mapping methods ...
}