Este proyecto se desarrolla con la finalidad de llevar al campo práctico los contenidos estudiados durante el desarrollo del curso de formación Java del programa Oracle Next Education ONE.
Crearemos una API REST usando Spring boot, nuestra API estará compuesta por tópicos sobre un curso específico, estos tópicos, así como las respuestas a estos serán creados por usuarios registrados.
Básicamente la funcionalidad de la API está basada en realizar un CRUD que se podrá realizar a cada entidad creada y que funciona así:
- Crear un nuevo registro.
- Mostrar todos registros.
- Mostrar un registro específico.
- Actualizar un registro.
- Eliminar un registro.
También contará con búsquedas personalizadas como:
- Búsqueda de un tópico por id de un curso.
- Búsqueda de un tópico o respuesta por id de un autor.
- Búsqueda de una respuesta por id de un tópico.
Foro-Alura consta de cuatro entidades (Usuario, Curso, Topico, Respuesta) en las cuales podemos realizar acciones CRUD y en algunas de ellas búsquedas personalizadas, para esto contaremos con endpoints específicos que se encargaran de registrar las informaciones requeridas o simplemente ejecutar la acción necesaria, para una mejor comprensión se hace uso de Swagger para documentar la API.
Puesta en marcha
- Dar inicio al servidor de Spring boot.
- Ingresar en http://localhost:8085/doc/swagger-ui/index.html#/
- Abrir autenticacion-controller y generar el token para autenticarse ingresando usuario y contraseña como se muestra a continuación.
{
"nombre": "admin",
"contrasena": "admin"
}
- Buscar el botón authorize en la esquina superior derecha de la página e ingresar el token generado en autenticacion-controller.
- Una vez autenticado podras usar cualquiera de los endpoints generados.
 JDK 17.0.6 |
 NetBeans IDE 14 |
 NB SpringBoot |
|---|---|---|
 MySQL 8.0.32 |
 Swagger |
 Postman |
Foro-Alura esta desarrollado en java implementando Spring Boot.
Para correr Foro-Alura en tu máquina local:
-
Determina donde quieres alojar el proyecto y clonalo en la ubicacion escojida:
-
Con el IDE de tu preferencia procede a abrir el proyecto.
Netbeans.
1. Abrir el proyecto.
2. Dar click en el icono Clean and Build (Shift+F11) de la barra de herramientas o buscar en la barra de menú:
Run -> Clean and Build (Shift+F11)
3. Verificar que este configuarada la clase main:
Run -> Set Project Configuration -> Customize -> Run -> MainClass
Roberth de Jesus Rodriguez Castro
