121 lines
7.2 KiB
Markdown
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. |