Este es un proyecto de API REST desarrollado con Spring Boot para gestionar clientes. Permite realizar operaciones CRUD (Create, Read, Update, and Delete - Crear, Leer, Actualizar y Eliminar) sobre la entidad Cliente.
- Java JDK 8 o superior: Asegúrate de tener instalado Java en tu sistema. Puedes descargarlo aquí.
- Maven: Necesitarás Maven para compilar y ejecutar el proyecto. Puedes descargarlo aquí.
- MySQL Server (opcional): Si deseas utilizar una base de datos MySQL, necesitarás tener MySQL Server instalado. Puedes descargarlo aquí.
-
Clonar el repositorio:
git clone https://github.com/tu_usuario/tu_proyecto.git
-
Importar el proyecto:
Importa el proyecto en tu IDE preferido (Eclipse, IntelliJ, etc.).
-
Configurar la conexión a la base de datos:
-
Si estás utilizando MySQL, asegúrate de tener las siguientes propiedades en el archivo
application.properties
:spring.datasource.url=jdbc:mysql://localhost:3306/nombre_base_datos spring.datasource.username=usuario spring.datasource.password=contraseña
-
-
Ejecutar la aplicación:
Utiliza Maven para ejecutar la aplicación:
mvn spring-boot:run
Una vez que la aplicación esté en funcionamiento, puedes realizar las siguientes operaciones:
-
Obtener todos los clientes:
- Método:
GET
- URL:
http://localhost:8080/clients
- Método:
-
Obtener un cliente por ID:
- Método:
GET
- URL:
http://localhost:8080/clients/{id}
- Método:
-
Crear un nuevo cliente:
- Método:
POST
- URL:
http://localhost:8080/clients
- Cuerpo de la solicitud:
{ "cedula": "123456789", "nombre": "Juan", "apellido": "Pérez", "telefono": "123456789", "email": "juan@example.com" }
- Método:
-
Actualizar un cliente existente:
- Método:
PUT
- URL:
http://localhost:8080/clients/{id}
- Cuerpo de la solicitud:
{ "cedula": "123456789", "nombre": "Juan", "apellido": "Pérez", "telefono": "987654321", "email": "juan@example.com" }
- Método:
-
Eliminar un cliente:
- Método:
DELETE
- URL:
http://localhost:8080/clients/{id}
- Método:
Si deseas contribuir a este proyecto, por favor sigue los siguientes pasos:
- Haz un fork del proyecto.
- Crea una nueva rama (
git checkout -b feature/nueva-caracteristica
). - Realiza tus cambios y haz commit (
git commit -am 'Agrega nueva característica'
). - Sube tus cambios (
git push origin feature/nueva-caracteristica
). - Crea un nuevo Pull Request.
Este proyecto está licenciado bajo la Licencia MIT.