En este post te mostraré cómo crear una API REST usando el lenguaje de programación Java, el framework Spring Boot y la base de datos MySQL. Va a ser un proyecto simple pero a partir del mismo vas a poder crear más endpoints o rutas para consumir distintos modelos.
Lo que tendremos al final será un proyecto sencillo que expone una API REST con los métodos HTTP GET, POST, PUT y DELETE, interactuando con la base de datos en MySQL y además soportando CORS.
Por cierto, para el intercambio y consumo de datos vamos a usar JSON.
Puedes crear un proyecto usando gradle, o usando Spring Initializr. También puedes descargar el proyecto ya terminado que te dejaré al final del post.
Nuestro archivo build.gradle
debe tener al menos las siguientes dependencias. Obviamente no debe ser idéntico, sino parecido a:
plugins {
id 'org.springframework.boot' version '2.3.3.RELEASE'
id 'io.spring.dependency-management' version '1.0.10.RELEASE'
id 'java'
}
group = 'com.example'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '11'
repositories {
mavenCentral()
}
dependencies {
implementation 'org.springframework.boot:spring-boot-starter'
implementation 'org.springframework.boot:spring-boot-starter-web'
testImplementation('org.springframework.boot:spring-boot-starter-test') {
exclude group: 'org.junit.vintage', module: 'junit-vintage-engine'
}
// Para conectar a bases de datos
compile 'org.springframework.boot:spring-boot-starter-data-jpa'
compile 'mysql:mysql-connector-java'
}
test {
useJUnitPlatform()
}
Estamos usando spring-boot-starter-web
para tener las anotaciones para poder crear la API REST, parsear automáticamente la petición a una clase de Java, etcétera.
También estamos usando JPA y el conector de MySQL para poder consumir datos de esta base de datos y realizar las migraciones pertinentes.
Recuerda que debes contar con MySQL instalado. También debes crear una base de datos que será exclusiva para el proyecto. Para esto puedes usar phpmyadmin, workbench o la terminal. Al final debes tener una base de datos vacía.
Luego, en la carpeta de resources vamos a crear un archivo llamado application.properties
para configurar las credenciales. Se debe ver así, cambiando obviamente tus credenciales:
spring.jpa.hibernate.ddl-auto=update
spring.datasource.url=jdbc:mysql://localhost:3306/consumo_api?useUnicode=true&serverTimezone=UTC
spring.datasource.username=root
spring.datasource.password=
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL5Dialect
En mi caso mi base de datos se llama consumo_api
; mi usuario es root
y no tengo contraseña, por lo que es una cadena vacía.
Cada entidad será una tabla de la base de datos. En este caso vamos a definir la clase Alumno
, pues la API se tratará de un CRUD de alumnos. Queda así:
package me.parzibyte.api;
import javax.persistence.Entity;
import javax.persistence.GeneratedValue;
import javax.persistence.GenerationType;
import javax.persistence.Id;
@Entity
public class Alumno {
@Id
@GeneratedValue(strategy = GenerationType.AUTO)
public Long id;
public String nombre;
}
Analicemos. Antes de la declaración de la clase colocamos la anotación de @Entity
para indicar que será una entidad. Después definimos las propiedades de nuestra clase, en este caso necesitamos el id y el nombre.
Para el id estamos usando la anotación de @Id
y de @GeneratedValue
, esto es para indicar que ese es el ID a nivel de base de datos. Con esto, haremos que a partir de la entidad se genere una tabla en la base de datos.
En SpringBoot, un repositorio permite relacionar la entidad y la base de datos. A través del repositorio hacemos las operaciones de SELECT, UPDATE, DELETE e INSERT con los métodos findAll
, save
, deleteById
y de nuevo save
, en ese orden.
Lo bueno de todo esto es que simplemente es un interfaz que indica la Entidad, y el Id. La misma extiende de CrudRepository y queda así:
package ControlEscolarSpringBoot;
import org.springframework.data.repository.CrudRepository;
public interface AlumnosRepository extends CrudRepository<Alumno, Long> {
}
En este caso la entidad es Alumno y el tipo de dato del ID es Long.
Finalmente el controlador se encarga de:
Si te fijas, se está inyectando de manera automática gracias a la anotación @Autowired
. Queda así:
package me.parzibyte.api;
import org.springframework.web.bind.annotation.*;
import org.springframework.beans.factory.annotation.Autowired;
@RestController
@RequestMapping(path = "/alumnos")
@CrossOrigin(origins = "http://localhost")
public class AlumnosController {
@Autowired
private AlumnosRepository alumnosRepository;
@RequestMapping(value = "/crear", method = RequestMethod.POST)
public Alumno crearAlumno(@RequestBody Alumno alumno) {
return alumnosRepository.save(alumno);
}
@RequestMapping(value = "/obtener", method = RequestMethod.GET)
public Iterable<Alumno> obtenerTodos() {
return alumnosRepository.findAll();
}
@RequestMapping(value = "/eliminar/{id}", method = RequestMethod.DELETE)
public boolean eliminar(@PathVariable() Long id) {
alumnosRepository.deleteById(id);
return true;
}
@RequestMapping(value = "/actualizar", method = RequestMethod.PUT)
public Alumno editar(@RequestBody Alumno alumno) {
return alumnosRepository.save(alumno);
}
}
Por ejemplo, para guardar un nuevo dato usamos el método POST e invocamos al método save
del repositorio. En el caso de eliminar, extraemos un valor de la ruta y usamos deleteById
.
También es importante mencionar que con @RequestMapping(path = "/alumnos")
hacemos que todas las rutas definidas en los métodos sean relativas a /alumnos. Por lo tanto, para consumir los datos debemos acceder a /alumnos/obtener, /alumnos/crear, etcétera.
Finalmente fíjate en que estamos permitiendo CORS en la línea 8. Esto puede ser cambiado a tu gusto.
Aquí dejo el código completo de la API, en mi repositorio de GitHub.
Recuerda que debes contar con gradle instalado. Una vez instalado simplemente ejecuta:
gradlew bootRun
Y luego navega a localhost:8080.
Puedes consumir la API con cualquier lenguaje que hable HTTP. También puedes usar Postman.
Pronto subiré un vídeo a YouTube demostrando cómo desarrollar la API y cómo consumirla con Postman. Actualización: a continuación dejo el vídeo.
Mientras tanto te recomiendo ver un sistema de ventas que hice hace algún tiempo usando este framework.
Hoy te voy a presentar un creador de credenciales que acabo de programar y que…
Ya te enseñé cómo convertir una aplicación web de Vue 3 en una PWA. Al…
En este artículo voy a documentar la arquitectura que yo utilizo al trabajar con WebAssembly…
En un artículo anterior te enseñé a crear un PWA. Al final, cualquier aplicación que…
Al usar Comlink para trabajar con los workers usando JavaScript me han aparecido algunos errores…
En este artículo te voy a enseñar cómo usar un "top level await" esperando a…
Esta web usa cookies.
Ver comentarios
hola tendras el codigo par conectar el springboot a android, lo necesito en android tambien
consulta este proyecto de github se puede abrir con visual studie code que ya tiene instalado spring boot y se puede conectar a my sql, puedes hablar sobre la seguridad y despliegue de microservicios