Descripción

Publicar y consumir algunos métodos creados del API REST.

Publicar y Consumir

Usando CRUD

Simplemente usando los métodos que ya nos proporciona el CRUD

Crear Persona

Insertamos un nuevo registro a la tabla Persona.

1. En la clase PersonaController
2. Se mapea con /add
3. Recibe los parámetros nombre, edad y sexo
4. Se carga el Objeto Persona y se ejecuta la función save().
5. Retorna el mensaje Agregado correctamente.

   @RequestMapping("/add")
   public String addPersona(@RequestParam  String nombre,@RequestParam  int edad,@RequestParam  String sexo) {
      Persona p = new Persona();
      p.setNombre(nombre);
      p.setEdad(edad);
      p.setSexo(sexo);
      personaRepository.save(p);
   		
      return "Agregado correctamente";
   }

    

Resultado

Consultar todas las Personas

Consultamos todos los registros de la tabla Persona.

1. En la clase PersonaController
2. Se mapea con /all
3. No recibe parámetros
4. Retorna el resultado de la función findAll().

   @RequestMapping("/all")
      public Iterable<Persona> getPersona() {
      return personaRepository.findAll();
   }

Resultado

Borra una Persona

Borramos un registro de la tabla Persona.

1. En la clase PersonaController
2. Se mapea con /delete
3. Recibe el parámetro id
4. Se carga el Objeto Persona y se ejecuta la función delete().
5. Retorna el mensaje Borrado correctamente.

   @RequestMapping("/delete")
    public String deletePersona(@RequestParam int id) {
    Persona p = new Persona();
    p.setIdPersona(id);
    personaRepository.delete(p);
    return "Borrado correctamente";
    }
   

Resultado

Total de Personas

Total de registros de la tabla Persona.

1. En la clase PersonaController
2. Se mapea con /total
3. No recibe parámetros
4. Retorna el resultado de la función count().

   @RequestMapping("/total")
      public long totalPersona() { 
      return personaRepository.count();
   }

Resultado

Creamos consultas propias

Podemos crear otras consultas de acuerdo a nuestras necesidades

Persona por tipo de sexo

Obtenemos las Personas por su tipo de sexo

1. En la interface PersonaRepository agregamos la consulta que filtra por tipo de sexo

   @Query("select p from Persona p where p.sexo = ?1")
   Iterable<Persona> findBySexo(String sexo);

2. En la clase PersonaController
3. Se mapea con /allBySexo
4. Recibe el parámetro sexo
5. Retorna el resultado de la función findBySexo().

   @RequestMapping("/allBySexo")
   public Iterable<Persona> getPersonaBySexo(@RequestParam String sexo) {
      return personaRepository.findBySexo(sexo);
   }

Resultado

Persona por tipo de sexo con paginado

Obtenemos las Personas por su tipo de sexo. Los resultados se muestran paginados.

1. En la interface PersonaRepository agregamos la consulta que filtra por tipo de sexo y agrega paginado.

   @Query("select p from Persona p where p.sexo = ?1")
   Page<Iterable<Persona>> findBySexoPag(@Param("sexo") String sexo,Pageable pageable);

2. En la clase PersonaController
3. Se mapea con /sexoPag
4. Recibe los parámetros sexo, inicio y bloque. Estos 2 últimos parámetros para el paginado.
   
5. Se pasa los parámetros de paginado a la función findBySexoPag()
6. Retorna el resultado de la función findBySexoPag().

   @RequestMapping(value="/sexoPag")
      public Page<Iterable<Persona>> personaPag(@RequestParam String sexo,@RequestParam int inicio,@RequestParam int bloque) {
      return personaRepository.findBySexoPag(sexo, new PageRequest(inicio, bloque));
   }

Resultado

Persona por tipo de sexo con paginado y ordenado por un campo

Obtenemos las Personas por su tipo de sexo. Los resultados se muestran paginados y ordenados por un campo.

1. En la clase PersonaController
2. Se mapea con /sexoOrder
3. Recibe los parámetros sexo, inicio, bloque y orden.
   
4. Se pasa los parámetros de paginado y orden a la función findBySexoPag()
5. Retorna el resultado de la función findBySexoPag().

   @RequestMapping(value="/sexoOrder")
      public Page<Iterable<Persona>> personaOrder(@RequestParam String sexo,@RequestParam int inicio,@RequestParam int bloque,@RequestParam String orden) {
      return personaRepository.findBySexoPag(sexo, new PageRequest(inicio, bloque,Sort.Direction.ASC, orden));
   }

Resultado

Otras opciones

Podemos crear otras consultas con otros métodos HTTP; POST, PUT, DELETE  o PATCH. También enviando HEAD en la petición.

Agregar Persona con el método POST

@RequestMapping(value="/add",method=RequestMethod.POST)
   public String addPersonaPost(@RequestParam  String nombre,@RequestParam  int edad,@RequestParam  String sexo) {
   Persona p = new Persona();
   p.setNombre(nombre);
   p.setEdad(edad);
   p.setSexo(sexo);
   personaRepository.save(p);
   return "Agregado correctamente";
}

Resultado. Utilizando curl:

Obtener Personas del sexo=M mediante HEAD

@RequestMapping(value="/sexo",headers={"sexo=M"})
   public Iterable<Persona> personaM() {
   return personaRepository.findBySexo("M");
}

Resultado. Utilizando curl:

Otros

Descargar Proyecto

Se puede descargar el proyecto completo de https://github.com/arielolivagh/gs-rest-service-complete/tree/v2.0