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();
.../...
Pour avoir plus d'information sur les annotations JAX-RS Cf.JAX-RS : Understanding the Basics
Exemples d'utilisation
Un get sur /cxf/rest/domainService/users donnera :
[
-
{
language: "fr"
id: "bourges"
displayName: "R Bourges"
-
informations: [
-
{
id: 52
informationKey: "INSERT_DATE"
informationValue: "2011/06/10 12:57:13"
}
-
{
id: 54
informationKey: "UPDATE_DATE"
informationValue: "2011/06/10 18:21:46"
}
]
admin: false
}
-
{
language: "fr"
id: "colmant"
displayName: "Y Colmant"
-
informations: [
-
{
id: 53
informationKey: "INSERT_DATE"
informationValue: "2011/06/10 12:57:27"
}
]
admin: false
}
]