# 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` | | `buscarPorId(int identificador)` | `SELECT ... WHERE identificador = ` | `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 = ` | 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.