Sommaire :
Introduction
Esup-commons V2 utilise la norme JAX-RS pour exposer la couche métier en REST. L'implémentation utilisée est celle offerte pour CXF.
Utilisation
En JAX-RS il est très simple d'exposer la couche métier sous forme d'un service REST. Cela revient à utiliser des annotations au niveau de l'interface DomainService :
@Path("/domainService/")
@Produces("application/json")
public interface DomainService extends Serializable {
.../...
@GET
@Path("/users/{id}")
User getUser(@PathParam("id") String id) throws UserNotFoundException;
.../...
@GET
@Path("/users")
List<User> getUsers();
.../...
@DELETE
@Path("/users/{id}")
void deleteUser(@PathParam("id") User user);
.../...
@PUT
@Path("/users")
void addUser(User user);
.../...
Pour avoir plus d'information sur les annotations JAX-RS Cf.JAX-RS : Understanding the Basics
Exemple d'utilisation
Un get sur /cxf/rest/domainService/users/colmant donnera :
{
"language":"fr",
"id":"colmant",
"displayName":"Y Colmant",
"informations":
[
{
"id":53,
"informationKey":"INSERT_DATE",
"informationValue":"2011/06/10 12:57:27"
}
],
"admin":false
}