Ya luego comentaré qué pasó conmigo y por qué no estuve enviando contenido a mi blog.
Hasta el momento hemos visto casi de manera abstracta el funcionamiento de RESTful usando Jersey desde NetBeans.
La mejor manera de probar un servicio es no creando una aplicación. Es decir, si vamos a probar como funciona algo, no tenemos que hacer un programa que utilice ese algo.
El objetivo principal del RESTful es proveer servicios estándar para todo tipo de cliente ¿cierto? Entonces, si hacemos una aplicación que consuma nuestro servicio, corremos el peligro de que ajustemos el servicio para que corra con nuestra aplicación y al final no sea estándar.
Asà que, antes de mostrar el RESTful, debemos instalar el complemento Poster en nuestro Firefox (porque asumimos que como buenos programadores, usamos Firefox) Este se puede descargar desde aquÃ: https://addons.mozilla.org/es-ES/firefox/addon/poster/
Ahora, les comento que he ordenado un poco el proyecto que hemos estado haciendo en los post anteriores. Ahora tiene un EJB que manejará la colección de entidades (como debe ser) y que está separado de la clase de recursos (como debe ser).
Además, el manejo de las peticiones CRUD en un REST son como sigue:
| Verbo REST | URI | Acción a realizar |
|---|---|---|
| POST | /persona | Create |
| GET | /persona/id | Read |
| PUT | /persona/id | Update |
| DELETE | /persona/id | Delete |
@Path("/persona")
@Consumes({"application/json", "application/xml"})
@Stateless
public class PersonaService {
@EJB
private PersonaFacade facade;
@POST
public Response create(Persona p) {
facade.insert(p);
return Response.ok(p).build();
}
@GET
@Path("{id}/")
public Persona read(@PathParam("id") int i) {
Persona p = facade.findById(i);
return p;
}
@GET
public List<Persona> read(@QueryParam("nombre")
@DefaultValue("") String nombre) {
List<Persona> l = nombre.isEmpty() ? facade.findAll() : facade.findByNombre(nombre);
return l;
}
@DELETE
@Path("/{id}")
public Response delete(@PathParam("id") int i) {
if (facade.delete(i)) {
return Response.ok().build();
}
return Response.status(Response.Status.NOT_FOUND).build();
}
@PUT
@Path("/{id}")
public Response update(@PathParam("id") int i, Persona p) {
p.setId(i);
facade.update(p);
return Response.ok().build();
}
}
Y el EJB es el siguiente:
@Stateless
public class PersonaFacade {
private static List<Persona> lista = new ArrayList<Persona>(); //lista temporal
public void insert(Persona p) {
lista.add(p); //agrega a la lista
}
public Persona findById(int id) {
Persona p = new Persona(id); //crea un objeto temporal...
int i = lista.indexOf(p); //... para buscarlo en la lista
if (i < 0) {//si no lo encuentra
return null; //... devuelve null
}
return lista.get(i); // sino, lo devuelve
}
public List<Persona> findAll() {
return lista;
}
public List<Persona> findByNombre(String nombre) {
List<Persona> $lista = new ArrayList<Persona>(); //un arreglo temporal
for (Persona persona : lista) { //se recorre la lista...
if (persona.getNombre().contains(nombre)) { //se compara el nombre
$lista.add(persona); //y si es parecido, lo agrega en la lista
}
}
return $lista; //... para devolverlo
}
public boolean delete(Persona p) {
return lista.remove(p);
}
public void update(Persona p) {
int pos = lista.indexOf(p); //busca en la lista..
if (pos >= 0) { //si lo encuentra...
lista.set(pos, p); //... lo actualiza
}
}
public boolean delete(int i) {
Persona p = findById(i);
return delete(p);
}
}
Ejecutando Poster
Ahora bien, una vez instalado el Poster en Firefox, lo abrimos haciendo clic en la barra inferior del navegador en el Ãcono color amarillo con una letra P. Esto nos abrirá la siguiente ventana:
Ejecutemos el proyecto desde nuestro NetBeans y veremos que se abrirá una ventana de bienvenida (no muy elegante) y un enlace para visualizar la descripción del recurso. Al hacer clic en ese enlace, se mostrará el WADL Podemos examinar por curiosidad para conocer los recursos existentes. Pero en este momento vamos a ver cómo funciona el Poster.
En la casilla URL se deberá poner el URI del servicio completo. Para nuestro ejemplo es http://localhost:8084/PersonasRestful/rest/persona (cambiar el puerto si es necesario)
En la casilla central llamada "Content type" se pondrá el tipo de datos que se manejará en el envÃo. Le pondremos el valor:
application/jsonEn la caja grande de entrada es el contenido a enviar. Ahà pondremos los datos a enviar.
Create
Para crear un nuevo objeto en la "base de datos" usando el servicio, necesitamos colocar el contenido siguiente:
{
"nombre":"Ann",
"fechaNacimiento":"2010-11-12"
}
Luego, hacemos clic en el botón central "POST". El Poster nos mostrará un resultado:
Intentemos agregar más objetos y hacer POST por cada uno de ellos.
Read
Para obtener el listado de todos los objetos registrados en el servicio, nos aseguramos que el URL apunte a URI
/rest/persona y hacemos clic en el botón GET. El Poster nos mostrará el siguiente contenido.
Esto me devuelve el listado completo. Pero si solo quiero uno de ellos, y conozco el ID, pondremos en el URI el ID de una persona. Por ejemplo
/rest/persona/2 y luego hacemos clic en "GET".
Update
Para actualizar un registro se debe tener lo siguiente: apuntar a un URI incluyendo el ID/rest/persona/2 y en el contenido colocar las propiedades a actualizar. Por ejemplo:{
"nombre":"Alfred",
"fechaNacimiento":"2010-11-12"
}
Y hacemos clic en el botón PUTEsta petición no nos ha respondido nada, ya que asà lo hemos pusimos en el RESTful.
Podemos verificar el contenido haciendo un GET de todos los objetos registrados.
Delete
Igual que el PUT y UPDATE... solo le indicamos el ID en el URI y hacemos clic en "DELETE". Luego verificamos haciendo un GET de todos los objetos registrados y veremos si está o no.
Cambiando el objeto resultado
Como podemos ver, todas las peticiones que hemos hecho (PUT y POST) tienen el formato JSON, pero los resultados a nuestras peticiones tienen formato XML. Bueno, por omisión el Jersey devolverá bajo ese tipo. Pero también permite devolver formato JSON si asà lo solicita el cliente POSTER. Para ello vamos a la pestaña "Headers" del Poster y agregamos la siguiente cabecera:- Accept: application/json
Recursos
El proyecto utilizado se puede descargar desde aquÃ:http://kenai.com/projects/apuntes/downloads/download/CRUDPersonasRest/personas-restful-crud.tar.gz