Para crear un WebService se siguen los pasos comunes en su construcción (Clic aquí para ver como crear un WebService desde cero). El siguiente paso es crear la conexión a la base de datos.
Para poder ejecutar las operaciones de CRUD mediante un Servicio Web REST con java debemos definir una conexión mediante una clase Java (clic aquí para ver la conexión de Java a MySQL) o mediante JPA
Código
Se creará un punto de partida para el WebService llamado RestApi que tendrá el siguiente código
package apiRest;
import javax.ws.rs.ApplicationPath;
import javax.ws.rs.core.Application;
@ApplicationPath("/service")
public class RestApi extends Application {
}Luego debemos de crear las funciones REST que se emplearán para las diversas funcionalidades del CRUD, como vamos a emplear JSON se puede optar por usar alguna biblioteca para manipular este formato de intercambio, pero se puede realizar este mismo procedimiento sin agregar ninguna bilbioteca adicional a Jersey y JAX-RS 2.0. Tendríamos una clase llamada JSONRest
package apiRest.services;
import javax.ws.rs.Consumes;
import javax.ws.rs.Path;
import javax.ws.rs.Produces;
import javax.ws.rs.core.MediaType;
@Path("/inquilino")
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
public class JSONRest {
/* Dentro se colocan los métodos
-GET
-POST
-PUT
-DELETE
*/
}SELECT
Tendremos dos casos, cuando recibimos todos los registros(inquilinosSEL) y cuando se recibe solo uno de los registros(inquilinosGET)
La clase JSONRest contiene el siguiente código
@GET
@Path("/{id}")
public Response inquilinosGET(@PathParam("id") int id) {
DaoInquilinos dao = new DaoInquilinosImpl();
Inquilinos inquilino= dao.inquilinosGet(id);
if (inquilino == null) {
String msg = "Inquilino no encontrado con id: " + id;
return Response.ok(msg, MediaType.TEXT_PLAIN).build();
} else {
return Response.ok(inquilino).build();
}
}
@GET
public Response inquilinosSEL() {
DaoInquilinos dao = new DaoInquilinosImpl();
List<Inquilinos> lista = dao.inquilinosSel();
if (lista == null) {
String msg = "Sin usuarios";
return Response.ok(msg, MediaType.TEXT_PLAIN).build();
} else {
GenericEntity<List<Inquilinos>> entity
= new GenericEntity<List<Inquilinos>>(lista) {
};
return Response.ok(entity).build();
}
}Probando desde el navegador
- http://localhost:8082/WebService/service/inquilinos/1
- http://localhost:8082/WebService/service/inquilinos/
Nota: la dirección (localhost) y el puerto (8082) variarán dependiendo de la ubicación y puerto empleado por el servidor de Java EE.
En el caso de la función "inquilinoGET" que requiere un valor para hacer la
búsqueda. Otra forma es usar la anotación que es @QueryParam en lugar de @PathParam y esa
anotación a su vez tiene como parámetro el nombre que tendrá desde la petición, similar a:
http://localhost:8082/WebService/service/inquilino/?id=1
INSERT
Se emplea el método POST, indicado mediante una anotación, para enviar la información a insertar, en nuestro caso es la BD la que genera automáticamente el código
La clase JSONRest contiene el siguiente código
@POST
@Produces(MediaType.TEXT_PLAIN)
public Response inquilinosINS(Inquilinos inquilino) {
DaoInquilinos dao = new DaoInquilinosImpl();
String msg = dao.inquilinosIns(inquilino);
return Response.ok(msg).build();
}UPDATE
Se emplea el método PUT, indicado mediante una anotación, para enviar la información que se desea modificar.
La clase JSONRest contiene el siguiente código
@PUT
@Produces(MediaType.TEXT_PLAIN)
public Response inquilinosUPD(Inquilinos inquilino) {
DaoInquilinos dao = new DaoInquilinosImpl();
String msg = dao.inquilinosUpd(inquilino);
return Response.ok(msg).build();
}DELETE
Urilizando la anotación DELETE se envía los identificadores de los registros a eliminar separados por comas. También se puede relizar eliminaciones individuales
La clase JSONRest contiene el siguiente código
@DELETE
@Path("/{ids}")
@Consumes(MediaType.TEXT_PLAIN)
@Produces(MediaType.TEXT_PLAIN)
public Response inquilinosDEL(@PathParam("ids") String ids) {
List<Integer> list = Arrays.stream(ids.split(","))
.map(Integer::parseInt)
.collect(Collectors.toList());
DaoInquilinos dao = new DaoInquilinosImpl();
String msg = dao.inquilinosDel(list);
return Response.ok(msg).build();
}Código completo
package apiRest.services;
import dao.DaoInquilinos;
import dao.impl.DaoInquilinosImpl;
import dto.Inquilinos;
import java.util.Arrays;
import java.util.List;
import java.util.stream.Collectors;
import javax.ws.rs.Consumes;
import javax.ws.rs.DELETE;
import javax.ws.rs.GET;
import javax.ws.rs.POST;
import javax.ws.rs.PUT;
import javax.ws.rs.Path;
import javax.ws.rs.PathParam;
import javax.ws.rs.Produces;
import javax.ws.rs.core.GenericEntity;
import javax.ws.rs.core.MediaType;
import javax.ws.rs.core.Response;
@Path("/inquilinos")
@Produces(MediaType.APPLICATION_JSON)
@Consumes(MediaType.APPLICATION_JSON)
public class JSONRest {
@GET
@Path("/{id}")
public Response inquilinosGET(@PathParam("id") int id) {
DaoInquilinos dao = new DaoInquilinosImpl();
Inquilinos inquilino = dao.inquilinosGet(id);
if (inquilino == null) {
String msg = "Inquilino no encontrado con id: " + id;
return Response.ok(msg, MediaType.TEXT_PLAIN).build();
} else {
return Response.ok(inquilino).build();
}
}
@GET
public Response inquilinosSEL() {
DaoInquilinos dao = new DaoInquilinosImpl();
List<Inquilinos> lista = dao.inquilinosSel();
if (lista == null) {
String msg = "Sin usuarios";
return Response.ok(msg, MediaType.TEXT_PLAIN).build();
} else {
GenericEntity<List<Inquilinos>> entity
= new GenericEntity<List<Inquilinos>>(lista) {
};
return Response.ok(entity).build();
}
}
@POST
@Produces(MediaType.TEXT_PLAIN)
public Response inquilinosINS(Inquilinos inquilino) {
DaoInquilinos dao = new DaoInquilinosImpl();
String msg = dao.inquilinosIns(inquilino);
return Response.ok(msg).build();
}
@PUT
@Produces(MediaType.TEXT_PLAIN)
public Response inquilinosUPD(Inquilinos inquilino) {
DaoInquilinos dao = new DaoInquilinosImpl();
String msg = dao.inquilinosUpd(inquilino);
return Response.ok(msg).build();
}
@DELETE
@Path("/{ids}")
@Consumes(MediaType.TEXT_PLAIN)
@Produces(MediaType.TEXT_PLAIN)
public Response inquilinosDEL(@PathParam("ids") String ids) {
List<Integer> list = Arrays.stream(ids.split(","))
.map(Integer::parseInt)
.collect(Collectors.toList());
DaoInquilinos dao = new DaoInquilinosImpl();
String msg = dao.inquilinosDel(list);
return Response.ok(msg).build();
}
}Se puede apreciar en este caso que en la anotación @Produces y @Consumes se indica explícitamente que se trabajará con JSON, pero en las respuestas de las funciones el tipo de retorno no es String, sino "Response", esto permite formatear correctamente el contenido capturado por las funciones DAO y transformarlo a JSON sin emplear otra biblioteca.
