Files
2026-10-30 13:13:16 +01:00

121 lines
7.2 KiB
Markdown

# aadd_conect02: Operaciones DML con JDBC y patrón DAO (MySQL)
## Descripción
Proyecto en Java que realiza operaciones básicas de manipulación de datos (DML) sobre la tabla `T_PAIS` de la base de datos `Mapa_Mundi`, administrada por MySQL. Se utiliza el API JDBC y el patrón DAO, y todas las sentencias SQL se ejecutan con `Statement` (no se usa `PreparedStatement`).
Los datos de conexión no están escritos en el código: se leen del fichero `application.properties` a través de la clase `GestorConfiguracion`. La conexión se abre una sola vez en `AppPrincipal` y se inyecta en el DAO por constructor.
## Estructura del proyecto
- `aadd_conect02/`
- `src/org/palomafp/aadd/dta/`
- `AppPrincipal.java`: clase principal que abre la conexión y ejecuta los cinco pasos del enunciado
- `model/`
- `Pais.java`: clase del modelo (un país)
- `dao/`
- `IPaisDao.java`: interfaz del DAO
- `impl/`
- `PaisDaoJdbc.java`: implementación del DAO con JDBC y `Statement`
- `gestores/`
- `GestorConfiguracion.java`: carga `application.properties` y devuelve la conexión
- `config/`
- `application.properties`: configuración (datos de conexión a la BBDD)
- `MapaMundi.sql`: script de creación de la base de datos
- `pom.xml`
- `README.md`
## Base de datos
El script `MapaMundi.sql` crea la base de datos `Mapa_Mundi` con dos tablas:
| Tabla | Columnas |
|---|---|
| `T_CONTINENTE` | `codigo` (PK), `nombre_continente` |
| `T_PAIS` | `cod_continente` (FK a `T_CONTINENTE`), `identificador` (PK, autoincremental), `nombre_pais`, `capital` |
Contiene 5 continentes y 198 países. Ninguna otra tabla referencia a `T_PAIS`, por lo que el borrado de un país no da problemas de clave foránea.
## Componentes principales
- **`Pais`**: clase del modelo con los atributos `codContinente`, `identificador`, `nombrePais` y `capital`, sus getters y setters y `toString()`.
- **`IPaisDao`**: interfaz que define las operaciones sobre países. La capa de presentación solo conoce esta interfaz.
- **`PaisDaoJdbc`**: implementación de `IPaisDao`. Recibe la `Connection` por constructor y la guarda en un atributo `private final`. Cada método crea un `Statement` a partir de esa conexión y lo cierra con `try-with-resources`; la conexión no la cierra el DAO. El `Pais` se rellena directamente con los datos del `ResultSet`. Las `SQLException` se propagan con `throws` a quien llama.
- **`GestorConfiguracion`**: clase de utilidad (constructor privado) que carga `application.properties` en un bloque `static` y entrega la `Connection`.
- **`AppPrincipal`**: abre la conexión con `try-with-resources`, crea el DAO pasándosela y ejecuta los cinco pasos del enunciado, cada uno en un método privado que recibe el DAO como parámetro. El `main` solo coordina.
## Configuración
Fichero `application.properties`:
```properties
# Información relativa a la base de datos
sgdb.clase.driver=com.mysql.cj.jdbc.Driver
sgdb.conexion.url=jdbc:mysql://192.168.1.62:3306/
bbdd.nombre=Mapa_Mundi
bbdd.usuario=myuser
bbdd.clave=mypass
```
La URL de conexión se forma concatenando `sgdb.conexion.url` y `bbdd.nombre`, es decir, `jdbc:mysql://192.168.1.62:3306/Mapa_Mundi`. Para ejecutar el proyecto en otro equipo hay que cambiar la IP (o usar `localhost`) y las credenciales.
## Métodos de `GestorConfiguracion`
| Método | Acción |
|---|---|
| bloque `static` | Carga `application.properties` desde el classpath. Si no existe o no se puede leer, lanza una `IllegalStateException` |
| `getConexion()` | Carga el driver indicado en `sgdb.clase.driver`, monta la URL y devuelve una `Connection` con el usuario y la clave configurados. Quien la recibe es responsable de cerrarla |
## Métodos de `IPaisDao` / `PaisDaoJdbc`
| Método | Sentencia SQL | Devuelve |
|---|---|---|
| `listarTodos()` | `SELECT` de todos los países | `List<Pais>` |
| `buscarPorId(int identificador)` | `SELECT ... WHERE identificador = <id>` | `Pais`, o `null` si no existe |
| `insertar(Pais pais)` | `INSERT` con los cuatro campos del país | Filas insertadas |
| `actualizar(Pais pais)` | `UPDATE` de continente, nombre y capital por identificador | Filas actualizadas |
| `borrar(int identificador)` | `DELETE ... WHERE identificador = <id>` | Filas borradas |
## Métodos de `AppPrincipal`
| Método | Acción |
|---|---|
| `main(String[] args)` | Abre la conexión con `try-with-resources`, crea el `PaisDaoJdbc` y ejecuta los cinco pasos en orden. Si el país 152 no existe, termina sin borrar nada. Captura la `SQLException` en un único punto |
| `listarPaises(IPaisDao dao)` | Paso 1. Consulta la lista de países y la imprime |
| `consultarPais(IPaisDao dao)` | Paso 2. Consulta el país 152, lo imprime y lo devuelve para los pasos 4 y 5 |
| `borrarPais(IPaisDao dao)` | Paso 3. Borra el país 152 y comprueba con una consulta que ya no existe |
| `insertarPais(IPaisDao dao, Pais pais)` | Paso 4. Inserta el país obtenido en el paso 2 |
| `actualizarCapital(IPaisDao dao, Pais pais)` | Paso 5. Cambia la capital a "Capital city" y actualiza el país |
Los valores `152` y `"Capital city"` están definidos como constantes (`ID_PAIS` y `NUEVA_CAPITAL`).
## Pasos del programa
| Paso | Operación | Resultado esperado |
|---|---|---|
| 1 | Consultar e imprimir la lista de países | 198 países |
| 2 | Consultar e imprimir el país 152 | `España`, capital `Madrid`, continente `04` |
| 3 | Borrar el país 152 | `Filas borradas: 1` y la consulta posterior devuelve `null` |
| 4 | Insertar el país del paso 2 | `Filas insertadas: 1` y la consulta devuelve España con capital `Madrid` |
| 5 | Actualizar la capital | `Filas actualizadas: 1` y la consulta devuelve España con capital `Capital city` |
## Aspectos a tener en cuenta
- El país insertado en el paso 4 es el mismo objeto `Pais` que se consultó en el paso 2, guardado en memoria antes de borrarlo. Por eso se recupera con el mismo identificador y el mismo continente.
- Con `Statement` los valores se concatenan en la sentencia SQL, por lo que un texto con apóstrofo (por ejemplo `Nuku'alofa`) rompería un `INSERT` o un `UPDATE`. Con España no hay problema. Es la limitación que resuelve `PreparedStatement`.
- Se utiliza una única conexión para todas las operaciones. El DAO no sabe cómo se crea (inyección por constructor) y no depende de `GestorConfiguracion`, lo que permitiría agrupar varias operaciones en una transacción si fuese necesario. En esta práctica no se usan transacciones: cada sentencia se confirma automáticamente.
- Tras la ejecución, España queda en la base de datos con la capital `Capital city`. Para volver al estado original hay que ejecutar de nuevo `MapaMundi.sql`.
- La carpeta `config` está configurada como *source folder* en Eclipse, por lo que `application.properties` está en el classpath.
## Ejecución
1. Ejecutar `MapaMundi.sql` en un cliente MySQL (por ejemplo DBeaver) para crear la base de datos.
2. Crear el usuario con permisos sobre la base de datos:
```sql
CREATE USER 'myuser'@'%' IDENTIFIED BY 'mypass';
GRANT ALL PRIVILEGES ON Mapa_Mundi.* TO 'myuser'@'%';
FLUSH PRIVILEGES;
```
3. Ajustar `config/application.properties` a la IP y credenciales del servidor MySQL.
4. Ejecutar `AppPrincipal` como aplicación Java.
5. Comprobar en la consola la salida de los cinco pasos.