andresWeitzel / ApiRest_Microcomponentes_SpringBoot

Api Rest para el manejo de Microcomponentes implementado con Spring Boot, Spring MVC, Spring Data JPA, SpringFox, Swagger UI, Maven, Lombok, Postman, Log4j, Git, SQLDeveloper, Oracle XE 21c y Otras Tecnologías.

ApiRest_Microcomponentes_SpringBoot

Api Rest para el manejo de Microcomponentes implementado con Spring Boot, Spring MVC, Spring Data JPA, SpringFox, Swagger UI, Maven, Lombok, Postman, Log4j, Git, SQLDeveloper, Oracle XE 21c y Otras Tecnologías.

• Micro_Frontend_Microcomponentes_React
• db_Microcomponentes_OracleXE
• PlayList

Índice 📜

Ver

Sección 1) Descripción, Tecnologías y Dependencias

• 1.0) Descripción del Proyecto.
• 1.1) Ejecución del Proyecto.
• 1.2) Patrones de Diseño.
• 1.3) Tecnologías.
• 1.4) Dependencias Maven.

Sección 2) Endpoints y Recursos

• 2.0) EndPoints.
• 2.1) Recursos por endpoints.

Sección 3) Prueba de Funcionalidad y Referencias

• 3.0) Prueba de Funcionalidad.
• 3.1) Referencias.

Sección 1) Descripción, Tecnologías y Dependencias

1.0) Descripción 🔝

Ver

• Microservicio Api Rest acerca de microcomponentes de electrónica implementado con Spring Boot, Spring MVC, Spring Data JPA, SpringFox, Swagger UI, Maven, Lombok, Postman, Log4j, Git, SQLDeveloper, Oracle XE 21c y Otras Tecnologías.
• Para este Microservicio no se implementa la capa de seguridad, es posible realizarlo con Spring Security (visualizar otras Api's Rest en mi perfíl de github).
• Se incluye documentación con Swagger 2 / Spring Fox para cada recurso junto con los códigos de respuesta Http más usados. Además se agrega doc junto con validaciones para cada Bean.
• Los Objetos de Búsqueda se trabajan como paginados, incluyendo algunos de tipo CRUD. Se implementa manejos de Excepciones con clases específicas para su control.
• Entre Otros.

1.1) Ejecución del Proyecto 🔝

Ver

• Descargamos y levantamos Oracle XE para ejecutar los servicios de base de datos.
• Abrimos una terminal y clonamos el repo de base de datos.
• Creamos y configuramos una conexión de oracle para la ejcución de los archivos de db.
• Para más info. consultar repositorio respectivo
• Descargamos Spring tool suite 4
• Desde sts u otro ide abrimos una terminal y creamos un entorno de trabajo o workspace.
• Clonar el Proyecto

git clone https://github.com/andresWeitzel/ApiRest_Microcomponentes_SpringBoot

• Click der sobre el proyecto --> Run as --> Spring Boot App
• Ya tenemos corriendo nuestra api desde tomcat. El url de la app para la ejecución de los endpoint's lo visualizamos desde consola.

1.2) Patrones de Diseño 🔝

Ver

Patrón de Diseño	Finalidad
DAO	Uso de interfaces entre la aplicación y el almacenamiento de datos.
MVC	Separación y Representación de los Datos, Manejo de errores, Escalabilidad, etc
DTO	Transferencia de objectos separando la capa de acceso a datos
Dependency Inyection	Uso de funcionalidades requeridas de clases a través de inyección
Otros	Otros

1.3) Tecnologías 🔝

Ver

Tecnologías	Versión	Finalidad
Java	12.0.2	JDK
Spring Tool Suite 4	4.9.0	IDE
Spring Boot	2.6.4	Framework
Spring Boot Data JPA	2.6.3	Mapeo de objetos y persistencia en la db
Spring Validation	2.7	Anotations para Validaciones
Spring Security	2.6.7	Módulo de Seguridad de Spring
Json Web Token	0.9.1	Manejo de Token's de Seguridad
SpringFox	3.0.0	Documentación de la Api
Lombok	1.18.22	Automatización de Código
Open-Api y UI Swagger	1.6.4	Documentación de la Api
UI Swagger	1.6.4	Visualización y Gestión de la Api
Oracle XE 21c	21.4.1	Sistema de Gestión de Bases de Datos
SQL Developer	21.4.1	Editor de Base de Datos
Maven	4.0.0	Gestor de Proyectos
Postman	9.1.1	Visualización y Gestión de la Api
CMD	10	Símbolo del Sistema para linea de comandos
GNU bash / Terminal	4.4.23	Bash / Terminal para el manejo e implementación de Git.
Git	2.29.1	Control de Versiones

1.4) Dependencias Maven 🔝

Ver

Dependencia Maven	Versión	Finalidad
spring-boot-starter-data-jpa	2.6.7	Api de JpaRepository para el manejo de métodos
spring-boot-starter-test	2.6.7	Para Testing
spring-boot-starter-web	2.6.7	Se agrega toda la configuración web automáticamente de Maven a Spring
spring-boot-starter-validation	2.7.0	Validación de Annotations
spring-boot-devtools	2.6.7	Herramientas para el Manejo de Spring Boot
springfox-boot-starter	3.0.0	Doc Api
springfox-swagger-ui	3.0.0	Doc Api
spring-boot-starter-data-mongodb	2.6.7	Manejo de SpringDataMongoDB con los métodos del Repository y anotations
springdoc-openapi-ui	1.6.4	Plantillas para el Front
spring-boot-devtools	2.6.7	Herramientas para el Manejo de Spring Boot
spring-boot-devtools	2.6.4	Herramientas para el Manejo de Spring Boot
ojdbc8	21.3.0.0	Driver para el SGDB Oracle
lombok	1.18.22	Dependencia para la automatización de Código

Sección 2) EndPoints y Recursos

2.0) EndPoints 🔝

Ver

2.1) Recursos y Servicios 🔝

Ver

Sección 3) Prueba de Funcionalidad y Referencias

3.0) Prueba de Funcionalidad 🔝

Ver

3.1) Referencias 🔝

Ver