# aadd_conect04: Procesamiento de ficheros CSV y XML con JDBC, patrón DAO y capa de servicios (MySQL) ## Descripción Proyecto en Java que procesa dos ficheros (un CSV de familias profesionales y un XML de ciclos formativos) y vuelca su información en la base de datos `Formacion_FP`, administrada por MySQL. Se utiliza el API JDBC, el patrón DAO (solo para el acceso a la base de datos) y una capa de servicios. Todas las sentencias SQL se ejecutan con `PreparedStatement`. Es la evolución de `aadd_conect03` con cuatro novedades: - **Procesamiento de ficheros**: lectura de un CSV (familias profesionales) y de un XML con DOM (ciclos formativos). - **Fichero de configuración ampliado**: además de los datos de conexión, contiene las rutas de los ficheros y el separador del CSV. - **Modelo orientado a objetos**: `CicloFormativo` referencia a objetos `FamiliaProfesional` y `TipoFormacion`. - **Excepción de aplicación** `FormacionException` (checked), única excepción que sale de las capas de acceso a datos, utilidades y servicios. Los datos de conexión y las rutas de los ficheros no están escritos en el código: se leen del fichero `application.properties` a través de la clase `GestorConfiguracion`. ## Estructura del proyecto - `aadd_conect04/` - `src/org/palomafp/aadd/dta/` - `AppPrincipal.java`: clase principal que ejecuta los dos casos de uso a través del servicio - `model/` - `FamiliaProfesional.java`: clase del modelo (una familia profesional) - `TipoFormacion.java`: clase del modelo (un tipo de formación) - `CicloFormativo.java`: clase del modelo (un ciclo formativo, con su familia y su tipo) - `dao/` - `IFamiliaProfesionalDAO.java`: interfaz del DAO de familias profesionales - `ITipoFormacionDAO.java`: interfaz del DAO de tipos de formación - `ICicloFormativoDAO.java`: interfaz del DAO de ciclos formativos - `impl/` - `FamiliaProfesionalDaoJDBC.java`: implementación JDBC con `PreparedStatement` - `TipoFormacionDaoJDBC.java`: implementación JDBC con `PreparedStatement` - `CicloFormativoDaoJDBC.java`: implementación JDBC con `PreparedStatement` y `JOIN` - `service/` - `FormacionService.java`: casos de uso (procesar familias y procesar ciclos) - `util/` - `LectorFamiliasCsv.java`: lee el CSV de familias profesionales - `LectorCiclosXml.java`: lee el XML de ciclos formativos - `excepciones/` - `FormacionException.java`: excepción de aplicación (checked) - `gestores/` - `GestorConfiguracion.java`: carga `application.properties` y expone sus valores - `GestorConexionBBDD.java`: crea las conexiones a la base de datos - `config/` - `application.properties`: configuración (conexión a la BBDD y rutas de los ficheros) - `ficheros/` - `familias_profesionales.csv`: familias profesionales a procesar - `catalogo_formacion.xml`: ciclos formativos a procesar - `Formacion_FP.sql`: script de creación de la base de datos - `pom.xml` - `README.md` ## Base de datos El script `Formacion_FP.sql` crea la base de datos `Formacion_FP` con tres tablas: | Tabla | Columnas | |---|---| | `T_FAMILIA_PROFESIONAL` | `codigo` (PK), `nombre` | | `T_TIPO_FORMACION` | `codigo` (PK), `nombre_corto`, `nombre_largo` | | `T_CICLO_FORMATIVO` | `codigo` (PK), `nombre_corto`, `nombre_largo`, `horas_duracion`, `codigo_familia` (FK a `T_FAMILIA_PROFESIONAL`), `codigo_tipo_formacion` (FK a `T_TIPO_FORMACION`) | Tras ejecutar el script, la base de datos contiene la familia `ADG` (con un nombre distinto al del CSV) y los cuatro tipos de formación: `CFGB`, `CFGM`, `CFGS` y `CE`. No contiene ciclos formativos. ## Origen y destino de los datos | Información | Origen | Destino | |---|---|---| | Familias profesionales | Fichero CSV | `T_FAMILIA_PROFESIONAL` | | Ciclos formativos | Fichero XML | `T_CICLO_FORMATIVO` | | Tipos de formación | Base de datos (`T_TIPO_FORMACION`) | Solo se consulta | ## Arquitectura en capas ``` AppPrincipal → Service → DAO → Base de datos → Util → Ficheros (CSV y XML) ``` | Capa | Responsabilidad | |---|---| | `AppPrincipal` | Decide qué se ejecuta y qué se imprime. No conoce conexiones, SQL ni ficheros | | Servicio | Representa los casos de uso. Lee los ficheros, abre y cierra la conexión y aplica las reglas de negocio | | DAO | Ejecuta las sentencias SQL de una tabla. Recibe la conexión por constructor y no la cierra | | Util | Lee los ficheros CSV y XML y los convierte en objetos del modelo. No usa el patrón DAO | | Modelo | Clases que representan una fila de cada tabla | El patrón DAO se usa **únicamente para el acceso a la base de datos**. Los ficheros se leen con clases de utilidad. ## Componentes principales - **`FamiliaProfesional`, `TipoFormacion` y `CicloFormativo`**: clases del modelo con sus atributos, getters y setters. `CicloFormativo` guarda un objeto `FamiliaProfesional` y un objeto `TipoFormacion`, no sus códigos. - **`IFamiliaProfesionalDAO`, `ITipoFormacionDAO` e `ICicloFormativoDAO`**: interfaces con las operaciones de acceso a datos. Todos sus métodos declaran `throws FormacionException`. - **`FamiliaProfesionalDaoJDBC`, `TipoFormacionDaoJDBC` y `CicloFormativoDaoJDBC`**: implementaciones JDBC. Reciben la `Connection` por constructor y la guardan en un atributo `private final`. Cada método crea un `PreparedStatement` con `try-with-resources`. Las `SQLException` se capturan y se relanzan envueltas en `FormacionException`, conservando la causa original. - **`FormacionService`**: abre la conexión con `try-with-resources` (se cierra sola), crea los DAO pasándosela y aplica la lógica de cada caso de uso. Los fallos al cerrar la conexión también se convierten en `FormacionException`. - **`LectorFamiliasCsv` y `LectorCiclosXml`**: clases de utilidad (constructor privado y método estático `leer()`). Obtienen la ruta y el separador de `GestorConfiguracion`. - **`FormacionException`**: excepción checked con dos constructores (`mensaje` y `mensaje, causa`). Es la única que conocen las capas superiores. - **`GestorConfiguracion`**: clase de utilidad (constructor privado) que carga `application.properties` en el método `cargar()` y ofrece un getter por propiedad. Si el fichero no existe o no se puede leer, lanza `FormacionException`. - **`GestorConexionBBDD`**: clase de utilidad que monta la URL (`sgbd.conexion.url` + `bbdd.nombre`) y devuelve una `Connection` nueva. Quien la recibe es responsable de cerrarla. - **`AppPrincipal`**: crea el `FormacionService` y ejecuta los dos casos de uso en orden. Captura `FormacionException` en un único punto. ## Configuración Fichero `application.properties`: ```properties # Información relativa a la base de datos sgbd.conexion.url=jdbc:mysql://192.168.1.62:3306/ bbdd.nombre=Formacion_FP bbdd.usuario=myuser bbdd.clave=mypass # Información relativa a familias profesionales familiaprofesional.ruta.fichero=ficheros/familias_profesionales.csv familiaprofesional.csv.separador=| # Información relativa a ciclos formativos cicloformativo.ruta.fichero=ficheros/catalogo_formacion.xml ``` - La URL de conexión se forma concatenando `sgbd.conexion.url` y `bbdd.nombre`, es decir, `jdbc:mysql://192.168.1.62:3306/Formacion_FP`. Para ejecutar el proyecto en otro equipo hay que cambiar la IP (o usar `localhost`) y las credenciales. - Las rutas son relativas al directorio de ejecución, por lo que el programa debe lanzarse desde la raíz del proyecto. ## Ficheros de entrada ### CSV de familias profesionales Fichero con cabecera y separador `|`: ``` id_registro|fecha_carga|cod_tipo_fam|nombre_tf ``` Solo interesan las columnas `cod_tipo_fam` (posición 2) y `nombre_tf` (posición 3). El fichero contiene datos con espacios sobrantes (`" IFC"` y `"TMV "`), que se eliminan con `trim()`. El separador se escapa con `Pattern.quote`, porque `|` es un carácter especial en las expresiones regulares de `String.split`. ### XML de ciclos formativos Los elementos `ciclo` cuelgan de `ciclos_formativos`. Correspondencia con la tabla `T_CICLO_FORMATIVO`: | XML | Columna | |---|---| | atributo `cod_cf` | `codigo` | | `nomb_corto` | `nombre_corto` | | `nombrelargo` | `nombre_largo` | | `num_horas_duracion` | `horas_duracion` | | `codigo_familia` | `codigo_familia` | | `codigo_tipoestudio` | `codigo_tipo_formacion` | ## Métodos de los DAO Los tres DAO ofrecen los mismos cinco métodos: | Método | Sentencia SQL | Devuelve | |---|---|---| | `obtenerTodos()` | `SELECT` de todas las filas | `List` del modelo | | `obtenerPorCodigo(String codigo)` | `SELECT ... WHERE codigo = ?` | El objeto, o `null` si no existe | | `insertar(objeto)` | `INSERT` con todos los campos | nada | | `actualizar(objeto)` | `UPDATE` de los campos no clave por código | nada | | `borrar(String codigo)` | `DELETE ... WHERE codigo = ?` | nada | `CicloFormativoDaoJDBC` usa un `JOIN` con `T_FAMILIA_PROFESIONAL` y `T_TIPO_FORMACION` en `obtenerTodos()` y `obtenerPorCodigo()` para reconstruir los objetos referenciados. ## Métodos del servicio | Método | Acción | |---|---| | `procesarFamilias()` | Lee el CSV y, por cada familia, la inserta si no existe en la BBDD o actualiza su nombre si ya existe. Devuelve el número de familias procesadas | | `procesarCiclos()` | Lee el XML e inserta solo los ciclos cuya familia profesional y tipo de formación existen en la BBDD. Devuelve el número de ciclos insertados | ### Reglas de `procesarCiclos()` 1. El lector crea cada `CicloFormativo` con objetos `FamiliaProfesional` y `TipoFormacion` que solo tienen el código. 2. El servicio busca en la BBDD la familia y el tipo con `obtenerPorCodigo`. 3. Si alguno de los dos no existe, el ciclo se descarta. 4. Si existen ambos, el servicio sustituye los objetos incompletos por los de la BBDD e inserta el ciclo. ## Métodos de `AppPrincipal` | Método | Acción | |---|---| | `main(String[] args)` | Crea el servicio, ejecuta `procesarFamilias()` y después `procesarCiclos()`, e imprime el número de registros procesados. Captura `FormacionException` en un único punto | **El orden es obligatorio**: las familias `IFC`, `TMV` y `SAN` solo existen en la BBDD después de procesar el CSV. Si se procesaran antes los ciclos, saldrían menos de 10. ## Resultado del procesamiento ### Familias profesionales | Código | Acción | Motivo | |---|---|---| | `ADG` | Actualizada | Ya existía en la BBDD: su nombre pasa a `Administración y Gestión` | | `IFC` | Insertada | No existía | | `TMV` | Insertada | No existía | | `SAN` | Insertada | No existía | ### Ciclos formativos El XML contiene 14 ciclos, de los que se insertan 10: | Ciclo | Familia | Tipo | ¿Se inserta? | |---|---|---|---| | `ADGB01` | `ADG` | `CFBA` | No: el tipo de formación no existe | | `ADGM01` | `ADG` | `CFGM` | Sí | | `ADGS01` | `ADG` | `CFGS` | Sí | | `IFCB01` | `IFE` | `CFGB` | No: la familia profesional no existe | | `IFCM01` | `IFC` | `CFGM` | Sí | | `IFCS02` | `IFC` | `CFGS` | Sí | | `IFCS03` | `IFC` | `CFGS` | Sí | | `IFCES03` | `IFC` | `CFE` | No: el tipo de formación no existe | | `TMVB01` | `TMV` | `CFGB` | Sí | | `TMVM01` | `TMV` | `CFGM` | Sí | | `TMVS01` | `TMV` | `CFGS` | Sí | | `TMVES02` | `TMV` | `CE` | Sí | | `SANM01` | `SAN` | `CFME` | No: el tipo de formación no existe | | `SANS01` | `SAN` | `CFGS` | Sí | ## Salida por consola Salida obtenida al ejecutar `AppPrincipal` con la base de datos recién creada: ``` Familias procesadas: 4 Ciclos insertados: 10 ``` ## Aspectos a tener en cuenta - Se asume que **no hay ciclos formativos** en la base de datos. Si se ejecuta `AppPrincipal` dos veces seguidas, la segunda fallará con un error de clave duplicada. Para repetir la prueba hay que volver a ejecutar `Formacion_FP.sql`. - Las familias sí se pueden procesar varias veces: si ya existen, solo se actualiza el nombre. - Los DAO no abren ni cierran la conexión; lo hace el servicio. `AppPrincipal` no conoce JDBC ni los ficheros. - Se usa una conexión por caso de uso: la misma conexión sirve para los tres DAO. - Los lectores no usan el patrón DAO, porque el enunciado lo limita al acceso a la base de datos. - Hay una única excepción de aplicación, `FormacionException`, que se propaga desde los DAO y los lectores hasta `AppPrincipal`. - La carpeta `config` está configurada como *source folder* en Eclipse, por lo que `application.properties` está en el classpath. ## Ejecución 1. Ejecutar `Formacion_FP.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 Formacion_FP.* TO 'myuser'@'%'; FLUSH PRIVILEGES; ``` 3. Ajustar `config/application.properties` a la IP y credenciales del servidor MySQL. 4. Comprobar que `ficheros/` contiene `familias_profesionales.csv` y `catalogo_formacion.xml`. 5. Ejecutar `AppPrincipal` como aplicación Java, desde la raíz del proyecto. 6. Comprobar en la consola la salida (`Familias procesadas: 4` y `Ciclos insertados: 10`). 7. Comprobar en la base de datos: ```sql SELECT * FROM T_FAMILIA_PROFESIONAL; -- ADG (nombre actualizado), IFC, SAN y TMV SELECT COUNT(*) FROM T_CICLO_FORMATIVO; -- 10 ```