Los chistes De Chuck es una aplicación divertida y educativa diseñada para explorar el uso de APIs en aplicaciones Java. El proyecto utiliza la API "chuckNorris.io" para obtener chistes aleatorios de Chuck Norris y permite a los usuarios puntuarlos. Estas puntuaciones se almacenan en una base de datos MySQL para un seguimiento y análisis posterior.
Una característica innovadora de la aplicación es la integración con la API LibreTranslate, que permite traducir los chistes a varios idiomas, incluidos inglés, español, italiano y portugués. La interfaz de usuario, desarrollada con Swing, cambia dinámicamente para reflejar el idioma seleccionado, ofreciendo una experiencia multilingüe completa.
El proyecto no solo sirve como un ejercicio técnico en la manipulación de APIs y bases de datos, sino que también promueve la colaboración y la mejora continua a través de la posibilidad de puntuar y revisar los chistes. Además, al usar tecnologías modernas como Docker para gestionar el contenedor de LibreTranslate, el proyecto se mantiene flexible y fácil de desplegar en diferentes entornos.
- Educación y experimentación: Proporcionar una plataforma para que los desarrolladores experimenten con APIs y bases de datos.
- Entretenimiento: Ofrecer una aplicación divertida y entretenida para los usuarios.
- Multilingüismo: Promover la accesibilidad a través de la traducción de contenidos a varios idiomas.
- Hacer un fork del proyecto o Ejecutar el archivo .exe
- Crear una tabla MySQL con los siguientes datos:
id_chiste,value,puntuacion,pos_entrada. - Correr una base de datos XAMPP.
- Instalar el contenedor LibreTranslate en Docker y correrlo.
- Iniciar el programa y automáticamente aparecerá un chiste.
- Seleccionar el idioma y puntuar el chiste.
- Al presionar "Otro chiste" o sus variantes, aparecerán nuevos chistes.
- Si se presiona el botón de abajo a la derecha que dice "Historial", se podrá acceder a todos los chistes que fueron puntuados y organizarlos por la puntuación que tuvieron.
Antes de ejecutar el proyecto Los chistes De Chuck, asegúrate de tener instalados los siguientes componentes:
- Java: Asegúrate de tener instalada la última versión del JDK (Java Development Kit).
- MySQL: Necesitarás una instancia de MySQL para almacenar los datos de los chistes y sus puntuaciones.
- XAMPP: Para gestionar fácilmente tu servidor MySQL (opcional pero recomendado).
- Docker: Para desplegar y ejecutar el contenedor de LibreTranslate.
El proyecto Los chistes De Chuck se desarrolló utilizando las siguientes tecnologías:
- Java: Lenguaje de programación principal utilizado para desarrollar la lógica del proyecto.
- Swing: Biblioteca de Java para crear la interfaz gráfica de usuario (GUI).
- MySQL: Sistema de gestión de bases de datos utilizado para almacenar los chistes y sus puntuaciones.
- Docker: Plataforma de contenedorización utilizada para desplegar la API de traducción LibreTranslate.
- APIs:
- chuckNorris.io: API utilizada para obtener chistes aleatorios de Chuck Norris.
- LibreTranslate: API utilizada para traducir los chistes a varios idiomas.
- Obtención de chistes: Recibe chistes aleatorios de la API "chuckNorris.io".
- Traducción multilingüe: Traduce los chistes a varios idiomas utilizando la API LibreTranslate.
- Almacenamiento: Guarda los chistes y sus puntuaciones en una base de datos MySQL.
- Interfaz amigable: Interfaz de usuario desarrollada en Java Swing, con soporte para cambio de idioma.
- Historial de chistes: Acceso a un historial de chistes puntuados, ordenables por la puntuación recibida.
Si deseas contribuir a este proyecto, por favor sigue estos pasos:
- Haz un fork del repositorio.
- Crea una rama para tu nueva característica (
git checkout -b feature/nueva-caracteristica). - Haz commit de tus cambios (
git commit -m 'Agregar nueva característica'). - Haz push a la rama (
git push origin feature/nueva-caracteristica). - Abre un Pull Request.
Este proyecto está licenciado bajo la Licencia MIT. Ver el archivo LICENSE para más detalles.