13 KiB
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:
CicloFormativoreferencia a objetosFamiliaProfesionalyTipoFormacion. - 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 serviciomodel/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 profesionalesITipoFormacionDAO.java: interfaz del DAO de tipos de formaciónICicloFormativoDAO.java: interfaz del DAO de ciclos formativosimpl/FamiliaProfesionalDaoJDBC.java: implementación JDBC conPreparedStatementTipoFormacionDaoJDBC.java: implementación JDBC conPreparedStatementCicloFormativoDaoJDBC.java: implementación JDBC conPreparedStatementyJOIN
service/FormacionService.java: casos de uso (procesar familias y procesar ciclos)
util/LectorFamiliasCsv.java: lee el CSV de familias profesionalesLectorCiclosXml.java: lee el XML de ciclos formativos
excepciones/FormacionException.java: excepción de aplicación (checked)
gestores/GestorConfiguracion.java: cargaapplication.propertiesy expone sus valoresGestorConexionBBDD.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 procesarcatalogo_formacion.xml: ciclos formativos a procesar
Formacion_FP.sql: script de creación de la base de datospom.xmlREADME.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,TipoFormacionyCicloFormativo: clases del modelo con sus atributos, getters y setters.CicloFormativoguarda un objetoFamiliaProfesionaly un objetoTipoFormacion, no sus códigos.IFamiliaProfesionalDAO,ITipoFormacionDAOeICicloFormativoDAO: interfaces con las operaciones de acceso a datos. Todos sus métodos declaranthrows FormacionException.FamiliaProfesionalDaoJDBC,TipoFormacionDaoJDBCyCicloFormativoDaoJDBC: implementaciones JDBC. Reciben laConnectionpor constructor y la guardan en un atributoprivate final. Cada método crea unPreparedStatementcontry-with-resources. LasSQLExceptionse capturan y se relanzan envueltas enFormacionException, conservando la causa original.FormacionService: abre la conexión contry-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 enFormacionException.LectorFamiliasCsvyLectorCiclosXml: clases de utilidad (constructor privado y método estáticoleer()). Obtienen la ruta y el separador deGestorConfiguracion.FormacionException: excepción checked con dos constructores (mensajeymensaje, causa). Es la única que conocen las capas superiores.GestorConfiguracion: clase de utilidad (constructor privado) que cargaapplication.propertiesen el métodocargar()y ofrece un getter por propiedad. Si el fichero no existe o no se puede leer, lanzaFormacionException.GestorConexionBBDD: clase de utilidad que monta la URL (sgbd.conexion.url+bbdd.nombre) y devuelve unaConnectionnueva. Quien la recibe es responsable de cerrarla.AppPrincipal: crea elFormacionServicey ejecuta los dos casos de uso en orden. CapturaFormacionExceptionen un único punto.
Configuración
Fichero application.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.urlybbdd.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 usarlocalhost) 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()
- El lector crea cada
CicloFormativocon objetosFamiliaProfesionalyTipoFormacionque solo tienen el código. - El servicio busca en la BBDD la familia y el tipo con
obtenerPorCodigo. - Si alguno de los dos no existe, el ciclo se descarta.
- 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
AppPrincipaldos veces seguidas, la segunda fallará con un error de clave duplicada. Para repetir la prueba hay que volver a ejecutarFormacion_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.
AppPrincipalno 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 hastaAppPrincipal. - La carpeta
configestá configurada como source folder en Eclipse, por lo queapplication.propertiesestá en el classpath.
Ejecución
- Ejecutar
Formacion_FP.sqlen un cliente MySQL (por ejemplo DBeaver) para crear la base de datos. - Crear el usuario con permisos sobre la base de datos:
CREATE USER 'myuser'@'%' IDENTIFIED BY 'mypass'; GRANT ALL PRIVILEGES ON Formacion_FP.* TO 'myuser'@'%'; FLUSH PRIVILEGES; - Ajustar
config/application.propertiesa la IP y credenciales del servidor MySQL. - Comprobar que
ficheros/contienefamilias_profesionales.csvycatalogo_formacion.xml. - Ejecutar
AppPrincipalcomo aplicación Java, desde la raíz del proyecto. - Comprobar en la consola la salida (
Familias procesadas: 4yCiclos insertados: 10). - Comprobar en la base de datos:
SELECT * FROM T_FAMILIA_PROFESIONAL; -- ADG (nombre actualizado), IFC, SAN y TMV SELECT COUNT(*) FROM T_CICLO_FORMATIVO; -- 10