Files
aadd_conect04/README.md
T
2026-11-05 10:21:45 +01:00

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: 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:

# 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:
    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:
    SELECT * FROM T_FAMILIA_PROFESIONAL;     -- ADG (nombre actualizado), IFC, SAN y TMV
    SELECT COUNT(*) FROM T_CICLO_FORMATIVO;  -- 10