Skip to content

Latest commit

 

History

History
67 lines (51 loc) · 2.46 KB

README.md

File metadata and controls

67 lines (51 loc) · 2.46 KB
Raw

CRUD API de Productos

Este proyecto es una API RESTful para gestionar productos, construida con Java y Spring Boot. La API utiliza Hibernate para el mapeo ORM y PostgreSQL como base de datos. Además, se ha configurado Docker para facilitar la implementación y pruebas. El cliente Postman permite realizar pruebas CRUD en los endpoints. Para la creación de tablas, se utilizó TablePlus.

Tecnologías utilizadas

  • Java: Lógica de negocio y desarrollo de API.
  • Spring Boot: Framework para el desarrollo de aplicaciones web.
  • Hibernate: ORM para manejo de entidades y persistencia en la base de datos.
  • PostgreSQL: Base de datos relacional.
  • TablePlus: Herramienta utilizada para la creación y administración de tablas en PostgreSQL.
  • Docker: Contenerización de la aplicación.
  • Postman: Cliente para probar y consumir los endpoints de la API.

Instalación

  1. Clona el repositorio

    git clone https://github.com/AlenSaavedra/Crud-ApiRest-Java
cd Crud-ApiRest-Java

  2. Configura PostgreSQL

    • Crea una base de datos en PostgreSQL usando TablePlus.
    • Actualiza los detalles de conexión en src/main/resources/application.properties: 
      spring.datasource.url=jdbc:postgresql://localhost:5432/tu_base_de_datos
spring.datasource.username=tu_usuario
spring.datasource.password=tu_contraseña

  3. Construcción con Docker

    • Construye la imagen Docker: 
      docker build -t crud-api-productos .
    • Corre el contenedor: 
      docker run -p 8080:8080 crud-api-productos

Endpoints

Método Endpoint Descripción
GET /productos Obtener todos los productos
GET /productos/{id} Obtener un producto por ID
POST /productos Crear un nuevo producto
PUT /productos/{id} Actualizar un producto por ID
DELETE /productos/{id} Eliminar un producto por ID

Pruebas con Postman

  1. Importa la colección de Postman ubicada en docs/PostmanCollection.json (si la has creado).
  2. Usa los diferentes endpoints para realizar operaciones CRUD.

Ejecución del proyecto

./mvnw spring-boot:run

La API estará disponible en http://localhost:8080.

Contribución

Si deseas contribuir, por favor crea un pull request o abre un issue para discutir el cambio.