first commit
This commit is contained in:
@@ -0,0 +1,252 @@
|
||||
# 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
|
||||
```
|
||||
Reference in New Issue
Block a user