Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/LuisAMoralesA/tallerIngles-UAEMEcatepec/llms.txt

Use this file to discover all available pages before exploring further.

Before building or running the Taller de Inglés UAEMEx Ecatepec (TEI) system, make sure your environment satisfies all the prerequisites listed on this page. The application is packaged as a standard Java EE WAR archive, compiled against Java 11, and intended to run inside GlassFish 7 with a MySQL 8 backend.

Software requerido

Install and configure every component in the table below before proceeding to the build or deployment steps.
ComponenteVersión mínimaNotas
Java (JDK)11OpenJDK or Oracle JDK
Apache Maven3.8.1For building the WAR
GlassFish7.0Jakarta EE 10 compatible
MySQL8.0With InnoDB engine
MySQL Connector/J8.3.0Bundled in pom.xml

Dependencias Maven

All project dependencies are declared in pom.xml and are resolved automatically by Maven during the build. The key runtime and compile-scope dependencies are shown below.
pom.xml
<!-- Jakarta EE 10 API -->
<dependency>
    <groupId>jakarta.platform</groupId>
    <artifactId>jakarta.jakartaee-api</artifactId>
    <version>10.0.0</version>
    <scope>provided</scope>
</dependency>
<!-- MySQL JDBC Driver -->
<dependency>
    <groupId>com.mysql</groupId>
    <artifactId>mysql-connector-j</artifactId>
    <version>8.3.0</version>
</dependency>
<!-- JasperReports PDF -->
<dependency>
    <groupId>net.sf.jasperreports</groupId>
    <artifactId>jasperreports</artifactId>
    <version>7.0.3</version>
</dependency>
<!-- Apache POI Excel -->
<dependency>
    <groupId>org.apache.poi</groupId>
    <artifactId>poi-ooxml</artifactId>
    <version>5.2.3</version>
</dependency>
The jakarta.jakartaee-api dependency is provided because GlassFish 7 already ships the Jakarta EE 10 runtime. The JDBC driver, JasperReports, and Apache POI artifacts are bundled inside the WAR so they are available at runtime without any additional GlassFish configuration.

Configuración de base de datos

The database connection is hardcoded in the inner class BaseDatos.configuracionBD inside src/main/java/controller/BaseDatos.java:
ParámetroValor
Driver classcom.mysql.cj.jdbc.Driver
URLjdbc:mysql://localhost:3306/tallerdeingles?autoReconnect=true&useSSL=false
UsuarioadminTallerIngles
ContraseñaUAEMEX_2026
These credentials are hardcoded in the source file. You must change both the username and the password before deploying to a production environment. Failure to do so exposes the database with well-known default credentials. After changing the values in BaseDatos.java, rebuild the project with mvn clean package and redeploy the WAR.

mysqldump

The system includes a database backup feature that relies on mysqldump.exe. Before building, place the binary in the project’s source tree so that Maven packages it into the WAR:
src/main/webapp/WEB-INF/mysqldump.exe
At runtime, GlassFish resolves the file through the Constantes.ARCHIVO_MYSQLDUMP constant, which expands to:
/tallerDeInglesUAEM/WEB-INF/mysqldump.exe
This binary is Windows-specific. If you are deploying on Linux or macOS, replace mysqldump.exe with the appropriate mysqldump binary for your platform and update the constant in Constantes.java accordingly before rebuilding.

Build docs developers (and LLMs) love